@kizunajs/kotlin 2.0.0-beta.0

package/dist/index.cjs

@@ -0,0 +1,22 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_generator = require("./generator-s2pn7vqP.cjs");
+//#region src/client-target.ts
+/**
+* A Kotlin client target for `kizuna.config.ts`.
+*
+* @example
+* kotlinClient({ output: './api/APIClient.kt', package: 'com.example.api' });
+*/
+const kotlinClient = (options) => ({
+	kind: "kotlin",
+	output: options.output,
+	generate: (contract) => require_generator.generateKotlinClient(contract, {
+		namespaceName: options.namespace ?? "API",
+		packageName: options.package,
+		camelCaseProperties: options.camelCaseProperties,
+		unknownEnumCase: options.unknownEnumCase
+	})
+});
+//#endregion
+exports.generateKotlinClient = require_generator.generateKotlinClient;
+exports.kotlinClient = kotlinClient;

package/dist/index.d.cts

@@ -0,0 +1,82 @@
+import { ApiDefinition, ClientTarget } from "kizunajs";
+
+//#region src/generator.d.ts
+interface KotlinConfig {
+  namespaceName: string;
+  /**
+   * Package declaration for the generated file (e.g. `com.example.api`).
+   *
+   * Omit to emit the file with no package (the default/root package).
+   */
+  packageName?: string;
+  /**
+   * Convert wire field names to camelCase properties, mapping the wire name
+   * back via `@SerialName`. When off, names are kept verbatim so the generated
+   * types mirror the wire shape.
+   *
+   * @default false
+   */
+  camelCaseProperties?: boolean;
+  /**
+   * Emit each `z.enum` as a `sealed interface` with an `Unknown(wireValue)`
+   * member, so unrecognised wire values decode instead of throwing. The raw
+   * string round-trips on encode and in query params. Discriminated unions are
+   * unaffected and still throw on an unknown discriminator.
+   *
+   * @default false
+   */
+  unknownEnumCase?: boolean;
+}
+/**
+ * Generate a Kotlin API client from a Kizuna api.
+ *
+ * @param api - What `defineConfig` assembled.
+ * @param config - Override the generated names:
+ *   - `namespaceName`: the object wrapping shared types.
+ *   - `packageName`: optional package declaration for the generated file.
+ */
+declare const generateKotlinClient: (api: ApiDefinition, config: KotlinConfig) => string;
+//#endregion
+//#region src/client-target.d.ts
+/**
+ * Where a generated Kotlin client is written, and what it is called there.
+ */
+interface KotlinClientOptions {
+  /**
+   * Path the generated file is written to.
+   */
+  output: string;
+  /**
+   * Name of the generated namespace object.
+   *
+   * @default 'API'
+   */
+  namespace?: string;
+  /**
+   * Package declaration for the generated file, e.g. `com.example.api`.
+   */
+  package?: string;
+  /**
+   * Convert wire field names to camelCase properties, mapping the wire name
+   * back via `@SerialName`.
+   *
+   * @default false
+   */
+  camelCaseProperties?: boolean;
+  /**
+   * Give every enum an `unknown` case, so a value the client has not been
+   * generated for decodes instead of throwing.
+   *
+   * @default false
+   */
+  unknownEnumCase?: boolean;
+}
+/**
+ * A Kotlin client target for `kizuna.config.ts`.
+ *
+ * @example
+ * kotlinClient({ output: './api/APIClient.kt', package: 'com.example.api' });
+ */
+declare const kotlinClient: (options: KotlinClientOptions) => ClientTarget;
+//#endregion
+export { type KotlinClientOptions, type KotlinConfig, generateKotlinClient, kotlinClient };

package/dist/index.d.mts

