c8y-nitro 0.10.4 → 0.11.0

package/README.md

@@ -13,6 +13,7 @@ Nitro-powered tooling for building Cumulocity IoT microservices without manually
 - 🔥 **File-based Routing** - Auto-discovered routes from your file structure
 - 🛠️ **TypeScript First** - Full type safety with excellent DX
 - 🔄 **Auto-Bootstrap** - Automatically registers and configures your microservice in development
+- 🧪 **Testing** - Test your service in Vitest against a fake Cumulocity tenant you seed with devices, measurements, alarms, and more
 
 ## Quickstart
 
@@ -28,6 +29,7 @@ Useful entry points:
 - [Configuration](https://schplitt.github.io/c8y-nitro/guide/configuration)
 - [Module Options](https://schplitt.github.io/c8y-nitro/reference/module-options)
 - [Utilities](https://schplitt.github.io/c8y-nitro/reference/utilities)
+- [Testing](https://schplitt.github.io/c8y-nitro/guide/testing)
 
 ## Development
 

package/dist/{apiClient-kxv5KHYJ.mjs → apiClient-GMQqcgQe.mjs}

@@ -1,7 +1,7 @@
-import { n as createC8yManifestFromNitro } from "./manifest-DV3UW9Dl.mjs";
+import { n as createC8yManifestFromNitro } from "./manifest-BhrHDm8Y.mjs";
 import { dirname, join, relative } from "node:path";
 import { mkdir, writeFile } from "node:fs/promises";
-//#region src/module/apiClient.ts
+// src/module/apiClient.ts
 /**
 * Converts route path to PascalCase function name.
 * Examples:
@@ -202,5 +202,4 @@ async function writeAPIClient(nitro, options) {
 	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-CElU3xv-.mjs → autoBootstrap-D4vEytWW.mjs}

@@ -1,11 +1,11 @@
-import { t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
-import { h as updateMicroservice, l as findMicroserviceByName, o as createBasicAuthHeader, p as subscribeToApplication, s as createMicroservice, u as getBootstrapCredentials } from "./env-CM-t7BwA.mjs";
-import { t as writeBootstrapCredentials } from "./env-file-BrOTmVjA.mjs";
+import { t as createC8yManifest } from "./manifest-BhrHDm8Y.mjs";
+import { h as updateMicroservice, l as findMicroserviceByName, o as createBasicAuthHeader, p as subscribeToApplication, s as createMicroservice, u as getBootstrapCredentials } from "./env-fUAhIWsI.mjs";
+import { t as writeBootstrapCredentials } from "./env-file-DWbaFlIp.mjs";
+import process from "node:process";
 import { join } from "node:path";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { createHash } from "node:crypto";
-import process from "node:process";
-//#region src/module/manifestCache.ts
+// src/module/manifestCache.ts
 /**
 * Directory (inside the project's `node_modules`) where c8y-nitro persists
 * local dev state such as the last-synced manifest hash. Lives in
@@ -64,8 +64,7 @@ async function writeManifestCache(rootDir, state) {
 	};
 	await writeFile(getCacheFile(rootDir), JSON.stringify(payload, null, 2), "utf-8");
 }
-//#endregion
-//#region src/module/autoBootstrap.ts
+// src/module/autoBootstrap.ts
 const BOOTSTRAP_ENV_VARS = [
 	"C8Y_BOOTSTRAP_TENANT",
 	"C8Y_BOOTSTRAP_USER",
@@ -212,5 +211,4 @@ async function finalizeBootstrap(opts) {
 	});
 	return credentials;
 }
-//#endregion
 export { readBootstrapCredentialsFromEnv as n, syncBootstrappedMicroservice as r, autoBootstrap as t };

package/dist/{bootstrap-hV_pJO5R.mjs → bootstrap-DpYAhM7C.mjs}

@@ -1,10 +1,10 @@
-import { t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
-import { h as updateMicroservice, l as findMicroserviceByName, o as createBasicAuthHeader, p as subscribeToApplication, s as createMicroservice, u as getBootstrapCredentials } from "./env-CM-t7BwA.mjs";
-import { t as writeBootstrapCredentials } from "./env-file-BrOTmVjA.mjs";
-import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-4Ju9safS.mjs";
+import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-Dozrdw3A.mjs";
+import { h as updateMicroservice, l as findMicroserviceByName, o as createBasicAuthHeader, p as subscribeToApplication, s as createMicroservice, u as getBootstrapCredentials } from "./env-fUAhIWsI.mjs";
+import { t as writeBootstrapCredentials } from "./env-file-DWbaFlIp.mjs";
+import { t as createC8yManifest } from "./manifest-BhrHDm8Y.mjs";
 import { defineCommand, runCommand } from "citty";
 import { consola } from "consola";
-//#region src/cli/commands/bootstrap.ts
+// src/cli/commands/bootstrap.ts
 var bootstrap_default = defineCommand({
 	meta: {
 		name: "bootstrap",
@@ -54,12 +54,11 @@ 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" })) {
-				const rolesCommand = await import("./roles-D08LKKLI.mjs").then((r) => r.default);
+				const rolesCommand = await import("./roles-DEIHe2Xt.mjs").then((r) => r.default);
 				await runCommand(rolesCommand, { rawArgs: [] });
 			}
 		}
 		consola.success("Bootstrap complete!");
 	}
 });
-//#endregion
 export { bootstrap_default as default };

package/dist/cli/index.mjs

@@ -1,6 +1,6 @@
-import { n as name, r as version, t as description } from "../package-WtwC9ClY.mjs";
+import { n as name, r as version, t as description } from "../package-y3p_br3i.mjs";
 import { defineCommand, runMain } from "citty";
-//#region src/cli/index.ts
+// src/cli/index.ts
 const main = defineCommand({
 	meta: {
 		name,
@@ -8,12 +8,11 @@ const main = defineCommand({
 		description
 	},
 	subCommands: {
-		bootstrap: () => import("../bootstrap-hV_pJO5R.mjs").then((r) => r.default),
-		roles: () => import("../roles-D08LKKLI.mjs").then((r) => r.default),
-		options: () => import("../options-Bif4gAIp.mjs").then((r) => r.default),
-		typegen: () => import("../typegen-BO_AkyNc.mjs").then((r) => r.default)
+		bootstrap: () => import("../bootstrap-DpYAhM7C.mjs").then((r) => r.default),
+		roles: () => import("../roles-DEIHe2Xt.mjs").then((r) => r.default),
+		options: () => import("../options-CgTptIpI.mjs").then((r) => r.default),
+		typegen: () => import("../typegen-Bw4VxFmA.mjs").then((r) => r.default)
 	}
 });
 runMain(main);
-//#endregion
 export {};

package/dist/{config-4Ju9safS.mjs → config-Dozrdw3A.mjs}

@@ -1,8 +1,8 @@
-import { i as toPrefixedEnvVar, n as resolveEnvFileNames, t as applyC8yNitroEnvVars } from "./env-CM-t7BwA.mjs";
+import { i as toPrefixedEnvVar, n as resolveEnvFileNames, t as applyC8yNitroEnvVars } from "./env-fUAhIWsI.mjs";
 import { dirname } from "pathe";
 import { loadConfig, loadDotenv } from "c12";
 import process from "process";
-//#region src/cli/utils/config.ts
+// src/cli/utils/config.ts
 function normalizeBaseUrl(baseUrl) {
 	return baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
 }
@@ -58,5 +58,4 @@ function validateBootstrapEnv(env) {
 		C8Y_DEVELOPMENT_PASSWORD: env.C8Y_DEVELOPMENT_PASSWORD
 	};
 }
-//#endregion
 export { validateBootstrapEnv as n, loadC8yConfig as t };

package/dist/{credentials-eKnJ7m9Y.d.mts → credentials-C_3m4LVX.d.mts}

@@ -1,5 +1,3 @@
 import { ICredentials } from "@c8y/client";
-//#region src/types/credentials.d.ts
 type TenantCredentials = Record<string, ICredentials>;
-//#endregion
 export { TenantCredentials as t };

package/dist/defaults-CrrCinRJ.mjs

@@ -0,0 +1,20 @@
+// src/testing/defaults.ts
+/**
+* Values the fake tenant uses when the plugin config leaves them out.
+*/
+const DEFAULTS = {
+	tenant: "t12345",
+	baseUrl: "https://t12345.cumulocity.test",
+	user: {
+		userName: "test-user",
+		roles: []
+	},
+	bootstrapUser: "servicebootstrap_test",
+	bootstrapPassword: "bootstrap-password",
+	developmentPassword: "test-password"
+};
+/**
+* Key under which the plugin provides its options to the test workers.
+*/
+const PROVIDE_KEY = "c8yNitroTest";
+export { PROVIDE_KEY as n, DEFAULTS as t };

package/dist/{env-CM-t7BwA.mjs → env-fUAhIWsI.mjs}

@@ -1,9 +1,9 @@
+import process from "node:process";
 import { resolve } from "pathe";
 import { Buffer } from "node:buffer";
 import { statSync } from "node:fs";
-import process from "node:process";
 import { setupDotenv } from "c12";
-//#region src/cli/utils/c8y-api.ts
+// src/cli/utils/c8y-api.ts
 /**
 * Creates a Basic Auth header for Cumulocity API requests.
 * Format: base64(tenant/user:password)
@@ -311,8 +311,7 @@ async function deleteTenantOption(baseUrl, category, key, authHeader) {
 		throw new Error(`Failed to delete tenant option ${category}/${key}: ${response.status} ${response.statusText}\n${errorText}`, { cause: response });
 	}
 }
-//#endregion
-//#region src/cli/utils/env.ts
+// src/cli/utils/env.ts
 /**
 * The project's own env files. Always loaded last so they override any
 * additional (e.g. monorepo-root) env files configured via `c8y.envFile`.
@@ -382,5 +381,4 @@ async function setupC8yDevEnv(rootDir, envFile) {
 	});
 	applyC8yNitroEnvVars(process.env);
 }
-//#endregion
 export { assignUserRole as a, deleteTenantOption as c, getCurrentApplicationSettings as d, getTenantOptionsByCategory as f, upsertTenantOption as g, updateMicroservice as h, toPrefixedEnvVar as i, findMicroserviceByName as l, unassignUserRole as m, resolveEnvFileNames as n, createBasicAuthHeader as o, subscribeToApplication as p, setupC8yDevEnv as r, createMicroservice as s, applyC8yNitroEnvVars as t, getBootstrapCredentials as u };

package/dist/{env-file-BrOTmVjA.mjs → env-file-DWbaFlIp.mjs}

@@ -1,7 +1,7 @@
 import { join } from "node:path";
 import { readFile, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
-//#region src/cli/utils/env-file.ts
+// src/cli/utils/env-file.ts
 /**
 * Writes or updates environment variables in a file.
 * Existing variables are overwritten, new ones are appended.
@@ -55,5 +55,4 @@ async function writeBootstrapCredentials(configDir, variables) {
 	await writeEnvVariables(targetPath, variables);
 	return targetName;
 }
-//#endregion
 export { writeBootstrapCredentials as t };

package/dist/{index-BOaWGoaf.d.mts → index-CmIQfBpj.d.mts}

@@ -1,7 +1,6 @@
-import "./credentials-eKnJ7m9Y.mjs";
+import "./credentials-C_3m4LVX.mjs";
 import { ConsumerResilienceOptions, SubscriptionApi } from "c8y-realtime";
 import { C8YTenantOptionKeysCacheConfig } from "c8y-nitro/types";
-//#region src/types/apiClient.d.ts
 interface C8YAPIClientOptions {
   /**
    * Relative directory from nitro configuration file to generate the API client into.
@@ -15,8 +14,6 @@ interface C8YAPIClientOptions {
    */
   contextPath?: string;
 }
-//#endregion
-//#region src/types/roles.generated.d.ts
 /**
  * AUTO-GENERATED by scripts/generate-roles.ts — do not edit by hand.
  *
@@ -30,8 +27,6 @@ interface C8YAPIClientOptions {
  * Cumulocity platform roles ("required roles") known from the core OpenAPI spec.
  */
 type C8YKnownRole = 'ROLE_ALARM_ADMIN' | 'ROLE_ALARM_READ' | 'ROLE_APPLICATION_MANAGEMENT_ADMIN' | 'ROLE_APPLICATION_MANAGEMENT_READ' | 'ROLE_AUDIT_ADMIN' | 'ROLE_AUDIT_READ' | 'ROLE_BINARY_ADMIN' | 'ROLE_BINARY_CREATE' | 'ROLE_BINARY_READ' | 'ROLE_BULK_OPERATION_ADMIN' | 'ROLE_BULK_OPERATION_READ' | 'ROLE_DEVICE' | 'ROLE_DEVICE_BOOTSTRAP' | 'ROLE_DEVICE_CONTROL_ADMIN' | 'ROLE_DEVICE_CONTROL_READ' | 'ROLE_EVENT_ADMIN' | 'ROLE_EVENT_READ' | 'ROLE_IDENTITY_ADMIN' | 'ROLE_IDENTITY_READ' | 'ROLE_INVENTORY_ADMIN' | 'ROLE_INVENTORY_CREATE' | 'ROLE_INVENTORY_READ' | 'ROLE_MANAGED_OBJECT_ADMIN' | 'ROLE_MANAGED_OBJECT_CREATE' | 'ROLE_MANAGED_OBJECT_READ' | 'ROLE_MEASUREMENT_ADMIN' | 'ROLE_MEASUREMENT_READ' | 'ROLE_NOTIFICATION_2_ADMIN' | 'ROLE_OPTION_MANAGEMENT_ADMIN' | 'ROLE_OPTION_MANAGEMENT_READ' | 'ROLE_RETENTION_RULE_ADMIN' | 'ROLE_RETENTION_RULE_READ' | 'ROLE_SMS_READ' | 'ROLE_SYSTEM' | 'ROLE_TENANT_ADMIN' | 'ROLE_TENANT_ALARM_ADMIN' | 'ROLE_TENANT_MANAGEMENT_ADMIN' | 'ROLE_TENANT_MANAGEMENT_CREATE' | 'ROLE_TENANT_MANAGEMENT_READ' | 'ROLE_TENANT_MANAGEMENT_UPDATE' | 'ROLE_TENANT_STATISTICS_READ' | 'ROLE_USER_MANAGEMENT_ADMIN' | 'ROLE_USER_MANAGEMENT_CREATE' | 'ROLE_USER_MANAGEMENT_OWN_ADMIN' | 'ROLE_USER_MANAGEMENT_OWN_READ' | 'ROLE_USER_MANAGEMENT_READ';
-//#endregion
-//#region src/types/roles.d.ts
 /**
  * Roles your microservice provides. Populated at runtime from the manifest's
  * `roles` field (see the module's generated `c8y-nitro.d.ts`).
@@ -43,8 +38,6 @@ interface C8YRoles$1 {}
  * other string (custom roles, or roles not yet in the generated list).
  */
 type C8YRole$1 = C8YKnownRole | (string & {});
-//#endregion
-//#region src/types/manifest.d.ts
 type C8YManifestOptions = Omit<C8YManifest, 'name' | 'version' | 'apiVersion' | 'key' | 'type' | 'provider' | 'openApiSpec'>;
 interface C8YManifest {
   /**
@@ -165,6 +158,42 @@ interface C8YManifest {
    * @example "/_openapi.json"
    */
   openApiSpec?: string;
+  /**
+   * MCP (Model Context Protocol) servers exposed by this microservice.
+   * Once the application is subscribed, Cumulocity AI Agent Manager
+   * auto-registers these entries, and MCP-aware clients (e.g., mc8yp)
+   * discover them from the manifest.
+   * @example [{ name: "my-service", url: "/service/my-service/mcp", type: "http", sendAuthentication: true }]
+   */
+  exposeMcpServers?: ExposedMcpServer[];
+}
+/**
+ * MCP server entry declared via `exposeMcpServers`.
+ */
+interface ExposedMcpServer {
+  /**
+   * Name of the MCP server as shown in AI Agent Manager.
+   * @example "my-service"
+   */
+  name: string;
+  /**
+   * Human-readable description of what the MCP server offers.
+   */
+  description?: string;
+  /**
+   * URL of the MCP endpoint, usually the full service path including the context path.
+   * @example "/service/my-service/mcp"
+   */
+  url: string;
+  /**
+   * MCP transport type. Streamable HTTP (`"http"`) is the supported transport.
+   * @example "http"
+   */
+  type: 'http' | (string & {});
+  /**
+   * Forward the calling user's authentication to the MCP server.
+   */
+  sendAuthentication?: boolean;
 }
 /**
  * Company/organization information.
@@ -367,8 +396,6 @@ interface Extension {
    */
   [key: string]: unknown;
 }
-//#endregion
-//#region src/types/zip.d.ts
 interface C8YZipOptions {
   /**
    * Name of the generated zip file
@@ -392,8 +419,6 @@ interface C8YZipOptions {
    */
   manifest?: C8YManifestOptions;
 }
-//#endregion
-//#region src/types/cache.d.ts
 interface C8yCacheOptions {
   /**
    * Cache TTL for subscribed tenant credentials in seconds.
@@ -417,8 +442,6 @@ interface C8yCacheOptions {
    */
   tenantOptions?: C8YTenantOptionKeysCacheConfig;
 }
-//#endregion
-//#region src/types/docker.d.ts
 interface C8yDockerOptions {
   /**
    * Path to a custom Dockerfile, relative to the Nitro config file location
@@ -453,8 +476,6 @@ interface C8yDockerOptions {
    */
   extraInstructions?: string[];
 }
-//#endregion
-//#region src/types/realtime.d.ts
 /**
  * Options for the Notification 2.0 realtime clients (backed by `c8y-realtime`).
  *
@@ -526,8 +547,6 @@ interface C8yRealtimeOptions {
    */
   resilience?: ConsumerResilienceOptions;
 }
-//#endregion
-//#region src/types/tenantOptions.d.ts
 /**
  * Per-key cache TTL configuration for tenant options.
  * Overwritten by generated types from manifest settings (manifest.settings[].key).
@@ -544,8 +563,6 @@ type C8YTenantOptionKey$1 = string;
  * Overwritten by generated types from the manifest.
  */
 type C8YSettingsCategory$1 = string;
-//#endregion
-//#region src/types/index.d.ts
 interface C8yDevOptions {
   /**
    * Automatically inject the configured development user into incoming requests
@@ -633,5 +650,4 @@ interface C8yNitroModuleOptions {
    */
   skipBootstrap?: boolean;
 }
-//#endregion
-export { C8YTenantOptionKey$1 as a, C8yDockerOptions as c, C8YManifest as d, C8YManifestOptions as f, C8YAPIClientOptions as g, C8YKnownRole as h, C8YSettingsCategory$1 as i, C8yCacheOptions as l, C8YRoles$1 as m, C8yNitroModuleOptions as n, C8YTenantOptionKeysCacheConfig$1 as o, C8YRole$1 as p, C8yOpenAPIOptions as r, C8yRealtimeOptions as s, C8yDevOptions as t, C8YZipOptions as u };
+export { C8YAPIClientOptions as _, C8YTenantOptionKey$1 as a, C8yDockerOptions as c, C8YManifest as d, C8YManifestOptions as f, C8YKnownRole as g, C8YRoles$1 as h, C8YSettingsCategory$1 as i, C8yCacheOptions as l, C8YRole$1 as m, C8yNitroModuleOptions as n, C8YTenantOptionKeysCacheConfig$1 as o, ExposedMcpServer as p, C8yOpenAPIOptions as r, C8yRealtimeOptions as s, C8yDevOptions as t, C8YZipOptions as u };

package/dist/index.d.mts

@@ -1,7 +1,6 @@
-import { n as C8yNitroModuleOptions } from "./index-BOaWGoaf.mjs";
-import { t as TenantCredentials } from "./credentials-eKnJ7m9Y.mjs";
+import { n as C8yNitroModuleOptions } from "./index-CmIQfBpj.mjs";
+import { t as TenantCredentials } from "./credentials-C_3m4LVX.mjs";
 import { NitroModule } from "nitro/types";
-//#region src/index.d.ts
 declare module 'nitro/types' {
   interface NitroOptions {
     c8y?: C8yNitroModuleOptions;
@@ -12,6 +11,5 @@ declare module 'nitro/types' {
     'c8y:tenantCredentialsUpdated': (prev: TenantCredentials | null, next: TenantCredentials) => void;
   }
 }
-declare function c8y(): NitroModule;
-//#endregion
-export { c8y, c8y as default };
+export declare function c8y(): NitroModule;
+export { c8y as default };

package/dist/index.mjs

@@ -1,8 +1,9 @@
-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 { r as setupC8yDevEnv } from "./env-CM-t7BwA.mjs";
-import { t as autoBootstrap } from "./autoBootstrap-CElU3xv-.mjs";
-import { n as name } from "./package-WtwC9ClY.mjs";
+import { t as writeAPIClient } from "./apiClient-GMQqcgQe.mjs";
+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-BhrHDm8Y.mjs";
+import { t as autoBootstrap } from "./autoBootstrap-D4vEytWW.mjs";
+import { r as setupC8yDevEnv } from "./env-fUAhIWsI.mjs";
+import { n as name } from "./package-y3p_br3i.mjs";
+import process from "node:process";
 import { basename, join, resolve } from "node:path";
 import { copyFile, mkdir, writeFile } from "node:fs/promises";
 import { x } from "tinyexec";
@@ -16,7 +17,7 @@ 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/docker.ts
+// src/module/docker.ts
 /**
 * Generate the Dockerfile content for a Nitro build
 * @param outputDirName - Name of the output directory (e.g., '.output')
@@ -119,8 +120,7 @@ async function createDockerImage(nitro, options = {}) {
 	nitro.logger.debug("Docker image creation complete.");
 	return imageTarPath;
 }
-//#endregion
-//#region src/module/c8yzip.ts
+// src/module/c8yzip.ts
 const spinnies = new Spinnies();
 function formatBytes(bytes) {
 	if (bytes === 0) return "0 B";
@@ -179,8 +179,7 @@ async function createC8yZip(nitro, options = {}, dockerOptions = {}) {
 	nitro.logger.log(colors.gray(`  └─ ${outputFile} (${zipSize})`));
 	nitro.logger.info("Zip file can be uploaded to Cumulocity IoT platform");
 }
-//#endregion
-//#region src/module/runtime.ts
+// src/module/runtime.ts
 function setupRuntime(nitro, manifest) {
 	nitro.logger.debug("Setting up C8Y nitro runtime");
 	const roles = manifest.roles ?? [];
@@ -217,8 +216,7 @@ export const c8yTenantOptionKeys = [${settingKeys.map((key) => `'${key}'`).join(
 	writeFileSync(typesFile, typesContent, { encoding: "utf-8" });
 	nitro.logger.debug(`Written C8Y types to ${typesFile}`);
 }
-//#endregion
-//#region src/module/runtimeConfig.ts
+// src/module/runtimeConfig.ts
 /**
 * Derive a stable, unique realtime client name from the microservice identity
 * (its `contextPath`, falling back to `name`).
@@ -267,8 +265,7 @@ async function setupRuntimeConfig(nitro, options) {
 	const probePaths = [options.manifest?.livenessProbe?.httpGet?.path, options.manifest?.readinessProbe?.httpGet?.path].filter((path) => Boolean(path));
 	nitro.options.runtimeConfig.c8yOpenApiExcludeRoutes = [...excludeInternalRoutes ? ["/_", ...probePaths] : [], ...options.openapi?.excludeRoutes ?? []];
 }
-//#endregion
-//#region src/module/registerRuntime.ts
+// src/module/registerRuntime.ts
 /**
 * Links runtime middleware, handlers, and plugins to the nitro instance.
 * Works by having the handlers in a relative path to this file.
@@ -364,8 +361,7 @@ function registerRuntime(nitro, options = {}) {
 	}
 	nitro.options.handlers.push(...handlers);
 }
-//#endregion
-//#region src/module/probeCheck.ts
+// src/module/probeCheck.ts
 function checkProbes(nitro, manifestOptions = {}) {
 	if (manifestOptions.livenessProbe?.httpGet) {
 		const probe = manifestOptions.livenessProbe.httpGet;
@@ -392,8 +388,7 @@ function checkProbeEndpoint(nitro, probe, probeType) {
 		nitro.logger.warn(`${probeType} route "${path}" exists but does not accept ${method} requests. Available methods: ${availableMethods || "none specified"}. The probe will fail at runtime.`);
 	}
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 function c8y() {
 	return {
 		name: "c8y-nitro",
@@ -427,22 +422,22 @@ function c8y() {
 			await setupEvlog(nitro);
 			if (nitro.options.preset === "nitro-dev") {
 				await setupC8yDevEnv(nitro.options.rootDir, options.envFile);
-				if (!options.skipBootstrap) await autoBootstrap(nitro);
+				if (!options.skipBootstrap && !process.env.VITEST) await autoBootstrap(nitro);
 			}
 			await setupRuntimeConfig(nitro, options);
 			setupRuntime(nitro, manifest);
+			registerRuntime(nitro, options);
 			nitro.hooks.hook("dev:reload", async () => {
 				await setupC8yDevEnv(nitro.options.rootDir, options.envFile);
 				manifest = await createC8yManifestFromNitro(nitro);
 				setupRuntime(nitro, manifest);
-				if (!options.skipBootstrap) await autoBootstrap(nitro);
+				if (!options.skipBootstrap && !process.env.VITEST) await autoBootstrap(nitro);
 				if (options.apiClient) {
 					nitro.logger.debug("Generating C8Y API client");
 					await writeAPIClient(nitro, options);
 				}
 			});
 			nitro.hooks.hook("build:before", async () => {
-				registerRuntime(nitro, options);
 				if (options.manifest) checkProbes(nitro, options.manifest);
 			});
 			nitro.hooks.hook("close", async () => {
@@ -451,5 +446,4 @@ function c8y() {
 		}
 	};
 }
-//#endregion
 export { c8y, c8y as default };

package/dist/{logging-BUYT8Z2V.mjs → logging-B1PuWdiF.mjs}

@@ -1,6 +1,6 @@
 import { createError } from "evlog";
 import "evlog/nitro/v3";
-//#region src/utils/logging.ts
+// src/utils/logging.ts
 /**
 * Create a structured error for a Cumulocity microservice. Always prefer this
 * over Nitro/h3's built-in `createError`: the returned error is captured in the
@@ -53,5 +53,4 @@ import "evlog/nitro/v3";
 * @see https://www.evlog.dev
 */
 const createError$1 = createError;
-//#endregion
 export { createError$1 as t };

package/dist/{manifest-DV3UW9Dl.mjs → manifest-BhrHDm8Y.mjs}

@@ -1,5 +1,5 @@
 import { readPackage } from "pkg-types";
-//#region src/module/constants.ts
+// 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";
@@ -13,8 +13,7 @@ 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
+// src/module/manifest.ts
 const DEFAULT_OPENAPI_ROUTE = "/_openapi.json";
 const ROLE_OPTION_MANAGEMENT_READ = "ROLE_OPTION_MANAGEMENT_READ";
 /**
@@ -85,7 +84,7 @@ async function readPackageJsonFieldsForManifest(rootDir, logger) {
 * 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
+* @param logger - Optional Nitro logger (`nitro.logger`) for debug output
 */
 async function createC8yManifest(rootDir, nitroConfig = {}, logger) {
 	const { options, openApiSpec } = extractManifestInputs(nitroConfig);
@@ -108,8 +107,8 @@ async function createC8yManifest(rootDir, nitroConfig = {}, logger) {
 	}
 	const manifest = {
 		...restManifestFields,
-		...probeFields,
 		...options,
+		...probeFields,
 		...requiredRoles !== void 0 ? { requiredRoles } : {},
 		...openApiSpec ? { openApiSpec } : {},
 		provider,
@@ -131,5 +130,4 @@ async function createC8yManifest(rootDir, nitroConfig = {}, logger) {
 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-Bif4gAIp.mjs → options-CgTptIpI.mjs}

@@ -1,12 +1,12 @@
-import { t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
-import { c as deleteTenantOption, d as getCurrentApplicationSettings, f as getTenantOptionsByCategory, g as upsertTenantOption, o as createBasicAuthHeader } from "./env-CM-t7BwA.mjs";
-import { n as readBootstrapCredentialsFromEnv, r as syncBootstrappedMicroservice } from "./autoBootstrap-CElU3xv-.mjs";
-import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-4Ju9safS.mjs";
+import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-Dozrdw3A.mjs";
+import { c as deleteTenantOption, d as getCurrentApplicationSettings, f as getTenantOptionsByCategory, g as upsertTenantOption, o as createBasicAuthHeader } from "./env-fUAhIWsI.mjs";
+import { n as readBootstrapCredentialsFromEnv, r as syncBootstrappedMicroservice } from "./autoBootstrap-D4vEytWW.mjs";
+import { t as createC8yManifest } from "./manifest-BhrHDm8Y.mjs";
 import process from "node:process";
 import { defineCommand } from "citty";
 import { consola } from "consola";
 import { createInterface } from "node:readline/promises";
-//#region src/cli/commands/options.ts
+// src/cli/commands/options.ts
 var options_default = defineCommand({
 	meta: {
 		name: "options",
@@ -176,5 +176,4 @@ async function handleDelete(ctx) {
 	}
 	consola.success("Delete operation completed");
 }
-//#endregion
 export { options_default as default };

package/dist/{package-WtwC9ClY.mjs → package-y3p_br3i.mjs}

@@ -1,6 +1,5 @@
-//#region package.json
+// package.json
 var name = "c8y-nitro";
-var version = "0.10.4";
+var version = "0.11.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-D08LKKLI.mjs → roles-DEIHe2Xt.mjs}

@@ -1,9 +1,9 @@
-import { t as createC8yManifest } from "./manifest-DV3UW9Dl.mjs";
-import { a as assignUserRole, m as unassignUserRole, o as createBasicAuthHeader } from "./env-CM-t7BwA.mjs";
-import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-4Ju9safS.mjs";
+import { n as validateBootstrapEnv, t as loadC8yConfig } from "./config-Dozrdw3A.mjs";
+import { a as assignUserRole, m as unassignUserRole, o as createBasicAuthHeader } from "./env-fUAhIWsI.mjs";
+import { t as createC8yManifest } from "./manifest-BhrHDm8Y.mjs";
 import { defineCommand } from "citty";
 import { consola } from "consola";
-//#region src/cli/commands/roles.ts
+// src/cli/commands/roles.ts
 var roles_default = defineCommand({
 	meta: {
 		name: "roles",
@@ -35,5 +35,4 @@ var roles_default = defineCommand({
 		} else consola.warn("No roles defined in manifest. Nothing to manage.");
 	}
 });
-//#endregion
 export { roles_default as default };