@cldmv/slothlet 3.1.0 → 3.2.0

package/dist/lib/helpers/config.mjs

@@ -125,7 +125,8 @@ export class Config extends ComponentBase {
 				ownership: false,
 				context: false,
 				initialization: false,
-				materialize: false
+				materialize: false,
+				versioning: false
 			};
 		}
 
@@ -140,7 +141,8 @@ export class Config extends ComponentBase {
 				ownership: true,
 				context: true,
 				initialization: true,
-				materialize: true
+				materialize: true,
+				versioning: true
 			};
 		}
 
@@ -155,7 +157,8 @@ export class Config extends ComponentBase {
 				ownership: debug.ownership || false,
 				context: debug.context || false,
 				initialization: debug.initialization || false,
-				materialize: debug.materialize || false
+				materialize: debug.materialize || false,
+				versioning: debug.versioning || false
 			};
 		}
 
@@ -169,7 +172,8 @@ export class Config extends ComponentBase {
 			ownership: false,
 			context: false,
 			initialization: false,
-			materialize: false
+			materialize: false,
+			versioning: false
 		};
 	}
 
@@ -270,6 +274,16 @@ export class Config extends ComponentBase {
 		}
 
 		
+		if (config.versionDispatcher !== undefined && config.versionDispatcher !== null) {
+			if (typeof config.versionDispatcher !== "string" && typeof config.versionDispatcher !== "function") {
+				throw new this.SlothletError("INVALID_CONFIG_VERSION_DISPATCHER", {
+					received: typeof config.versionDispatcher,
+					validationError: true
+				});
+			}
+		}
+
+		
 		let i18nConfig = null;
 		if (config.i18n && typeof config.i18n === "object") {
 			i18nConfig = {
@@ -300,7 +314,8 @@ export class Config extends ComponentBase {
 			backgroundMaterialize: config.backgroundMaterialize === true,
 			silent: config.silent === true,
 			typescript: this.normalizeTypeScript(config.typescript),
-			env: this.normalizeEnv(config.env)
+			env: this.normalizeEnv(config.env),
+			versionDispatcher: config.versionDispatcher ?? null
 		};
 	}
 

package/dist/lib/i18n/languages/de-de.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "Pfad existiert bereits und Kollisionsmodus ist 'error'",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "Pfad-Segment existiert nicht oder kann nicht durchlaufen werden",
 		"API_PATH_REASON_REQUIRED": "apiPath ist für die removeApi Operation erforderlich",
+		"API_PATH_REASON_VERSIONED_ROOT": "Versionierte API-Komponenten können nicht am Root-Pfad eingehängt werden; geben Sie einen punkt-separierten Pfad an, z. B. 'auth' oder 'v1.auth'",
 		"INVALID_API_PATH": "Ungültiger API-Pfad: '{apiPath}' existiert nicht in der geladenen API.",
 		"HINT_INVALID_API_PATH": "Stellen Sie sicher, dass der API-Pfad existiert, bevor Sie ihn benutzen. Benutzen Sie einen dot-separierten Pfad (z.B. 'math.add'), der auf ein aktuell geladenes Modul verweist.",
 		"HOOKS_NOT_INITIALIZED": "Zugriff auf Hook-Funktionalität nicht möglich: Der Hook-Manager ist nicht initialisiert.",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "Für diese Slothlet-Instanz ist kein Context-Manager konfiguriert.",
 		"HINT_NO_CONTEXT_MANAGER": "Kontext-Operationen erfordern einen Context-Manager. Initialisieren Sie Slothlet mit 'contextManager: new AsyncContextManager()' oder 'contextManager: new LiveContextManager()' in Ihrer Konfiguration.",
 		"UNSUPPORTED_CONTEXT_MANAGER": "Nicht unterstützter Context-Manager: '{manager}'. Nur AsyncContextManager und LiveContextManager werden unterstützt.",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Benutzen Sie AsyncContextManager für asynchrone/ALS-basierten Kontext oder LiveContextManager für synchronen Live-Binding-Kontext."
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Benutzen Sie AsyncContextManager für asynchrone/ALS-basierten Kontext oder LiveContextManager für synchronen Live-Binding-Kontext.",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher muss ein String (Metadatenschlüssel) oder eine Funktion sein; erhalten: {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version muss ein nicht leerer String sein; erhalten: {received}",
+		"VERSION_NOT_FOUND": "Version '{version}' ist unter dem Pfad '{apiPath}' nicht registriert.",
+		"VERSION_NO_DEFAULT": "Für den Pfad '{apiPath}' ist keine Standardversion konfiguriert, und aus den Aufrufer-Metadaten konnte keine Version aufgelöst werden.",
+		"VERSION_DISPATCH_NOT_CALLABLE": "Der versionierte Dispatcher unter '{apiPath}' ist ein Namespace und keine aufrufbare Funktion.",
+		"VERSION_REGISTER_DUPLICATE": "Version '{version}' ist unter dem Pfad '{apiPath}' bereits registriert. Verwenden Sie collisionMode 'replace', um sie zu überschreiben.",
+		"HINT_VERSION_REGISTER_DUPLICATE": "Rufen Sie zuerst api.slothlet.versioning.unregister('{apiPath}', '{version}') auf oder registrieren Sie mit einem anderen Versions-Tag.",
+		"HINT_VERSION_NOT_FOUND": "Rufen Sie api.slothlet.versioning.list('{apiPath}') auf, um zu sehen, welche Versions-Tags derzeit unter diesem Pfad registriert sind.",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "Die Funktion versionDispatcher hat '{returned}' zurückgegeben, was kein für den Pfad '{apiPath}' registriertes Versions-Tag ist.",
+		"DEBUG_VERSION_RESOLVED": "Version aufgelöst: {version} für Pfad {apiPath} (Aufrufer: {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "Keine Discriminator-Übereinstimmung für Pfad {apiPath}; Standardversion {version} wird verwendet.",
+		"DEBUG_VERSION_REGISTERED": "Version {version} unter {logicalPath} registriert (moduleID: {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "Version {version} von {logicalPath} abgemeldet"
 	},
 	"metadata": {
 		"code": "de-de",

package/dist/lib/i18n/languages/en-gb.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "path already exists and collision mode is 'error'",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "path segment does not exist or is not traversable",
 		"API_PATH_REASON_REQUIRED": "apiPath is required for removeApi operation",
+		"API_PATH_REASON_VERSIONED_ROOT": "versioned API components cannot be mounted at the root path; provide a dot-separated path such as 'auth' or 'v1.auth'",
 		"INVALID_API_PATH": "Invalid API path: '{apiPath}' does not exist in the loaded API.",
 		"HINT_INVALID_API_PATH": "Ensure the API path exists before using it. Use a dot-separated path (e.g. 'math.add') that refers to a currently loaded module.",
 		"HOOKS_NOT_INITIALIZED": "Cannot access hook functionality: the hook manager is not initialized.",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "No context manager is configured for this slothlet instance.",
 		"HINT_NO_CONTEXT_MANAGER": "Context operations require a context manager. Initialize slothlet with 'contextManager: new AsyncContextManager()' or 'contextManager: new LiveContextManager()' in your configuration.",
 		"UNSUPPORTED_CONTEXT_MANAGER": "Unsupported context manager: '{manager}'. Only AsyncContextManager and LiveContextManager are supported.",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Use AsyncContextManager for async/ALS-based context isolation or LiveContextManager for synchronous live-binding context."
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Use AsyncContextManager for async/ALS-based context isolation or LiveContextManager for synchronous live-binding context.",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher must be a string (metadata key) or a function, received {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version must be a non-empty string, received {received}",
+		"VERSION_NOT_FOUND": "Version '{version}' is not registered at path '{apiPath}'",
+		"VERSION_NO_DEFAULT": "No default version configured for path '{apiPath}' and no version could be resolved from caller metadata",
+		"VERSION_DISPATCH_NOT_CALLABLE": "The versioned dispatcher at '{apiPath}' is a namespace, not a callable function",
+		"VERSION_REGISTER_DUPLICATE": "Version '{version}' is already registered at path '{apiPath}'. Use collisionMode 'replace' to overwrite",
+		"HINT_VERSION_REGISTER_DUPLICATE": "Call api.slothlet.versioning.unregister('{apiPath}', '{version}') first, or register with a different version tag.",
+		"HINT_VERSION_NOT_FOUND": "Call api.slothlet.versioning.list('{apiPath}') to see which version tags are currently registered at that path.",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "versionDispatcher function returned '{returned}' which is not a registered version tag for path '{apiPath}'",
+		"DEBUG_VERSION_RESOLVED": "Version resolved: {version} for path {apiPath} (caller: {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "No discriminator match for path {apiPath}; using default version {version}",
+		"DEBUG_VERSION_REGISTERED": "Version {version} registered at {logicalPath} (moduleID: {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "Version {version} unregistered from {logicalPath}"
 	},
 	"metadata": {
 		"code": "en-gb",

package/dist/lib/i18n/languages/en-us.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "path already exists and collision mode is 'error'",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "path segment does not exist or is not traversable",
 		"API_PATH_REASON_REQUIRED": "apiPath is required for removeApi operation",
+		"API_PATH_REASON_VERSIONED_ROOT": "versioned API components cannot be mounted at the root path; provide a dot-separated path such as 'auth' or 'v1.auth'",
 		"INVALID_API_PATH": "Invalid API path: '{apiPath}' does not exist in the loaded API.",
 		"HINT_INVALID_API_PATH": "Ensure the API path exists before using it. Use a dot-separated path (e.g. 'math.add') that refers to a currently loaded module.",
 		"HOOKS_NOT_INITIALIZED": "Cannot access hook functionality: the hook manager is not initialized.",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "No context manager is configured for this slothlet instance.",
 		"HINT_NO_CONTEXT_MANAGER": "Context operations require a context manager. Initialize slothlet with 'contextManager: new AsyncContextManager()' or 'contextManager: new LiveContextManager()' in your configuration.",
 		"UNSUPPORTED_CONTEXT_MANAGER": "Unsupported context manager: '{manager}'. Only AsyncContextManager and LiveContextManager are supported.",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Use AsyncContextManager for async/ALS-based context isolation or LiveContextManager for synchronous live-binding context."
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Use AsyncContextManager for async/ALS-based context isolation or LiveContextManager for synchronous live-binding context.",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher must be a string (metadata key) or a function, received {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version must be a non-empty string, received {received}",
+		"VERSION_NOT_FOUND": "Version '{version}' is not registered at path '{apiPath}'",
+		"VERSION_NO_DEFAULT": "No default version configured for path '{apiPath}' and no version could be resolved from caller metadata",
+		"VERSION_DISPATCH_NOT_CALLABLE": "The versioned dispatcher at '{apiPath}' is a namespace, not a callable function",
+		"VERSION_REGISTER_DUPLICATE": "Version '{version}' is already registered at path '{apiPath}'. Use collisionMode 'replace' to overwrite",
+		"HINT_VERSION_REGISTER_DUPLICATE": "Call api.slothlet.versioning.unregister('{apiPath}', '{version}') first, or register with a different version tag.",
+		"HINT_VERSION_NOT_FOUND": "Call api.slothlet.versioning.list('{apiPath}') to see which version tags are currently registered at that path.",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "versionDispatcher function returned '{returned}' which is not a registered version tag for path '{apiPath}'",
+		"DEBUG_VERSION_RESOLVED": "Version resolved: {version} for path {apiPath} (caller: {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "No discriminator match for path {apiPath}; using default version {version}",
+		"DEBUG_VERSION_REGISTERED": "Version {version} registered at {logicalPath} (moduleID: {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "Version {version} unregistered from {logicalPath}"
 	},
 	"metadata": {
 		"code": "en-us",

package/dist/lib/i18n/languages/es-mx.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "la ruta ya existe y el modo de colisión es 'error'",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "el segmento de ruta no existe o no se puede recorrer",
 		"API_PATH_REASON_REQUIRED": "apiPath es obligatorio para la operación removeApi",
+		"API_PATH_REASON_VERSIONED_ROOT": "Los componentes API versionados no pueden montarse en la ruta raíz; proporcione una ruta separada por puntos como 'auth' o 'v1.auth'",
 		"INVALID_API_PATH": "Ruta de API inválida: '{apiPath}' no existe en la API cargada.",
 		"HINT_INVALID_API_PATH": "Asegúrese de que la ruta de la API existe antes de usarla. Use una ruta separada por puntos (ej. 'math.add') que se refiera a un módulo cargado actualmente.",
 		"HOOKS_NOT_INITIALIZED": "No se puede acceder a la funcionalidad de ganchos: el gestor de ganchos no está inicializado.",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "No se ha configurado ningún gestor de contexto para esta instancia de slothlet.",
 		"HINT_NO_CONTEXT_MANAGER": "Las operaciones de contexto requieren un gestor de contexto. Inicialice slothlet con 'contextManager: new AsyncContextManager()' o 'contextManager: new LiveContextManager()' en su configuración.",
 		"UNSUPPORTED_CONTEXT_MANAGER": "Gestor de contexto no soportado: '{manager}'. Solo se soportan AsyncContextManager y LiveContextManager.",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Use AsyncContextManager para aislamiento de contexto basado en async/ALS o LiveContextManager para contexto de enlace en vivo síncrono."
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Use AsyncContextManager para aislamiento de contexto basado en async/ALS o LiveContextManager para contexto de enlace en vivo síncrono.",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher debe ser una cadena (clave de metadatos) o una función; recibido: {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version debe ser una cadena no vacía; recibido: {received}",
+		"VERSION_NOT_FOUND": "La versión '{version}' no está registrada en la ruta '{apiPath}'.",
+		"VERSION_NO_DEFAULT": "No hay versión predeterminada configurada para la ruta '{apiPath}' y no se pudo resolver ninguna versión desde los metadatos del llamador.",
+		"VERSION_DISPATCH_NOT_CALLABLE": "El despachador versionado en '{apiPath}' es un namespace, no una función invocable.",
+		"VERSION_REGISTER_DUPLICATE": "La versión '{version}' ya está registrada en la ruta '{apiPath}'. Use collisionMode 'replace' para sobrescribir.",
+		"HINT_VERSION_REGISTER_DUPLICATE": "Llame primero a api.slothlet.versioning.unregister('{apiPath}', '{version}') o regístrela con una etiqueta de versión diferente.",
+		"HINT_VERSION_NOT_FOUND": "Llame a api.slothlet.versioning.list('{apiPath}') para ver qué etiquetas de versión están actualmente registradas en esa ruta.",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "La función versionDispatcher devolvió '{returned}', que no es una etiqueta de versión registrada para la ruta '{apiPath}'.",
+		"DEBUG_VERSION_RESOLVED": "Versión resuelta: {version} para la ruta {apiPath} (llamador: {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "Sin coincidencia del discriminador para la ruta {apiPath}; se usa la versión predeterminada {version}.",
+		"DEBUG_VERSION_REGISTERED": "Versión {version} registrada en {logicalPath} (moduleID: {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "Versión {version} dada de baja de {logicalPath}"
 	},
 	"metadata": {
 		"code": "es-mx",

package/dist/lib/i18n/languages/fr-fr.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "le chemin existe déjà et le mode de collision est 'error'",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "le segment de chemin n'existe pas ou n'est pas traversable",
 		"API_PATH_REASON_REQUIRED": "apiPath est requis pour l'opération removeApi",
+		"API_PATH_REASON_VERSIONED_ROOT": "Les composants API versionnés ne peuvent pas être montés à la racine ; fournissez un chemin séparé par des points, tel que 'auth' ou 'v1.auth'",
 		"INVALID_API_PATH": "Chemin d'API invalide : '{apiPath}' n'existe pas dans l'API chargée.",
 		"HINT_INVALID_API_PATH": "Assurez-vous que le chemin d'API existe avant de l'utiliser. Utilisez un chemin séparé par des points (ex : 'math.add') qui fait référence à un module actuellement chargé.",
 		"HOOKS_NOT_INITIALIZED": "Impossible d'accéder aux fonctionnalités de hook : le gestionnaire de hook n'est pas initialisé.",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "Aucun gestionnaire de contexte n'est configuré pour cette instance Slothlet.",
 		"HINT_NO_CONTEXT_MANAGER": "Les opérations de contexte nécessitent un gestionnaire de contexte. Initialisez Slothlet avec 'contextManager: new AsyncContextManager()' ou 'contextManager: new LiveContextManager()' dans votre configuration.",
 		"UNSUPPORTED_CONTEXT_MANAGER": "Gestionnaire de contexte non supporté : '{manager}'. Seuls AsyncContextManager et LiveContextManager sont supportés.",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Utilisez AsyncContextManager pour l'isolation de contexte basée sur l'async/ALS ou LiveContextManager pour un contexte de live-binding synchrone."
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Utilisez AsyncContextManager pour l'isolation de contexte basée sur l'async/ALS ou LiveContextManager pour un contexte de live-binding synchrone.",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher doit être une chaîne (clé de métadonnées) ou une fonction ; reçu : {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version doit être une chaîne non vide ; reçu : {received}",
+		"VERSION_NOT_FOUND": "La version '{version}' n'est pas enregistrée au chemin '{apiPath}'.",
+		"VERSION_NO_DEFAULT": "Aucune version par défaut configurée pour le chemin '{apiPath}' et aucune version n'a pu être résolue depuis les métadonnées de l'appelant.",
+		"VERSION_DISPATCH_NOT_CALLABLE": "Le dispatcher versionné à '{apiPath}' est un espace de noms, pas une fonction appelable.",
+		"VERSION_REGISTER_DUPLICATE": "La version '{version}' est déjà enregistrée au chemin '{apiPath}'. Utilisez collisionMode 'replace' pour écraser.",
+		"HINT_VERSION_REGISTER_DUPLICATE": "Appelez d'abord api.slothlet.versioning.unregister('{apiPath}', '{version}') ou enregistrez avec un tag de version différent.",
+		"HINT_VERSION_NOT_FOUND": "Appelez api.slothlet.versioning.list('{apiPath}') pour voir quels tags de version sont actuellement enregistrés à ce chemin.",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "La fonction versionDispatcher a retourné '{returned}', qui n'est pas un tag de version enregistré pour le chemin '{apiPath}'.",
+		"DEBUG_VERSION_RESOLVED": "Version résolue : {version} pour le chemin {apiPath} (appelant : {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "Aucune correspondance de discriminateur pour le chemin {apiPath} ; utilisation de la version par défaut {version}.",
+		"DEBUG_VERSION_REGISTERED": "Version {version} enregistrée à {logicalPath} (moduleID : {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "Version {version} désinscrite de {logicalPath}"
 	},
 	"metadata": {
 		"code": "fr-fr",

package/dist/lib/i18n/languages/hi-in.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "पथ पहले से मौजूद है और टकराव मोड 'error' है",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "पथ खंड मौजूद नहीं है या पार करने योग्य नहीं है",
 		"API_PATH_REASON_REQUIRED": "removeApi ऑपरेशन के लिए apiPath आवश्यक है",
+		"API_PATH_REASON_VERSIONED_ROOT": "संस्करणित API घटकों को रूट पथ पर माउंट नहीं किया जा सकता, इसके बजाय 'auth' या 'v1.auth' जैसा डॉट-अलग पथ प्रदान करें",
 		"INVALID_API_PATH": "अमान्य API पथ: लोड की गई API में '{apiPath}' मौजूद नहीं है।",
 		"HINT_INVALID_API_PATH": "उपयोग करने से पहले सुनिश्चित करें कि API पथ मौजूद है। डॉट-सेपरेटेड पथ (उदा. 'math.add') का उपयोग करें जो वर्तमान में लोड किए गए मॉड्यूल को संदर्भित करता है।",
 		"HOOKS_NOT_INITIALIZED": "हुक कार्यक्षमता तक नहीं पहुँचा जा सकता: हुक मैनेजर प्रारंभ नहीं किया गया है।",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "इस slothlet इंस्टेंस के लिए कोई संदर्भ प्रबंधक (context manager) कॉन्फ़िगर नहीं है।",
 		"HINT_NO_CONTEXT_MANAGER": "संदर्भ संचालन के लिए एक संदर्भ प्रबंधक की आवश्यकता होती है। अपने कॉन्फ़िगरेशन में 'contextManager: new AsyncContextManager()' या 'contextManager: new LiveContextManager()' के साथ slothlet प्रारंभ करें।",
 		"UNSUPPORTED_CONTEXT_MANAGER": "असमर्थित संदर्भ प्रबंधक: '{manager}'। केवल AsyncContextManager और LiveContextManager समर्थित हैं।",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "एसिंक/ALS-आधारित संदर्भ अलगाव के लिए AsyncContextManager या सिंक्रोनस लाइव-बाइंडिंग संदर्भ के लिए LiveContextManager का उपयोग करें।"
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "एसिंक/ALS-आधारित संदर्भ अलगाव के लिए AsyncContextManager या सिंक्रोनस लाइव-बाइंडिंग संदर्भ के लिए LiveContextManager का उपयोग करें।",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher एक स्ट्रिंग (मेटाडेटा कुंजी) या फ़ंक्शन होना चाहिए; प्राप्त: {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version एक गैर-रिक्त स्ट्रिंग होनी चाहिए; प्राप्त: {received}",
+		"VERSION_NOT_FOUND": "संस्करण '{version}' पथ '{apiPath}' पर पंजीकृत नहीं है।",
+		"VERSION_NO_DEFAULT": "पथ '{apiPath}' के लिए कोई डिफ़ॉल्ट संस्करण कॉन्फ़िगर नहीं किया गया है और कॉलर मेटाडेटा से कोई संस्करण हल नहीं किया जा सका।",
+		"VERSION_DISPATCH_NOT_CALLABLE": "'{apiPath}' पर वर्शन Dispatcher एक namespace है, कॉल करने योग्य फ़ंक्शन नहीं।",
+		"VERSION_REGISTER_DUPLICATE": "संस्करण '{version}' पहले से ही पथ '{apiPath}' पर पंजीकृत है। अधिलेखित करने के लिए collisionMode 'replace' का उपयोग करें।",
+		"HINT_VERSION_REGISTER_DUPLICATE": "पहले api.slothlet.versioning.unregister('{apiPath}', '{version}') को कॉल करें या किसी भिन्न संस्करण टैग के साथ पंजीकृत करें।",
+		"HINT_VERSION_NOT_FOUND": "api.slothlet.versioning.list('{apiPath}') को कॉल करें यह देखने के लिए कि उस पथ पर कौन से संस्करण टैग वर्तमान में पंजीकृत हैं।",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "versionDispatcher फ़ंक्शन ने '{returned}' लौटाया, जो पथ '{apiPath}' के लिए पंजीकृत संस्करण टैग नहीं है।",
+		"DEBUG_VERSION_RESOLVED": "संस्करण हल किया गया: {version}, पथ: {apiPath} (कॉलर: {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "पथ {apiPath} के लिए कोई Discriminator मिलान नहीं; डिफ़ॉल्ट संस्करण {version} का उपयोग किया जा रहा है।",
+		"DEBUG_VERSION_REGISTERED": "संस्करण {version} को {logicalPath} पर पंजीकृत किया गया (moduleID: {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "संस्करण {version} को {logicalPath} से हटाया गया"
 	},
 	"metadata": {
 		"code": "hi-in",

package/dist/lib/i18n/languages/ja-jp.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "パスが既に存在し、衝突モードが 'error' です",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "パスセグメントが存在しないか、探索不可能です",
 		"API_PATH_REASON_REQUIRED": "removeApi 操作には apiPath が必要です",
+		"API_PATH_REASON_VERSIONED_ROOT": "バージョン管理された API コンポーネントはルートパスにマウントできません。'auth' や 'v1.auth' のようなドット区切りのパスを指定してください",
 		"INVALID_API_PATH": "無効な API パス: '{apiPath}' は読み込まれた API 内に存在しません。",
 		"HINT_INVALID_API_PATH": "API パスを使用する前に存在することを確認してください。現在読み込まれているモジュールを参照するドット区切りのパス (例: 'math.add') を使用してください。",
 		"HOOKS_NOT_INITIALIZED": "フック機能にアクセスできません: フックマネージャーが初期化されていません。",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "この Slothlet インスタンスにはコンテキストマネージャーが構成されていません。",
 		"HINT_NO_CONTEXT_MANAGER": "コンテキスト操作にはコンテキストマネージャーが必要です。構成時に 'contextManager: new AsyncContextManager()' または 'contextManager: new LiveContextManager()' を使って Slothlet を初期化してください。",
 		"UNSUPPORTED_CONTEXT_MANAGER": "サポートされていないコンテキストマネージャー: '{manager}' です。 AsyncContextManager と LiveContextManager のみがサポートされています。",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "async/ALS ベースのコンテキスト分離には AsyncContextManager を、同期的な live-binding コンテキストには LiveContextManager を使用してください。"
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "async/ALS ベースのコンテキスト分離には AsyncContextManager を、同期的な live-binding コンテキストには LiveContextManager を使用してください。",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher は文字列（メタデータキー）または関数である必要があります。受信値: {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version は空でない文字列である必要があります。受信値: {received}",
+		"VERSION_NOT_FOUND": "バージョン '{version}' はパス '{apiPath}' に登録されていません。",
+		"VERSION_NO_DEFAULT": "パス '{apiPath}' にデフォルトバージョンが設定されておらず、呼び出し元メタデータからバージョンを解決できませんでした。",
+		"VERSION_DISPATCH_NOT_CALLABLE": "'{apiPath}' のバージョン Dispatcher は名前空間であり、呼び出し可能な関数ではありません。",
+		"VERSION_REGISTER_DUPLICATE": "バージョン '{version}' はすでにパス '{apiPath}' に登録されています。上書きするには collisionMode 'replace' を使用してください。",
+		"HINT_VERSION_REGISTER_DUPLICATE": "最初に api.slothlet.versioning.unregister('{apiPath}', '{version}') を呼び出すか、別のバージョンタグで登録してください。",
+		"HINT_VERSION_NOT_FOUND": "api.slothlet.versioning.list('{apiPath}') を呼び出して、そのパスに現在登録されているバージョンタグを確認してください。",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "versionDispatcher 関数が '{returned}' を返しましたが、これはパス '{apiPath}' の登録済みバージョンタグではありません。",
+		"DEBUG_VERSION_RESOLVED": "バージョン解決済み: {version}、パス: {apiPath}（呼び出し元: {callerModule}）",
+		"DEBUG_VERSION_DEFAULT_USED": "パス {apiPath} の Discriminator に一致なし。デフォルトバージョン {version} を使用します。",
+		"DEBUG_VERSION_REGISTERED": "バージョン {version} が {logicalPath} に登録されました（moduleID: {moduleID}）",
+		"DEBUG_VERSION_UNREGISTERED": "バージョン {version} が {logicalPath} から登録解除されました"
 	},
 	"metadata": {
 		"code": "ja-jp",

package/dist/lib/i18n/languages/ko-kr.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "경로가 이미 존재하고 충돌 모드가 'error'임",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "경로 세그먼트가 존재하지 않거나 탐색할 수 없음",
 		"API_PATH_REASON_REQUIRED": "removeApi 작업에 apiPath가 필요함",
+		"API_PATH_REASON_VERSIONED_ROOT": "버전이 지정된 API 컴포넌트는 루트 경로에 마운트할 수 없습니다. 'auth' 또는 'v1.auth'와 같이 점으로 구분된 경로를 제공하세요",
 		"INVALID_API_PATH": "유효하지 않은 API 경로: 로드된 API에 '{apiPath}'이(가) 존재하지 않습니다.",
 		"HINT_INVALID_API_PATH": "API 경로가 사용 전에 존재하는지 확인하십시오. 현재 로드된 모듈을 가리키는 점 구분 경로(예: 'math.add')를 사용하십시오.",
 		"HOOKS_NOT_INITIALIZED": "후크 기능에 액세스할 수 없습니다: 후크 관리자가 초기화되지 않았습니다.",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "이 Slothlet 인스턴스에 설정된 컨텍스트 관리자가 없습니다.",
 		"HINT_NO_CONTEXT_MANAGER": "컨텍스트 작업에는 컨텍스트 관리자가 필요합니다. 설정 시 'contextManager: new AsyncContextManager()' 또는 'contextManager: new LiveContextManager()'로 Slothlet을 초기화하십시오.",
 		"UNSUPPORTED_CONTEXT_MANAGER": "지원되지 않는 컨텍스트 관리자: '{manager}'. AsyncContextManager와 LiveContextManager만 지원됩니다.",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "비동기/ALS 기반 컨텍스트 격리는 AsyncContextManager를, 동기식 라이브 데이터 바인딩 컨텍스트에는 LiveContextManager를 사용하십시오."
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "비동기/ALS 기반 컨텍스트 격리는 AsyncContextManager를, 동기식 라이브 데이터 바인딩 컨텍스트에는 LiveContextManager를 사용하십시오.",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher는 문자열(메타데이터 키) 또는 함수여야 합니다. 수신됨: {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version은 비어 있지 않은 문자열이어야 합니다. 수신됨: {received}",
+		"VERSION_NOT_FOUND": "버전 '{version}'은(는) 경로 '{apiPath}'에 등록되지 않았습니다.",
+		"VERSION_NO_DEFAULT": "경로 '{apiPath}'에 대한 기본 버전이 구성되지 않았으며, 호출자 메타데이터에서 버전을 해석할 수 없습니다.",
+		"VERSION_DISPATCH_NOT_CALLABLE": "'{apiPath}'의 버전 Dispatcher는 네임스페이스이며 호출 가능한 함수가 아닙니다.",
+		"VERSION_REGISTER_DUPLICATE": "버전 '{version}'은(는) 이미 경로 '{apiPath}'에 등록되어 있습니다. 덮어쓰려면 collisionMode 'replace'를 사용하세요.",
+		"HINT_VERSION_REGISTER_DUPLICATE": "먼저 api.slothlet.versioning.unregister('{apiPath}', '{version}')를 호출하거나 다른 버전 태그로 등록하세요.",
+		"HINT_VERSION_NOT_FOUND": "api.slothlet.versioning.list('{apiPath}')를 호출하여 해당 경로에 현재 등록된 버전 태그를 확인하세요.",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "versionDispatcher 함수가 '{returned}'를 반환했는데, 이는 경로 '{apiPath}'에 등록된 버전 태그가 아닙니다.",
+		"DEBUG_VERSION_RESOLVED": "버전 해석됨: {version}, 경로: {apiPath} (호출자: {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "경로 {apiPath}에 대한 Discriminator 일치 없음; 기본 버전 {version}을(를) 사용합니다.",
+		"DEBUG_VERSION_REGISTERED": "버전 {version}이(가) {logicalPath}에 등록됨 (moduleID: {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "버전 {version}이(가) {logicalPath}에서 등록 취소됨"
 	},
 	"metadata": {
 		"code": "ko-kr",

package/dist/lib/i18n/languages/pt-br.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "o caminho já existe e o modo de colisão é 'error'",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "o segmento do caminho não existe ou não é atravessável",
 		"API_PATH_REASON_REQUIRED": "apiPath é obrigatório para a operação removeApi",
+		"API_PATH_REASON_VERSIONED_ROOT": "Componentes de API versionados não podem ser montados no caminho raiz; forneça um caminho separado por pontos como 'auth' ou 'v1.auth'",
 		"INVALID_API_PATH": "Caminho de API inválido: '{apiPath}' não existe na API carregada.",
 		"HINT_INVALID_API_PATH": "Certifique-se de que o caminho da API existe antes de usá-lo. Use um caminho separado por pontos (ex: 'math.add') que se refira a um módulo carregado no momento.",
 		"HOOKS_NOT_INITIALIZED": "Não é possível acessar a funcionalidade de gancho (hook): o gerenciador de ganchos não foi inicializado.",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "Nenhum gerenciador de contexto está configurado para esta instância do slothlet.",
 		"HINT_NO_CONTEXT_MANAGER": "As operações de contexto requerem um gerenciador de contexto. Inicialize o slothlet com 'contextManager: new AsyncContextManager()' ou 'contextManager: new LiveContextManager()' em sua configuração.",
 		"UNSUPPORTED_CONTEXT_MANAGER": "Gerenciador de contexto não suportado: '{manager}'. Apenas AsyncContextManager e LiveContextManager são suportados.",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Use AsyncContextManager para isolamento de contexto baseado em async/ALS ou LiveContextManager para contexto síncrono de live-binding."
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Use AsyncContextManager para isolamento de contexto baseado em async/ALS ou LiveContextManager para contexto síncrono de live-binding.",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher deve ser uma string (chave de metadados) ou uma função; recebido: {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version deve ser uma string não vazia; recebido: {received}",
+		"VERSION_NOT_FOUND": "A versão '{version}' não está registrada no caminho '{apiPath}'.",
+		"VERSION_NO_DEFAULT": "Nenhuma versão padrão configurada para o caminho '{apiPath}' e nenhuma versão pôde ser resolvida a partir dos metadados do chamador.",
+		"VERSION_DISPATCH_NOT_CALLABLE": "O despachante versionado em '{apiPath}' é um namespace, não uma função invocável.",
+		"VERSION_REGISTER_DUPLICATE": "A versão '{version}' já está registrada no caminho '{apiPath}'. Use collisionMode 'replace' para sobrescrever.",
+		"HINT_VERSION_REGISTER_DUPLICATE": "Chame api.slothlet.versioning.unregister('{apiPath}', '{version}') primeiro ou registre com uma tag de versão diferente.",
+		"HINT_VERSION_NOT_FOUND": "Chame api.slothlet.versioning.list('{apiPath}') para ver quais tags de versão estão atualmente registradas nesse caminho.",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "A função versionDispatcher retornou '{returned}', que não é uma tag de versão registrada para o caminho '{apiPath}'.",
+		"DEBUG_VERSION_RESOLVED": "Versão resolvida: {version} para o caminho {apiPath} (chamador: {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "Nenhuma correspondência de discriminador para o caminho {apiPath}; usando versão padrão {version}.",
+		"DEBUG_VERSION_REGISTERED": "Versão {version} registrada em {logicalPath} (moduleID: {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "Versão {version} removida de {logicalPath}"
 	},
 	"metadata": {
 		"code": "pt-br",

package/dist/lib/i18n/languages/ru-ru.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "Путь уже существует и режим столкновения 'error'",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "Сегмент пути не существует или не может быть пройден",
 		"API_PATH_REASON_REQUIRED": "apiPath обязателен для операции removeApi",
+		"API_PATH_REASON_VERSIONED_ROOT": "Версионированные API-компоненты нельзя монтировать в корневом пути; укажите путь через точку, например 'auth' или 'v1.auth'",
 		"INVALID_API_PATH": "Неверный API-путь: '{apiPath}' не существует в загруженной API.",
 		"HINT_INVALID_API_PATH": "Убедитесь, что путь API существует перед использованием. Используйте точечную нотацию, напр. 'math.add'.",
 		"HOOKS_NOT_INITIALIZED": "Невозможно использовать hooks: менеджер hook не инициализирован.",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "Для этого экземпляра Slothlet не настроен менеджер контекста.",
 		"HINT_NO_CONTEXT_MANAGER": "Инициализируйте Slothlet с 'contextManager: new AsyncContextManager()' или 'new LiveContextManager()'.",
 		"UNSUPPORTED_CONTEXT_MANAGER": "Неподдерживаемый менеджер контекста: '{manager}'. Поддерживаются AsyncContextManager и LiveContextManager.",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Используйте AsyncContextManager для async/ALS или LiveContextManager для live-binding."
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "Используйте AsyncContextManager для async/ALS или LiveContextManager для live-binding.",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher должен быть строкой (ключ метаданных) или функцией; получено: {received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version должен быть непустой строкой; получено: {received}",
+		"VERSION_NOT_FOUND": "Версия '{version}' не зарегистрирована по пути '{apiPath}'.",
+		"VERSION_NO_DEFAULT": "Для пути '{apiPath}' не настроена версия по умолчанию, и версия не может быть определена из метаданных вызывающего.",
+		"VERSION_DISPATCH_NOT_CALLABLE": "Версионированный диспетчер по пути '{apiPath}' является пространством имён, а не вызываемой функцией.",
+		"VERSION_REGISTER_DUPLICATE": "Версия '{version}' уже зарегистрирована по пути '{apiPath}'. Используйте collisionMode 'replace' для замены.",
+		"HINT_VERSION_REGISTER_DUPLICATE": "Сначала вызовите api.slothlet.versioning.unregister('{apiPath}', '{version}') или зарегистрируйте с другим тегом версии.",
+		"HINT_VERSION_NOT_FOUND": "Вызовите api.slothlet.versioning.list('{apiPath}'), чтобы увидеть, какие теги версий зарегистрированы по этому пути.",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "Функция versionDispatcher вернула '{returned}', что не является зарегистрированным тегом версии для пути '{apiPath}'.",
+		"DEBUG_VERSION_RESOLVED": "Версия определена: {version} для пути {apiPath} (вызывающий: {callerModule})",
+		"DEBUG_VERSION_DEFAULT_USED": "Нет совпадения дискриминатора для пути {apiPath}; используется версия по умолчанию {version}.",
+		"DEBUG_VERSION_REGISTERED": "Версия {version} зарегистрирована в {logicalPath} (moduleID: {moduleID})",
+		"DEBUG_VERSION_UNREGISTERED": "Версия {version} удалена из {logicalPath}"
 	},
 	"metadata": {
 		"code": "ru-ru",

package/dist/lib/i18n/languages/zh-cn.json

@@ -358,6 +358,7 @@
 		"API_PATH_REASON_COLLISION_ERROR": "路径已存在且冲突模式为 'error'",
 		"API_PATH_REASON_NOT_TRAVERSABLE": "路径段不存在或不可遍历",
 		"API_PATH_REASON_REQUIRED": "removeApi 操作需要指定 apiPath",
+		"API_PATH_REASON_VERSIONED_ROOT": "已版本化的 API 组件不能挂载在根路径下；请提供以点分隔的路径，例如 'auth' 或 'v1.auth'",
 		"INVALID_API_PATH": "无效的 API 路径：'{apiPath}' 在已加载的 API 中不存在。",
 		"HINT_INVALID_API_PATH": "在使用前确保 API 路径存在。使用点分写法（例如 'math.add'）指向当前已加载的模块。",
 		"HOOKS_NOT_INITIALIZED": "无法访问钩子功能：钩子管理器未初始化。",
@@ -367,7 +368,20 @@
 		"NO_CONTEXT_MANAGER": "此 slothlet 实例未配置上下文管理器。",
 		"HINT_NO_CONTEXT_MANAGER": "上下文操作需要上下文管理器。在配置中初始化 slothlet，例如 'contextManager: new AsyncContextManager()' 或 'contextManager: new LiveContextManager()'。",
 		"UNSUPPORTED_CONTEXT_MANAGER": "不支持的上下文管理器：'{manager}'。仅支持 AsyncContextManager 和 LiveContextManager。",
-		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "对异步/ALS 上下文隔离使用 AsyncContextManager，对同步实时绑定上下文使用 LiveContextManager。"
+		"HINT_UNSUPPORTED_CONTEXT_MANAGER": "对异步/ALS 上下文隔离使用 AsyncContextManager，对同步实时绑定上下文使用 LiveContextManager。",
+		"INVALID_CONFIG_VERSION_DISPATCHER": "config.versionDispatcher 必须是字符串（元数据键）或函数；收到：{received}",
+		"INVALID_CONFIG_VERSION_TAG": "versionConfig.version 必须是非空字符串；收到：{received}",
+		"VERSION_NOT_FOUND": "版本 '{version}' 未在路径 '{apiPath}' 注册。",
+		"VERSION_NO_DEFAULT": "路径 '{apiPath}' 未配置默认版本，且无法从调用方元数据中解析版本。",
+		"VERSION_DISPATCH_NOT_CALLABLE": "'{apiPath}' 处的版本调度器是命名空间，不是可调用函数。",
+		"VERSION_REGISTER_DUPLICATE": "版本 '{version}' 已在路径 '{apiPath}' 注册。使用 collisionMode 'replace' 覆盖。",
+		"HINT_VERSION_REGISTER_DUPLICATE": "请先调用 api.slothlet.versioning.unregister('{apiPath}', '{version}')，或使用不同的版本标签注册。",
+		"HINT_VERSION_NOT_FOUND": "调用 api.slothlet.versioning.list('{apiPath}') 查看当前在该路径注册的版本标签。",
+		"VERSION_DISCRIMINATOR_INVALID_RETURN": "versionDispatcher 函数返回了 '{returned}'，它不是路径 '{apiPath}' 的已注册版本标签。",
+		"DEBUG_VERSION_RESOLVED": "已解析版本：{version}，路径：{apiPath}（调用方：{callerModule}）",
+		"DEBUG_VERSION_DEFAULT_USED": "路径 {apiPath} 无匹配判别器；使用默认版本 {version}。",
+		"DEBUG_VERSION_REGISTERED": "版本 {version} 已在 {logicalPath} 注册（moduleID：{moduleID}）",
+		"DEBUG_VERSION_UNREGISTERED": "版本 {version} 已从 {logicalPath} 注销"
 	},
 	"metadata": {
 		"code": "zh-cn",

package/dist/slothlet.mjs

@@ -23,6 +23,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { getContextManager } from "@cldmv/slothlet/factories/context";
 import { SlothletError, SlothletWarning, SlothletDebug } from "@cldmv/slothlet/errors";
 import { registerInstance } from "@cldmv/slothlet/handlers/lifecycle-token";
+import { resolveWrapper } from "@cldmv/slothlet/handlers/unified-wrapper";
 import { initI18n } from "@cldmv/slothlet/i18n";
 import {
 	enableEventEmitterPatching,
@@ -596,7 +597,8 @@ class Slothlet {
 					
 					
 					options: { ...(operation.options || {}), recordHistory: false },
-					moduleID: `replay_${this.helpers.utilities.generateId().substring(0, 8)}` 
+					moduleID: `replay_${this.helpers.utilities.generateId().substring(0, 8)}`, 
+					versionConfig: operation.versionConfig || null
 				});
 				
 				
@@ -662,12 +664,76 @@ class Slothlet {
 	}
 
 	
+	async _drainInFlightLoads() {
+		if (!this.api) return;
+
+		const pending = [];
+		const seen = new Set();
+
+		
+		const collect = (obj, depth = 0) => {
+			
+			
+			
+			
+			const objType = typeof obj;
+			if (!obj || (objType !== "object" && objType !== "function") || depth > 15 || seen.has(obj)) return;
+			seen.add(obj);
+
+			try {
+				
+				if (obj.__isVersionDispatcher === true) return;
+
+				
+				
+				
+				
+				const wrapper = resolveWrapper(obj);
+				if (wrapper) {
+					const mat = wrapper.____slothletInternal.materializationPromise;
+					if (mat) pending.push(mat);
+
+					
+					
+					
+					
+					
+					for (const key of Object.keys(wrapper)) {
+						if (!key.startsWith("____")) collect(wrapper[key], depth + 1);
+					}
+					return;
+				}
+
+				for (const key of Object.keys(obj)) {
+					collect(obj[key], depth + 1);
+				}
+			} catch {
+				
+				
+			}
+		};
+
+		for (const key of Object.keys(this.api)) {
+			collect(this.api[key]);
+		}
+
+		if (pending.length > 0) {
+			await Promise.allSettled(pending);
+		}
+	}
+
+	
 	async shutdown() {
 		if (!this.isLoaded) {
 			return;
 		}
 
 		
+		
+		
+		await this._drainInFlightLoads();
+
+		
 		disableEventEmitterPatching();
 		cleanupEventEmitterResources();
 
@@ -684,6 +750,9 @@ class Slothlet {
 		}
 
 		
+		this.handlers.versionManager?.shutdown();
+
+		
 		
 		this.isLoaded = false;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cldmv/slothlet",
-	"version": "3.1.0",
+	"version": "3.2.0",
 	"moduleVersions": {
 		"lazy": "3.0.0",
 		"eager": "3.0.0",
@@ -125,6 +125,7 @@
 		"vitest": "node tests/vitests/run-all-vitest.mjs --workers 8",
 		"baseline": "npm run vitest -- --baseline",
 		"coverage": "npm run vitest -- --coverage-quiet",
+		"ci:coverage": "npm run coverage",
 		"test": "npm run test:pre-build",
 		"test:pre-build": "node tests/test-conditional.mjs",
 		"test:post-build": "npm run test:types",
@@ -132,6 +133,7 @@
 		"test:node": "node tests/run-all-tests.mjs",
 		"test:all": "node tests/test-conditional.mjs && npm run test:node",
 		"test:types": "node tests/validate-typescript.mjs",
+		"ci:test:types": "npm run build:dist && npm run build:types && npm run test:types",
 		"test:performance": "node tests/performance/performance-benchmark-aggregated.mjs",
 		"test:performance-simple": "node tests/performance/performance-benchmark.mjs",
 		"lint": "eslint --config .configs/eslint.config.mjs .",
@@ -141,7 +143,8 @@
 		"fix:headers": "node tools/dev/fix-headers.mjs",
 		"build": "npm run build:dev",
 		"build:ci": "npm run build:cleanup && npm run build:dist && npm run build:types && npm run build:exports && npm run test:types && npm run build:prepend-license && npm run ci:cleanup-src",
-		"build:dev": "npm run build:cleanup && npm run build:dist && npm run build:types && npm run build:exports && npm run test:types && npm run build:prepend-license && npm run build:cleanup",
+		"build:dev": "npm run build:cleanup && npm run build:dist && npm run build:types && npm run build:exports && npm run test:types && npm run build:prepend-license",
+		"build:dev:test": "npm run build:cleanup && npm run build:dist && npm run build:types && npm run build:exports && npm run test:types && npm run build:prepend-license && npm run build:cleanup",
 		"build:unsafe": "npm run build:cleanup && npm run build:dist && npm run build:types && npm run build:exports && npm run test:types && npm run build:prepend-license",
 		"ci:cleanup-src": "node tools/ci/ci-cleanup-src.mjs",
 		"build:cleanup": "shx rm -rf types && shx rm -rf dist",

package/types/dist/lib/builders/api_builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"api_builder.d.mts","sourceRoot":"","sources":["../../../../dist/lib/builders/api_builder.mjs"],"names":[],"mappings":"AAkEA;;;;;;;;;;;;;GAaG;AACH;IACC,gCAAuC;IAcvC;;;;;OAKG;IACH,oCAHa,OAAO,KAAQ,CAiG3B;IAED;;;;;;;;;;;OAWG;IACH,gCAijCC;IAED;;;;OAIG;IACH,+BAYC;IAED;;;;OAIG;IACH,0BAgCC;IAED;;;;OAIG;IACH,4BAoMC;IAED;;;;;OAKG;IACH,8BAyCC;IAED;;;;;OAKG;IACH,uBAgCC;CACD;;;;;;;;;;;;;;;;;;;;;;;;;;8BAtkD6B,0CAA0C"}
+{"version":3,"file":"api_builder.d.mts","sourceRoot":"","sources":["../../../../dist/lib/builders/api_builder.mjs"],"names":[],"mappings":"AAyEA;;;;;;;;;;;;;GAaG;AACH;IACC,gCAAuC;IAcvC;;;;;OAKG;IACH,oCAHa,OAAO,KAAQ,CAiG3B;IAED;;;;;;;;;;;OAWG;IACH,gCA2uCC;IAED;;;;OAIG;IACH,+BAYC;IAED;;;;OAIG;IACH,0BAgCC;IAED;;;;OAIG;IACH,4BAoMC;IAED;;;;;OAKG;IACH,8BAyCC;IAED;;;;;OAKG;IACH,uBAgCC;CACD;;;;;;;;;;;;;;;;;;;;;;;;;;8BAvwD6B,0CAA0C"}

package/types/dist/lib/handlers/api-manager.d.mts

@@ -273,6 +273,34 @@ export class ApiManager extends ComponentBase {
         folderPath: string | string[];
         options?: Record<string, unknown>;
     }): Promise<string | string[]>;
+    /**
+     * Roll back a failed versioned add.
+     *
+     * @description
+     * Called when `versionManager.registerVersion()` throws after the API tree, cache,
+     * ownership, and history have already been mutated by `addApiComponent()`. Scrubs
+     * the orphaned "add" entry from `operationHistory`, then delegates tree/cache/ownership
+     * and `addHistory` cleanup to `removeApiComponent({ recordHistory: false })` so that
+     * no spurious "remove" entry is pushed into `operationHistory`.
+     *
+     * The rollback is best-effort: if `removeApiComponent` itself throws the error is
+     * swallowed and the caller re-throws the original registration error.
+     *
+     * @param {object} opts - Rollback context.
+     * @param {string} opts.moduleID - The moduleID of the just-added component.
+     * @param {string} opts.effectivePath - The effective (versioned) mount path, e.g. "v1.auth".
+     * @param {string} opts.normalizedPath - The logical path, e.g. "auth".
+     * @returns {Promise<void>}
+     * @package
+     *
+     * @example
+     * await this._rollbackFailedVersionedAdd({ moduleID, effectivePath, normalizedPath });
+     */
+    _rollbackFailedVersionedAdd({ moduleID, effectivePath, normalizedPath }: {
+        moduleID: string;
+        effectivePath: string;
+        normalizedPath: string;
+    }): Promise<void>;
     /**
      * Remove API modules at runtime.
      * @param {string} pathOrModuleId - API path (with dots) or module ID (with underscore) to remove.