@happyvertical/smrt-core 0.49.5 → 0.49.7

package/dist/vite-plugin/sveltekit-generator.js

@@ -3,14 +3,16 @@ import { CRUD_OPERATIONS, createManifestClassNamePredicate, declaredTypeAcceptsD
 import { isFrameworkBaseClass } from "../registry/framework-base-classes.js";
 import { generateConditionalGetRouteHelper } from "../generators/conditional-get.js";
 import { AUTO_GENERATED_ROUTE_HEADER } from "./route-header.js";
+import { resolveSvelteKitConfigImport } from "./sveltekit-config-import.js";
 import { generateChangesRoute } from "./changes-route.js";
-import { generateDevPlaneRoute } from "./dev-plane-route.js";
+import { generateDevPlaneRoute, willGenerateDevPlaneRoute } from "./dev-plane-route.js";
 import { generateEventsRoute } from "./events-route.js";
-import { generateResourcesRoute } from "./resources-route.js";
-import { generateSyncApplyRoute } from "./sync-apply-route.js";
+import { generateResourcesRoute, reservesResourcesRoute } from "./resources-route.js";
+import { canonicalSvelteKitPath } from "./sveltekit-path.js";
+import { collectSyncApplyTargets, generateSyncApplyRoute } from "./sync-apply-route.js";
 import { computeWebManifestHash, isCollectionManifestClass, orderedManifestObjectEntries, resolveCollectionItemObject, resolveCollectionItemTypeName } from "./web-collections.js";
-import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { isAbsolute, join, relative, sep } from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
 //#region src/vite-plugin/sveltekit-generator.ts
 /**
 * SvelteKit route auto-generation from SMRT objects
@@ -44,7 +46,7 @@ function isCollectionClass(objectDef) {
 	return objectDef.extends === "SmrtCollection" || !!objectDef.extendsTypeArg;
 }
 function getRegistrationPackageName(manifest, objectDef, isLocal) {
-	if (isLocal) return manifest.packageName ?? objectDef.packageName;
+	if (isLocal) return objectDef.packageName ?? manifest.packageName;
 	return objectDef.packageName;
 }
 function toSingleQuotedStringLiteral(value) {
@@ -85,9 +87,12 @@ function isValidTypeIdentifier(name) {
 function resolveObjectTypeReference(projectRoot, className, objectDef, options, routeDir) {
 	const simpleClassName = extractSimpleClassName(className);
 	if (!objectDef || !isValidTypeIdentifier(simpleClassName)) return { typeName: "import('@happyvertical/smrt-core').SmrtObject" };
+	const external = !isLocalObject(projectRoot, objectDef) && objectDef.packageName;
+	const importPath = external ? objectDef.importPath || objectDef.packageName : getRouteTypeImportPath(projectRoot, objectDef, options, simpleClassName, routeDir);
+	const exportName = external ? objectDef.exportName || simpleClassName : simpleClassName;
 	return {
 		typeName: simpleClassName,
-		importStatement: `import type { ${simpleClassName} } from '${isLocalObject(projectRoot, objectDef) || !objectDef.packageName ? getRouteTypeImportPath(projectRoot, objectDef, options, simpleClassName, routeDir) : objectDef.packageName}';`
+		importStatement: `import type { ${exportName}${exportName === simpleClassName ? "" : ` as ${simpleClassName}`} } from '${importPath}';`
 	};
 }
 function getRouteTypeImportPath(projectRoot, objectDef, options, simpleClassName, routeDir) {
@@ -744,6 +749,12 @@ function findItemClassRegistryKey(className, objectDef, manifest) {
 	if (!itemObject) return resolveCollectionItemTypeName(manifest, objectDef) || className;
 	return Object.entries(manifest.objects).find(([, manifestObject]) => manifestObject === itemObject)?.[0] || itemObject.className;
 }
+function assertCompatibleCustomActionRouteSpecs(routeSpecs) {
+	const [firstSpec] = routeSpecs;
+	if (!firstSpec) return;
+	const { hostType, lookupClassName, routeConfig } = firstSpec;
+	if (routeSpecs.some((spec) => spec.hostType !== hostType || spec.lookupClassName !== lookupClassName || spec.routeConfig.scope !== routeConfig.scope)) throw new Error(`Cannot generate mixed custom route handlers for ${lookupClassName}. All handlers sharing a route path must target the same host type and scope.`);
+}
 function groupCustomActionRoutes(actionSpecs) {
 	const groupedRoutes = /* @__PURE__ */ new Map();
 	for (const { routeDir, spec } of actionSpecs) {
@@ -753,24 +764,91 @@ function groupCustomActionRoutes(actionSpecs) {
 		existing.push(spec);
 		groupedRoutes.set(routeDir, existing);
 	}
+	for (const routeSpecs of groupedRoutes.values()) assertCompatibleCustomActionRouteSpecs(routeSpecs);
 	return groupedRoutes;
 }
-/**
-* Generates SvelteKit API routes from manifest
-*/
-async function generateSvelteKitRoutes(projectRoot, manifest, options) {
+/** Reject selected identities that would write the same endpoint file. */
+function assertNoCrossObjectRouteCollisions(projectRoot, manifest, options, exposureManifest, reservedRoutePaths = /* @__PURE__ */ new Set()) {
+	const claims = /* @__PURE__ */ new Map();
+	const claimPath = (routePath, routeDir, owner, writer) => {
+		const canonicalRoutePath = canonicalSvelteKitPath(routePath);
+		const prior = claims.get(canonicalRoutePath);
+		if (prior && (prior.owner !== owner || prior.writer !== writer)) throw new Error(`Conflicting SvelteKit route ${routeDir}: ${prior.owner} (${prior.writer}) and ${owner} (${writer}) would write the same handler`);
+		claims.set(canonicalRoutePath, {
+			owner,
+			writer
+		});
+	};
+	const claim = (routeDir, owner, writer) => claimPath(join(projectRoot, routeDir, "+server.ts"), routeDir, owner, writer);
+	for (const routePath of reservedRoutePaths) claimPath(resolve(routePath), relative(projectRoot, routePath), "producer knowledge", "knowledge");
+	for (const [className, objectDef] of orderedManifestObjectEntries(manifest)) {
+		if (isFrameworkBaseClass(objectDef.className, objectDef.packageName)) continue;
+		const routeDir = join(options.routesDir, objectDef.collection);
+		if (isCollectionManifestClass(manifest, objectDef)) {
+			const actionSpecs = resolveApiCustomActions(objectDef, exposureManifest, true).exposed.map(([actionName, actionDef]) => {
+				const routeConfig = resolveApiActionRouteConfig(actionName, actionDef, objectDef.decoratorConfig?.api, { kebabRoutes: options.kebabRoutes }, "collection");
+				return {
+					routeDir: join(routeDir, ...routeConfig.pathSegments),
+					spec: {
+						actionName,
+						hostType: "collection",
+						lookupClassName: findItemClassRegistryKey(className, objectDef, manifest),
+						routeConfig
+					}
+				};
+			});
+			for (const [actionRouteDir] of groupCustomActionRoutes(actionSpecs)) claim(actionRouteDir, className, "custom-action");
+			continue;
+		}
+		const actions = resolveStandardCrudActions(objectDef.decoratorConfig?.api);
+		if (actions.some((action) => action === "list" || action === "create")) claim(routeDir, className, "crud-collection");
+		if (actions.some((action) => action === "get" || action === "update" || action === "delete")) claim(join(routeDir, "[id]"), className, "crud-item");
+		const actionSpecs = resolveApiCustomActions(objectDef, exposureManifest, false).exposed.map(([actionName, actionDef]) => {
+			const routeConfig = resolveApiActionRouteConfig(actionName, actionDef, objectDef.decoratorConfig?.api, { kebabRoutes: options.kebabRoutes });
+			return {
+				routeDir: join(routeConfig.scope === "collection" ? routeDir : join(routeDir, "[id]"), ...routeConfig.pathSegments),
+				spec: {
+					actionName,
+					hostType: "item",
+					lookupClassName: className,
+					routeConfig
+				}
+			};
+		});
+		for (const [actionRouteDir] of groupCustomActionRoutes(actionSpecs)) claim(actionRouteDir, className, "custom-action");
+	}
+	if (collectSyncApplyTargets(manifest).length > 0) claim(join(options.routesDir, "sync", "apply"), "sync/apply", "sync-apply");
+	const hasAnchor = Object.values(manifest.objects).some((objectDef) => !isCollectionManifestClass(manifest, objectDef));
+	if (hasAnchor && options.changesRoute?.enabled !== false) claim(join(options.routesDir, "_changes"), "_changes", "changes");
+	if (willGenerateDevPlaneRoute(projectRoot, options)) claim(join(options.routesDir, "_dev", "[...tool]"), "_dev", "dev-plane");
+	if (hasAnchor && options.eventsRoute?.enabled !== false) claim(join(options.routesDir, "_events"), "_events", "events");
+	if (reservesResourcesRoute(projectRoot, options)) claim(join(options.routesDir, "_resources"), "_resources", "resources");
+	if (options.knowledge?.api?.enabled) {
+		const routeDir = knowledgeRouteDir(projectRoot, options);
+		claimPath(join(routeDir, "+server.ts"), routeDir, "knowledge", "knowledge");
+	}
+}
+async function generateSvelteKitRoutes(projectRoot, routeManifest, options, semanticManifest = routeManifest, utilityManifests = {
+	sync: routeManifest,
+	changes: routeManifest,
+	events: routeManifest,
+	eventsSemantic: semanticManifest,
+	clearKnowledgeRoute: true
+}, registrationManifest = routeManifest, hooks = {}) {
 	if (!options.enabled) return;
 	console.log("[smrt] Generating SvelteKit routes...");
-	clearGeneratedRouteFiles(join(projectRoot, options.routesDir));
-	clearGeneratedKnowledgeRoute(projectRoot, options);
-	await generateSmrtConfigFile(projectRoot, manifest, options);
+	if (options.rejectRouteCollisions) assertNoCrossObjectRouteCollisions(projectRoot, routeManifest, options, semanticManifest, utilityManifests.protectedRoutePaths);
+	await hooks.beforeCleanup?.();
+	clearGeneratedSvelteKitRouteFiles(join(projectRoot, options.routesDir), utilityManifests.protectedRoutePaths, utilityManifests.protectedRouteRoots);
+	if (utilityManifests.clearKnowledgeRoute !== false) clearGeneratedKnowledgeRoute(projectRoot, options);
+	await generateSmrtConfigFile(projectRoot, registrationManifest, options);
 	const generatedRoutePaths = [];
 	let generatedCount = 0;
 	let skippedCollections = 0;
-	for (const [className, objectDef] of orderedManifestObjectEntries(manifest)) {
+	for (const [className, objectDef] of orderedManifestObjectEntries(routeManifest)) {
 		if (isFrameworkBaseClass(objectDef.className, objectDef.packageName)) continue;
-		if (isCollectionManifestClass(manifest, objectDef)) {
-			const collectionRoutePaths = await generateCollectionRoutesForObject(projectRoot, className, objectDef, manifest, options);
+		if (isCollectionManifestClass(semanticManifest, objectDef)) {
+			const collectionRoutePaths = await generateCollectionRoutesForObject(projectRoot, className, objectDef, semanticManifest, options);
 			generatedRoutePaths.push(...collectionRoutePaths);
 			if (collectionRoutePaths.length > 0) generatedCount++;
 			else {
@@ -779,35 +857,57 @@ async function generateSvelteKitRoutes(projectRoot, manifest, options) {
 			}
 			continue;
 		}
-		generatedRoutePaths.push(...await generateRoutesForObject(projectRoot, className, objectDef, manifest, options));
+		generatedRoutePaths.push(...await generateRoutesForObject(projectRoot, className, objectDef, semanticManifest, options));
 		generatedCount++;
 	}
 	if (options.knowledge?.api?.enabled) generatedRoutePaths.push(generateKnowledgeRoute(projectRoot, options));
-	if (generateSyncApplyRoute(projectRoot, manifest, options)) generatedRoutePaths.push(join(projectRoot, options.routesDir, "sync", "apply", "+server.ts"));
-	if (generateChangesRoute(projectRoot, manifest, options)) generatedRoutePaths.push(join(projectRoot, options.routesDir, "_changes", "+server.ts"));
+	if (generateSyncApplyRoute(projectRoot, utilityManifests.sync, options)) generatedRoutePaths.push(join(projectRoot, options.routesDir, "sync", "apply", "+server.ts"));
+	if (generateChangesRoute(projectRoot, utilityManifests.changes, options)) generatedRoutePaths.push(join(projectRoot, options.routesDir, "_changes", "+server.ts"));
 	if (generateDevPlaneRoute(projectRoot, options)) generatedRoutePaths.push(join(projectRoot, options.routesDir, "_dev", "[...tool]", "+server.ts"));
-	if (generateEventsRoute(projectRoot, manifest, options, computeWebManifestHash(manifest))) generatedRoutePaths.push(join(projectRoot, options.routesDir, "_events", "+server.ts"));
+	if (generateEventsRoute(projectRoot, utilityManifests.events, options, computeWebManifestHash(utilityManifests.eventsSemantic))) generatedRoutePaths.push(join(projectRoot, options.routesDir, "_events", "+server.ts"));
 	if (generateResourcesRoute(projectRoot, options)) generatedRoutePaths.push(join(projectRoot, options.routesDir, "_resources", "+server.ts"));
-	updateGitignore(projectRoot, generatedRoutePaths);
+	updateGitignore(projectRoot, generatedRoutePaths, join(projectRoot, svelteKitRouteRoot(options.routesDir)));
 	const skippedMsg = skippedCollections > 0 ? ` (skipped ${skippedCollections} collection classes)` : "";
 	console.log(`[smrt] Generated routes for ${generatedCount} SMRT objects${skippedMsg}`);
 }
-function clearGeneratedRouteFiles(routesRoot) {
+/** Remove only SMRT header-owned SvelteKit handlers below one route root. */
+function clearGeneratedSvelteKitRouteFiles(routesRoot, excludedPaths = /* @__PURE__ */ new Set(), protectedRouteRoots = /* @__PURE__ */ new Set(), visitedRoots = /* @__PURE__ */ new Set()) {
+	const canonicalRoot = canonicalSvelteKitPath(routesRoot);
+	if (protectedRouteRoots.has(canonicalRoot) || visitedRoots.has(canonicalRoot)) return;
 	if (!existsSync(routesRoot)) return;
+	visitedRoots.add(canonicalRoot);
 	for (const entry of readdirSync(routesRoot, { withFileTypes: true })) {
 		const entryPath = join(routesRoot, entry.name);
-		if (entry.isDirectory()) {
-			clearGeneratedRouteFiles(entryPath);
+		if (isSvelteKitRouteDirectory(entryPath, entry)) {
+			clearGeneratedSvelteKitRouteFiles(entryPath, excludedPaths, protectedRouteRoots, visitedRoots);
 			continue;
 		}
 		if (!entry.isFile() || entry.name !== "+server.ts") continue;
+		if (excludedPaths.has(canonicalSvelteKitPath(entryPath))) continue;
 		if (readFileSync(entryPath, "utf-8").startsWith("// Auto-generated by @smrt/core vite plugin")) unlinkSync(entryPath);
 	}
 }
+function isSvelteKitRouteDirectory(entryPath, entry) {
+	if (entry.isDirectory()) return true;
+	if (!entry.isSymbolicLink?.()) return false;
+	try {
+		return statSync(entryPath).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/** Refresh the managed ignore block after an externally coordinated cleanup. */
+function reconcileSvelteKitRouteGitignore(projectRoot, routesDir) {
+	updateGitignore(projectRoot, [], join(projectRoot, svelteKitRouteRoot(routesDir)));
+}
 function knowledgeRouteDir(projectRoot, options) {
 	const basePath = String(options.knowledge?.api?.basePath || "/__smrt/knowledge");
 	return join(projectRoot, svelteKitRouteRoot(options.routesDir), ...basePath.split("/").map((segment) => segment.trim()).filter(Boolean));
 }
+/** Exact generated knowledge handler path for coordinator-owned cleanup. */
+function knowledgeRoutePath(projectRoot, options) {
+	return join(knowledgeRouteDir(projectRoot, options), "+server.ts");
+}
 function svelteKitRouteRoot(routesDir) {
 	const normalized = routesDir.replaceAll("\\", "/").replace(/\/+$/, "");
 	const markerIndex = normalized.indexOf("/routes");
@@ -816,7 +916,7 @@ function svelteKitRouteRoot(routesDir) {
 	return "src/routes";
 }
 function clearGeneratedKnowledgeRoute(projectRoot, options) {
-	const routePath = join(knowledgeRouteDir(projectRoot, options), "+server.ts");
+	const routePath = knowledgeRoutePath(projectRoot, options);
 	if (!existsSync(routePath)) return;
 	if (readFileSync(routePath, "utf-8").startsWith("// Auto-generated by @smrt/core vite plugin")) unlinkSync(routePath);
 }
@@ -847,16 +947,17 @@ async function generateRegistrationFile(projectRoot, manifest, options) {
 	const registrationBindings = buildRegistrationBindings(manifest);
 	for (const [className, objectDef] of Object.entries(manifest.objects)) if (isLocalObject(projectRoot, objectDef)) localObjects.push([className, objectDef]);
 	else if (objectDef.packageName) {
-		const packageEntry = packageObjects.get(objectDef.packageName) || {
+		const externalImportPath = objectDef.importPath || objectDef.packageName;
+		const packageEntry = packageObjects.get(externalImportPath) || {
 			objects: [],
 			hasCollectionImport: false
 		};
 		if (isCollectionManifestClass(manifest, objectDef)) packageEntry.hasCollectionImport = true;
 		else packageEntry.objects.push({
-			simpleName: extractSimpleClassName(className),
+			simpleName: objectDef.exportName || extractSimpleClassName(className),
 			bindingName: registrationBindings.get(className) || extractSimpleClassName(className)
 		});
-		packageObjects.set(objectDef.packageName, packageEntry);
+		packageObjects.set(externalImportPath, packageEntry);
 	} else localObjects.push([className, objectDef]);
 	const localNamedImports = /* @__PURE__ */ new Map();
 	const localSideEffectImports = /* @__PURE__ */ new Set();
@@ -891,11 +992,12 @@ async function generateRegistrationFile(projectRoot, manifest, options) {
 		return imports;
 	}).join("\n"), localImports].filter(Boolean).join("\n");
 	const externalRuntimeDependencies = (manifest.smrtDependencies || []).filter((dependency) => dependency !== "@happyvertical/smrt-core");
+	const consumerRegistrationPaths = options.consumerRegistrationPaths ?? (externalRuntimeDependencies.length > 0 ? [join(projectRoot, ".smrt", "register.js")] : []);
 	let consumerRegistrationImport = "";
-	if (externalRuntimeDependencies.length > 0) {
-		const consumerRegistrationPath = relative(configDir, join(projectRoot, ".smrt", "register.js")).replace(/\\/g, "/");
-		consumerRegistrationImport = `import '${consumerRegistrationPath.startsWith(".") ? consumerRegistrationPath : `./${consumerRegistrationPath}`}';`;
-	}
+	if (consumerRegistrationPaths.length > 0) consumerRegistrationImport = [...new Set(consumerRegistrationPaths)].sort().map((registerPath) => {
+		const consumerRegistrationPath = relative(configDir, registerPath).replace(/\\/g, "/");
+		return `import '${consumerRegistrationPath.startsWith(".") ? consumerRegistrationPath : `./${consumerRegistrationPath}`}';`;
+	}).join("\n");
 	/**
 	* Strip machine specifics from an object definition before it is embedded in
 	* generated source.
@@ -1154,7 +1256,7 @@ export async function getCollection<
 /**
 * Generates route files for a single SMRT object
 */
-async function generateRoutesForObject(projectRoot, className, objectDef, manifest, options) {
+async function generateRoutesForObject(projectRoot, className, objectDef, semanticManifest, options) {
 	const collectionName = objectDef.collection;
 	const routeDir = join(projectRoot, options.routesDir, collectionName);
 	const generatedRoutePaths = [];
@@ -1165,14 +1267,14 @@ async function generateRoutesForObject(projectRoot, className, objectDef, manife
 	}
 	const includedActions = resolveStandardCrudActions(apiConfig);
 	if (includedActions.includes("list") || includedActions.includes("create")) {
-		const collectionRoute = generateCollectionRouteTemplate(projectRoot, className, objectDef, manifest, includedActions, options, routeDir);
+		const collectionRoute = generateCollectionRouteTemplate(projectRoot, className, objectDef, semanticManifest, includedActions, options, routeDir);
 		generatedRoutePaths.push(writeRoute(routeDir, "+server.ts", collectionRoute));
 	}
 	if (includedActions.includes("get") || includedActions.includes("update") || includedActions.includes("delete")) {
-		const itemRoute = generateItemRouteTemplate(projectRoot, className, objectDef, manifest, includedActions, options, join(routeDir, "[id]"));
+		const itemRoute = generateItemRouteTemplate(projectRoot, className, objectDef, semanticManifest, includedActions, options, join(routeDir, "[id]"));
 		generatedRoutePaths.push(writeRoute(join(routeDir, "[id]"), "+server.ts", itemRoute));
 	}
-	const { exposed: customActions, rejected } = resolveApiCustomActions(objectDef, manifest, false);
+	const { exposed: customActions, rejected } = resolveApiCustomActions(objectDef, semanticManifest, false);
 	warnUnhostedActions(className, rejected);
 	const actionSpecs = [];
 	for (const [actionName, actionDef] of customActions) {
@@ -1193,12 +1295,12 @@ async function generateRoutesForObject(projectRoot, className, objectDef, manife
 		});
 	}
 	for (const [actionRouteDir, routeSpecs] of groupCustomActionRoutes(actionSpecs)) {
-		const actionRoute = generateActionRouteTemplate(projectRoot, actionRouteDir, routeSpecs, objectDef, manifest, options);
+		const actionRoute = generateActionRouteTemplate(projectRoot, actionRouteDir, routeSpecs, objectDef, semanticManifest, options);
 		generatedRoutePaths.push(writeRoute(actionRouteDir, "+server.ts", actionRoute));
 	}
 	return generatedRoutePaths;
 }
-async function generateCollectionRoutesForObject(projectRoot, className, objectDef, manifest, options) {
+async function generateCollectionRoutesForObject(projectRoot, className, objectDef, semanticManifest, options) {
 	const generatedRoutePaths = [];
 	const apiConfig = objectDef.decoratorConfig?.api;
 	if (apiConfig === false) {
@@ -1206,9 +1308,9 @@ async function generateCollectionRoutesForObject(projectRoot, className, objectD
 		return generatedRoutePaths;
 	}
 	const routeDir = join(projectRoot, options.routesDir, objectDef.collection);
-	const lookupClassName = findItemClassRegistryKey(className, objectDef, manifest);
-	const lookupObjectDef = findObjectDefByRegistryKey(manifest, lookupClassName);
-	const { exposed: customActions, rejected } = resolveApiCustomActions(objectDef, manifest, true);
+	const lookupClassName = findItemClassRegistryKey(className, objectDef, semanticManifest);
+	const lookupObjectDef = findObjectDefByRegistryKey(semanticManifest, lookupClassName);
+	const { exposed: customActions, rejected } = resolveApiCustomActions(objectDef, semanticManifest, true);
 	warnUnhostedActions(className, rejected);
 	if (customActions.length === 0) return generatedRoutePaths;
 	const actionSpecs = [];
@@ -1229,7 +1331,7 @@ async function generateCollectionRoutesForObject(projectRoot, className, objectD
 		});
 	}
 	for (const [actionRouteDir, routeSpecs] of groupCustomActionRoutes(actionSpecs)) {
-		const actionRoute = generateActionRouteTemplate(projectRoot, actionRouteDir, routeSpecs, objectDef, manifest, options);
+		const actionRoute = generateActionRouteTemplate(projectRoot, actionRouteDir, routeSpecs, objectDef, semanticManifest, options);
 		generatedRoutePaths.push(writeRoute(actionRouteDir, "+server.ts", actionRoute));
 	}
 	return generatedRoutePaths;
@@ -1514,25 +1616,26 @@ function smrtRouteErrorResponse(cause: unknown) {
 }
 `;
 }
-function generateCollectionRouteTemplate(projectRoot, className, objectDef, manifest, includedActions, options, routeDir) {
+function generateCollectionRouteTemplate(projectRoot, className, objectDef, semanticManifest, includedActions, options, routeDir) {
 	const hasGet = includedActions.includes("list");
 	const hasPost = includedActions.includes("create");
 	const modelType = resolveObjectTypeReference(projectRoot, className, objectDef, options, routeDir);
 	const serializers = resolveStandardRouteSerializers(objectDef.decoratorConfig?.api);
 	const serializerImports = serializers.importStatements.join("\n");
 	const listUsesSerializer = !!serializers.listItemSerializerName;
-	const listUsesPermissionScopedBody = collectReadPermissionFields(objectDef, manifest).length > 0;
+	const listUsesPermissionScopedBody = collectReadPermissionFields(objectDef, semanticManifest).length > 0;
 	const listUsesBodyHash = listUsesSerializer || listUsesPermissionScopedBody;
-	const webManifestHash = computeWebManifestHash(manifest);
+	const webManifestHash = computeWebManifestHash(semanticManifest);
+	const configImport = resolveSvelteKitConfigImport(projectRoot, routeDir, options);
 	const imports = `${AUTO_GENERATED_ROUTE_HEADER}
 // DO NOT EDIT - changes will be overwritten
 
 import { error${hasPost ? ", json" : ""} } from '@sveltejs/kit';
-${serializerImports ? `${serializerImports}\n` : ""}import { getCollection } from '$lib/server/smrt';
+${serializerImports ? `${serializerImports}\n` : ""}import { getCollection } from '${configImport}';
 ${hasPost ? "import { normalizeTypedHttpError } from '@happyvertical/smrt-core';\n" : ""}
 ${modelType.importStatement ? `${modelType.importStatement}\n` : ""}import type { RequestHandler } from './$types';
 // Note: ${className} is auto-registered by the Vite plugin scanner
-${generateAuthGuardHelper(objectDef, manifest)}${needsRouteTenantContext(objectDef) ? generateTenantContextHelper(usesPrincipalContext(objectDef), isTenantScoped(objectDef)) : ""}${hasPost ? generateWritablePolicyHelper(objectDef) : ""}${hasPost ? generateTypedRouteErrorHelper() : ""}${hasGet ? generateListBoundsHelper(objectDef) : ""}${hasGet ? generateConditionalGetRouteHelper(objectDef.decoratorConfig?.api, {
+${generateAuthGuardHelper(objectDef, semanticManifest)}${needsRouteTenantContext(objectDef) ? generateTenantContextHelper(usesPrincipalContext(objectDef), isTenantScoped(objectDef)) : ""}${hasPost ? generateWritablePolicyHelper(objectDef) : ""}${hasPost ? generateTypedRouteErrorHelper() : ""}${hasGet ? generateListBoundsHelper(objectDef) : ""}${hasGet ? generateConditionalGetRouteHelper(objectDef.decoratorConfig?.api, {
 		tenantScoped: isTenantScoped(objectDef),
 		permissionScoped: listUsesPermissionScopedBody,
 		modelName: className,
@@ -1638,7 +1741,7 @@ function generateClassNotRegisteredError(className) {
 /**
 * Generates item route template (GET, PUT, DELETE)
 */
-function generateItemRouteTemplate(projectRoot, className, objectDef, manifest, includedActions, options, routeDir) {
+function generateItemRouteTemplate(projectRoot, className, objectDef, semanticManifest, includedActions, options, routeDir) {
 	const hasGet = includedActions.includes("get");
 	const hasPut = includedActions.includes("update");
 	const hasDelete = includedActions.includes("delete");
@@ -1647,17 +1750,18 @@ function generateItemRouteTemplate(projectRoot, className, objectDef, manifest,
 	const serializers = resolveStandardRouteSerializers(objectDef.decoratorConfig?.api);
 	const serializerImports = serializers.importStatements.join("\n");
 	const getUsesSerializer = !!serializers.itemSerializerName;
-	const getUsesPermissionScopedBody = collectReadPermissionFields(objectDef, manifest).length > 0;
+	const getUsesPermissionScopedBody = collectReadPermissionFields(objectDef, semanticManifest).length > 0;
 	const getUsesBodyHash = getUsesSerializer || getUsesPermissionScopedBody;
-	const webManifestHash = computeWebManifestHash(manifest);
+	const webManifestHash = computeWebManifestHash(semanticManifest);
+	const configImport = resolveSvelteKitConfigImport(projectRoot, routeDir, options);
 	const imports = `${AUTO_GENERATED_ROUTE_HEADER}
 // DO NOT EDIT - changes will be overwritten
 
 import { error${hasPut || hasDelete ? ", json" : ""} } from '@sveltejs/kit';
-${serializerImports ? `${serializerImports}\n` : ""}import { getCollection } from '$lib/server/smrt';
+${serializerImports ? `${serializerImports}\n` : ""}import { getCollection } from '${configImport}';
 ${hasPut || hasDelete ? "import { normalizeTypedHttpError } from '@happyvertical/smrt-core';\n" : ""}
 ${modelType.importStatement ? `${modelType.importStatement}\n` : ""}import type { RequestHandler } from './$types';
-${generateAuthGuardHelper(objectDef, manifest)}${needsRouteTenantContext(objectDef) ? generateTenantContextHelper(usesPrincipalContext(objectDef), isTenantScoped(objectDef)) : ""}${hasPut ? generateWritablePolicyHelper(objectDef) : ""}${hasPut || hasDelete ? generateTypedRouteErrorHelper() : ""}${hasGet ? generateConditionalGetRouteHelper(objectDef.decoratorConfig?.api, {
+${generateAuthGuardHelper(objectDef, semanticManifest)}${needsRouteTenantContext(objectDef) ? generateTenantContextHelper(usesPrincipalContext(objectDef), isTenantScoped(objectDef)) : ""}${hasPut ? generateWritablePolicyHelper(objectDef) : ""}${hasPut || hasDelete ? generateTypedRouteErrorHelper() : ""}${hasGet ? generateConditionalGetRouteHelper(objectDef.decoratorConfig?.api, {
 		tenantScoped: isTenantScoped(objectDef),
 		permissionScoped: getUsesPermissionScopedBody,
 		modelName: className,
@@ -1739,14 +1843,14 @@ ${generateNotFoundError(className)}
 /**
 * Generates custom action route template
 */
-function generateActionRouteTemplate(projectRoot, routeDir, routeSpecs, objectDef, manifest, options) {
+function generateActionRouteTemplate(projectRoot, routeDir, routeSpecs, objectDef, semanticManifest, options) {
 	if (routeSpecs.length === 0) throw new Error("Cannot generate a custom action route without handlers");
 	const [firstSpec] = routeSpecs;
 	const { lookupClassName, routeConfig, hostType } = firstSpec;
+	assertCompatibleCustomActionRouteSpecs(routeSpecs);
 	const lookupModelType = resolveObjectTypeReference(projectRoot, lookupClassName, firstSpec.lookupObjectDef, options, routeDir);
 	const hostModelType = resolveObjectTypeReference(projectRoot, firstSpec.hostClassName, objectDef, options, routeDir);
 	const typeImports = mergeImportStatements([lookupModelType.importStatement, hostModelType.importStatement]);
-	if (routeSpecs.some((spec) => spec.hostType !== hostType || spec.lookupClassName !== lookupClassName || spec.routeConfig.scope !== routeConfig.scope)) throw new Error(`Cannot generate mixed custom route handlers for ${lookupClassName}. All handlers sharing a route path must target the same host type and scope.`);
 	const decoderImports = /* @__PURE__ */ new Set();
 	for (const spec of routeSpecs) {
 		if (hasSingleOptionsParameter(spec.actionDef)) continue;
@@ -1755,14 +1859,16 @@ function generateActionRouteTemplate(projectRoot, routeDir, routeSpecs, objectDe
 			if (decoder) decoderImports.add(decoder);
 		}
 	}
+	const coreImports = [
+		"normalizeCustomActionFailure",
+		"normalizeTypedHttpError",
+		...[...decoderImports].sort()
+	].join(", ");
+	const configImport = resolveSvelteKitConfigImport(projectRoot, routeDir, options);
 	const importBlock = [
 		"import { error, json } from '@sveltejs/kit';",
-		`import { ${[
-			"normalizeCustomActionFailure",
-			"normalizeTypedHttpError",
-			...[...decoderImports].sort()
-		].join(", ")} } from '@happyvertical/smrt-core';`,
-		hostType === "collection" || routeConfig.scope !== "collection" ? "import { getCollection } from '$lib/server/smrt';" : "import { ObjectRegistry } from '@happyvertical/smrt-core';",
+		`import { ${coreImports} } from '@happyvertical/smrt-core';`,
+		hostType === "collection" || routeConfig.scope !== "collection" ? `import { getCollection } from '${configImport}';` : [`import '${configImport}';`, "import { ObjectRegistry } from '@happyvertical/smrt-core';"].join("\n"),
 		typeImports,
 		"import type { RequestHandler } from './$types';"
 	].filter(Boolean).join("\n");
@@ -1774,7 +1880,7 @@ function generateActionRouteTemplate(projectRoot, routeDir, routeSpecs, objectDe
 // DO NOT EDIT - changes will be overwritten
 
 ${importBlock}
-${generateAuthGuardHelper(objectDef, manifest)}${needsTenantContext ? generateTenantContextHelper(principalContext, tenantScoped) : ""}
+${generateAuthGuardHelper(objectDef, semanticManifest)}${needsTenantContext ? generateTenantContextHelper(principalContext, tenantScoped) : ""}
 ${generateTypedRouteErrorHelper()}
 ${handlers}`;
 }
@@ -2001,17 +2107,27 @@ function rolesFrom(value: unknown): string[] {
 /**
 * Updates .gitignore to exclude auto-generated routes
 */
-function updateGitignore(projectRoot, generatedRoutePaths) {
+function updateGitignore(projectRoot, generatedRoutePaths, routeRoot) {
 	const gitignorePath = join(projectRoot, ".gitignore");
 	let gitignoreContent = "";
 	if (existsSync(gitignorePath)) gitignoreContent = readFileSync(gitignorePath, "utf-8");
-	const generatedPaths = [...new Set(generatedRoutePaths.map((path) => gitignorePatternForPath(relative(projectRoot, path))))].sort((a, b) => a.localeCompare(b));
+	const generatedPaths = [...new Set([...generatedRoutePaths, ...findGeneratedRouteFiles(routeRoot)].map((path) => gitignorePatternForPath(relative(projectRoot, path))))].sort((a, b) => a.localeCompare(b));
 	const updatedContent = updateGeneratedRouteIgnoreBlock(gitignoreContent, generatedPaths);
 	if (updatedContent !== gitignoreContent) {
 		writeFileSync(gitignorePath, updatedContent, "utf-8");
 		console.log("[smrt] Updated .gitignore with generated route paths");
 	}
 }
+function findGeneratedRouteFiles(routeRoot) {
+	if (!existsSync(routeRoot)) return [];
+	const files = [];
+	for (const entry of readdirSync(routeRoot, { withFileTypes: true })) {
+		const path = join(routeRoot, entry.name);
+		if (entry.isDirectory()) files.push(...findGeneratedRouteFiles(path));
+		else if (entry.isFile() && entry.name === "+server.ts" && readFileSync(path, "utf-8").startsWith("// Auto-generated by @smrt/core vite plugin")) files.push(path);
+	}
+	return files;
+}
 function gitignorePatternForPath(path) {
 	return path.replaceAll("\\", "/").replaceAll(/([*?[\]\\!#])/g, "\\$1");
 }
@@ -2064,6 +2180,6 @@ function updateGeneratedRouteIgnoreBlock(gitignoreContent, generatedPaths) {
 	return `${updatedContent}${managedBlock.join("\n")}\n`;
 }
 //#endregion
-export { findCliApiCoherenceViolations, generateSvelteKitRoutes, methodNameToKebab, resolveApiActionRouteConfig, resolveApiActionSet, resolveApiCustomActions, validateCliIncludeAgainstApi };
+export { assertNoCrossObjectRouteCollisions, clearGeneratedSvelteKitRouteFiles, findCliApiCoherenceViolations, generateSvelteKitRoutes, knowledgeRoutePath, methodNameToKebab, reconcileSvelteKitRouteGitignore, resolveApiActionRouteConfig, resolveApiActionSet, resolveApiCustomActions, validateCliIncludeAgainstApi };
 
 //# sourceMappingURL=sveltekit-generator.js.map