@kizunajs/fetch 2.0.0-beta.3 → 2.0.0-beta.5

package/dist/server.cjs

@@ -27,6 +27,15 @@ var TypeCollector = class {
 	}
 };
 const quote = (value) => JSON.stringify(value);
+/**
+* A literal as the type the JSON carries, so `z.literal(true)` is `true`.
+*/
+const literalType = (value) => {
+	if (typeof value === "string") return quote(value);
+	if (typeof value === "bigint") return `${value}n`;
+	if (value === void 0) return "undefined";
+	return String(value);
+};
 const indent$1 = (text, depth = 1) => text.split("\n").map((line) => line.length > 0 ? "    ".repeat(depth) + line : line).join("\n");
 /**
 * A property name, quoted only when it is not a plain identifier.
@@ -165,14 +174,21 @@ const typeOf = (schema, collector, hint) => {
 		return side ? typeOf(side, collector, hint) : "unknown";
 	}
 	const modelName = (0, kizunajs_generator.readMetaId)(schema);
-	if (modelName !== void 0 && def.type === "object") {
+	if (modelName !== void 0) {
 		if (collector.claim(modelName)) collector.add({
 			name: modelName,
 			description: (0, kizunajs_generator.readMetaDescription)(schema),
-			body: objectBody(schema, collector, modelName)
+			body: structuralType(schema, collector, modelName)
 		});
 		return modelName;
 	}
+	return structuralType(schema, collector, hint);
+};
+/**
+* The type a schema describes by its shape, its name already spent by the caller.
+*/
+const structuralType = (schema, collector, hint) => {
+	const def = (0, kizunajs_generator.readDef)(schema);
 	switch (def.type) {
 		case "string": return "string";
 		case "number":
@@ -188,11 +204,11 @@ const typeOf = (schema, collector, hint) => {
 		case "undefined": return "undefined";
 		case "literal": {
 			const values = def.values ?? [];
-			return values.length > 0 ? values.map((value) => quote(String(value))).join(" | ") : "never";
+			return values.length > 0 ? values.map(literalType).join(" | ") : "never";
 		}
 		case "enum": {
 			const values = Object.values(def.entries ?? {});
-			return values.length > 0 ? values.map((value) => quote(String(value))).join(" | ") : "never";
+			return values.length > 0 ? values.map(literalType).join(" | ") : "never";
 		}
 		case "array": return def.element ? `Array<${typeOf(def.element, collector, `${hint}Item`)}>` : "unknown[]";
 		case "object": return objectBody(schema, collector, hint);
@@ -275,7 +291,7 @@ const routeDoc = (routeKey, route) => {
 	lines.push("@example", exampleCall(routeKey, route));
 	return docComment(lines);
 };
-const emitRoute = (routeKey, key, route, collector) => {
+const emitRoute = (routeKey, key, route, collector, namespaceName) => {
 	const namespace = routeKey.split(".").map(kizunajs_generator.toPascalCase).join("");
 	const members = [];
 	const args = [];
@@ -283,19 +299,19 @@ const emitRoute = (routeKey, key, route, collector) => {
 	if (params.length > 0) {
 		const body = route.pathParams ? typeOf(route.pathParams, collector, `${namespace}Params`) : `{\n${indent(params.map((name) => `${name}: string;`).join("\n"))}\n}`;
 		members.push(`export type Params = ${body};`);
-		args.push(`params: API.${namespace}.Params`);
+		args.push(`params: ${namespaceName}.${namespace}.Params`);
 	}
 	if (route.query) {
 		members.push(`export type Query = ${typeOf(route.query, collector, `${namespace}Query`)};`);
-		args.push(`query?: API.${namespace}.Query`);
+		args.push(`query?: ${namespaceName}.${namespace}.Query`);
 	}
 	if (route.body && !(0, kizunajs_generator.isVoidSchema)(route.body)) {
 		members.push(`export type Body = ${typeOf(route.body, collector, `${namespace}Body`)};`);
-		args.push(`body: API.${namespace}.Body`);
+		args.push(`body: ${namespaceName}.${namespace}.Body`);
 	}
 	if (route.headers) {
 		members.push(`export type Headers = ${typeOf(route.headers, collector, `${namespace}Headers`)};`);
-		args.push(`headers?: API.${namespace}.Headers`);
+		args.push(`headers?: ${namespaceName}.${namespace}.Headers`);
 	} else args.push("headers?: Record<string, string>");
 	args.push("fetchOptions?: RequestInit");
 	const validates = route.body !== void 0 || route.query !== void 0;
@@ -319,13 +335,13 @@ const emitRoute = (routeKey, key, route, collector) => {
 	const streams = Object.values(route.responses).some((response) => (0, kizunajs_generator.isStreamResponse)(response));
 	return {
 		namespace,
-		signature: `${routeDoc(routeKey, route)}${key}: ClientMethod<'${route.method}', ${streams}, ${argsType}, API.${namespace}.Result>;`,
+		signature: `${routeDoc(routeKey, route)}${key}: ClientMethod<'${route.method}', ${streams}, ${argsType}, ${namespaceName}.${namespace}.Result>;`,
 		declaration: `export namespace ${namespace} {\n${indent(members.join("\n\n"))}\n}`,
 		table: `${key}: {\n${indent(tableEntries.map((entry) => `${entry},`).join("\n"))}\n},`
 	};
 };
 const isRoute = (value) => !!value && typeof value === "object" && typeof value.method === "string";
-const emitTree = (routes, prefix, collector) => {
+const emitTree = (routes, prefix, collector, namespaceName) => {
 	const signatures = [];
 	const tables = [];
 	const declarations = [];
@@ -333,14 +349,14 @@ const emitTree = (routes, prefix, collector) => {
 		const node = routes[key];
 		const routeKey = prefix ? `${prefix}.${key}` : key;
 		if (isRoute(node)) {
-			const emitted = emitRoute(routeKey, key, node, collector);
+			const emitted = emitRoute(routeKey, key, node, collector, namespaceName);
 			signatures.push(emitted.signature);
 			tables.push(emitted.table);
 			declarations.push(emitted.declaration);
 			continue;
 		}
 		if (node && typeof node === "object") {
-			const group = emitTree(node, routeKey, collector);
+			const group = emitTree(node, routeKey, collector, namespaceName);
 			signatures.push(`${key}: {\n${indent(group.signatures)}\n};`);
 			tables.push(`${key}: {\n${indent(group.table)}\n},`);
 			declarations.push(...group.declarations);
@@ -372,9 +388,9 @@ const emitRequestContext = (contract, collector) => {
 	return fields.length > 0 ? `export interface RequestContext {\n${indent(fields.join("\n"))}\n}` : void 0;
 };
 const generateFetchClient = (contract, options = {}) => {
-	const { runtimeModule = "@kizunajs/fetch", regenerateCommand = "kizuna generate", source } = options;
+	const { namespace: namespaceName = "API", runtimeModule = "@kizunajs/fetch", regenerateCommand = "kizuna generate", source } = options;
 	const collector = new TypeCollector();
-	const tree = emitTree(contract.routes, "", collector);
+	const tree = emitTree(contract.routes, "", collector, namespaceName);
 	const api = [...collector.all().map((model) => {
 		return `${model.description ? `/**\n * ${model.description}\n */\n` : ""}export type ${model.name} = ${model.body};`;
 	}), ...tree.declarations].join("\n\n");
@@ -390,7 +406,7 @@ ${[
  */
 import { createGeneratedClient, type ClientConfig, type ClientMethod, type GeneratedRoutes } from '${runtimeModule}';
 
-export namespace API {
+export namespace ${namespaceName} {
 ${indent(api)}
 }
 

package/dist/server.d.cts

@@ -5,6 +5,13 @@ import { ApiDefinition, ClientTarget } from "kizunajs";
  * What a generated client is called and where its runtime comes from.
  */
 interface FetchClientOptions {
+  /**
+   * Name of the generated namespace holding every model and every route's
+   * `Params`, `Query`, `Body`, `Headers` and `Result`.
+   *
+   * @default 'API'
+   */
+  namespace?: string;
   /**
    * Module the generated file imports its runtime from.
    *

package/dist/server.d.mts

@@ -5,6 +5,13 @@ import { ApiDefinition, ClientTarget } from "kizunajs";
  * What a generated client is called and where its runtime comes from.
  */
 interface FetchClientOptions {
+  /**
+   * Name of the generated namespace holding every model and every route's
+   * `Params`, `Query`, `Body`, `Headers` and `Result`.
+   *
+   * @default 'API'
+   */
+  namespace?: string;
   /**
    * Module the generated file imports its runtime from.
    *

package/dist/server.mjs

@@ -26,6 +26,15 @@ var TypeCollector = class {
 	}
 };
 const quote = (value) => JSON.stringify(value);
+/**
+* A literal as the type the JSON carries, so `z.literal(true)` is `true`.
+*/
+const literalType = (value) => {
+	if (typeof value === "string") return quote(value);
+	if (typeof value === "bigint") return `${value}n`;
+	if (value === void 0) return "undefined";
+	return String(value);
+};
 const indent$1 = (text, depth = 1) => text.split("\n").map((line) => line.length > 0 ? "    ".repeat(depth) + line : line).join("\n");
 /**
 * A property name, quoted only when it is not a plain identifier.
@@ -164,14 +173,21 @@ const typeOf = (schema, collector, hint) => {
 		return side ? typeOf(side, collector, hint) : "unknown";
 	}
 	const modelName = readMetaId(schema);
-	if (modelName !== void 0 && def.type === "object") {
+	if (modelName !== void 0) {
 		if (collector.claim(modelName)) collector.add({
 			name: modelName,
 			description: readMetaDescription(schema),
-			body: objectBody(schema, collector, modelName)
+			body: structuralType(schema, collector, modelName)
 		});
 		return modelName;
 	}
+	return structuralType(schema, collector, hint);
+};
+/**
+* The type a schema describes by its shape, its name already spent by the caller.
+*/
+const structuralType = (schema, collector, hint) => {
+	const def = readDef(schema);
 	switch (def.type) {
 		case "string": return "string";
 		case "number":
@@ -187,11 +203,11 @@ const typeOf = (schema, collector, hint) => {
 		case "undefined": return "undefined";
 		case "literal": {
 			const values = def.values ?? [];
-			return values.length > 0 ? values.map((value) => quote(String(value))).join(" | ") : "never";
+			return values.length > 0 ? values.map(literalType).join(" | ") : "never";
 		}
 		case "enum": {
 			const values = Object.values(def.entries ?? {});
-			return values.length > 0 ? values.map((value) => quote(String(value))).join(" | ") : "never";
+			return values.length > 0 ? values.map(literalType).join(" | ") : "never";
 		}
 		case "array": return def.element ? `Array<${typeOf(def.element, collector, `${hint}Item`)}>` : "unknown[]";
 		case "object": return objectBody(schema, collector, hint);
@@ -274,7 +290,7 @@ const routeDoc = (routeKey, route) => {
 	lines.push("@example", exampleCall(routeKey, route));
 	return docComment(lines);
 };
-const emitRoute = (routeKey, key, route, collector) => {
+const emitRoute = (routeKey, key, route, collector, namespaceName) => {
 	const namespace = routeKey.split(".").map(toPascalCase).join("");
 	const members = [];
 	const args = [];
@@ -282,19 +298,19 @@ const emitRoute = (routeKey, key, route, collector) => {
 	if (params.length > 0) {
 		const body = route.pathParams ? typeOf(route.pathParams, collector, `${namespace}Params`) : `{\n${indent(params.map((name) => `${name}: string;`).join("\n"))}\n}`;
 		members.push(`export type Params = ${body};`);
-		args.push(`params: API.${namespace}.Params`);
+		args.push(`params: ${namespaceName}.${namespace}.Params`);
 	}
 	if (route.query) {
 		members.push(`export type Query = ${typeOf(route.query, collector, `${namespace}Query`)};`);
-		args.push(`query?: API.${namespace}.Query`);
+		args.push(`query?: ${namespaceName}.${namespace}.Query`);
 	}
 	if (route.body && !isVoidSchema(route.body)) {
 		members.push(`export type Body = ${typeOf(route.body, collector, `${namespace}Body`)};`);
-		args.push(`body: API.${namespace}.Body`);
+		args.push(`body: ${namespaceName}.${namespace}.Body`);
 	}
 	if (route.headers) {
 		members.push(`export type Headers = ${typeOf(route.headers, collector, `${namespace}Headers`)};`);
-		args.push(`headers?: API.${namespace}.Headers`);
+		args.push(`headers?: ${namespaceName}.${namespace}.Headers`);
 	} else args.push("headers?: Record<string, string>");
 	args.push("fetchOptions?: RequestInit");
 	const validates = route.body !== void 0 || route.query !== void 0;
@@ -318,13 +334,13 @@ const emitRoute = (routeKey, key, route, collector) => {
 	const streams = Object.values(route.responses).some((response) => isStreamResponse(response));
 	return {
 		namespace,
-		signature: `${routeDoc(routeKey, route)}${key}: ClientMethod<'${route.method}', ${streams}, ${argsType}, API.${namespace}.Result>;`,
+		signature: `${routeDoc(routeKey, route)}${key}: ClientMethod<'${route.method}', ${streams}, ${argsType}, ${namespaceName}.${namespace}.Result>;`,
 		declaration: `export namespace ${namespace} {\n${indent(members.join("\n\n"))}\n}`,
 		table: `${key}: {\n${indent(tableEntries.map((entry) => `${entry},`).join("\n"))}\n},`
 	};
 };
 const isRoute = (value) => !!value && typeof value === "object" && typeof value.method === "string";
-const emitTree = (routes, prefix, collector) => {
+const emitTree = (routes, prefix, collector, namespaceName) => {
 	const signatures = [];
 	const tables = [];
 	const declarations = [];
@@ -332,14 +348,14 @@ const emitTree = (routes, prefix, collector) => {
 		const node = routes[key];
 		const routeKey = prefix ? `${prefix}.${key}` : key;
 		if (isRoute(node)) {
-			const emitted = emitRoute(routeKey, key, node, collector);
+			const emitted = emitRoute(routeKey, key, node, collector, namespaceName);
 			signatures.push(emitted.signature);
 			tables.push(emitted.table);
 			declarations.push(emitted.declaration);
 			continue;
 		}
 		if (node && typeof node === "object") {
-			const group = emitTree(node, routeKey, collector);
+			const group = emitTree(node, routeKey, collector, namespaceName);
 			signatures.push(`${key}: {\n${indent(group.signatures)}\n};`);
 			tables.push(`${key}: {\n${indent(group.table)}\n},`);
 			declarations.push(...group.declarations);
@@ -371,9 +387,9 @@ const emitRequestContext = (contract, collector) => {
 	return fields.length > 0 ? `export interface RequestContext {\n${indent(fields.join("\n"))}\n}` : void 0;
 };
 const generateFetchClient = (contract, options = {}) => {
-	const { runtimeModule = "@kizunajs/fetch", regenerateCommand = "kizuna generate", source } = options;
+	const { namespace: namespaceName = "API", runtimeModule = "@kizunajs/fetch", regenerateCommand = "kizuna generate", source } = options;
 	const collector = new TypeCollector();
-	const tree = emitTree(contract.routes, "", collector);
+	const tree = emitTree(contract.routes, "", collector, namespaceName);
 	const api = [...collector.all().map((model) => {
 		return `${model.description ? `/**\n * ${model.description}\n */\n` : ""}export type ${model.name} = ${model.body};`;
 	}), ...tree.declarations].join("\n\n");
@@ -389,7 +405,7 @@ ${[
  */
 import { createGeneratedClient, type ClientConfig, type ClientMethod, type GeneratedRoutes } from '${runtimeModule}';
 
-export namespace API {
+export namespace ${namespaceName} {
 ${indent(api)}
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kizunajs/fetch",
-  "version": "2.0.0-beta.3",
+  "version": "2.0.0-beta.5",
   "description": "Typed fetch client for Kizuna.js APIs",
   "keywords": [
     "kizunajs",
@@ -68,7 +68,7 @@
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "kizunajs": "2.0.0-beta.3"
+    "kizunajs": "2.0.0-beta.5"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",
@@ -76,8 +76,8 @@
     "tsdown": "^0.21.0",
     "typescript": "^6.0.3",
     "zod": "^4.0.0",
-    "kizunajs": "2.0.0-beta.3",
-    "@kizunajs/express": "2.0.0-beta.3"
+    "kizunajs": "2.0.0-beta.5",
+    "@kizunajs/express": "2.0.0-beta.5"
   },
   "scripts": {
     "build": "tsdown src/index.ts src/server.ts --format esm,cjs --dts --clean --external kizunajs --external zod",