@intlayer/engine 9.5.9-canary.0 → 9.5.10

package/dist/cjs/init/documentationRouter.cjs

@@ -0,0 +1,141 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region src/init/documentationRouter.ts
+/**
+* Documentation URL Constants
+*/
+const DocumentationRouter = {
+	NextJS: "https://intlayer.org/doc/environment/nextjs",
+	NextJS_16: "https://intlayer.org/doc/environment/nextjs",
+	NextJS_15: "https://intlayer.org/doc/environment/nextjs/15",
+	NextJS_14: "https://intlayer.org/doc/environment/nextjs/14",
+	NextJS_PageRouter: "https://intlayer.org/doc/environment/nextjs/next-with-page-router",
+	CRA: "https://intlayer.org/doc/environment/create-react-app",
+	Astro: "https://intlayer.org/doc/environment/astro",
+	Astro_Lit: "https://intlayer.org/doc/environment/astro/lit",
+	Astro_Preact: "https://intlayer.org/doc/environment/astro/preact",
+	Astro_React: "https://intlayer.org/doc/environment/astro/react",
+	Astro_Solid: "https://intlayer.org/doc/environment/astro/solid",
+	Astro_Svelte: "https://intlayer.org/doc/environment/astro/svelte",
+	Astro_Vue: "https://intlayer.org/doc/environment/astro/vue",
+	ViteAndReact: "https://intlayer.org/doc/environment/vite-and-react",
+	ViteAndReact_ReactRouterV7: "https://intlayer.org/doc/environment/vite-and-react/react-router-v7",
+	ViteAndVue: "https://intlayer.org/doc/environment/vite-and-vue",
+	ViteAndSolid: "https://intlayer.org/doc/environment/vite-and-solid",
+	ViteAndSvelte: "https://intlayer.org/doc/environment/vite-and-svelte",
+	ViteAndPreact: "https://intlayer.org/doc/environment/vite-and-preact",
+	ViteAndLit: "https://intlayer.org/doc/environment/vite-and-lit",
+	ViteAndVanilla: "https://intlayer.org/doc/environment/vite-and-vanilla",
+	Vanilla: "https://intlayer.org/doc/environment/vanilla",
+	TanStackRouter: "https://intlayer.org/doc/environment/tanstack-start",
+	TanStackRouterAndSolid: "https://intlayer.org/doc/environment/tanstack-start/solid",
+	SolidStart: "https://intlayer.org/doc/environment/solid-start",
+	Analog: "https://intlayer.org/doc/environment/analog",
+	Remix: "https://intlayer.org/doc/environment/remix-3",
+	NuxtAndVue: "https://intlayer.org/doc/environment/nuxt-and-vue",
+	Angular: "https://intlayer.org/doc/environment/angular",
+	Angular_19: "https://intlayer.org/doc/environment/angular/19",
+	SvelteKit: "https://intlayer.org/doc/environment/sveltekit",
+	ReactNativeAndExpo: "https://intlayer.org/doc/environment/react-native-and-expo",
+	Lynx: "https://intlayer.org/doc/environment/lynx-and-react",
+	HTMX: "https://intlayer.org/doc/environment/htmx",
+	Storybook: "https://intlayer.org/doc/storybook",
+	Express: "https://intlayer.org/doc/environment/express",
+	NestJS: "https://intlayer.org/doc/environment/nest",
+	Fastify: "https://intlayer.org/doc/environment/fastify",
+	Hono: "https://intlayer.org/doc/environment/hono",
+	AdonisJS: "https://intlayer.org/doc/environment/adonisjs",
+	Elysia: "https://intlayer.org/doc/environment/elysia",
+	Default: "https://intlayer.org/doc/get-started",
+	LSP: "https://intlayer.org/doc/lsp",
+	ESLint: "https://intlayer.org/doc/eslint",
+	NextIntl: "https://intlayer.org/doc/next-intl",
+	NextI18Next: "https://intlayer.org/doc/next-i18next",
+	ReactI18Next: "https://intlayer.org/doc/compatibility/react-i18next",
+	ReactIntl: "https://intlayer.org/doc/compatibility/react-intl",
+	VueI18n: "https://intlayer.org/doc/compatibility/vue-i18n",
+	NuxtI18n: "https://intlayer.org/doc/compatibility/nuxtjs-i18n",
+	I18next: "https://intlayer.org/doc/compatibility/i18next"
+};
+/**
+* Helper: Detects the environment and returns the doc URL
+*/
+const getDocumentationUrl = (packageJson) => {
+	const deps = {
+		...packageJson?.dependencies,
+		...packageJson?.devDependencies
+	};
+	/**
+	* Helper to check if a version string matches a specific major version
+	* Matches: "15", "^15.0.0", "~15.2", "15.0.0-beta"
+	*/
+	const isVersion = (versionString, major) => {
+		if (!versionString || typeof versionString !== "string") return false;
+		return new RegExp(`^[\\^~]?${major}(?:\\.|$)`).test(versionString);
+	};
+	if (deps["@lynx-js/react"] || deps["@lynx-js/core"]) return DocumentationRouter.Lynx;
+	if (deps["react-native"] || deps.expo) return DocumentationRouter.ReactNativeAndExpo;
+	if (deps.next) {
+		const version = deps.next;
+		if (isVersion(version, 14)) return DocumentationRouter.NextJS_14;
+		if (isVersion(version, 15)) return DocumentationRouter.NextJS_15;
+		return DocumentationRouter.NextJS;
+	}
+	if (deps.nuxt) return DocumentationRouter.NuxtAndVue;
+	if (deps.astro) {
+		if (deps["@astrojs/react"] || deps.react) return DocumentationRouter.Astro_React;
+		if (deps["@astrojs/vue"] || deps.vue) return DocumentationRouter.Astro_Vue;
+		if (deps["@astrojs/svelte"] || deps.svelte) return DocumentationRouter.Astro_Svelte;
+		if (deps["@astrojs/solid-js"] || deps["solid-js"]) return DocumentationRouter.Astro_Solid;
+		if (deps["@astrojs/preact"] || deps.preact) return DocumentationRouter.Astro_Preact;
+		if (deps["@astrojs/lit"] || deps.lit) return DocumentationRouter.Astro_Lit;
+		return DocumentationRouter.Astro;
+	}
+	if (deps["@sveltejs/kit"]) return DocumentationRouter.SvelteKit;
+	if (deps["@analogjs/platform"]) return DocumentationRouter.Analog;
+	if (deps["@solidjs/start"]) return DocumentationRouter.SolidStart;
+	if (deps.remix || deps["remix-intlayer"]) return DocumentationRouter.Remix;
+	if (deps["@tanstack/react-router"]) return DocumentationRouter.TanStackRouter;
+	if (deps["@tanstack/solid-router"]) return DocumentationRouter.TanStackRouterAndSolid;
+	if (deps["@tanstack/start"]) {
+		if (deps["solid-js"] || deps["@tanstack/solid-router"]) return DocumentationRouter.TanStackRouterAndSolid;
+		return DocumentationRouter.TanStackRouter;
+	}
+	const reactRouterVersion = deps["react-router"];
+	if (typeof reactRouterVersion === "string" && (deps["@react-router/fs-routes"] || isVersion(reactRouterVersion, 7))) return DocumentationRouter.ViteAndReact_ReactRouterV7;
+	if (deps.vite) {
+		if (deps.vue) return DocumentationRouter.ViteAndVue;
+		if (deps["solid-js"]) return DocumentationRouter.ViteAndSolid;
+		if (deps.svelte) return DocumentationRouter.ViteAndSvelte;
+		if (deps.preact) return DocumentationRouter.ViteAndPreact;
+		if (deps.lit) return DocumentationRouter.ViteAndLit;
+		if (deps["vanilla-intlayer"]) return DocumentationRouter.ViteAndVanilla;
+		return DocumentationRouter.ViteAndReact;
+	}
+	if (deps["react-scripts"]) return DocumentationRouter.CRA;
+	if (deps["@angular/core"]) {
+		const version = deps["@angular/core"];
+		if (isVersion(version, 19)) return DocumentationRouter.Angular_19;
+		return DocumentationRouter.Angular;
+	}
+	if (deps.lit) return DocumentationRouter.ViteAndLit;
+	if (deps["vanilla-intlayer"]) return DocumentationRouter.Vanilla;
+	if (deps.htmx || deps["htmx.org"]) return DocumentationRouter.HTMX;
+	if (deps.storybook || deps["@storybook/react"] || deps["@storybook/vue3"]) return DocumentationRouter.Storybook;
+	if (deps["@nestjs/core"]) return DocumentationRouter.NestJS;
+	if (deps["@adonisjs/core"]) return DocumentationRouter.AdonisJS;
+	if (deps.elysia) return DocumentationRouter.Elysia;
+	if (deps.hono) return DocumentationRouter.Hono;
+	if (deps.express) return DocumentationRouter.Express;
+	if (deps.fastify) return DocumentationRouter.Fastify;
+	if (deps["next-intl"]) return DocumentationRouter.NextIntl;
+	if (deps["react-i18next"] || deps.i18next) return DocumentationRouter.ReactI18Next;
+	if (deps["react-intl"]) return DocumentationRouter.ReactIntl;
+	if (deps["next-i18next"]) return DocumentationRouter.NextI18Next;
+	if (deps["vue-i18n"]) return DocumentationRouter.VueI18n;
+	return DocumentationRouter.Default;
+};
+
+//#endregion
+exports.DocumentationRouter = DocumentationRouter;
+exports.getDocumentationUrl = getDocumentationUrl;
+//# sourceMappingURL=documentationRouter.cjs.map