@@ -0,0 +1,82 @@
+import { ApiDefinition, ClientTarget } from "kizunajs";
+
+//#region src/generator.d.ts
+interface KotlinConfig {
+  namespaceName: string;
+  /**
+   * Package declaration for the generated file (e.g. `com.example.api`).
+   *
+   * Omit to emit the file with no package (the default/root package).
+   */
+  packageName?: string;
+  /**
+   * Convert wire field names to camelCase properties, mapping the wire name
+   * back via `@SerialName`. When off, names are kept verbatim so the generated
+   * types mirror the wire shape.
+   *
+   * @default false
+   */
+  camelCaseProperties?: boolean;
+  /**
+   * Emit each `z.enum` as a `sealed interface` with an `Unknown(wireValue)`
+   * member, so unrecognised wire values decode instead of throwing. The raw
+   * string round-trips on encode and in query params. Discriminated unions are
+   * unaffected and still throw on an unknown discriminator.
+   *
+   * @default false
+   */
+  unknownEnumCase?: boolean;
+}
+/**
+ * Generate a Kotlin API client from a Kizuna api.
+ *
+ * @param api - What `defineConfig` assembled.
+ * @param config - Override the generated names:
+ *   - `namespaceName`: the object wrapping shared types.
+ *   - `packageName`: optional package declaration for the generated file.
+ */
+declare const generateKotlinClient: (api: ApiDefinition, config: KotlinConfig) => string;
+//#endregion
+//#region src/client-target.d.ts
+/**
+ * Where a generated Kotlin client is written, and what it is called there.
+ */
+interface KotlinClientOptions {
+  /**
+   * Path the generated file is written to.
+   */
+  output: string;
+  /**
+   * Name of the generated namespace object.
+   *
+   * @default 'API'
+   */
+  namespace?: string;
+  /**
+   * Package declaration for the generated file, e.g. `com.example.api`.
+   */
+  package?: string;
+  /**
+   * Convert wire field names to camelCase properties, mapping the wire name
+   * back via `@SerialName`.
+   *
+   * @default false
+   */
+  camelCaseProperties?: boolean;
+  /**
+   * Give every enum an `unknown` case, so a value the client has not been
+   * generated for decodes instead of throwing.
+   *
+   * @default false
+   */
+  unknownEnumCase?: boolean;
+}
+/**
+ * A Kotlin client target for `kizuna.config.ts`.
+ *
+ * @example
+ * kotlinClient({ output: './api/APIClient.kt', package: 'com.example.api' });
+ */
+declare const kotlinClient: (options: KotlinClientOptions) => ClientTarget;
+//#endregion
+export { type KotlinClientOptions, type KotlinConfig, generateKotlinClient, kotlinClient };

package/dist/index.mjs

@@ -0,0 +1,20 @@
+import { t as generateKotlinClient } from "./generator-BvNpSarY.mjs";
+//#region src/client-target.ts
+/**
+* A Kotlin client target for `kizuna.config.ts`.
+*
+* @example
+* kotlinClient({ output: './api/APIClient.kt', package: 'com.example.api' });
+*/
+const kotlinClient = (options) => ({
+	kind: "kotlin",
+	output: options.output,
+	generate: (contract) => generateKotlinClient(contract, {
+		namespaceName: options.namespace ?? "API",
+		packageName: options.package,
+		camelCaseProperties: options.camelCaseProperties,
+		unknownEnumCase: options.unknownEnumCase
+	})
+});
+//#endregion
+export { generateKotlinClient, kotlinClient };

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@kizunajs/kotlin",
+  "version": "2.0.0-beta.0",
+  "description": "Kotlin client generation for Kizuna.js APIs",
+  "keywords": [
+    "kizunajs",
+    "typescript",
+    "zod",
+    "openapi",
+    "spec-driven",
+    "type-safe",
+    "rest",
+    "api",
+    "kotlin",
+    "android",
+    "jvm",
+    "codegen",
+    "client-generation"
+  ],
+  "license": "MIT",
+  "homepage": "https://kizunajs.com/docs/clients/kotlin",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kizunajs/kizuna.git",
+    "directory": "packages/kotlin"
+  },
+  "bugs": "https://github.com/kizunajs/kizuna/issues",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "bin": {
+    "kizuna-kotlin": "./dist/cli.mjs"
+  },
+  "kizuna": {
+    "entries": {
+      ".": "server"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@kizunajs/cli": "2.0.0-beta.0"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0",
+    "kizunajs": "2.0.0-beta.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "tsdown": "^0.21.0",
+    "typescript": "^6.0.3",
+    "zod": "^4.0.0",
+    "kizunajs": "2.0.0-beta.0"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/cli.ts --format esm,cjs --dts --clean --external kizunajs --external @kizunajs/cli --external zod",
+    "typecheck": "tsc --noEmit"
+  }
+}