c8y-nitro 0.9.1 → 0.10.0

package/dist/apiClient-kxv5KHYJ.mjs

@@ -0,0 +1,206 @@
+import { n as createC8yManifestFromNitro } from "./manifest-DV3UW9Dl.mjs";
+import { dirname, join, relative } from "node:path";
+import { mkdir, writeFile } from "node:fs/promises";
+//#region src/module/apiClient.ts
+/**
+* Converts route path to PascalCase function name.
+* Examples:
+* - /health + get -> GetHealth
+* - /health + post -> PostHealth
+* - /someRoute -> SomeRoute (default)
+* - /[id] or /:id + get -> GetById
+* - /api/[multiple]/[params] -> GetApiByMultipleByParams
+* @param path - The route path (e.g., "/api/[id]" or "/api/:id")
+* @param method - HTTP method (get, post, put, delete, etc.)
+*/
+function generateFunctionName(path, method) {
+	return `${method}${path.replace(/^\//, "").replaceAll(".", "_").replaceAll("*", "").split("/").map((seg) => {
+		if (seg.startsWith("[") && seg.endsWith("]")) return `By${capitalize(seg.slice(1, -1))}`;
+		if (seg.startsWith(":")) return `By${capitalize(seg.slice(1))}`;
+		return capitalize(seg);
+	}).join("") || "Index"}`;
+}
+/**
+* Extracts route parameters from path.
+* Example: "/api/[id]/items/[itemId]" or "/api/:id/items/:itemId" -> [{name: "id", type: "string"}, {name: "itemId", type: "string"}]
+* @param path - The route path to extract parameters from
+*/
+function extractParams(path) {
+	const params = [];
+	const segments = path.split("/");
+	for (const seg of segments) if (seg.startsWith("[") && seg.endsWith("]")) {
+		const name = seg.slice(1, -1);
+		params.push(name);
+	} else if (seg.startsWith(":")) {
+		const name = seg.slice(1);
+		params.push(name);
+	}
+	return params;
+}
+/**
+* Capitalizes first letter of a string.
+* @param str - The string to capitalize
+*/
+function capitalize(str) {
+	return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+* Converts a file name to a valid JavaScript class name.
+* Only allows letters, numbers (not at start), $ and _.
+* Removes or replaces invalid characters and ensures PascalCase.
+* Always prefixed with "Generated" for clarity.
+* @param fileName - The file name to convert
+* @example "my-service-api" -> "GeneratedMyServiceApi"
+* @example "playgroundAPIClient" -> "GeneratedPlaygroundAPIClient"
+* @example "special@chars!" -> "GeneratedSpecialchars"
+*/
+function toValidClassName(fileName) {
+	let cleaned = fileName.replace(/\.(ts|js|mjs|cjs|tsx|jsx)$/, "").replace(/[-_.]/g, " ");
+	cleaned = cleaned.replace(/[^a-zA-Z0-9\s$]/g, "");
+	return `Generated${cleaned.split(/\s+/).filter((word) => word.length > 0).map((word) => capitalize(word)).join("")}`;
+}
+/**
+* Generates TypeScript method code for a route in an Angular service.
+* @param route - Parsed route information including path, method, params, and return type
+*/
+function generateMethod(route) {
+	const hasParams = route.params.length > 0;
+	let inlineParamsType = "";
+	if (hasParams) inlineParamsType = `{ ${route.params.map((name) => `${name}: string | number`).join("; ")} }`;
+	const methodParam = hasParams ? `params: ${inlineParamsType}` : "";
+	const returnTypeAnnotation = `Promise<${route.returnType}>`;
+	let pathExpression = `\`\${this.BASE_PATH}${route.path}\``;
+	if (hasParams) pathExpression = `\`\${this.BASE_PATH}${route.path.replace(/\[([^\]]+)\]/g, (_, paramName) => `\${params.${paramName}}`)}\``;
+	const fetchOptions = `{ method: '${route.method}', headers: { 'Content-Type': 'application/json' } }`;
+	return `  async ${route.functionName}(${methodParam}): ${returnTypeAnnotation} {
+    const response = await this.fetchClient.fetch(${pathExpression}, ${fetchOptions});
+    return this.serialize(response);
+  }`;
+}
+/**
+* Helper types for proper type serialization from Nitro.
+* https://github.com/nitrojs/nitro/blob/67b43f2692a41728a2759462b6982c6872ed3a81/src/types/fetch/_serialize.ts
+*/
+const serializationTypes = `type JsonPrimitive = string | number | boolean | string | number | boolean | null;
+type NonJsonPrimitive = undefined | Function | symbol;
+type IsAny<T> = 0 extends 1 & T ? true : false;
+type FilterKeys<TObj extends object, TFilter> = { [TKey in keyof TObj]: TObj[TKey] extends TFilter ? TKey : never }[keyof TObj];
+type Serialize<T> = IsAny<T> extends true ? any : T extends JsonPrimitive | undefined ? T : T extends Map<any, any> | Set<any> ? Record<string, never> : T extends NonJsonPrimitive ? never : T extends {
+  toJSON: () => infer U;
+} ? U : T extends [] ? [] : T extends [unknown, ...unknown[]] ? SerializeTuple<T> : T extends ReadonlyArray<infer U> ? (U extends NonJsonPrimitive ? null : Serialize<U>)[] : T extends object ? SerializeObject<T> : never;
+type SerializeTuple<T extends [unknown, ...unknown[]]> = { [k in keyof T]: T[k] extends NonJsonPrimitive ? null : Serialize<T[k]> };
+type SerializeObject<T extends object> = { [k in keyof Omit<T, FilterKeys<T, NonJsonPrimitive>>]: Serialize<T[k]> };
+type Simplify<TType> = TType extends any[] | Date ? TType : { [K in keyof TType]: Simplify<TType[K]> };
+type Awaited<T> = T extends PromiseLike<infer U> ? Awaited<U> : T;
+type C8ySerialize<T> = T extends void | undefined | null ? undefined : T extends string ? string : Simplify<Serialize<T>>;
+`;
+/**
+* Generates complete Angular API client service.
+* @param routes - Array of parsed routes to generate methods for
+* @param contextPath - The microservice context path (e.g., "my-service")
+* @param className - The class name for the generated service (e.g., "PlaygroundAPIClient")
+*/
+function generateAPIClient(routes, contextPath, className) {
+	const methods = routes.map((route) => generateMethod(route)).join("\n\n");
+	return `/* eslint-disable eslint-comments/no-unlimited-disable */
+/* eslint-disable */
+/**
+ * Auto-generated Cumulocity API Client
+ * Generated by c8y-nitro
+ *
+ * This Angular service provides typed methods for all Nitro routes.
+ * Each method corresponds to a route handler and returns properly typed responses.
+ */
+import { Injectable, inject } from '@angular/core'
+import { FetchClient } from '@c8y/client'
+
+// Type helpers for proper serialization
+${serializationTypes}
+
+@Injectable({ providedIn: 'root' })
+export class ${className} {
+  private readonly BASE_PATH = '/service/${contextPath}';
+  private readonly fetchClient: FetchClient = inject(FetchClient)
+
+  /**
+   * Serializes the response based on content type and body.
+   * - Empty body (null, undefined, void) -> undefined
+   * - text/plain (string) -> raw text
+   * - application/json (number, boolean, object, array) -> JSON parsed
+   */
+  private async serialize(response: Response): Promise<any> {
+    const contentType = response.headers.get('content-type');
+    const text = await response.text();
+    
+    // Handle empty responses (null, undefined, empty return)
+    if (!text || text.length === 0) {
+      return undefined;
+    }
+    
+    // Handle plain text responses (strings)
+    if (contentType?.includes('text/plain')) {
+      return text;
+    }
+    
+    // Handle JSON responses (numbers, booleans, objects, arrays)
+    return JSON.parse(text);
+  }
+
+${methods}
+}`;
+}
+/**
+* Generates the TypeScript return type for a route handler.
+* @param handlerPath - Absolute path to the route handler file
+* @param outputFile - Absolute path to the output API client file
+* @returns TypeScript return type string with proper serialization wrappers
+*/
+function getReturnType(handlerPath, outputFile) {
+	const relativeHandlerPath = relative(dirname(outputFile), handlerPath);
+	return `C8ySerialize<Awaited<ReturnType<typeof import('${(relativeHandlerPath.startsWith(".") ? relativeHandlerPath : `./${relativeHandlerPath}`).replace(/\.ts$/, "")}').default>>>`;
+}
+/**
+* Writes the generated API client to disk.
+* @param nitro - Nitro instance
+* @param options - Complete module options including apiClient and manifest
+*/
+async function writeAPIClient(nitro, options) {
+	const { apiClient: apiClientOptions } = options;
+	if (!apiClientOptions) {
+		nitro.logger.debug("API client generation skipped: no apiClient options provided");
+		return;
+	}
+	const manifest = await createC8yManifestFromNitro(nitro);
+	const serviceName = manifest.name;
+	const serviceContextPath = apiClientOptions.contextPath ?? manifest.contextPath ?? serviceName;
+	const name = `${serviceName}APIClient`;
+	const rootDir = nitro.options.rootDir;
+	const outputDir = join(rootDir, apiClientOptions.dir);
+	const outputFile = join(outputDir, `${name}.ts`);
+	const routes = (nitro.routing.routes._routes ?? []).filter((route) => {
+		return !route.handler.includes("nitro/dist/runtime/internal");
+	}).map((route) => {
+		const path = route.route;
+		const method = (!route.method ? "GET" : route.method).toUpperCase();
+		const params = extractParams(path);
+		const functionName = generateFunctionName(path, method);
+		const returnType = getReturnType(route.handler, outputFile);
+		return {
+			path: path.replace(/:([^/]+)/g, "[$1]"),
+			method,
+			functionName,
+			params,
+			returnType
+		};
+	});
+	if (routes.length === 0) {
+		nitro.logger.warn("No routes found to generate API client");
+		return;
+	}
+	const code = generateAPIClient(routes, serviceContextPath, toValidClassName(name));
+	await mkdir(outputDir, { recursive: true });
+	await writeFile(outputFile, code, "utf-8");
+	nitro.logger.success(`Generated API client with ${routes.length} routes at: ${relative(rootDir, outputFile)}`);
+}
+//#endregion
+export { writeAPIClient as t };

package/dist/{autoBootstrap-qCcCgset.mjs → autoBootstrap-DUjHuHe_.mjs}

@@ -1,4 +1,5 @@
-import { a as findMicroserviceByName, d as updateMicroservice, l as subscribeToApplication, n as createBasicAuthHeader, o as getBootstrapCredentials, p as createC8yManifest, r as createMicroservice } from "./c8y-api-DpCWhaJU.mjs";
+import { t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
+import { a as findMicroserviceByName, d as updateMicroservice, l as subscribeToApplication, n as createBasicAuthHeader, o as getBootstrapCredentials, r as createMicroservice } from "./c8y-api-DSs1xIIh.mjs";
 import { t as writeBootstrapCredentials } from "./env-file-BrOTmVjA.mjs";
 import { join } from "node:path";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
@@ -55,7 +56,8 @@ async function readManifestCache(rootDir) {
 * @param state - The state to persist (schema version is filled in automatically)
 */
 async function writeManifestCache(rootDir, state) {
-	await mkdir(getCacheDir(rootDir), { recursive: true });
+	const dir = getCacheDir(rootDir);
+	await mkdir(dir, { recursive: true });
 	const payload = {
 		schemaVersion: CACHE_SCHEMA_VERSION,
 		...state
@@ -138,10 +140,12 @@ async function syncBootstrappedMicroservice(options) {
 	const appId = existingApp.id;
 	const isRealService = Boolean(existingApp.activeVersionId);
 	const cache = await readManifestCache(rootDir);
-	if (!cache || cache.manifestHash !== currentHash || cache.appId !== appId) if (isRealService) logger.warn(`Local manifest for "${manifest.name}" differs from the deployed microservice on the development tenant. The running service was left untouched. Redeploy or run \`npx c8y-nitro bootstrap\` to update it explicitly.`);
-	else {
-		await updateMicroservice(baseUrl, appId, manifest, authHeader);
-		logger.success(`Updated microservice "${manifest.name}" with changed manifest.`);
+	if (!cache || cache.manifestHash !== currentHash || cache.appId !== appId) {
+		if (isRealService) logger.warn(`Local manifest for "${manifest.name}" differs from the deployed microservice on the development tenant. The running service was left untouched. Redeploy or run \`npx c8y-nitro bootstrap\` to update it explicitly.`);
+		else {
+			await updateMicroservice(baseUrl, appId, manifest, authHeader);
+			logger.success(`Updated microservice "${manifest.name}" with changed manifest.`);
+		}
 	}
 	const hasBootstrapCreds = BOOTSTRAP_ENV_VARS.every((v) => env[v]);
 	const appChanged = cache?.appId !== appId;

package/dist/{bootstrap-BcTCUiqG.mjs → bootstrap-DrMjty-k.mjs}

@@ -1,4 +1,5 @@
-import { a as findMicroserviceByName, d as updateMicroservice, l as subscribeToApplication, n as createBasicAuthHeader, o as getBootstrapCredentials, p as createC8yManifest, r as createMicroservice } from "./c8y-api-DpCWhaJU.mjs";
+import { t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
+import { a as findMicroserviceByName, d as updateMicroservice, l as subscribeToApplication, n as createBasicAuthHeader, o as getBootstrapCredentials, r as createMicroservice } from "./c8y-api-DSs1xIIh.mjs";
 import { t as writeBootstrapCredentials } from "./env-file-BrOTmVjA.mjs";
 import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-BVQHqlgV.mjs";
 import { defineCommand, runCommand } from "citty";
@@ -52,7 +53,10 @@ var bootstrap_default = defineCommand({
 		});
 		consola.success(`Bootstrap credentials written to ${envFileName}`);
 		if (manifest.roles && manifest.roles.length > 0) {
-			if (await consola.prompt("Do you want to manage microservice roles for your development user?", { type: "confirm" })) await runCommand(await import("./roles-CkUvL64s.mjs").then((r) => r.default), { rawArgs: [] });
+			if (await consola.prompt("Do you want to manage microservice roles for your development user?", { type: "confirm" })) {
+				const rolesCommand = await import("./roles-CNCObfa3.mjs").then((r) => r.default);
+				await runCommand(rolesCommand, { rawArgs: [] });
+			}
 		}
 		consola.success("Bootstrap complete!");
 	}

package/dist/{c8y-api-DpCWhaJU.mjs → c8y-api-DSs1xIIh.mjs}

@@ -1,128 +1,4 @@
-import { readPackage } from "pkg-types";
 import { Buffer } from "node:buffer";
-//#region src/module/constants.ts
-const GENERATED_LIVENESS_ROUTE = "/_c8y_nitro/liveness";
-const GENERATED_READINESS_ROUTE = "/_c8y_nitro/readiness";
-const GENERATED_INVALIDATE_TENANT_OPTIONS_ROUTE = "/_c8y_nitro/invalidate-tenant-options";
-//#endregion
-//#region src/module/manifest.ts
-const DEFAULT_OPENAPI_ROUTE = "/_openapi.json";
-const ROLE_OPTION_MANAGEMENT_READ = "ROLE_OPTION_MANAGEMENT_READ";
-/**
-* Cumulocity microservice name constraints: lowercase letters, digits and
-* hyphens only, 1-23 characters. Enforced by the platform on upload, so we
-* fail early with a clear message instead of a cryptic API rejection.
-* @see https://github.com/schplitt/c8y-nitro/issues/75
-*/
-const MICROSERVICE_NAME_REGEX = /^[a-z0-9-]{1,23}$/;
-/**
-* Decide whether Nitro will expose an OpenAPI spec in the deployed build,
-* and if so return the configured route (with leading slash).
-* Returns null when OpenAPI is not enabled for production.
-* @param config - Nitro config (or options) to inspect
-*/
-function resolveNitroOpenApiRoute(config) {
-	if (!config.experimental?.openAPI) return null;
-	if (!config.openAPI?.production) return null;
-	return config.openAPI?.route || DEFAULT_OPENAPI_ROUTE;
-}
-/**
-* Pull the parts of a Nitro config that feed manifest generation.
-* @param config - Nitro config (or options) loaded from disk or from a Nitro instance
-*/
-function extractManifestInputs(config) {
-	return {
-		options: config.c8y?.manifest ?? {},
-		openApiSpec: resolveNitroOpenApiRoute(config) ?? void 0
-	};
-}
-function validateManifestSettings(options) {
-	const invalidSettings = options.settings?.filter((setting) => typeof setting.defaultValue !== "string" || setting.defaultValue.length === 0) ?? [];
-	if (invalidSettings.length === 0) return;
-	const invalidKeys = invalidSettings.map((setting) => `"${setting.key}"`).join(", ");
-	throw new Error(`manifest.settings entries must define a non-empty defaultValue. Invalid keys: ${invalidKeys}`);
-}
-async function readPackageJsonFieldsForManifest(rootDir, logger) {
-	logger?.debug(`Reading package file from ${rootDir}`);
-	const pkg = await readPackage(rootDir);
-	const name = pkg.name?.replace(/^@[^/]+\//, "");
-	const version = pkg.version;
-	const author = pkg.author;
-	const authorName = typeof author === "string" ? author : author?.name;
-	const authorEmail = typeof author === "string" ? void 0 : author?.email;
-	const authorUrl = typeof author === "string" ? void 0 : author?.url;
-	if (!name || !version || !authorName) throw new Error("package.json must contain name, version, and author name fields");
-	if (!MICROSERVICE_NAME_REGEX.test(name)) throw new Error(`Invalid microservice name "${name}". Cumulocity requires the name to match ${MICROSERVICE_NAME_REGEX.source} (lowercase letters, digits and hyphens only, 1-23 characters). Adjust the "name" field in package.json accordingly (scope like "@org/" is stripped and does not count).`);
-	const support = typeof pkg.bugs === "string" ? pkg.bugs : pkg.bugs?.url ?? pkg.bugs?.email;
-	const provider = {
-		name: authorName ?? name,
-		domain: authorUrl ?? pkg.homepage,
-		support: support ?? authorEmail
-	};
-	logger?.debug(`Found package.json fields for manifest: name=${name}, version=${version}, provider=${JSON.stringify(provider)}`);
-	return {
-		name,
-		version,
-		provider,
-		contextPath: name
-	};
-}
-/**
-* Create a Cumulocity manifest from a project root and its Nitro config.
-* Reads `package.json` for identity fields, takes user manifest options from
-* `nitroConfig.c8y.manifest`, and auto-injects `openApiSpec` when Nitro
-* OpenAPI is enabled for production.
-*
-* Used by both the Nitro module and the CLI commands.
-* @param rootDir - Directory containing the project's `package.json`
-* @param nitroConfig - Nitro config (or options) for this project
-* @param logger - Optional logger for debug output
-*/
-async function createC8yManifest(rootDir, nitroConfig = {}, logger) {
-	const { options, openApiSpec } = extractManifestInputs(nitroConfig);
-	validateManifestSettings(options);
-	const { name, version, provider, ...restManifestFields } = await readPackageJsonFieldsForManifest(rootDir, logger);
-	const probeFields = {};
-	if (!options.livenessProbe?.httpGet) probeFields.livenessProbe = {
-		...options.livenessProbe,
-		httpGet: { path: GENERATED_LIVENESS_ROUTE }
-	};
-	if (!options.readinessProbe?.httpGet) probeFields.readinessProbe = {
-		...options.readinessProbe,
-		httpGet: { path: GENERATED_READINESS_ROUTE }
-	};
-	const key = `${name}-key`;
-	let requiredRoles = options.requiredRoles ? [...options.requiredRoles] : void 0;
-	if (options.settings && options.settings.length > 0 && !requiredRoles?.includes(ROLE_OPTION_MANAGEMENT_READ)) {
-		requiredRoles = [...requiredRoles ?? [], ROLE_OPTION_MANAGEMENT_READ];
-		logger?.debug(`Auto-added ${ROLE_OPTION_MANAGEMENT_READ} to requiredRoles because manifest.settings are defined`);
-	}
-	const manifest = {
-		...restManifestFields,
-		...probeFields,
-		...options,
-		...requiredRoles !== void 0 ? { requiredRoles } : {},
-		...openApiSpec ? { openApiSpec } : {},
-		provider,
-		name,
-		version,
-		apiVersion: "v2",
-		key,
-		type: "MICROSERVICE"
-	};
-	if (openApiSpec) logger?.debug(`Auto-added openApiSpec="${openApiSpec}" to manifest (Nitro OpenAPI is enabled)`);
-	logger?.debug(`Created Cumulocity manifest: ${JSON.stringify(manifest, null, 2)}`);
-	return manifest;
-}
-/**
-* Creates a Cumulocity manifest from a Nitro instance.
-* Convenience wrapper for use in the Nitro module.
-* @param nitro - The Nitro instance
-*/
-async function createC8yManifestFromNitro(nitro) {
-	return createC8yManifest(nitro.options.rootDir, nitro.options, nitro.logger);
-}
-//#endregion
 //#region src/cli/utils/c8y-api.ts
 /**
 * Creates a Basic Auth header for Cumulocity API requests.
@@ -432,4 +308,4 @@ async function deleteTenantOption(baseUrl, category, key, authHeader) {
 	}
 }
 //#endregion
-export { GENERATED_READINESS_ROUTE as _, findMicroserviceByName as a, getTenantOptionsByCategory as c, updateMicroservice as d, upsertTenantOption as f, GENERATED_LIVENESS_ROUTE as g, GENERATED_INVALIDATE_TENANT_OPTIONS_ROUTE as h, deleteTenantOption as i, subscribeToApplication as l, createC8yManifestFromNitro as m, createBasicAuthHeader as n, getBootstrapCredentials as o, createC8yManifest as p, createMicroservice as r, getCurrentApplicationSettings as s, assignUserRole as t, unassignUserRole as u };
+export { findMicroserviceByName as a, getTenantOptionsByCategory as c, updateMicroservice as d, upsertTenantOption as f, deleteTenantOption as i, subscribeToApplication as l, createBasicAuthHeader as n, getBootstrapCredentials as o, createMicroservice as r, getCurrentApplicationSettings as s, assignUserRole as t, unassignUserRole as u };

package/dist/cli/index.d.mts

@@ -1 +1 @@
-export { };
+export {}

package/dist/cli/index.mjs

@@ -1,17 +1,19 @@
-import { n as name, r as version, t as description } from "../package-CUuWGZoQ.mjs";
+import { n as name, r as version, t as description } from "../package-CX0mgzB-.mjs";
 import { defineCommand, runMain } from "citty";
 //#region src/cli/index.ts
-runMain(defineCommand({
+const main = defineCommand({
 	meta: {
 		name,
 		version,
 		description
 	},
 	subCommands: {
-		bootstrap: () => import("../bootstrap-BcTCUiqG.mjs").then((r) => r.default),
-		roles: () => import("../roles-CkUvL64s.mjs").then((r) => r.default),
-		options: () => import("../options-BBnR-y_W.mjs").then((r) => r.default)
+		bootstrap: () => import("../bootstrap-DrMjty-k.mjs").then((r) => r.default),
+		roles: () => import("../roles-CNCObfa3.mjs").then((r) => r.default),
+		options: () => import("../options-54uJmuUV.mjs").then((r) => r.default),
+		typegen: () => import("../typegen-BO_AkyNc.mjs").then((r) => r.default)
 	}
-}));
+});
+runMain(main);
 //#endregion
 export {};

package/dist/{client-DCov9jV6.mjs → client-BjA5bBxj.mjs}

@@ -262,7 +262,9 @@ const useDeployedTenantCredentials = Object.assign(async () => {
 function useUserClient(requestOrEvent) {
 	const request = "req" in requestOrEvent ? requestOrEvent.req : requestOrEvent;
 	if (request.context?.["c8y_user_client"]) return request.context["c8y_user_client"];
-	const client = new Client(new MicroserviceClientRequestAuth(convertRequestHeadersToC8yFormat(request)), process.env.C8Y_BASEURL);
+	const headers = convertRequestHeadersToC8yFormat(request);
+	const auth = new MicroserviceClientRequestAuth(headers);
+	const client = new Client(auth, process.env.C8Y_BASEURL);
 	request.context ??= {};
 	request.context["c8y_user_client"] = client;
 	return client;

package/dist/{index-Dil1PcDr.d.mts → index-DHd7xpBX.d.mts}

@@ -414,6 +414,18 @@ interface C8yCacheOptions {
 //#endregion
 //#region src/types/docker.d.ts
 interface C8yDockerOptions {
+  /**
+   * Path to a custom Dockerfile, relative to the Nitro config file location
+   * (`rootDir`).
+   *
+   * When set, the built-in Dockerfile template is **not** generated. The file
+   * at this path is copied into the build context and used as-is for the Docker
+   * build. The `baseImage` and `extraInstructions` options are ignored when a
+   * custom Dockerfile is provided.
+   *
+   * @example 'docker/Dockerfile'
+   */
+  dockerfile?: string;
   /**
    * Base image for the generated Dockerfile.
    *

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { n as C8yNitroModuleOptions } from "./index-Dil1PcDr.mjs";
+import { n as C8yNitroModuleOptions } from "./index-DHd7xpBX.mjs";
 import { t as TenantCredentials } from "./credentials-eKnJ7m9Y.mjs";
 import { NitroModule } from "nitro/types";
 //#region src/index.d.ts

package/dist/index.mjs

@@ -1,8 +1,9 @@
-import { _ as GENERATED_READINESS_ROUTE, g as GENERATED_LIVENESS_ROUTE, h as GENERATED_INVALIDATE_TENANT_OPTIONS_ROUTE, m as createC8yManifestFromNitro, p as createC8yManifest } from "./c8y-api-DpCWhaJU.mjs";
-import { t as autoBootstrap } from "./autoBootstrap-qCcCgset.mjs";
-import { n as name } from "./package-CUuWGZoQ.mjs";
-import { basename, dirname, join, relative } from "node:path";
-import { mkdir, writeFile } from "node:fs/promises";
+import { a as GENERATED_INVALIDATE_TENANT_OPTIONS_ROUTE, i as C8Y_NITRO_TYPES_FILE, n as createC8yManifestFromNitro, o as GENERATED_LIVENESS_ROUTE, r as C8Y_NITRO_TYPES_DIR, s as GENERATED_READINESS_ROUTE, t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
+import { t as writeAPIClient } from "./apiClient-kxv5KHYJ.mjs";
+import { t as autoBootstrap } from "./autoBootstrap-DUjHuHe_.mjs";
+import { n as name } from "./package-CX0mgzB-.mjs";
+import { basename, join, resolve } from "node:path";
+import { copyFile, mkdir, writeFile } from "node:fs/promises";
 import { x } from "tinyexec";
 import { join as join$1 } from "pathe";
 import { mkdir as mkdir$1, readFile as readFile$1, stat, writeFile as writeFile$1 } from "fs/promises";
@@ -14,208 +15,6 @@ import { isValidRealtimeName, toRealtimeName } from "c8y-realtime";
 import { createHash } from "node:crypto";
 import { fileURLToPath } from "node:url";
 import evlog from "evlog/nitro/v3";
-//#region src/module/apiClient.ts
-/**
-* Converts route path to PascalCase function name.
-* Examples:
-* - /health + get -> GetHealth
-* - /health + post -> PostHealth
-* - /someRoute -> SomeRoute (default)
-* - /[id] or /:id + get -> GetById
-* - /api/[multiple]/[params] -> GetApiByMultipleByParams
-* @param path - The route path (e.g., "/api/[id]" or "/api/:id")
-* @param method - HTTP method (get, post, put, delete, etc.)
-*/
-function generateFunctionName(path, method) {
-	return `${method}${path.replace(/^\//, "").replaceAll(".", "_").replaceAll("*", "").split("/").map((seg) => {
-		if (seg.startsWith("[") && seg.endsWith("]")) return `By${capitalize(seg.slice(1, -1))}`;
-		if (seg.startsWith(":")) return `By${capitalize(seg.slice(1))}`;
-		return capitalize(seg);
-	}).join("") || "Index"}`;
-}
-/**
-* Extracts route parameters from path.
-* Example: "/api/[id]/items/[itemId]" or "/api/:id/items/:itemId" -> [{name: "id", type: "string"}, {name: "itemId", type: "string"}]
-* @param path - The route path to extract parameters from
-*/
-function extractParams(path) {
-	const params = [];
-	const segments = path.split("/");
-	for (const seg of segments) if (seg.startsWith("[") && seg.endsWith("]")) {
-		const name = seg.slice(1, -1);
-		params.push(name);
-	} else if (seg.startsWith(":")) {
-		const name = seg.slice(1);
-		params.push(name);
-	}
-	return params;
-}
-/**
-* Capitalizes first letter of a string.
-* @param str - The string to capitalize
-*/
-function capitalize(str) {
-	return str.charAt(0).toUpperCase() + str.slice(1);
-}
-/**
-* Converts a file name to a valid JavaScript class name.
-* Only allows letters, numbers (not at start), $ and _.
-* Removes or replaces invalid characters and ensures PascalCase.
-* Always prefixed with "Generated" for clarity.
-* @param fileName - The file name to convert
-* @example "my-service-api" -> "GeneratedMyServiceApi"
-* @example "playgroundAPIClient" -> "GeneratedPlaygroundAPIClient"
-* @example "special@chars!" -> "GeneratedSpecialchars"
-*/
-function toValidClassName(fileName) {
-	let cleaned = fileName.replace(/\.(ts|js|mjs|cjs|tsx|jsx)$/, "").replace(/[-_.]/g, " ");
-	cleaned = cleaned.replace(/[^a-zA-Z0-9\s$]/g, "");
-	return `Generated${cleaned.split(/\s+/).filter((word) => word.length > 0).map((word) => capitalize(word)).join("")}`;
-}
-/**
-* Generates TypeScript method code for a route in an Angular service.
-* @param route - Parsed route information including path, method, params, and return type
-*/
-function generateMethod(route) {
-	const hasParams = route.params.length > 0;
-	let inlineParamsType = "";
-	if (hasParams) inlineParamsType = `{ ${route.params.map((name) => `${name}: string | number`).join("; ")} }`;
-	const methodParam = hasParams ? `params: ${inlineParamsType}` : "";
-	const returnTypeAnnotation = `Promise<${route.returnType}>`;
-	let pathExpression = `\`\${this.BASE_PATH}${route.path}\``;
-	if (hasParams) pathExpression = `\`\${this.BASE_PATH}${route.path.replace(/\[([^\]]+)\]/g, (_, paramName) => `\${params.${paramName}}`)}\``;
-	const fetchOptions = `{ method: '${route.method}', headers: { 'Content-Type': 'application/json' } }`;
-	return `  async ${route.functionName}(${methodParam}): ${returnTypeAnnotation} {
-    const response = await this.fetchClient.fetch(${pathExpression}, ${fetchOptions});
-    return this.serialize(response);
-  }`;
-}
-/**
-* Helper types for proper type serialization from Nitro.
-* https://github.com/nitrojs/nitro/blob/67b43f2692a41728a2759462b6982c6872ed3a81/src/types/fetch/_serialize.ts
-*/
-const serializationTypes = `type JsonPrimitive = string | number | boolean | string | number | boolean | null;
-type NonJsonPrimitive = undefined | Function | symbol;
-type IsAny<T> = 0 extends 1 & T ? true : false;
-type FilterKeys<TObj extends object, TFilter> = { [TKey in keyof TObj]: TObj[TKey] extends TFilter ? TKey : never }[keyof TObj];
-type Serialize<T> = IsAny<T> extends true ? any : T extends JsonPrimitive | undefined ? T : T extends Map<any, any> | Set<any> ? Record<string, never> : T extends NonJsonPrimitive ? never : T extends {
-  toJSON: () => infer U;
-} ? U : T extends [] ? [] : T extends [unknown, ...unknown[]] ? SerializeTuple<T> : T extends ReadonlyArray<infer U> ? (U extends NonJsonPrimitive ? null : Serialize<U>)[] : T extends object ? SerializeObject<T> : never;
-type SerializeTuple<T extends [unknown, ...unknown[]]> = { [k in keyof T]: T[k] extends NonJsonPrimitive ? null : Serialize<T[k]> };
-type SerializeObject<T extends object> = { [k in keyof Omit<T, FilterKeys<T, NonJsonPrimitive>>]: Serialize<T[k]> };
-type Simplify<TType> = TType extends any[] | Date ? TType : { [K in keyof TType]: Simplify<TType[K]> };
-type Awaited<T> = T extends PromiseLike<infer U> ? Awaited<U> : T;
-type C8ySerialize<T> = T extends void | undefined | null ? undefined : T extends string ? string : Simplify<Serialize<T>>;
-`;
-/**
-* Generates complete Angular API client service.
-* @param routes - Array of parsed routes to generate methods for
-* @param contextPath - The microservice context path (e.g., "my-service")
-* @param className - The class name for the generated service (e.g., "PlaygroundAPIClient")
-*/
-function generateAPIClient(routes, contextPath, className) {
-	const methods = routes.map((route) => generateMethod(route)).join("\n\n");
-	return `/* eslint-disable eslint-comments/no-unlimited-disable */
-/* eslint-disable */
-/**
- * Auto-generated Cumulocity API Client
- * Generated by c8y-nitro
- *
- * This Angular service provides typed methods for all Nitro routes.
- * Each method corresponds to a route handler and returns properly typed responses.
- */
-import { Injectable, inject } from '@angular/core'
-import { FetchClient } from '@c8y/client'
-
-// Type helpers for proper serialization
-${serializationTypes}
-
-@Injectable({ providedIn: 'root' })
-export class ${className} {
-  private readonly BASE_PATH = '/service/${contextPath}';
-  private readonly fetchClient: FetchClient = inject(FetchClient)
-
-  /**
-   * Serializes the response based on content type and body.
-   * - Empty body (null, undefined, void) -> undefined
-   * - text/plain (string) -> raw text
-   * - application/json (number, boolean, object, array) -> JSON parsed
-   */
-  private async serialize(response: Response): Promise<any> {
-    const contentType = response.headers.get('content-type');
-    const text = await response.text();
-    
-    // Handle empty responses (null, undefined, empty return)
-    if (!text || text.length === 0) {
-      return undefined;
-    }
-    
-    // Handle plain text responses (strings)
-    if (contentType?.includes('text/plain')) {
-      return text;
-    }
-    
-    // Handle JSON responses (numbers, booleans, objects, arrays)
-    return JSON.parse(text);
-  }
-
-${methods}
-}`;
-}
-/**
-* Generates the TypeScript return type for a route handler.
-* @param handlerPath - Absolute path to the route handler file
-* @param outputFile - Absolute path to the output API client file
-* @returns TypeScript return type string with proper serialization wrappers
-*/
-function getReturnType(handlerPath, outputFile) {
-	const relativeHandlerPath = relative(dirname(outputFile), handlerPath);
-	return `C8ySerialize<Awaited<ReturnType<typeof import('${(relativeHandlerPath.startsWith(".") ? relativeHandlerPath : `./${relativeHandlerPath}`).replace(/\.ts$/, "")}').default>>>`;
-}
-/**
-* Writes the generated API client to disk.
-* @param nitro - Nitro instance
-* @param options - Complete module options including apiClient and manifest
-*/
-async function writeAPIClient(nitro, options) {
-	const { apiClient: apiClientOptions } = options;
-	if (!apiClientOptions) {
-		nitro.logger.debug("API client generation skipped: no apiClient options provided");
-		return;
-	}
-	const manifest = await createC8yManifestFromNitro(nitro);
-	const serviceName = manifest.name;
-	const serviceContextPath = apiClientOptions.contextPath ?? manifest.contextPath ?? serviceName;
-	const name = `${serviceName}APIClient`;
-	const rootDir = nitro.options.rootDir;
-	const outputDir = join(rootDir, apiClientOptions.dir);
-	const outputFile = join(outputDir, `${name}.ts`);
-	const routes = (nitro.routing.routes._routes ?? []).filter((route) => {
-		return !route.handler.includes("nitro/dist/runtime/internal");
-	}).map((route) => {
-		const path = route.route;
-		const method = (!route.method ? "GET" : route.method).toUpperCase();
-		const params = extractParams(path);
-		const functionName = generateFunctionName(path, method);
-		const returnType = getReturnType(route.handler, outputFile);
-		return {
-			path: path.replace(/:([^/]+)/g, "[$1]"),
-			method,
-			functionName,
-			params,
-			returnType
-		};
-	});
-	if (routes.length === 0) {
-		nitro.logger.warn("No routes found to generate API client");
-		return;
-	}
-	const code = generateAPIClient(routes, serviceContextPath, toValidClassName(name));
-	await mkdir(outputDir, { recursive: true });
-	await writeFile(outputFile, code, "utf-8");
-	nitro.logger.success(`Generated API client with ${routes.length} routes at: ${relative(rootDir, outputFile)}`);
-}
-//#endregion
 //#region src/module/docker.ts
 /**
 * Generate the Dockerfile content for a Nitro build
@@ -249,12 +48,17 @@ async function checkDockerInstalled() {
 		return false;
 	}
 }
-async function writeDockerfile(outputDir, options) {
-	const outputDirName = basename(outputDir);
+async function writeDockerfile(outputDir, rootDir, options) {
 	const c8yDir = join(outputDir, "../.c8y");
 	const dockerfilePath = join(c8yDir, "Dockerfile");
 	await mkdir(c8yDir, { recursive: true });
-	await writeFile(dockerfilePath, getDockerfileContent(outputDirName, options), "utf-8");
+	if (options.dockerfile) {
+		const customDockerfilePath = resolve(rootDir, options.dockerfile);
+		await copyFile(customDockerfilePath, dockerfilePath);
+	} else {
+		const dockerfileContent = getDockerfileContent(basename(outputDir), options);
+		await writeFile(dockerfilePath, dockerfileContent, "utf-8");
+	}
 	return c8yDir;
 }
 async function buildDockerImage(nitro, c8yDir) {
@@ -309,7 +113,7 @@ async function saveDockerImageToTar(nitro, c8yDir, imageName) {
 async function createDockerImage(nitro, options = {}) {
 	if (!await checkDockerInstalled()) throw new Error("Docker is not installed or not available in PATH. Please install Docker to build images.");
 	nitro.logger.debug("Creating Docker image...");
-	const c8yDir = await writeDockerfile(nitro.options.output.dir, options);
+	const c8yDir = await writeDockerfile(nitro.options.output.dir, nitro.options.rootDir, options);
 	const imageTarPath = await saveDockerImageToTar(nitro, c8yDir, await buildDockerImage(nitro, c8yDir));
 	nitro.logger.debug("Docker image creation complete.");
 	return imageTarPath;
@@ -337,7 +141,9 @@ function formatBytes(bytes) {
 * @returns Absolute path to the output zip file
 */
 function resolveZipOutputPath(rootDir, options, manifest) {
-	return join$1(join$1(rootDir, options.outputDir ?? "./"), typeof options.name === "function" ? options.name(manifest.name, manifest.version) : options.name ?? `${manifest.name}-${manifest.version}.zip`);
+	const outputDir = join$1(rootDir, options.outputDir ?? "./");
+	const fileName = typeof options.name === "function" ? options.name(manifest.name, manifest.version) : options.name ?? `${manifest.name}-${manifest.version}.zip`;
+	return join$1(outputDir, fileName);
 }
 async function createC8yZip(nitro, options = {}, dockerOptions = {}) {
 	const startTime = Date.now();
@@ -377,8 +183,8 @@ function setupRuntime(nitro, manifest) {
 	const roles = manifest.roles ?? [];
 	const settingKeys = (manifest.settings ?? []).map((s) => s.key);
 	const settingsCategory = manifest.settingsCategory ?? manifest.contextPath ?? manifest.name;
-	const completeTypesDir = join$1(nitro.options.rootDir, nitro.options.typescript.generatedTypesDir ?? "node_modules/.nitro/types");
-	const typesFile = join$1(completeTypesDir, "c8y-nitro.d.ts");
+	const completeTypesDir = join$1(nitro.options.rootDir, C8Y_NITRO_TYPES_DIR);
+	const typesFile = join$1(completeTypesDir, C8Y_NITRO_TYPES_FILE);
 	const typesContent = `// generated by c8y-nitro
 declare module 'c8y-nitro/types' {
   interface C8YRoles {
@@ -512,14 +318,16 @@ function registerRuntime(nitro, options = {}) {
 		});
 		nitro.logger.debug("Registered public request URL rewrite middleware");
 	}
-	if (Boolean(nitro.options.experimental?.openAPI && (isNitroDev || nitro.options.openAPI?.production))) if (!isNitroDev && nitro.options.openAPI?.production === "prerender") nitro.logger.warn("c8y-nitro cannot transform a prerendered OpenAPI document (internal routes stay listed and the server URL is baked in at build time). Use `openAPI: { production: true }` to serve the document at runtime instead.");
-	else {
-		nitro.options.handlers.push({
-			route: "/**",
-			handler: join$1(thisFilePath, "./runtime/handlers/openapi"),
-			middleware: true
-		});
-		nitro.logger.debug(`Registered OpenAPI transform middleware for ${nitro.options.openAPI?.route || "/_openapi.json"}`);
+	if (Boolean(nitro.options.experimental?.openAPI && (isNitroDev || nitro.options.openAPI?.production))) {
+		if (!isNitroDev && nitro.options.openAPI?.production === "prerender") nitro.logger.warn("c8y-nitro cannot transform a prerendered OpenAPI document (internal routes stay listed and the server URL is baked in at build time). Use `openAPI: { production: true }` to serve the document at runtime instead.");
+		else {
+			nitro.options.handlers.push({
+				route: "/**",
+				handler: join$1(thisFilePath, "./runtime/handlers/openapi"),
+				middleware: true
+			});
+			nitro.logger.debug(`Registered OpenAPI transform middleware for ${nitro.options.openAPI?.route || "/_openapi.json"}`);
+		}
 	}
 	/**
 	* Handlers (can't be auto scanned as they need methods etc)
@@ -588,10 +396,6 @@ function c8y() {
 		name: "c8y-nitro",
 		setup: async (nitro) => {
 			const options = nitro.options.c8y ?? {};
-			nitro.options.typescript.generateTsConfig = true;
-			nitro.options.typescript.tsConfig = {};
-			nitro.options.typescript.tsConfig.include = ["./**/*.d.ts"];
-			nitro.options.typescript.tsConfig.exclude = [];
 			nitro.options.noExternals = nitro.options.noExternals === true ? true : [
 				...Array.isArray(nitro.options.noExternals) ? nitro.options.noExternals : [],
 				name,
@@ -634,12 +438,6 @@ function c8y() {
 				registerRuntime(nitro, options);
 				if (options.manifest) checkProbes(nitro, options.manifest);
 			});
-			nitro.hooks.hook("types:extend", async () => {
-				if (options.apiClient) {
-					nitro.logger.debug("Generating C8Y API client");
-					await writeAPIClient(nitro, options);
-				}
-			});
 			nitro.hooks.hook("close", async () => {
 				if (nitro.options.preset !== "nitro-dev") await createC8yZip(nitro, options.zip, options.docker);
 			});

package/dist/manifest-DV3UW9Dl.mjs

@@ -0,0 +1,135 @@
+import { readPackage } from "pkg-types";
+//#region src/module/constants.ts
+const GENERATED_LIVENESS_ROUTE = "/_c8y_nitro/liveness";
+const GENERATED_READINESS_ROUTE = "/_c8y_nitro/readiness";
+const GENERATED_INVALIDATE_TENANT_OPTIONS_ROUTE = "/_c8y_nitro/invalidate-tenant-options";
+/**
+* Directory the module writes its generated type declarations into, relative to
+* the project root. Consumers add `node_modules/.c8y-nitro/*.d.ts` to their
+* tsconfig `include` — nitro no longer generates a tsconfig to inherit from.
+*/
+const C8Y_NITRO_TYPES_DIR = "node_modules/.c8y-nitro";
+/**
+* File name of the generated declarations inside {@link C8Y_NITRO_TYPES_DIR}.
+*/
+const C8Y_NITRO_TYPES_FILE = "types.d.ts";
+//#endregion
+//#region src/module/manifest.ts
+const DEFAULT_OPENAPI_ROUTE = "/_openapi.json";
+const ROLE_OPTION_MANAGEMENT_READ = "ROLE_OPTION_MANAGEMENT_READ";
+/**
+* Cumulocity microservice name constraints: lowercase letters, digits and
+* hyphens only, 1-23 characters. Enforced by the platform on upload, so we
+* fail early with a clear message instead of a cryptic API rejection.
+* @see https://github.com/schplitt/c8y-nitro/issues/75
+*/
+const MICROSERVICE_NAME_REGEX = /^[a-z0-9-]{1,23}$/;
+/**
+* Decide whether Nitro will expose an OpenAPI spec in the deployed build,
+* and if so return the configured route (with leading slash).
+* Returns null when OpenAPI is not enabled for production.
+* @param config - Nitro config (or options) to inspect
+*/
+function resolveNitroOpenApiRoute(config) {
+	if (!config.experimental?.openAPI) return null;
+	if (!config.openAPI?.production) return null;
+	return config.openAPI?.route || DEFAULT_OPENAPI_ROUTE;
+}
+/**
+* Pull the parts of a Nitro config that feed manifest generation.
+* @param config - Nitro config (or options) loaded from disk or from a Nitro instance
+*/
+function extractManifestInputs(config) {
+	return {
+		options: config.c8y?.manifest ?? {},
+		openApiSpec: resolveNitroOpenApiRoute(config) ?? void 0
+	};
+}
+function validateManifestSettings(options) {
+	const invalidSettings = options.settings?.filter((setting) => typeof setting.defaultValue !== "string" || setting.defaultValue.length === 0) ?? [];
+	if (invalidSettings.length === 0) return;
+	const invalidKeys = invalidSettings.map((setting) => `"${setting.key}"`).join(", ");
+	throw new Error(`manifest.settings entries must define a non-empty defaultValue. Invalid keys: ${invalidKeys}`);
+}
+async function readPackageJsonFieldsForManifest(rootDir, logger) {
+	logger?.debug(`Reading package file from ${rootDir}`);
+	const pkg = await readPackage(rootDir);
+	const name = pkg.name?.replace(/^@[^/]+\//, "");
+	const version = pkg.version;
+	const author = pkg.author;
+	const authorName = typeof author === "string" ? author : author?.name;
+	const authorEmail = typeof author === "string" ? void 0 : author?.email;
+	const authorUrl = typeof author === "string" ? void 0 : author?.url;
+	if (!name || !version || !authorName) throw new Error("package.json must contain name, version, and author name fields");
+	if (!MICROSERVICE_NAME_REGEX.test(name)) throw new Error(`Invalid microservice name "${name}". Cumulocity requires the name to match ${MICROSERVICE_NAME_REGEX.source} (lowercase letters, digits and hyphens only, 1-23 characters). Adjust the "name" field in package.json accordingly (scope like "@org/" is stripped and does not count).`);
+	const support = typeof pkg.bugs === "string" ? pkg.bugs : pkg.bugs?.url ?? pkg.bugs?.email;
+	const provider = {
+		name: authorName ?? name,
+		domain: authorUrl ?? pkg.homepage,
+		support: support ?? authorEmail
+	};
+	logger?.debug(`Found package.json fields for manifest: name=${name}, version=${version}, provider=${JSON.stringify(provider)}`);
+	return {
+		name,
+		version,
+		provider,
+		contextPath: name
+	};
+}
+/**
+* Create a Cumulocity manifest from a project root and its Nitro config.
+* Reads `package.json` for identity fields, takes user manifest options from
+* `nitroConfig.c8y.manifest`, and auto-injects `openApiSpec` when Nitro
+* OpenAPI is enabled for production.
+*
+* Used by both the Nitro module and the CLI commands.
+* @param rootDir - Directory containing the project's `package.json`
+* @param nitroConfig - Nitro config (or options) for this project
+* @param logger - Optional logger for debug output
+*/
+async function createC8yManifest(rootDir, nitroConfig = {}, logger) {
+	const { options, openApiSpec } = extractManifestInputs(nitroConfig);
+	validateManifestSettings(options);
+	const { name, version, provider, ...restManifestFields } = await readPackageJsonFieldsForManifest(rootDir, logger);
+	const probeFields = {};
+	if (!options.livenessProbe?.httpGet) probeFields.livenessProbe = {
+		...options.livenessProbe,
+		httpGet: { path: GENERATED_LIVENESS_ROUTE }
+	};
+	if (!options.readinessProbe?.httpGet) probeFields.readinessProbe = {
+		...options.readinessProbe,
+		httpGet: { path: GENERATED_READINESS_ROUTE }
+	};
+	const key = `${name}-key`;
+	let requiredRoles = options.requiredRoles ? [...options.requiredRoles] : void 0;
+	if (options.settings && options.settings.length > 0 && !requiredRoles?.includes(ROLE_OPTION_MANAGEMENT_READ)) {
+		requiredRoles = [...requiredRoles ?? [], ROLE_OPTION_MANAGEMENT_READ];
+		logger?.debug(`Auto-added ${ROLE_OPTION_MANAGEMENT_READ} to requiredRoles because manifest.settings are defined`);
+	}
+	const manifest = {
+		...restManifestFields,
+		...probeFields,
+		...options,
+		...requiredRoles !== void 0 ? { requiredRoles } : {},
+		...openApiSpec ? { openApiSpec } : {},
+		provider,
+		name,
+		version,
+		apiVersion: "v2",
+		key,
+		type: "MICROSERVICE"
+	};
+	if (openApiSpec) logger?.debug(`Auto-added openApiSpec="${openApiSpec}" to manifest (Nitro OpenAPI is enabled)`);
+	logger?.debug(`Created Cumulocity manifest: ${JSON.stringify(manifest, null, 2)}`);
+	return manifest;
+}
+/**
+* Creates a Cumulocity manifest from a Nitro instance.
+* Convenience wrapper for use in the Nitro module.
+* @param nitro - The Nitro instance
+*/
+async function createC8yManifestFromNitro(nitro) {
+	return createC8yManifest(nitro.options.rootDir, nitro.options, nitro.logger);
+}
+//#endregion
+export { GENERATED_INVALIDATE_TENANT_OPTIONS_ROUTE as a, C8Y_NITRO_TYPES_FILE as i, createC8yManifestFromNitro as n, GENERATED_LIVENESS_ROUTE as o, C8Y_NITRO_TYPES_DIR as r, GENERATED_READINESS_ROUTE as s, createC8yManifest as t };

package/dist/{options-BBnR-y_W.mjs → options-54uJmuUV.mjs}

@@ -1,5 +1,6 @@
-import { c as getTenantOptionsByCategory, f as upsertTenantOption, i as deleteTenantOption, n as createBasicAuthHeader, p as createC8yManifest, s as getCurrentApplicationSettings } from "./c8y-api-DpCWhaJU.mjs";
-import { n as readBootstrapCredentialsFromEnv, r as syncBootstrappedMicroservice } from "./autoBootstrap-qCcCgset.mjs";
+import { t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
+import { c as getTenantOptionsByCategory, f as upsertTenantOption, i as deleteTenantOption, n as createBasicAuthHeader, s as getCurrentApplicationSettings } from "./c8y-api-DSs1xIIh.mjs";
+import { n as readBootstrapCredentialsFromEnv, r as syncBootstrappedMicroservice } from "./autoBootstrap-DUjHuHe_.mjs";
 import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-BVQHqlgV.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";

package/dist/{package-CUuWGZoQ.mjs → package-CX0mgzB-.mjs}

@@ -1,6 +1,6 @@
 //#region package.json
 var name = "c8y-nitro";
-var version = "0.9.1";
+var version = "0.10.0";
 var description = "Lightning fast Cumulocity IoT microservice development powered by Nitro";
 //#endregion
 export { name as n, version as r, description as t };

package/dist/{roles-CkUvL64s.mjs → roles-CNCObfa3.mjs}

@@ -1,4 +1,5 @@
-import { n as createBasicAuthHeader, p as createC8yManifest, t as assignUserRole, u as unassignUserRole } from "./c8y-api-DpCWhaJU.mjs";
+import { t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
+import { n as createBasicAuthHeader, t as assignUserRole, u as unassignUserRole } from "./c8y-api-DSs1xIIh.mjs";
 import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-BVQHqlgV.mjs";
 import { defineCommand } from "citty";
 import { consola } from "consola";

package/dist/runtime/handlers/invalidateTenantOptions.mjs

@@ -1,5 +1,5 @@
 import { t as createError } from "../../logging-BUYT8Z2V.mjs";
-import { t as useDeployedTenantClient } from "../../client-DCov9jV6.mjs";
+import { t as useDeployedTenantClient } from "../../client-BjA5bBxj.mjs";
 import { c8yTenantOptionKeys } from "c8y-nitro/runtime";
 import { defineCachedFunction } from "nitro/cache";
 import { useRuntimeConfig } from "nitro/runtime-config";

package/dist/runtime/handlers/openapi.mjs

@@ -1,4 +1,4 @@
-import { r as tryGetUserTenantDomainFast } from "../../client-DCov9jV6.mjs";
+import { r as tryGetUserTenantDomainFast } from "../../client-BjA5bBxj.mjs";
 import { c8yManifest } from "c8y-nitro/runtime";
 import { useRuntimeConfig } from "nitro/runtime-config";
 import { getRequestURL } from "nitro/h3";

package/dist/runtime/handlers/rewriteRequestUrl.mjs

@@ -1,4 +1,4 @@
-import { n as buildPublicRequestUrl, r as tryGetUserTenantDomainFast } from "../../client-DCov9jV6.mjs";
+import { n as buildPublicRequestUrl, r as tryGetUserTenantDomainFast } from "../../client-BjA5bBxj.mjs";
 import { c8yManifest } from "c8y-nitro/runtime";
 import { defineMiddleware } from "nitro";
 //#region src/module/runtime/handlers/rewriteRequestUrl.ts

package/dist/typegen-BO_AkyNc.mjs

@@ -0,0 +1,30 @@
+import { i as C8Y_NITRO_TYPES_FILE, r as C8Y_NITRO_TYPES_DIR } from "./manifest-DV3UW9Dl.mjs";
+import { t as writeAPIClient } from "./apiClient-kxv5KHYJ.mjs";
+import { resolve } from "pathe";
+import process from "node:process";
+import { defineCommand } from "citty";
+import { consola } from "consola";
+import { createNitro } from "nitro/builder";
+//#region src/cli/commands/typegen.ts
+var typegen_default = defineCommand({
+	meta: {
+		name: "typegen",
+		description: "Generate the c8y-nitro type declarations (replaces the removed `nitro prepare`)"
+	},
+	args: { dir: {
+		type: "positional",
+		description: "Project root directory",
+		required: false,
+		default: "."
+	} },
+	async run({ args }) {
+		const rootDir = resolve(process.cwd(), args.dir);
+		const nitro = await createNitro({ rootDir });
+		consola.success(`Generated types at ${C8Y_NITRO_TYPES_DIR}/${C8Y_NITRO_TYPES_FILE}`);
+		const c8yOptions = nitro.options.c8y ?? {};
+		if (c8yOptions.apiClient) await writeAPIClient(nitro, c8yOptions);
+		consola.info(`Add "${C8Y_NITRO_TYPES_DIR}/*.d.ts" to your tsconfig \`include\` if you have not already.`);
+	}
+});
+//#endregion
+export { typegen_default as default };

package/dist/types.d.mts

@@ -1,3 +1,3 @@
-import { a as C8YTenantOptionKey, c as C8yDockerOptions, d as C8YManifest, f as C8YManifestOptions, g as C8YAPIClientOptions, h as C8YKnownRole, i as C8YSettingsCategory, l as C8yCacheOptions, m as C8YRoles, n as C8yNitroModuleOptions, o as C8YTenantOptionKeysCacheConfig, p as C8YRole, r as C8yOpenAPIOptions, s as C8yRealtimeOptions, t as C8yDevOptions, u as C8YZipOptions } from "./index-Dil1PcDr.mjs";
+import { a as C8YTenantOptionKey, c as C8yDockerOptions, d as C8YManifest, f as C8YManifestOptions, g as C8YAPIClientOptions, h as C8YKnownRole, i as C8YSettingsCategory, l as C8yCacheOptions, m as C8YRoles, n as C8yNitroModuleOptions, o as C8YTenantOptionKeysCacheConfig, p as C8YRole, r as C8yOpenAPIOptions, s as C8yRealtimeOptions, t as C8yDevOptions, u as C8YZipOptions } from "./index-DHd7xpBX.mjs";
 import { t as TenantCredentials } from "./credentials-eKnJ7m9Y.mjs";
 export { C8YAPIClientOptions, type C8YKnownRole, type C8YManifest, type C8YManifestOptions, C8YRole, C8YRoles, C8YSettingsCategory, C8YTenantOptionKey, C8YTenantOptionKeysCacheConfig, type C8YZipOptions, type C8yCacheOptions, C8yDevOptions, type C8yDockerOptions, C8yNitroModuleOptions, C8yOpenAPIOptions, type C8yRealtimeOptions, type TenantCredentials };

package/dist/utils.mjs

@@ -132,7 +132,8 @@ defineCachedFunction(async (requestOrEvent, _tenantId) => {
 * const log = useLogger(useRequest())
 */
 function useLogger(eventOrRequest, service) {
-	return useLogger$1("req" in eventOrRequest ? eventOrRequest : { req: eventOrRequest }, service);
+	const event = "req" in eventOrRequest ? eventOrRequest : { req: eventOrRequest };
+	return useLogger$1(event, service);
 }
 /**
 * Create a structured error for a Cumulocity microservice. Always prefer this
@@ -324,7 +325,9 @@ async function useUserTenantCredentials(requestOrEvent) {
 function useUserClient(requestOrEvent) {
 	const request = "req" in requestOrEvent ? requestOrEvent.req : requestOrEvent;
 	if (request.context?.["c8y_user_client"]) return request.context["c8y_user_client"];
-	const client = new Client(new MicroserviceClientRequestAuth(convertRequestHeadersToC8yFormat(request)), process.env.C8Y_BASEURL);
+	const headers = convertRequestHeadersToC8yFormat(request);
+	const auth = new MicroserviceClientRequestAuth(headers);
+	const client = new Client(auth, process.env.C8Y_BASEURL);
 	request.context ??= {};
 	request.context["c8y_user_client"] = client;
 	return client;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c8y-nitro",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "type": "module",
   "description": "Lightning fast Cumulocity IoT microservice development powered by Nitro",
   "keywords": [
@@ -38,18 +38,18 @@
     "dist"
   ],
   "dependencies": {
-    "c12": "^4.0.0-beta.5",
+    "c12": "^4.0.0-rc.1",
     "c8y-realtime": "^0.2.2",
     "citty": "^0.2.2",
     "consola": "^3.4.2",
     "croner": "^10.0.1",
-    "evlog": "^2.21.0",
+    "evlog": "^2.28.1",
     "itty-time": "^2.0.2",
     "jszip": "^3.10.1",
     "pathe": "^2.0.3",
-    "pkg-types": "^2.3.1",
+    "pkg-types": "^2.3.2",
     "spinnies": "^0.5.1",
-    "tinyexec": "^1.2.4",
+    "tinyexec": "^1.3.1",
     "ws": "^8.21.3"
   },
   "devDependencies": {
@@ -58,20 +58,20 @@
     "@types/node": "^24.12.3",
     "@types/spinnies": "^0.5.3",
     "@types/ws": "^8.18.1",
-    "bumpp": "^11.1.0",
-    "changelogithub": "^14.0.0",
-    "eslint": "^10.7.0",
-    "memfs": "^4.64.0",
-    "tsdown": "^0.22.8",
-    "tsnapi": "^1.0.0",
+    "bumpp": "^12.3.0",
+    "changelogithub": "^15.0.5",
+    "eslint": "^10.9.1",
+    "memfs": "^4.69.1",
+    "tsdown": "^0.22.14",
+    "tsnapi": "^1.4.2",
     "typescript": "^6.0.3",
     "vitepress": "2.0.0-alpha.17",
     "vitepress-plugin-llms": "1.13.3",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "peerDependencies": {
     "@c8y/client": ">=1021",
-    "nitro": "3.0.260429-beta"
+    "nitro": "3.0.260903-beta"
   },
   "engines": {
     "node": ">=24.0.0"