package/dist/cjs/init/documentationRouter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentationRouter.cjs","names":[],"sources":["../../../src/init/documentationRouter.ts"],"sourcesContent":["/**\n * Documentation URL Constants\n */\nexport const DocumentationRouter = {\n  NextJS: 'https://intlayer.org/doc/environment/nextjs',\n  NextJS_16: 'https://intlayer.org/doc/environment/nextjs',\n  NextJS_15: 'https://intlayer.org/doc/environment/nextjs/15',\n  NextJS_14: 'https://intlayer.org/doc/environment/nextjs/14',\n  NextJS_PageRouter:\n    'https://intlayer.org/doc/environment/nextjs/next-with-page-router',\n  CRA: 'https://intlayer.org/doc/environment/create-react-app',\n  Astro: 'https://intlayer.org/doc/environment/astro',\n  Astro_Lit: 'https://intlayer.org/doc/environment/astro/lit',\n  Astro_Preact: 'https://intlayer.org/doc/environment/astro/preact',\n  Astro_React: 'https://intlayer.org/doc/environment/astro/react',\n  Astro_Solid: 'https://intlayer.org/doc/environment/astro/solid',\n  Astro_Svelte: 'https://intlayer.org/doc/environment/astro/svelte',\n  Astro_Vue: 'https://intlayer.org/doc/environment/astro/vue',\n  ViteAndReact: 'https://intlayer.org/doc/environment/vite-and-react',\n  ViteAndReact_ReactRouterV7:\n    'https://intlayer.org/doc/environment/vite-and-react/react-router-v7',\n  ViteAndVue: 'https://intlayer.org/doc/environment/vite-and-vue',\n  ViteAndSolid: 'https://intlayer.org/doc/environment/vite-and-solid',\n  ViteAndSvelte: 'https://intlayer.org/doc/environment/vite-and-svelte',\n  ViteAndPreact: 'https://intlayer.org/doc/environment/vite-and-preact',\n  ViteAndLit: 'https://intlayer.org/doc/environment/vite-and-lit',\n  ViteAndVanilla: 'https://intlayer.org/doc/environment/vite-and-vanilla',\n  Vanilla: 'https://intlayer.org/doc/environment/vanilla',\n  TanStackRouter: 'https://intlayer.org/doc/environment/tanstack-start',\n  TanStackRouterAndSolid:\n    'https://intlayer.org/doc/environment/tanstack-start/solid',\n  SolidStart: 'https://intlayer.org/doc/environment/solid-start',\n  Analog: 'https://intlayer.org/doc/environment/analog',\n  Remix: 'https://intlayer.org/doc/environment/remix-3',\n  NuxtAndVue: 'https://intlayer.org/doc/environment/nuxt-and-vue',\n  Angular: 'https://intlayer.org/doc/environment/angular',\n  Angular_19: 'https://intlayer.org/doc/environment/angular/19',\n  SvelteKit: 'https://intlayer.org/doc/environment/sveltekit',\n  ReactNativeAndExpo:\n    'https://intlayer.org/doc/environment/react-native-and-expo',\n  Lynx: 'https://intlayer.org/doc/environment/lynx-and-react',\n  HTMX: 'https://intlayer.org/doc/environment/htmx',\n  Storybook: 'https://intlayer.org/doc/storybook',\n  Express: 'https://intlayer.org/doc/environment/express',\n  NestJS: 'https://intlayer.org/doc/environment/nest',\n  Fastify: 'https://intlayer.org/doc/environment/fastify',\n  Hono: 'https://intlayer.org/doc/environment/hono',\n  AdonisJS: 'https://intlayer.org/doc/environment/adonisjs',\n  Elysia: 'https://intlayer.org/doc/environment/elysia',\n  Default: 'https://intlayer.org/doc/get-started',\n\n  // Intlayer Language Server (Go-to-Definition from getter keys to .content files)\n  LSP: 'https://intlayer.org/doc/lsp',\n\n  // Lint rules for hardcoded text and non-optimizable dynamic calls\n  ESLint: 'https://intlayer.org/doc/eslint',\n\n  // Competitor / Compat libs\n  NextIntl: 'https://intlayer.org/doc/next-intl',\n  NextI18Next: 'https://intlayer.org/doc/next-i18next',\n  ReactI18Next: 'https://intlayer.org/doc/compatibility/react-i18next',\n  ReactIntl: 'https://intlayer.org/doc/compatibility/react-intl',\n  VueI18n: 'https://intlayer.org/doc/compatibility/vue-i18n',\n  NuxtI18n: 'https://intlayer.org/doc/compatibility/nuxtjs-i18n',\n  I18next: 'https://intlayer.org/doc/compatibility/i18next',\n};\n\nexport type DocumentationRouterType = typeof DocumentationRouter;\n\n/**\n * Helper: Detects the environment and returns the doc URL\n */\nexport const getDocumentationUrl = (packageJson: any): string => {\n  const deps = {\n    ...packageJson?.dependencies,\n    ...packageJson?.devDependencies,\n  };\n\n  /**\n   * Helper to check if a version string matches a specific major version\n   * Matches: \"15\", \"^15.0.0\", \"~15.2\", \"15.0.0-beta\"\n   */\n  const isVersion = (versionString: string, major: number): boolean => {\n    if (!versionString || typeof versionString !== 'string') return false;\n    const regex = new RegExp(`^[\\\\^~]?${major}(?:\\\\.|$)`);\n    return regex.test(versionString);\n  };\n\n  // Mobile / Cross-platform\n  if (deps['@lynx-js/react'] || deps['@lynx-js/core']) {\n    return DocumentationRouter.Lynx;\n  }\n  if (deps['react-native'] || deps.expo) {\n    return DocumentationRouter.ReactNativeAndExpo;\n  }\n\n  // Meta-frameworks (Next, Nuxt, Astro, SvelteKit)\n  if (deps.next) {\n    const version = deps.next;\n\n    if (isVersion(version, 14)) {\n      return DocumentationRouter.NextJS_14;\n    }\n\n    if (isVersion(version, 15)) {\n      return DocumentationRouter.NextJS_15;\n    }\n\n    return DocumentationRouter.NextJS;\n  }\n\n  if (deps.nuxt) return DocumentationRouter.NuxtAndVue;\n\n  if (deps.astro) {\n    if (deps['@astrojs/react'] || deps.react)\n      return DocumentationRouter.Astro_React;\n    if (deps['@astrojs/vue'] || deps.vue) return DocumentationRouter.Astro_Vue;\n    if (deps['@astrojs/svelte'] || deps.svelte)\n      return DocumentationRouter.Astro_Svelte;\n    if (deps['@astrojs/solid-js'] || deps['solid-js'])\n      return DocumentationRouter.Astro_Solid;\n    if (deps['@astrojs/preact'] || deps.preact)\n      return DocumentationRouter.Astro_Preact;\n    if (deps['@astrojs/lit'] || deps.lit) return DocumentationRouter.Astro_Lit;\n\n    return DocumentationRouter.Astro;\n  }\n\n  if (deps['@sveltejs/kit']) return DocumentationRouter.SvelteKit;\n  if (deps['@analogjs/platform']) return DocumentationRouter.Analog;\n  if (deps['@solidjs/start']) return DocumentationRouter.SolidStart;\n  if (deps.remix || deps['remix-intlayer']) return DocumentationRouter.Remix;\n\n  // Routers (TanStack & React Router v7)\n  if (deps['@tanstack/react-router']) {\n    return DocumentationRouter.TanStackRouter;\n  }\n  if (deps['@tanstack/solid-router']) {\n    return DocumentationRouter.TanStackRouterAndSolid;\n  }\n  if (deps['@tanstack/start']) {\n    if (deps['solid-js'] || deps['@tanstack/solid-router']) {\n      return DocumentationRouter.TanStackRouterAndSolid;\n    }\n    return DocumentationRouter.TanStackRouter;\n  }\n\n  // Check for React Router v7 (the guide covers both config and FS routes)\n  const reactRouterVersion = deps['react-router'];\n  if (\n    typeof reactRouterVersion === 'string' &&\n    (deps['@react-router/fs-routes'] || isVersion(reactRouterVersion, 7))\n  ) {\n    return DocumentationRouter.ViteAndReact_ReactRouterV7;\n  }\n\n  // Vite Ecosystem (General)\n  if (deps.vite) {\n    if (deps.vue) return DocumentationRouter.ViteAndVue;\n    if (deps['solid-js']) return DocumentationRouter.ViteAndSolid;\n    if (deps.svelte) return DocumentationRouter.ViteAndSvelte;\n    if (deps.preact) return DocumentationRouter.ViteAndPreact;\n    if (deps.lit) return DocumentationRouter.ViteAndLit;\n    if (deps['vanilla-intlayer']) return DocumentationRouter.ViteAndVanilla;\n\n    // Default to React if Vite is present but specific other frameworks aren't found\n    return DocumentationRouter.ViteAndReact;\n  }\n\n  // Other Web Frameworks\n  if (deps['react-scripts']) return DocumentationRouter.CRA;\n  if (deps['@angular/core']) {\n    const version = deps['@angular/core'];\n    if (isVersion(version, 19)) {\n      return DocumentationRouter.Angular_19;\n    }\n    return DocumentationRouter.Angular;\n  }\n  if (deps.lit) return DocumentationRouter.ViteAndLit;\n  if (deps['vanilla-intlayer']) return DocumentationRouter.Vanilla;\n  if (deps.htmx || deps['htmx.org']) return DocumentationRouter.HTMX;\n  if (deps.storybook || deps['@storybook/react'] || deps['@storybook/vue3'])\n    return DocumentationRouter.Storybook;\n\n  // Backend\n  // NestJS first: it runs on top of Express (or Fastify), so both dependencies\n  // are present and the more specific one has to win.\n  if (deps['@nestjs/core']) return DocumentationRouter.NestJS;\n  if (deps['@adonisjs/core']) return DocumentationRouter.AdonisJS;\n  if (deps.elysia) return DocumentationRouter.Elysia;\n  if (deps.hono) return DocumentationRouter.Hono;\n  if (deps.express) return DocumentationRouter.Express;\n  if (deps.fastify) return DocumentationRouter.Fastify;\n\n  // Competitor Libs (Migration Guides)\n  // We check these last as specific environment setup is usually higher priority,\n  // but if no specific framework logic matched (or as a fallback), we guide to migration.\n  if (deps['next-intl']) return DocumentationRouter.NextIntl;\n  if (deps['react-i18next'] || deps.i18next)\n    return DocumentationRouter.ReactI18Next;\n  if (deps['react-intl']) return DocumentationRouter.ReactIntl;\n  if (deps['next-i18next']) return DocumentationRouter.NextI18Next;\n  if (deps['vue-i18n']) return DocumentationRouter.VueI18n;\n\n  return DocumentationRouter.Default;\n};\n"],"mappings":"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"}

package/dist/cjs/init/frameworkSetup/backend/index.cjs

@@ -0,0 +1,138 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_init_utils_fileSystem = require('../../utils/fileSystem.cjs');
+const require_init_frameworkSetup_backend_transforms = require('./transforms.cjs');
+let _intlayer_config_colors = require("@intlayer/config/colors");
+_intlayer_config_colors = require_runtime.__toESM(_intlayer_config_colors);
+let _intlayer_config_logger = require("@intlayer/config/logger");
+
+//#region src/init/frameworkSetup/backend/index.ts
+/** Script extensions probed for a server entry file. */
+const ENTRY_EXTENSIONS = [
+	"ts",
+	"mts",
+	"js",
+	"mjs",
+	"cjs"
+];
+/** Conventional server entry file names, most likely first. */
+const DEFAULT_ENTRY_BASE_NAMES = [
+	"src/index",
+	"src/server",
+	"src/app",
+	"src/main",
+	"index",
+	"server",
+	"app",
+	"main"
+];
+/**
+* Lists the candidate server entry files: the `package.json` `main` field when
+* it points at source (not a build output), then the conventional names.
+*/
+const getEntryCandidates = async (rootDir, entryBaseNames) => {
+	const candidates = [];
+	try {
+		const { main } = JSON.parse(await require_init_utils_fileSystem.readFileFromRoot(rootDir, "package.json"));
+		if (typeof main === "string" && !/^(\.\/)?(dist|build|out)\//.test(main)) candidates.push(main.replace(/^\.\//, ""));
+	} catch {}
+	for (const baseName of entryBaseNames) for (const extension of ENTRY_EXTENSIONS) candidates.push(`${baseName}.${extension}`);
+	return [...new Set(candidates)];
+};
+/**
+* Registers the middleware in the first candidate entry file the transform
+* recognizes. Files the transform cannot confidently edit are left untouched;
+* when none matches, guidance is logged instead.
+*/
+const registerBackendMiddleware = async (rootDir, integration) => {
+	(0, _intlayer_config_logger.logger)((0, _intlayer_config_logger.colorize)(`Setting up ${integration.name} integration...`, _intlayer_config_colors.CYAN));
+	const candidates = await getEntryCandidates(rootDir, integration.entryBaseNames);
+	for (const candidate of candidates) {
+		if (!await require_init_utils_fileSystem.exists(rootDir, candidate)) continue;
+		const code = await require_init_utils_fileSystem.readFileFromRoot(rootDir, candidate);
+		let result;
+		try {
+			result = integration.transform(code);
+		} catch {
+			continue;
+		}
+		if (result.status === "already") {
+			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(candidate)} already registers the Intlayer middleware`);
+			return;
+		}
+		if (result.status === "registered") {
+			await require_init_utils_fileSystem.writeFileToRoot(rootDir, candidate, result.code);
+			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Registered ${(0, _intlayer_config_logger.colorize)(integration.registrationHint, _intlayer_config_colors.MAGENTA)} in ${(0, _intlayer_config_logger.colorizePath)(candidate)}`);
+			return;
+		}
+	}
+	(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not find where your ${integration.name} app is created — add ${(0, _intlayer_config_logger.colorize)(integration.registrationHint, _intlayer_config_colors.MAGENTA)} manually: ${(0, _intlayer_config_logger.colorizePath)(integration.documentationUrl)}`, { level: "warn" });
+};
+/** Wraps a backend integration into a framework adapter. */
+const createBackendAdapter = (integration) => ({
+	name: integration.name,
+	detect: ({ allDeps }) => integration.detect(allDeps),
+	setup: ({ rootDir }) => registerBackendMiddleware(rootDir, integration)
+});
+/**
+* NestJS on the Express platform. Checked before Express: a Nest app is
+* created by `NestFactory`, not `express()`. Nest on Fastify is left to the
+* guide (its adapter is registered through the Fastify instance).
+*/
+const nestJsAdapter = createBackendAdapter({
+	name: "NestJS",
+	detect: (allDeps) => Boolean(allDeps["@nestjs/core"]) && !allDeps["@nestjs/platform-fastify"],
+	entryBaseNames: ["src/main", "main"],
+	transform: require_init_frameworkSetup_backend_transforms.registerNestJsMiddleware,
+	registrationHint: "app.use(intlayer())",
+	documentationUrl: "https://intlayer.org/doc/environment/nest.md"
+});
+const expressAdapter = createBackendAdapter({
+	name: "Express",
+	detect: (allDeps) => Boolean(allDeps.express),
+	entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,
+	transform: require_init_frameworkSetup_backend_transforms.registerExpressMiddleware,
+	registrationHint: "app.use(intlayer())",
+	documentationUrl: "https://intlayer.org/doc/environment/express.md"
+});
+const fastifyAdapter = createBackendAdapter({
+	name: "Fastify",
+	detect: (allDeps) => Boolean(allDeps.fastify),
+	entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,
+	transform: require_init_frameworkSetup_backend_transforms.registerFastifyPlugin,
+	registrationHint: "fastify.register(intlayer)",
+	documentationUrl: "https://intlayer.org/doc/environment/fastify.md"
+});
+const honoAdapter = createBackendAdapter({
+	name: "Hono",
+	detect: (allDeps) => Boolean(allDeps.hono),
+	entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,
+	transform: require_init_frameworkSetup_backend_transforms.registerHonoMiddleware,
+	registrationHint: "app.use(\"*\", intlayer())",
+	documentationUrl: "https://intlayer.org/doc/environment/hono.md"
+});
+const elysiaAdapter = createBackendAdapter({
+	name: "Elysia",
+	detect: (allDeps) => Boolean(allDeps.elysia),
+	entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,
+	transform: require_init_frameworkSetup_backend_transforms.registerElysiaPlugin,
+	registrationHint: "new Elysia().use(intlayer())",
+	documentationUrl: "https://intlayer.org/doc/environment/elysia.md"
+});
+/** Backend adapters, in detection order. */
+const backendAdapters = [
+	nestJsAdapter,
+	expressAdapter,
+	fastifyAdapter,
+	honoAdapter,
+	elysiaAdapter
+];
+
+//#endregion
+exports.backendAdapters = backendAdapters;
+exports.elysiaAdapter = elysiaAdapter;
+exports.expressAdapter = expressAdapter;
+exports.fastifyAdapter = fastifyAdapter;
+exports.honoAdapter = honoAdapter;
+exports.nestJsAdapter = nestJsAdapter;
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/init/frameworkSetup/backend/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["readFileFromRoot","colorize","ANSIColors","exists","v","colorizePath","writeFileToRoot","x","registerNestJsMiddleware","registerExpressMiddleware","registerFastifyPlugin","registerHonoMiddleware","registerElysiaPlugin"],"sources":["../../../../../src/init/frameworkSetup/backend/index.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizePath, logger, v, x } from '@intlayer/config/logger';\nimport {\n  exists,\n  readFileFromRoot,\n  writeFileToRoot,\n} from '../../utils/fileSystem';\nimport type { FrameworkAdapter } from '../types';\nimport {\n  type BackendTransformResult,\n  registerElysiaPlugin,\n  registerExpressMiddleware,\n  registerFastifyPlugin,\n  registerHonoMiddleware,\n  registerNestJsMiddleware,\n} from './transforms';\n\n/** Script extensions probed for a server entry file. */\nconst ENTRY_EXTENSIONS = ['ts', 'mts', 'js', 'mjs', 'cjs'] as const;\n\n/** Conventional server entry file names, most likely first. */\nconst DEFAULT_ENTRY_BASE_NAMES = [\n  'src/index',\n  'src/server',\n  'src/app',\n  'src/main',\n  'index',\n  'server',\n  'app',\n  'main',\n] as const;\n\n/**\n * Lists the candidate server entry files: the `package.json` `main` field when\n * it points at source (not a build output), then the conventional names.\n */\nconst getEntryCandidates = async (\n  rootDir: string,\n  entryBaseNames: readonly string[]\n): Promise<string[]> => {\n  const candidates: string[] = [];\n\n  try {\n    const { main } = JSON.parse(\n      await readFileFromRoot(rootDir, 'package.json')\n    );\n    const isSourceEntry =\n      typeof main === 'string' && !/^(\\.\\/)?(dist|build|out)\\//.test(main);\n    if (isSourceEntry) candidates.push(main.replace(/^\\.\\//, ''));\n  } catch {\n    // No readable package.json — rely on the conventional names.\n  }\n\n  for (const baseName of entryBaseNames) {\n    for (const extension of ENTRY_EXTENSIONS) {\n      candidates.push(`${baseName}.${extension}`);\n    }\n  }\n\n  return [...new Set(candidates)];\n};\n\n/** A server framework whose Intlayer middleware can be registered by init. */\ntype BackendIntegration = {\n  /** Human-readable framework name, used in logs. */\n  name: string;\n  /** Returns true when the project uses this framework. */\n  detect: (allDeps: Record<string, string>) => boolean;\n  /** Entry file base names to probe, in order. */\n  entryBaseNames: readonly string[];\n  /** Registers the middleware in an entry file's source. */\n  transform: (code: string) => BackendTransformResult;\n  /** How the registration reads, shown in logs and manual-setup guidance. */\n  registrationHint: string;\n  /** Guide for a manual setup. */\n  documentationUrl: string;\n};\n\n/**\n * Registers the middleware in the first candidate entry file the transform\n * recognizes. Files the transform cannot confidently edit are left untouched;\n * when none matches, guidance is logged instead.\n */\nconst registerBackendMiddleware = async (\n  rootDir: string,\n  integration: BackendIntegration\n): Promise<void> => {\n  logger(\n    colorize(`Setting up ${integration.name} integration...`, ANSIColors.CYAN)\n  );\n\n  const candidates = await getEntryCandidates(\n    rootDir,\n    integration.entryBaseNames\n  );\n\n  for (const candidate of candidates) {\n    if (!(await exists(rootDir, candidate))) continue;\n\n    const code = await readFileFromRoot(rootDir, candidate);\n\n    let result: BackendTransformResult;\n    try {\n      result = integration.transform(code);\n    } catch {\n      // Unparsable file — try the next candidate.\n      continue;\n    }\n\n    if (result.status === 'already') {\n      logger(\n        `${v} ${colorizePath(candidate)} already registers the Intlayer middleware`\n      );\n      return;\n    }\n\n    if (result.status === 'registered') {\n      await writeFileToRoot(rootDir, candidate, result.code);\n      logger(\n        `${v} Registered ${colorize(integration.registrationHint, ANSIColors.MAGENTA)} in ${colorizePath(candidate)}`\n      );\n      return;\n    }\n  }\n\n  logger(\n    `${x} Could not find where your ${integration.name} app is created — add ${colorize(integration.registrationHint, ANSIColors.MAGENTA)} manually: ${colorizePath(integration.documentationUrl)}`,\n    { level: 'warn' }\n  );\n};\n\n/** Wraps a backend integration into a framework adapter. */\nconst createBackendAdapter = (\n  integration: BackendIntegration\n): FrameworkAdapter => ({\n  name: integration.name,\n  detect: ({ allDeps }) => integration.detect(allDeps),\n  setup: ({ rootDir }) => registerBackendMiddleware(rootDir, integration),\n});\n\n/**\n * NestJS on the Express platform. Checked before Express: a Nest app is\n * created by `NestFactory`, not `express()`. Nest on Fastify is left to the\n * guide (its adapter is registered through the Fastify instance).\n */\nexport const nestJsAdapter = createBackendAdapter({\n  name: 'NestJS',\n  detect: (allDeps) =>\n    Boolean(allDeps['@nestjs/core']) && !allDeps['@nestjs/platform-fastify'],\n  entryBaseNames: ['src/main', 'main'],\n  transform: registerNestJsMiddleware,\n  registrationHint: 'app.use(intlayer())',\n  documentationUrl: 'https://intlayer.org/doc/environment/nest.md',\n});\n\nexport const expressAdapter = createBackendAdapter({\n  name: 'Express',\n  detect: (allDeps) => Boolean(allDeps.express),\n  entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,\n  transform: registerExpressMiddleware,\n  registrationHint: 'app.use(intlayer())',\n  documentationUrl: 'https://intlayer.org/doc/environment/express.md',\n});\n\nexport const fastifyAdapter = createBackendAdapter({\n  name: 'Fastify',\n  detect: (allDeps) => Boolean(allDeps.fastify),\n  entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,\n  transform: registerFastifyPlugin,\n  registrationHint: 'fastify.register(intlayer)',\n  documentationUrl: 'https://intlayer.org/doc/environment/fastify.md',\n});\n\nexport const honoAdapter = createBackendAdapter({\n  name: 'Hono',\n  detect: (allDeps) => Boolean(allDeps.hono),\n  entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,\n  transform: registerHonoMiddleware,\n  registrationHint: 'app.use(\"*\", intlayer())',\n  documentationUrl: 'https://intlayer.org/doc/environment/hono.md',\n});\n\nexport const elysiaAdapter = createBackendAdapter({\n  name: 'Elysia',\n  detect: (allDeps) => Boolean(allDeps.elysia),\n  entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,\n  transform: registerElysiaPlugin,\n  registrationHint: 'new Elysia().use(intlayer())',\n  documentationUrl: 'https://intlayer.org/doc/environment/elysia.md',\n});\n\n/** Backend adapters, in detection order. */\nexport const backendAdapters: FrameworkAdapter[] = [\n  nestJsAdapter,\n  expressAdapter,\n  fastifyAdapter,\n  honoAdapter,\n  elysiaAdapter,\n];\n"],"mappings":"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"}

package/dist/cjs/init/frameworkSetup/backend/transforms.cjs

@@ -0,0 +1,223 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_utils_babelParser = require('../../../utils/babelParser.cjs');
+const require_init_utils_astImports = require('../../utils/astImports.cjs');
+let recast = require("recast");
+recast = require_runtime.__toESM(recast);
+
+//#region src/init/frameworkSetup/backend/transforms.ts
+const { namedTypes: n } = recast.types;
+/** Local name the injected middleware / plugin factory is bound to. */
+const MIDDLEWARE_IDENTIFIER = "intlayer";
+/** babel-ts parser handles TypeScript *and* plain JavaScript. */
+const parseCode = (code) => recast.parse(code, { parser: require_utils_babelParser.babelTsParser });
+/** Parses a single statement. */
+const parseStatement = (code) => parseCode(code).program.body[0];
+/** Whether `node` is a `require("<source>")` call. */
+const isRequireOf = (node, source) => node?.type === "CallExpression" && node.callee?.type === "Identifier" && node.callee.name === "require" && node.arguments[0]?.value === source;
+/**
+* Resolves the local names a factory is bound to at module scope, from ESM
+* imports (`import express from "express"`, `import { Hono } from "hono"`) or
+* CommonJS requires (`const express = require("express")`,
+* `const { Hono } = require("hono")`).
+*/
+const findFactoryLocalNames = (ast, factory) => {
+	const localNames = [];
+	const acceptsNamed = (name) => factory.named?.includes(name) ?? false;
+	for (const statement of ast.program.body) {
+		if (statement.type === "ImportDeclaration" && statement.source.value === factory.source) for (const specifier of statement.specifiers) {
+			const isAcceptedDefault = specifier.type === "ImportDefaultSpecifier" && factory.default;
+			const isAcceptedNamed = specifier.type === "ImportSpecifier" && acceptsNamed(specifier.imported.name);
+			if (isAcceptedDefault || isAcceptedNamed) localNames.push(specifier.local.name);
+		}
+		if (statement.type !== "VariableDeclaration") continue;
+		for (const declarator of statement.declarations) {
+			if (!isRequireOf(declarator.init, factory.source)) continue;
+			if (declarator.id.type === "Identifier" && factory.default) localNames.push(declarator.id.name);
+			if (declarator.id.type === "ObjectPattern") {
+				for (const property of declarator.id.properties) if (property.key?.type === "Identifier" && property.value?.type === "Identifier" && acceptsNamed(property.key.name)) localNames.push(property.value.name);
+			}
+		}
+	}
+	return localNames;
+};
+/** Whether the module uses CommonJS (`require`) rather than ESM imports. */
+const isCommonJsModule = (ast) => !ast.program.body.some((statement) => statement.type === "ImportDeclaration" || statement.type === "ExportNamedDeclaration" || statement.type === "ExportDefaultDeclaration") && ast.program.body.some((statement) => statement.type === "VariableDeclaration" && statement.declarations.some((declarator) => declarator.init?.type === "CallExpression" && declarator.init.callee?.name === "require"));
+/**
+* Binds `intlayer` from `source`: an ESM named import, or — in a CommonJS
+* module — `const { intlayer } = require("<source>");` placed after the last
+* top-level `require`.
+*/
+const ensureMiddlewareBinding = (ast, source) => {
+	if (!isCommonJsModule(ast)) {
+		require_init_utils_astImports.ensureNamedImport(ast, MIDDLEWARE_IDENTIFIER, source);
+		return;
+	}
+	const body = ast.program.body;
+	let insertIndex = 0;
+	body.forEach((statement, index) => {
+		if (statement.type === "VariableDeclaration" && statement.declarations.some((declarator) => declarator.init?.callee?.name === "require")) insertIndex = index + 1;
+	});
+	body.splice(insertIndex, 0, parseStatement(`const { ${MIDDLEWARE_IDENTIFIER} } = require("${source}");`));
+};
+/**
+* Finds the first `const <app> = <init>` whose initializer matches, returning
+* the app identifier and the statement path to insert after. `export const`
+* declarations resolve to the export statement.
+*/
+const findAppDeclaration = (ast, matchesInit) => {
+	let found = null;
+	recast.visit(ast, { visitVariableDeclarator(path) {
+		const { id, init } = path.node;
+		if (!found && id.type === "Identifier" && init && matchesInit(init)) {
+			let statementPath = path.parent;
+			if (statementPath.parent?.node.type === "ExportNamedDeclaration") statementPath = statementPath.parent;
+			found = {
+				appName: id.name,
+				statementPath
+			};
+			return false;
+		}
+		this.traverse(path);
+	} });
+	return found;
+};
+/** Whether `node` calls one of `calleeNames` directly (`express()`, `new Hono()`). */
+const isFactoryCall = (node, calleeNames, type) => node?.type === type && node.callee?.type === "Identifier" && calleeNames.includes(node.callee.name);
+/**
+* Shared flow of the "declare the app, then register the middleware on the
+* next line" frameworks (Express, Fastify, Hono, NestJS).
+*/
+const registerAfterAppDeclaration = (code, { middlewareSource, findDeclaration, buildRegistration }) => {
+	if (code.includes(middlewareSource)) return {
+		code,
+		status: "already"
+	};
+	const ast = parseCode(code);
+	if (require_init_utils_astImports.isModuleScopeBinding(ast, MIDDLEWARE_IDENTIFIER)) return {
+		code,
+		status: "skipped"
+	};
+	const declaration = findDeclaration(ast);
+	if (!declaration) return {
+		code,
+		status: "skipped"
+	};
+	declaration.statementPath.insertAfter(parseStatement(buildRegistration(declaration.appName)));
+	ensureMiddlewareBinding(ast, middlewareSource);
+	return {
+		code: recast.print(ast).code,
+		status: "registered"
+	};
+};
+/**
+* Registers `express-intlayer` right after `const app = express()`:
+* `app.use(intlayer());`.
+*/
+const registerExpressMiddleware = (code) => registerAfterAppDeclaration(code, {
+	middlewareSource: "express-intlayer",
+	findDeclaration: (ast) => {
+		const factoryNames = findFactoryLocalNames(ast, {
+			source: "express",
+			default: true
+		});
+		return findAppDeclaration(ast, (init) => isFactoryCall(init, factoryNames, "CallExpression"));
+	},
+	buildRegistration: (appName) => `${appName}.use(intlayer());`
+});
+/**
+* Registers `fastify-intlayer` right after `const app = Fastify()`:
+* `app.register(intlayer);`. Not awaited, so it also works in CommonJS and
+* non-async scopes — Fastify queues plugins until `ready`/`listen`.
+*/
+const registerFastifyPlugin = (code) => registerAfterAppDeclaration(code, {
+	middlewareSource: "fastify-intlayer",
+	findDeclaration: (ast) => {
+		const factoryNames = findFactoryLocalNames(ast, {
+			source: "fastify",
+			default: true,
+			named: ["fastify", "Fastify"]
+		});
+		return findAppDeclaration(ast, (init) => isFactoryCall(init, factoryNames, "CallExpression"));
+	},
+	buildRegistration: (appName) => `${appName}.register(intlayer);`
+});
+/**
+* Registers `hono-intlayer` right after `const app = new Hono()`:
+* `app.use("*", intlayer());`. A chained declaration
+* (`new Hono().get(…)`) is skipped: its routes would be registered before the
+* middleware, which Hono runs in registration order.
+*/
+const registerHonoMiddleware = (code) => registerAfterAppDeclaration(code, {
+	middlewareSource: "hono-intlayer",
+	findDeclaration: (ast) => {
+		const factoryNames = findFactoryLocalNames(ast, {
+			source: "hono",
+			named: ["Hono"]
+		});
+		return findAppDeclaration(ast, (init) => isFactoryCall(init, factoryNames, "NewExpression"));
+	},
+	buildRegistration: (appName) => `${appName}.use("*", intlayer());`
+});
+/**
+* Registers `express-intlayer` on a NestJS (Express platform) app right after
+* `const app = await NestFactory.create(…)`: `app.use(intlayer());`.
+*/
+const registerNestJsMiddleware = (code) => registerAfterAppDeclaration(code, {
+	middlewareSource: "express-intlayer",
+	findDeclaration: (ast) => findAppDeclaration(ast, (init) => {
+		const call = init.type === "AwaitExpression" ? init.argument : init;
+		return n.CallExpression.check(call) && n.MemberExpression.check(call.callee) && call.callee.object.name === "NestFactory" && call.callee.property.name === "create";
+	}),
+	buildRegistration: (appName) => `${appName}.use(intlayer());`
+});
+/**
+* Registers `elysia-intlayer` directly on the app constructor:
+* `new Elysia()` → `new Elysia().use(intlayer())`. Works for chained
+* declarations too, and keeps the plugin ahead of every route.
+*/
+const registerElysiaPlugin = (code) => {
+	const middlewareSource = "elysia-intlayer";
+	if (code.includes(middlewareSource)) return {
+		code,
+		status: "already"
+	};
+	const ast = parseCode(code);
+	if (require_init_utils_astImports.isModuleScopeBinding(ast, MIDDLEWARE_IDENTIFIER)) return {
+		code,
+		status: "skipped"
+	};
+	const factoryNames = findFactoryLocalNames(ast, {
+		source: "elysia",
+		named: ["Elysia"]
+	});
+	let registered = false;
+	recast.visit(ast, { visitNewExpression(path) {
+		if (registered) return false;
+		if (isFactoryCall(path.node, factoryNames, "NewExpression")) {
+			const withPlugin = parseStatement("__app__.use(intlayer());").expression;
+			withPlugin.callee.object = path.node;
+			path.replace(withPlugin);
+			registered = true;
+			return false;
+		}
+		this.traverse(path);
+	} });
+	if (!registered) return {
+		code,
+		status: "skipped"
+	};
+	ensureMiddlewareBinding(ast, middlewareSource);
+	return {
+		code: recast.print(ast).code,
+		status: "registered"
+	};
+};
+
+//#endregion
+exports.registerElysiaPlugin = registerElysiaPlugin;
+exports.registerExpressMiddleware = registerExpressMiddleware;
+exports.registerFastifyPlugin = registerFastifyPlugin;
+exports.registerHonoMiddleware = registerHonoMiddleware;
+exports.registerNestJsMiddleware = registerNestJsMiddleware;
+//# sourceMappingURL=transforms.cjs.map

package/dist/cjs/init/frameworkSetup/backend/transforms.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.cjs","names":["babelTsParser","isModuleScopeBinding"],"sources":["../../../../../src/init/frameworkSetup/backend/transforms.ts"],"sourcesContent":["import * as recast from 'recast';\nimport { babelTsParser } from '../../../utils/babelParser';\nimport {\n  ensureNamedImport,\n  isModuleScopeBinding,\n} from '../../utils/astImports';\n\nconst { namedTypes: n } = recast.types;\n\n/** Local name the injected middleware / plugin factory is bound to. */\nconst MIDDLEWARE_IDENTIFIER = 'intlayer';\n\n/** babel-ts parser handles TypeScript *and* plain JavaScript. */\nconst parseCode = (code: string): any =>\n  recast.parse(code, { parser: babelTsParser });\n\n/** Parses a single statement. */\nconst parseStatement = (code: string): any => parseCode(code).program.body[0];\n\n/** Result of a backend transform. `code` is unchanged for any non-`registered` status. */\nexport type BackendTransformResult = {\n  code: string;\n  status: 'registered' | 'already' | 'skipped';\n};\n\n/** How a server framework exposes its app factory. */\ntype FactoryImport = {\n  /** Module the factory is imported from, e.g. `express`. */\n  source: string;\n  /** Accepted forms: the default export, and/or these named exports. */\n  default?: boolean;\n  named?: string[];\n};\n\n/** Whether `node` is a `require(\"<source>\")` call. */\nconst isRequireOf = (node: any, source: string): boolean =>\n  node?.type === 'CallExpression' &&\n  node.callee?.type === 'Identifier' &&\n  node.callee.name === 'require' &&\n  node.arguments[0]?.value === source;\n\n/**\n * Resolves the local names a factory is bound to at module scope, from ESM\n * imports (`import express from \"express\"`, `import { Hono } from \"hono\"`) or\n * CommonJS requires (`const express = require(\"express\")`,\n * `const { Hono } = require(\"hono\")`).\n */\nconst findFactoryLocalNames = (ast: any, factory: FactoryImport): string[] => {\n  const localNames: string[] = [];\n  const acceptsNamed = (name: string): boolean =>\n    factory.named?.includes(name) ?? false;\n\n  for (const statement of ast.program.body) {\n    if (\n      statement.type === 'ImportDeclaration' &&\n      statement.source.value === factory.source\n    ) {\n      for (const specifier of statement.specifiers) {\n        const isAcceptedDefault =\n          specifier.type === 'ImportDefaultSpecifier' && factory.default;\n        const isAcceptedNamed =\n          specifier.type === 'ImportSpecifier' &&\n          acceptsNamed(specifier.imported.name);\n        if (isAcceptedDefault || isAcceptedNamed) {\n          localNames.push(specifier.local.name);\n        }\n      }\n    }\n\n    if (statement.type !== 'VariableDeclaration') continue;\n\n    for (const declarator of statement.declarations) {\n      if (!isRequireOf(declarator.init, factory.source)) continue;\n\n      if (declarator.id.type === 'Identifier' && factory.default) {\n        localNames.push(declarator.id.name);\n      }\n      if (declarator.id.type === 'ObjectPattern') {\n        for (const property of declarator.id.properties) {\n          if (\n            property.key?.type === 'Identifier' &&\n            property.value?.type === 'Identifier' &&\n            acceptsNamed(property.key.name)\n          ) {\n            localNames.push(property.value.name);\n          }\n        }\n      }\n    }\n  }\n\n  return localNames;\n};\n\n/** Whether the module uses CommonJS (`require`) rather than ESM imports. */\nconst isCommonJsModule = (ast: any): boolean =>\n  !ast.program.body.some(\n    (statement: any) =>\n      statement.type === 'ImportDeclaration' ||\n      statement.type === 'ExportNamedDeclaration' ||\n      statement.type === 'ExportDefaultDeclaration'\n  ) &&\n  ast.program.body.some(\n    (statement: any) =>\n      statement.type === 'VariableDeclaration' &&\n      statement.declarations.some(\n        (declarator: any) =>\n          declarator.init?.type === 'CallExpression' &&\n          declarator.init.callee?.name === 'require'\n      )\n  );\n\n/**\n * Binds `intlayer` from `source`: an ESM named import, or — in a CommonJS\n * module — `const { intlayer } = require(\"<source>\");` placed after the last\n * top-level `require`.\n */\nconst ensureMiddlewareBinding = (ast: any, source: string): void => {\n  if (!isCommonJsModule(ast)) {\n    ensureNamedImport(ast, MIDDLEWARE_IDENTIFIER, source);\n    return;\n  }\n\n  const body = ast.program.body;\n  let insertIndex = 0;\n  body.forEach((statement: any, index: number) => {\n    const isRequireDeclaration =\n      statement.type === 'VariableDeclaration' &&\n      statement.declarations.some(\n        (declarator: any) => declarator.init?.callee?.name === 'require'\n      );\n    if (isRequireDeclaration) insertIndex = index + 1;\n  });\n\n  body.splice(\n    insertIndex,\n    0,\n    parseStatement(`const { ${MIDDLEWARE_IDENTIFIER} } = require(\"${source}\");`)\n  );\n};\n\n/**\n * Finds the first `const <app> = <init>` whose initializer matches, returning\n * the app identifier and the statement path to insert after. `export const`\n * declarations resolve to the export statement.\n */\nconst findAppDeclaration = (\n  ast: any,\n  matchesInit: (init: any) => boolean\n): { appName: string; statementPath: any } | null => {\n  let found: { appName: string; statementPath: any } | null = null;\n\n  recast.visit(ast, {\n    visitVariableDeclarator(path) {\n      const { id, init } = path.node as any;\n      if (!found && id.type === 'Identifier' && init && matchesInit(init)) {\n        let statementPath = path.parent;\n        if (statementPath.parent?.node.type === 'ExportNamedDeclaration') {\n          statementPath = statementPath.parent;\n        }\n        found = { appName: id.name, statementPath };\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n\n  return found;\n};\n\n/** Whether `node` calls one of `calleeNames` directly (`express()`, `new Hono()`). */\nconst isFactoryCall = (\n  node: any,\n  calleeNames: string[],\n  type: 'CallExpression' | 'NewExpression'\n): boolean =>\n  node?.type === type &&\n  node.callee?.type === 'Identifier' &&\n  calleeNames.includes(node.callee.name);\n\n/**\n * Shared flow of the \"declare the app, then register the middleware on the\n * next line\" frameworks (Express, Fastify, Hono, NestJS).\n */\nconst registerAfterAppDeclaration = (\n  code: string,\n  {\n    middlewareSource,\n    findDeclaration,\n    buildRegistration,\n  }: {\n    middlewareSource: string;\n    findDeclaration: (ast: any) => ReturnType<typeof findAppDeclaration>;\n    buildRegistration: (appName: string) => string;\n  }\n): BackendTransformResult => {\n  if (code.includes(middlewareSource)) return { code, status: 'already' };\n\n  const ast = parseCode(code);\n  if (isModuleScopeBinding(ast, MIDDLEWARE_IDENTIFIER)) {\n    return { code, status: 'skipped' };\n  }\n\n  const declaration = findDeclaration(ast);\n  if (!declaration) return { code, status: 'skipped' };\n\n  declaration.statementPath.insertAfter(\n    parseStatement(buildRegistration(declaration.appName))\n  );\n  ensureMiddlewareBinding(ast, middlewareSource);\n\n  return { code: recast.print(ast).code, status: 'registered' };\n};\n\n/**\n * Registers `express-intlayer` right after `const app = express()`:\n * `app.use(intlayer());`.\n */\nexport const registerExpressMiddleware = (\n  code: string\n): BackendTransformResult =>\n  registerAfterAppDeclaration(code, {\n    middlewareSource: 'express-intlayer',\n    findDeclaration: (ast) => {\n      const factoryNames = findFactoryLocalNames(ast, {\n        source: 'express',\n        default: true,\n      });\n      return findAppDeclaration(ast, (init) =>\n        isFactoryCall(init, factoryNames, 'CallExpression')\n      );\n    },\n    buildRegistration: (appName) => `${appName}.use(intlayer());`,\n  });\n\n/**\n * Registers `fastify-intlayer` right after `const app = Fastify()`:\n * `app.register(intlayer);`. Not awaited, so it also works in CommonJS and\n * non-async scopes — Fastify queues plugins until `ready`/`listen`.\n */\nexport const registerFastifyPlugin = (code: string): BackendTransformResult =>\n  registerAfterAppDeclaration(code, {\n    middlewareSource: 'fastify-intlayer',\n    findDeclaration: (ast) => {\n      const factoryNames = findFactoryLocalNames(ast, {\n        source: 'fastify',\n        default: true,\n        named: ['fastify', 'Fastify'],\n      });\n      return findAppDeclaration(ast, (init) =>\n        isFactoryCall(init, factoryNames, 'CallExpression')\n      );\n    },\n    buildRegistration: (appName) => `${appName}.register(intlayer);`,\n  });\n\n/**\n * Registers `hono-intlayer` right after `const app = new Hono()`:\n * `app.use(\"*\", intlayer());`. A chained declaration\n * (`new Hono().get(…)`) is skipped: its routes would be registered before the\n * middleware, which Hono runs in registration order.\n */\nexport const registerHonoMiddleware = (code: string): BackendTransformResult =>\n  registerAfterAppDeclaration(code, {\n    middlewareSource: 'hono-intlayer',\n    findDeclaration: (ast) => {\n      const factoryNames = findFactoryLocalNames(ast, {\n        source: 'hono',\n        named: ['Hono'],\n      });\n      return findAppDeclaration(ast, (init) =>\n        isFactoryCall(init, factoryNames, 'NewExpression')\n      );\n    },\n    buildRegistration: (appName) => `${appName}.use(\"*\", intlayer());`,\n  });\n\n/**\n * Registers `express-intlayer` on a NestJS (Express platform) app right after\n * `const app = await NestFactory.create(…)`: `app.use(intlayer());`.\n */\nexport const registerNestJsMiddleware = (\n  code: string\n): BackendTransformResult =>\n  registerAfterAppDeclaration(code, {\n    middlewareSource: 'express-intlayer',\n    findDeclaration: (ast) =>\n      findAppDeclaration(ast, (init) => {\n        const call = init.type === 'AwaitExpression' ? init.argument : init;\n        return (\n          n.CallExpression.check(call) &&\n          n.MemberExpression.check(call.callee) &&\n          (call.callee.object as any).name === 'NestFactory' &&\n          (call.callee.property as any).name === 'create'\n        );\n      }),\n    buildRegistration: (appName) => `${appName}.use(intlayer());`,\n  });\n\n/**\n * Registers `elysia-intlayer` directly on the app constructor:\n * `new Elysia()` → `new Elysia().use(intlayer())`. Works for chained\n * declarations too, and keeps the plugin ahead of every route.\n */\nexport const registerElysiaPlugin = (code: string): BackendTransformResult => {\n  const middlewareSource = 'elysia-intlayer';\n  if (code.includes(middlewareSource)) return { code, status: 'already' };\n\n  const ast = parseCode(code);\n  if (isModuleScopeBinding(ast, MIDDLEWARE_IDENTIFIER)) {\n    return { code, status: 'skipped' };\n  }\n\n  const factoryNames = findFactoryLocalNames(ast, {\n    source: 'elysia',\n    named: ['Elysia'],\n  });\n\n  let registered = false;\n  recast.visit(ast, {\n    visitNewExpression(path) {\n      if (registered) return false;\n      if (isFactoryCall(path.node, factoryNames, 'NewExpression')) {\n        const withPlugin = parseStatement(\n          '__app__.use(intlayer());'\n        ).expression;\n        withPlugin.callee.object = path.node;\n        path.replace(withPlugin);\n        registered = true;\n        return false;\n      }\n      this.traverse(path);\n    },\n  });\n\n  if (!registered) return { code, status: 'skipped' };\n\n  ensureMiddlewareBinding(ast, middlewareSource);\n\n  return { code: recast.print(ast).code, status: 'registered' };\n};\n"],"mappings":"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"}

package/dist/cjs/init/frameworkSetup/index.cjs

@@ -1,14 +1,20 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_init_frameworkSetup_backend_index = require('./backend/index.cjs');
 const require_init_frameworkSetup_nextAppRouter_index = require('./nextAppRouter/index.cjs');
 const require_init_frameworkSetup_tanstackStart_index = require('./tanstackStart/index.cjs');
 
 //#region src/init/frameworkSetup/index.ts
 /**
 * Registered framework adapters, tried in order. The first one whose `detect`
-* returns true handles the project. Add new adapters (Nuxt, Vite + React, …)
-* here as they are implemented.
+* returns true handles the project. Frontend adapters come first, so an app
+* with its own server keeps its frontend scaffolding. Add new adapters (Nuxt,
+* Vite + React, …) here as they are implemented.
 */
-const adapters = [require_init_frameworkSetup_nextAppRouter_index.nextAppRouterAdapter, require_init_frameworkSetup_tanstackStart_index.tanStackStartAdapter];
+const adapters = [
+	require_init_frameworkSetup_nextAppRouter_index.nextAppRouterAdapter,
+	require_init_frameworkSetup_tanstackStart_index.tanStackStartAdapter,
+	...require_init_frameworkSetup_backend_index.backendAdapters
+];
 /**
 * Runs framework-specific scaffolding (middleware/proxy, providers in
 * layout/page, example content) for the first adapter that matches the project.

package/dist/cjs/init/frameworkSetup/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["nextAppRouterAdapter","tanStackStartAdapter"],"sources":["../../../../src/init/frameworkSetup/index.ts"],"sourcesContent":["import { nextAppRouterAdapter } from './nextAppRouter';\nimport { tanStackStartAdapter } from './tanstackStart';\nimport type { FrameworkAdapter, FrameworkSetupContext } from './types';\n\nexport type { FrameworkAdapter, FrameworkSetupContext } from './types';\n\n/**\n * Registered framework adapters, tried in order. The first one whose `detect`\n * returns true handles the project. Add new adapters (Nuxt, Vite + React, …)\n * here as they are implemented.\n */\nconst adapters: FrameworkAdapter[] = [\n  nextAppRouterAdapter,\n  tanStackStartAdapter,\n];\n\n/**\n * Runs framework-specific scaffolding (middleware/proxy, providers in\n * layout/page, example content) for the first adapter that matches the project.\n * No-ops when no adapter recognizes the project. Each adapter is idempotent and\n * non-destructive, so this is safe to run on existing applications.\n */\nexport const setupFramework = async (\n  context: FrameworkSetupContext\n): Promise<void> => {\n  for (const adapter of adapters) {\n    if (await adapter.detect(context)) {\n      await adapter.setup(context);\n      return;\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;AAWA,MAAM,WAA+B,CACnCA,sEACAC,oEACF;;;;;;;AAQA,MAAa,iBAAiB,OAC5B,YACkB;CAClB,KAAK,MAAM,WAAW,UACpB,IAAI,MAAM,QAAQ,OAAO,OAAO,GAAG;EACjC,MAAM,QAAQ,MAAM,OAAO;EAC3B;CACF;AAEJ"}
+{"version":3,"file":"index.cjs","names":["nextAppRouterAdapter","tanStackStartAdapter","backendAdapters"],"sources":["../../../../src/init/frameworkSetup/index.ts"],"sourcesContent":["import { backendAdapters } from './backend';\nimport { nextAppRouterAdapter } from './nextAppRouter';\nimport { tanStackStartAdapter } from './tanstackStart';\nimport type { FrameworkAdapter, FrameworkSetupContext } from './types';\n\nexport type { FrameworkAdapter, FrameworkSetupContext } from './types';\n\n/**\n * Registered framework adapters, tried in order. The first one whose `detect`\n * returns true handles the project. Frontend adapters come first, so an app\n * with its own server keeps its frontend scaffolding. Add new adapters (Nuxt,\n * Vite + React, …) here as they are implemented.\n */\nconst adapters: FrameworkAdapter[] = [\n  nextAppRouterAdapter,\n  tanStackStartAdapter,\n  ...backendAdapters,\n];\n\n/**\n * Runs framework-specific scaffolding (middleware/proxy, providers in\n * layout/page, example content) for the first adapter that matches the project.\n * No-ops when no adapter recognizes the project. Each adapter is idempotent and\n * non-destructive, so this is safe to run on existing applications.\n */\nexport const setupFramework = async (\n  context: FrameworkSetupContext\n): Promise<void> => {\n  for (const adapter of adapters) {\n    if (await adapter.detect(context)) {\n      await adapter.setup(context);\n      return;\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;;AAaA,MAAM,WAA+B;CACnCA;CACAC;CACA,GAAGC;AACL;;;;;;;AAQA,MAAa,iBAAiB,OAC5B,YACkB;CAClB,KAAK,MAAM,WAAW,UACpB,IAAI,MAAM,QAAQ,OAAO,OAAO,GAAG;EACjC,MAAM,QAAQ,MAAM,OAAO;EAC3B;CACF;AAEJ"}