create-payload-app 4.0.0-internal.fa345ef → 4.0.0-internal.fec2230

package/dist/lib/init-tanstack.spec.js

@@ -0,0 +1,394 @@
+import fse from 'fs-extra';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { initTanStack } from './init-tanstack.js';
+const mocks = vi.hoisted(()=>({
+        applyPreparedWrites: vi.fn(),
+        configurePayloadTsConfig: vi.fn(),
+        ensurePnpmBuildApprovals: vi.fn(),
+        getTanStackAppDetails: vi.fn(),
+        installPackages: vi.fn(),
+        prepareTanStackInit: vi.fn(),
+        resolvePackageVersion: vi.fn()
+    }));
+vi.mock('../utils/resolvePackageVersion.js', async (importOriginal)=>({
+        ...await importOriginal(),
+        resolvePackageVersion: mocks.resolvePackageVersion
+    }));
+vi.mock('./configure-payload-tsconfig.js', ()=>({
+        configurePayloadTsConfig: mocks.configurePayloadTsConfig
+    }));
+vi.mock('./configure-pnpm-builds.js', ()=>({
+        ensurePnpmBuildApprovals: mocks.ensurePnpmBuildApprovals
+    }));
+vi.mock('./install-packages.js', ()=>({
+        installPackages: mocks.installPackages
+    }));
+vi.mock('./tanstack/detect.js', ()=>({
+        getTanStackAppDetails: mocks.getTanStackAppDetails
+    }));
+vi.mock('./tanstack/prepare.js', ()=>({
+        applyPreparedWrites: mocks.applyPreparedWrites,
+        prepareTanStackInit: mocks.prepareTanStackInit
+    }));
+describe('initTanStack', ()=>{
+    const templateRoot = '/tmp/tanstack-template';
+    let appDetails;
+    let preparedWrites;
+    let projectDir;
+    beforeEach(()=>{
+        vi.clearAllMocks();
+        projectDir = fse.mkdtempSync(path.join(os.tmpdir(), 'cpa-init-tanstack-'));
+        appDetails = createAppDetails({
+            kind: 'start',
+            projectDir
+        });
+        preparedWrites = [
+            {
+                content: 'export default {}\n',
+                filePath: path.join(projectDir, 'src/payload.config.ts')
+            }
+        ];
+        mocks.prepareTanStackInit.mockResolvedValue({
+            success: true,
+            writes: preparedWrites
+        });
+        mocks.applyPreparedWrites.mockResolvedValue(undefined);
+        mocks.ensurePnpmBuildApprovals.mockResolvedValue(undefined);
+        mocks.installPackages.mockResolvedValue({
+            success: true
+        });
+        mocks.configurePayloadTsConfig.mockResolvedValue(undefined);
+        mocks.resolvePackageVersion.mockResolvedValue('4.2.0');
+        mocks.getTanStackAppDetails.mockResolvedValue({
+            compatible: true,
+            details: appDetails,
+            detected: true
+        });
+    });
+    afterEach(()=>{
+        fse.removeSync(projectDir);
+    });
+    it('should prepare, apply, install, and configure in order', async ()=>{
+        const result = await initTanStack({
+            '--debug': true,
+            '--payload-version': 'beta',
+            appDetails,
+            dbType: 'mongodb',
+            packageManager: 'pnpm',
+            projectDir,
+            templateRoot
+        });
+        expect(result).toEqual({
+            payloadConfigPath: path.join(projectDir, 'src/payload.config.ts'),
+            success: true
+        });
+        expect(mocks.prepareTanStackInit).toHaveBeenCalledWith({
+            appDetails,
+            templateRoot
+        });
+        expect(mocks.applyPreparedWrites).toHaveBeenCalledWith({
+            writes: preparedWrites
+        });
+        expect(mocks.prepareTanStackInit).toHaveBeenCalledBefore(mocks.applyPreparedWrites);
+        expect(mocks.applyPreparedWrites).toHaveBeenCalledBefore(mocks.installPackages);
+        expect(mocks.resolvePackageVersion).toHaveBeenCalledWith({
+            debug: true,
+            packageName: 'payload',
+            versionOrTag: 'beta'
+        });
+        expect(mocks.ensurePnpmBuildApprovals).toHaveBeenCalledWith({
+            packageManager: 'pnpm',
+            projectDir
+        });
+        expect(mocks.configurePayloadTsConfig).toHaveBeenCalledWith({
+            configPath: path.join(projectDir, 'tsconfig.json'),
+            payloadConfigPath: path.join(projectDir, 'src/payload.config.ts')
+        });
+    });
+    it.each([
+        [
+            'mongodb',
+            '@payloadcms/db-mongodb@4.2.0'
+        ],
+        [
+            'postgres',
+            '@payloadcms/db-postgres@4.2.0'
+        ],
+        [
+            'sqlite',
+            '@payloadcms/db-sqlite@4.2.0'
+        ]
+    ])('should install the exact Payload dependencies for %s', async (dbType, databasePackage)=>{
+        await initTanStack({
+            appDetails,
+            dbType,
+            packageManager: 'npm',
+            projectDir,
+            templateRoot
+        });
+        expect(mocks.installPackages).toHaveBeenCalledWith({
+            packageManager: 'npm',
+            packagesToInstall: [
+                '@payloadcms/plugin-mcp@4.2.0',
+                '@payloadcms/richtext-lexical@4.2.0',
+                '@payloadcms/tanstack-start@4.2.0',
+                '@payloadcms/ui@4.2.0',
+                '@vitejs/plugin-rsc@^0.5.21',
+                databasePackage,
+                'graphql@^16.8.1',
+                'payload@4.2.0',
+                'sharp@0.34.2'
+            ],
+            projectDir
+        });
+    });
+    it('should replace Router-only plugin package metadata', async ()=>{
+        appDetails = createAppDetails({
+            kind: 'router-only',
+            projectDir
+        });
+        const packageJsonPath = path.join(projectDir, 'package.json');
+        const originalPackageContent = `{
+  "name": "router-app",
+  "scripts": {
+    "dev": "vite"
+  },
+  "dependencies": {
+    "@tanstack/router-plugin": "^1.0.0",
+    "payload": "^4.0.0"
+  },
+  "devDependencies": {
+    "@tanstack/router-plugin": "^1.0.0",
+    "typescript": "^6.0.0"
+  }
+}`;
+        fse.writeFileSync(packageJsonPath, originalPackageContent);
+        await initTanStack({
+            appDetails,
+            dbType: 'mongodb',
+            packageManager: 'yarn',
+            projectDir,
+            templateRoot
+        });
+        expect(mocks.applyPreparedWrites).toHaveBeenCalledWith({
+            writes: [
+                ...preparedWrites,
+                {
+                    content: `{
+  "name": "router-app",
+  "scripts": {
+    "dev": "vite"
+  },
+  "dependencies": {
+    "payload": "^4.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.0"
+  }
+}\n`,
+                    filePath: packageJsonPath
+                }
+            ]
+        });
+        expect(fse.readFileSync(packageJsonPath, 'utf8')).toBe(originalPackageContent);
+        expect(mocks.installPackages).toHaveBeenCalledWith({
+            packageManager: 'yarn',
+            packagesToInstall: [
+                '@payloadcms/plugin-mcp@4.2.0',
+                '@payloadcms/richtext-lexical@4.2.0',
+                '@payloadcms/tanstack-start@4.2.0',
+                '@payloadcms/ui@4.2.0',
+                '@vitejs/plugin-rsc@^0.5.21',
+                '@payloadcms/db-mongodb@4.2.0',
+                'graphql@^16.8.1',
+                'payload@4.2.0',
+                'sharp@0.34.2',
+                '@tanstack/react-start@^1.168.26'
+            ],
+            projectDir
+        });
+    });
+    it('should reject malformed Router package metadata before applying host writes', async ()=>{
+        appDetails = createAppDetails({
+            kind: 'router-only',
+            projectDir
+        });
+        const packageJsonPath = path.join(projectDir, 'package.json');
+        const malformedPackageContent = '{ "dependencies": {';
+        fse.writeFileSync(packageJsonPath, malformedPackageContent);
+        const result = await initTanStack({
+            appDetails,
+            dbType: 'mongodb',
+            packageManager: 'pnpm',
+            projectDir,
+            templateRoot
+        });
+        expect(result.success).toBe(false);
+        if (result.success) {
+            throw new Error('Expected malformed package metadata to fail preparation.');
+        }
+        expect(result.reason).toContain('Could not prepare package.json');
+        expect(fse.readFileSync(packageJsonPath, 'utf8')).toBe(malformedPackageContent);
+        expect(mocks.applyPreparedWrites).not.toHaveBeenCalled();
+        expect(mocks.installPackages).not.toHaveBeenCalled();
+    });
+    it.each([
+        {
+            existingDependencies: {
+                '@tanstack/react-router': '^1.200.0',
+                '@tanstack/react-start': '^1.200.0',
+                react: '^19.0.0'
+            },
+            existingDevDependencies: {
+                vite: '^7.0.0'
+            },
+            expectedDependencies: {
+                '@payloadcms/db-postgres': '4.2.0',
+                '@payloadcms/plugin-mcp': '4.2.0',
+                '@payloadcms/richtext-lexical': '4.2.0',
+                '@payloadcms/tanstack-start': '4.2.0',
+                '@payloadcms/ui': '4.2.0',
+                '@tanstack/react-router': '^1.200.0',
+                '@tanstack/react-start': '^1.200.0',
+                '@vitejs/plugin-rsc': '^0.5.21',
+                graphql: '^16.8.1',
+                payload: '4.2.0',
+                react: '^19.0.0',
+                sharp: '0.34.2'
+            },
+            expectedDevDependencies: {
+                vite: '^7.0.0'
+            },
+            kind: 'start'
+        },
+        {
+            existingDependencies: {
+                '@tanstack/react-router': '^1.200.0',
+                react: '^19.0.0'
+            },
+            existingDevDependencies: {
+                '@tanstack/router-plugin': '^1.200.0',
+                vite: '^7.0.0'
+            },
+            expectedDependencies: {
+                '@payloadcms/db-postgres': '4.2.0',
+                '@payloadcms/plugin-mcp': '4.2.0',
+                '@payloadcms/richtext-lexical': '4.2.0',
+                '@payloadcms/tanstack-start': '4.2.0',
+                '@payloadcms/ui': '4.2.0',
+                '@tanstack/react-router': '^1.200.0',
+                '@tanstack/react-start': '^1.168.26',
+                '@vitejs/plugin-rsc': '^0.5.21',
+                graphql: '^16.8.1',
+                payload: '4.2.0',
+                react: '^19.0.0',
+                sharp: '0.34.2'
+            },
+            expectedDevDependencies: {
+                vite: '^7.0.0'
+            },
+            kind: 'router-only'
+        }
+    ])('should record required dependencies without installing them for a $kind project with --no-deps', async ({ existingDependencies, existingDevDependencies, expectedDependencies, expectedDevDependencies, kind })=>{
+        appDetails = createAppDetails({
+            kind,
+            projectDir
+        });
+        const packageJsonPath = path.join(projectDir, 'package.json');
+        fse.writeJsonSync(packageJsonPath, {
+            dependencies: existingDependencies,
+            devDependencies: existingDevDependencies,
+            name: `${kind}-app`
+        });
+        const result = await initTanStack({
+            '--no-deps': true,
+            appDetails,
+            dbType: 'postgres',
+            packageManager: 'pnpm',
+            projectDir,
+            templateRoot
+        });
+        expect(result.success).toBe(true);
+        expect(mocks.resolvePackageVersion).toHaveBeenCalledWith({
+            debug: undefined,
+            packageName: 'payload',
+            versionOrTag: 'canary'
+        });
+        expect(mocks.ensurePnpmBuildApprovals).not.toHaveBeenCalled();
+        expect(mocks.installPackages).not.toHaveBeenCalled();
+        expect(mocks.configurePayloadTsConfig).toHaveBeenCalledOnce();
+        const appliedWrites = mocks.applyPreparedWrites.mock.calls[0]?.[0].writes;
+        const packageJsonWrite = appliedWrites.find(({ filePath })=>filePath === packageJsonPath);
+        expect(JSON.parse(packageJsonWrite?.content ?? '{}')).toEqual({
+            dependencies: expectedDependencies,
+            devDependencies: expectedDevDependencies,
+            name: `${kind}-app`
+        });
+    });
+    it('should return the preparation failure without applying writes', async ()=>{
+        mocks.prepareTanStackInit.mockResolvedValue({
+            reason: 'unsafe host transform',
+            success: false
+        });
+        const result = await initTanStack({
+            appDetails,
+            dbType: 'sqlite',
+            packageManager: 'bun',
+            projectDir,
+            templateRoot
+        });
+        expect(result).toEqual({
+            reason: 'unsafe host transform',
+            success: false
+        });
+        expect(mocks.applyPreparedWrites).not.toHaveBeenCalled();
+        expect(mocks.installPackages).not.toHaveBeenCalled();
+    });
+    it('should return a failure when dependency installation rejects', async ()=>{
+        mocks.installPackages.mockRejectedValue(new Error('Command failed with exit code 1'));
+        const result = await initTanStack({
+            appDetails,
+            dbType: 'mongodb',
+            packageManager: 'npm',
+            projectDir,
+            templateRoot
+        });
+        expect(result).toEqual({
+            reason: 'Failed to install dependencies',
+            success: false
+        });
+        expect(mocks.configurePayloadTsConfig).not.toHaveBeenCalled();
+    });
+    it('should detect app details when none are provided', async ()=>{
+        const result = await initTanStack({
+            dbType: 'mongodb',
+            packageManager: 'npm',
+            projectDir,
+            templateRoot
+        });
+        expect(result.success).toBe(true);
+        expect(mocks.getTanStackAppDetails).toHaveBeenCalledWith({
+            projectDir
+        });
+        expect(mocks.prepareTanStackInit).toHaveBeenCalledWith({
+            appDetails,
+            templateRoot
+        });
+    });
+});
+function createAppDetails({ kind, projectDir }) {
+    return {
+        isPayloadInstalled: false,
+        kind,
+        projectDir,
+        rootRoutePath: path.join(projectDir, 'src/routes/__root.tsx'),
+        routerPath: path.join(projectDir, 'src/router.tsx'),
+        routesDir: path.join(projectDir, 'src/routes'),
+        sourceDir: path.join(projectDir, 'src'),
+        viteConfigPath: path.join(projectDir, 'vite.config.ts')
+    };
+}
+
+//# sourceMappingURL=init-tanstack.spec.js.map

package/dist/lib/init-tanstack.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/init-tanstack.spec.ts"],"sourcesContent":["import fse from 'fs-extra'\nimport os from 'node:os'\nimport path from 'node:path'\nimport { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'\n\nimport type { DbType, TanStackAppDetails } from '../types.js'\n\nimport { initTanStack } from './init-tanstack.js'\n\nconst mocks = vi.hoisted(() => ({\n  applyPreparedWrites: vi.fn(),\n  configurePayloadTsConfig: vi.fn(),\n  ensurePnpmBuildApprovals: vi.fn(),\n  getTanStackAppDetails: vi.fn(),\n  installPackages: vi.fn(),\n  prepareTanStackInit: vi.fn(),\n  resolvePackageVersion: vi.fn(),\n}))\n\nvi.mock('../utils/resolvePackageVersion.js', async (importOriginal) => ({\n  ...(await importOriginal()),\n  resolvePackageVersion: mocks.resolvePackageVersion,\n}))\n\nvi.mock('./configure-payload-tsconfig.js', () => ({\n  configurePayloadTsConfig: mocks.configurePayloadTsConfig,\n}))\n\nvi.mock('./configure-pnpm-builds.js', () => ({\n  ensurePnpmBuildApprovals: mocks.ensurePnpmBuildApprovals,\n}))\n\nvi.mock('./install-packages.js', () => ({\n  installPackages: mocks.installPackages,\n}))\n\nvi.mock('./tanstack/detect.js', () => ({\n  getTanStackAppDetails: mocks.getTanStackAppDetails,\n}))\n\nvi.mock('./tanstack/prepare.js', () => ({\n  applyPreparedWrites: mocks.applyPreparedWrites,\n  prepareTanStackInit: mocks.prepareTanStackInit,\n}))\n\ndescribe('initTanStack', () => {\n  const templateRoot = '/tmp/tanstack-template'\n  let appDetails: TanStackAppDetails\n  let preparedWrites: Array<{ content: string; filePath: string }>\n  let projectDir: string\n\n  beforeEach(() => {\n    vi.clearAllMocks()\n    projectDir = fse.mkdtempSync(path.join(os.tmpdir(), 'cpa-init-tanstack-'))\n    appDetails = createAppDetails({ kind: 'start', projectDir })\n    preparedWrites = [\n      {\n        content: 'export default {}\\n',\n        filePath: path.join(projectDir, 'src/payload.config.ts'),\n      },\n    ]\n    mocks.prepareTanStackInit.mockResolvedValue({ success: true, writes: preparedWrites })\n    mocks.applyPreparedWrites.mockResolvedValue(undefined)\n    mocks.ensurePnpmBuildApprovals.mockResolvedValue(undefined)\n    mocks.installPackages.mockResolvedValue({ success: true })\n    mocks.configurePayloadTsConfig.mockResolvedValue(undefined)\n    mocks.resolvePackageVersion.mockResolvedValue('4.2.0')\n    mocks.getTanStackAppDetails.mockResolvedValue({\n      compatible: true,\n      details: appDetails,\n      detected: true,\n    })\n  })\n\n  afterEach(() => {\n    fse.removeSync(projectDir)\n  })\n\n  it('should prepare, apply, install, and configure in order', async () => {\n    const result = await initTanStack({\n      '--debug': true,\n      '--payload-version': 'beta',\n      appDetails,\n      dbType: 'mongodb',\n      packageManager: 'pnpm',\n      projectDir,\n      templateRoot,\n    })\n\n    expect(result).toEqual({\n      payloadConfigPath: path.join(projectDir, 'src/payload.config.ts'),\n      success: true,\n    })\n    expect(mocks.prepareTanStackInit).toHaveBeenCalledWith({ appDetails, templateRoot })\n    expect(mocks.applyPreparedWrites).toHaveBeenCalledWith({ writes: preparedWrites })\n    expect(mocks.prepareTanStackInit).toHaveBeenCalledBefore(mocks.applyPreparedWrites)\n    expect(mocks.applyPreparedWrites).toHaveBeenCalledBefore(mocks.installPackages)\n    expect(mocks.resolvePackageVersion).toHaveBeenCalledWith({\n      debug: true,\n      packageName: 'payload',\n      versionOrTag: 'beta',\n    })\n    expect(mocks.ensurePnpmBuildApprovals).toHaveBeenCalledWith({\n      packageManager: 'pnpm',\n      projectDir,\n    })\n    expect(mocks.configurePayloadTsConfig).toHaveBeenCalledWith({\n      configPath: path.join(projectDir, 'tsconfig.json'),\n      payloadConfigPath: path.join(projectDir, 'src/payload.config.ts'),\n    })\n  })\n\n  it.each<[DbType, string]>([\n    ['mongodb', '@payloadcms/db-mongodb@4.2.0'],\n    ['postgres', '@payloadcms/db-postgres@4.2.0'],\n    ['sqlite', '@payloadcms/db-sqlite@4.2.0'],\n  ])('should install the exact Payload dependencies for %s', async (dbType, databasePackage) => {\n    await initTanStack({\n      appDetails,\n      dbType,\n      packageManager: 'npm',\n      projectDir,\n      templateRoot,\n    })\n\n    expect(mocks.installPackages).toHaveBeenCalledWith({\n      packageManager: 'npm',\n      packagesToInstall: [\n        '@payloadcms/plugin-mcp@4.2.0',\n        '@payloadcms/richtext-lexical@4.2.0',\n        '@payloadcms/tanstack-start@4.2.0',\n        '@payloadcms/ui@4.2.0',\n        '@vitejs/plugin-rsc@^0.5.21',\n        databasePackage,\n        'graphql@^16.8.1',\n        'payload@4.2.0',\n        'sharp@0.34.2',\n      ],\n      projectDir,\n    })\n  })\n\n  it('should replace Router-only plugin package metadata', async () => {\n    appDetails = createAppDetails({ kind: 'router-only', projectDir })\n    const packageJsonPath = path.join(projectDir, 'package.json')\n    const originalPackageContent = `{\n  \"name\": \"router-app\",\n  \"scripts\": {\n    \"dev\": \"vite\"\n  },\n  \"dependencies\": {\n    \"@tanstack/router-plugin\": \"^1.0.0\",\n    \"payload\": \"^4.0.0\"\n  },\n  \"devDependencies\": {\n    \"@tanstack/router-plugin\": \"^1.0.0\",\n    \"typescript\": \"^6.0.0\"\n  }\n}`\n    fse.writeFileSync(packageJsonPath, originalPackageContent)\n\n    await initTanStack({\n      appDetails,\n      dbType: 'mongodb',\n      packageManager: 'yarn',\n      projectDir,\n      templateRoot,\n    })\n\n    expect(mocks.applyPreparedWrites).toHaveBeenCalledWith({\n      writes: [\n        ...preparedWrites,\n        {\n          content: `{\n  \"name\": \"router-app\",\n  \"scripts\": {\n    \"dev\": \"vite\"\n  },\n  \"dependencies\": {\n    \"payload\": \"^4.0.0\"\n  },\n  \"devDependencies\": {\n    \"typescript\": \"^6.0.0\"\n  }\n}\\n`,\n          filePath: packageJsonPath,\n        },\n      ],\n    })\n    expect(fse.readFileSync(packageJsonPath, 'utf8')).toBe(originalPackageContent)\n    expect(mocks.installPackages).toHaveBeenCalledWith({\n      packageManager: 'yarn',\n      packagesToInstall: [\n        '@payloadcms/plugin-mcp@4.2.0',\n        '@payloadcms/richtext-lexical@4.2.0',\n        '@payloadcms/tanstack-start@4.2.0',\n        '@payloadcms/ui@4.2.0',\n        '@vitejs/plugin-rsc@^0.5.21',\n        '@payloadcms/db-mongodb@4.2.0',\n        'graphql@^16.8.1',\n        'payload@4.2.0',\n        'sharp@0.34.2',\n        '@tanstack/react-start@^1.168.26',\n      ],\n      projectDir,\n    })\n  })\n\n  it('should reject malformed Router package metadata before applying host writes', async () => {\n    appDetails = createAppDetails({ kind: 'router-only', projectDir })\n    const packageJsonPath = path.join(projectDir, 'package.json')\n    const malformedPackageContent = '{ \"dependencies\": {'\n    fse.writeFileSync(packageJsonPath, malformedPackageContent)\n\n    const result = await initTanStack({\n      appDetails,\n      dbType: 'mongodb',\n      packageManager: 'pnpm',\n      projectDir,\n      templateRoot,\n    })\n\n    expect(result.success).toBe(false)\n    if (result.success) {\n      throw new Error('Expected malformed package metadata to fail preparation.')\n    }\n    expect(result.reason).toContain('Could not prepare package.json')\n    expect(fse.readFileSync(packageJsonPath, 'utf8')).toBe(malformedPackageContent)\n    expect(mocks.applyPreparedWrites).not.toHaveBeenCalled()\n    expect(mocks.installPackages).not.toHaveBeenCalled()\n  })\n\n  it.each([\n    {\n      existingDependencies: {\n        '@tanstack/react-router': '^1.200.0',\n        '@tanstack/react-start': '^1.200.0',\n        react: '^19.0.0',\n      },\n      existingDevDependencies: { vite: '^7.0.0' },\n      expectedDependencies: {\n        '@payloadcms/db-postgres': '4.2.0',\n        '@payloadcms/plugin-mcp': '4.2.0',\n        '@payloadcms/richtext-lexical': '4.2.0',\n        '@payloadcms/tanstack-start': '4.2.0',\n        '@payloadcms/ui': '4.2.0',\n        '@tanstack/react-router': '^1.200.0',\n        '@tanstack/react-start': '^1.200.0',\n        '@vitejs/plugin-rsc': '^0.5.21',\n        graphql: '^16.8.1',\n        payload: '4.2.0',\n        react: '^19.0.0',\n        sharp: '0.34.2',\n      },\n      expectedDevDependencies: { vite: '^7.0.0' },\n      kind: 'start' as const,\n    },\n    {\n      existingDependencies: {\n        '@tanstack/react-router': '^1.200.0',\n        react: '^19.0.0',\n      },\n      existingDevDependencies: {\n        '@tanstack/router-plugin': '^1.200.0',\n        vite: '^7.0.0',\n      },\n      expectedDependencies: {\n        '@payloadcms/db-postgres': '4.2.0',\n        '@payloadcms/plugin-mcp': '4.2.0',\n        '@payloadcms/richtext-lexical': '4.2.0',\n        '@payloadcms/tanstack-start': '4.2.0',\n        '@payloadcms/ui': '4.2.0',\n        '@tanstack/react-router': '^1.200.0',\n        '@tanstack/react-start': '^1.168.26',\n        '@vitejs/plugin-rsc': '^0.5.21',\n        graphql: '^16.8.1',\n        payload: '4.2.0',\n        react: '^19.0.0',\n        sharp: '0.34.2',\n      },\n      expectedDevDependencies: { vite: '^7.0.0' },\n      kind: 'router-only' as const,\n    },\n  ])(\n    'should record required dependencies without installing them for a $kind project with --no-deps',\n    async ({\n      existingDependencies,\n      existingDevDependencies,\n      expectedDependencies,\n      expectedDevDependencies,\n      kind,\n    }) => {\n      appDetails = createAppDetails({ kind, projectDir })\n      const packageJsonPath = path.join(projectDir, 'package.json')\n      fse.writeJsonSync(packageJsonPath, {\n        dependencies: existingDependencies,\n        devDependencies: existingDevDependencies,\n        name: `${kind}-app`,\n      })\n\n      const result = await initTanStack({\n        '--no-deps': true,\n        appDetails,\n        dbType: 'postgres',\n        packageManager: 'pnpm',\n        projectDir,\n        templateRoot,\n      })\n\n      expect(result.success).toBe(true)\n      expect(mocks.resolvePackageVersion).toHaveBeenCalledWith({\n        debug: undefined,\n        packageName: 'payload',\n        versionOrTag: 'canary',\n      })\n      expect(mocks.ensurePnpmBuildApprovals).not.toHaveBeenCalled()\n      expect(mocks.installPackages).not.toHaveBeenCalled()\n      expect(mocks.configurePayloadTsConfig).toHaveBeenCalledOnce()\n\n      const appliedWrites = mocks.applyPreparedWrites.mock.calls[0]?.[0].writes as Array<{\n        content: string\n        filePath: string\n      }>\n      const packageJsonWrite = appliedWrites.find(({ filePath }) => filePath === packageJsonPath)\n\n      expect(JSON.parse(packageJsonWrite?.content ?? '{}')).toEqual({\n        dependencies: expectedDependencies,\n        devDependencies: expectedDevDependencies,\n        name: `${kind}-app`,\n      })\n    },\n  )\n\n  it('should return the preparation failure without applying writes', async () => {\n    mocks.prepareTanStackInit.mockResolvedValue({ reason: 'unsafe host transform', success: false })\n\n    const result = await initTanStack({\n      appDetails,\n      dbType: 'sqlite',\n      packageManager: 'bun',\n      projectDir,\n      templateRoot,\n    })\n\n    expect(result).toEqual({ reason: 'unsafe host transform', success: false })\n    expect(mocks.applyPreparedWrites).not.toHaveBeenCalled()\n    expect(mocks.installPackages).not.toHaveBeenCalled()\n  })\n\n  it('should return a failure when dependency installation rejects', async () => {\n    mocks.installPackages.mockRejectedValue(new Error('Command failed with exit code 1'))\n\n    const result = await initTanStack({\n      appDetails,\n      dbType: 'mongodb',\n      packageManager: 'npm',\n      projectDir,\n      templateRoot,\n    })\n\n    expect(result).toEqual({ reason: 'Failed to install dependencies', success: false })\n    expect(mocks.configurePayloadTsConfig).not.toHaveBeenCalled()\n  })\n\n  it('should detect app details when none are provided', async () => {\n    const result = await initTanStack({\n      dbType: 'mongodb',\n      packageManager: 'npm',\n      projectDir,\n      templateRoot,\n    })\n\n    expect(result.success).toBe(true)\n    expect(mocks.getTanStackAppDetails).toHaveBeenCalledWith({ projectDir })\n    expect(mocks.prepareTanStackInit).toHaveBeenCalledWith({ appDetails, templateRoot })\n  })\n})\n\nfunction createAppDetails({\n  kind,\n  projectDir,\n}: {\n  kind: TanStackAppDetails['kind']\n  projectDir: string\n}): TanStackAppDetails {\n  return {\n    isPayloadInstalled: false,\n    kind,\n    projectDir,\n    rootRoutePath: path.join(projectDir, 'src/routes/__root.tsx'),\n    routerPath: path.join(projectDir, 'src/router.tsx'),\n    routesDir: path.join(projectDir, 'src/routes'),\n    sourceDir: path.join(projectDir, 'src'),\n    viteConfigPath: path.join(projectDir, 'vite.config.ts'),\n  }\n}\n"],"names":["fse","os","path","afterEach","beforeEach","describe","expect","it","vi","initTanStack","mocks","hoisted","applyPreparedWrites","fn","configurePayloadTsConfig","ensurePnpmBuildApprovals","getTanStackAppDetails","installPackages","prepareTanStackInit","resolvePackageVersion","mock","importOriginal","templateRoot","appDetails","preparedWrites","projectDir","clearAllMocks","mkdtempSync","join","tmpdir","createAppDetails","kind","content","filePath","mockResolvedValue","success","writes","undefined","compatible","details","detected","removeSync","result","dbType","packageManager","toEqual","payloadConfigPath","toHaveBeenCalledWith","toHaveBeenCalledBefore","debug","packageName","versionOrTag","configPath","each","databasePackage","packagesToInstall","packageJsonPath","originalPackageContent","writeFileSync","readFileSync","toBe","malformedPackageContent","Error","reason","toContain","not","toHaveBeenCalled","existingDependencies","react","existingDevDependencies","vite","expectedDependencies","graphql","payload","sharp","expectedDevDependencies","writeJsonSync","dependencies","devDependencies","name","toHaveBeenCalledOnce","appliedWrites","calls","packageJsonWrite","find","JSON","parse","mockRejectedValue","isPayloadInstalled","rootRoutePath","routerPath","routesDir","sourceDir","viteConfigPath"],"mappings":"AAAA,OAAOA,SAAS,WAAU;AAC1B,OAAOC,QAAQ,UAAS;AACxB,OAAOC,UAAU,YAAW;AAC5B,SAASC,SAAS,EAAEC,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,SAAQ;AAIxE,SAASC,YAAY,QAAQ,qBAAoB;AAEjD,MAAMC,QAAQF,GAAGG,OAAO,CAAC,IAAO,CAAA;QAC9BC,qBAAqBJ,GAAGK,EAAE;QAC1BC,0BAA0BN,GAAGK,EAAE;QAC/BE,0BAA0BP,GAAGK,EAAE;QAC/BG,uBAAuBR,GAAGK,EAAE;QAC5BI,iBAAiBT,GAAGK,EAAE;QACtBK,qBAAqBV,GAAGK,EAAE;QAC1BM,uBAAuBX,GAAGK,EAAE;IAC9B,CAAA;AAEAL,GAAGY,IAAI,CAAC,qCAAqC,OAAOC,iBAAoB,CAAA;QACtE,GAAI,MAAMA,gBAAgB;QAC1BF,uBAAuBT,MAAMS,qBAAqB;IACpD,CAAA;AAEAX,GAAGY,IAAI,CAAC,mCAAmC,IAAO,CAAA;QAChDN,0BAA0BJ,MAAMI,wBAAwB;IAC1D,CAAA;AAEAN,GAAGY,IAAI,CAAC,8BAA8B,IAAO,CAAA;QAC3CL,0BAA0BL,MAAMK,wBAAwB;IAC1D,CAAA;AAEAP,GAAGY,IAAI,CAAC,yBAAyB,IAAO,CAAA;QACtCH,iBAAiBP,MAAMO,eAAe;IACxC,CAAA;AAEAT,GAAGY,IAAI,CAAC,wBAAwB,IAAO,CAAA;QACrCJ,uBAAuBN,MAAMM,qBAAqB;IACpD,CAAA;AAEAR,GAAGY,IAAI,CAAC,yBAAyB,IAAO,CAAA;QACtCR,qBAAqBF,MAAME,mBAAmB;QAC9CM,qBAAqBR,MAAMQ,mBAAmB;IAChD,CAAA;AAEAb,SAAS,gBAAgB;IACvB,MAAMiB,eAAe;IACrB,IAAIC;IACJ,IAAIC;IACJ,IAAIC;IAEJrB,WAAW;QACTI,GAAGkB,aAAa;QAChBD,aAAazB,IAAI2B,WAAW,CAACzB,KAAK0B,IAAI,CAAC3B,GAAG4B,MAAM,IAAI;QACpDN,aAAaO,iBAAiB;YAAEC,MAAM;YAASN;QAAW;QAC1DD,iBAAiB;YACf;gBACEQ,SAAS;gBACTC,UAAU/B,KAAK0B,IAAI,CAACH,YAAY;YAClC;SACD;QACDf,MAAMQ,mBAAmB,CAACgB,iBAAiB,CAAC;YAAEC,SAAS;YAAMC,QAAQZ;QAAe;QACpFd,MAAME,mBAAmB,CAACsB,iBAAiB,CAACG;QAC5C3B,MAAMK,wBAAwB,CAACmB,iBAAiB,CAACG;QACjD3B,MAAMO,eAAe,CAACiB,iBAAiB,CAAC;YAAEC,SAAS;QAAK;QACxDzB,MAAMI,wBAAwB,CAACoB,iBAAiB,CAACG;QACjD3B,MAAMS,qBAAqB,CAACe,iBAAiB,CAAC;QAC9CxB,MAAMM,qBAAqB,CAACkB,iBAAiB,CAAC;YAC5CI,YAAY;YACZC,SAAShB;YACTiB,UAAU;QACZ;IACF;IAEArC,UAAU;QACRH,IAAIyC,UAAU,CAAChB;IACjB;IAEAlB,GAAG,0DAA0D;QAC3D,MAAMmC,SAAS,MAAMjC,aAAa;YAChC,WAAW;YACX,qBAAqB;YACrBc;YACAoB,QAAQ;YACRC,gBAAgB;YAChBnB;YACAH;QACF;QAEAhB,OAAOoC,QAAQG,OAAO,CAAC;YACrBC,mBAAmB5C,KAAK0B,IAAI,CAACH,YAAY;YACzCU,SAAS;QACX;QACA7B,OAAOI,MAAMQ,mBAAmB,EAAE6B,oBAAoB,CAAC;YAAExB;YAAYD;QAAa;QAClFhB,OAAOI,MAAME,mBAAmB,EAAEmC,oBAAoB,CAAC;YAAEX,QAAQZ;QAAe;QAChFlB,OAAOI,MAAMQ,mBAAmB,EAAE8B,sBAAsB,CAACtC,MAAME,mBAAmB;QAClFN,OAAOI,MAAME,mBAAmB,EAAEoC,sBAAsB,CAACtC,MAAMO,eAAe;QAC9EX,OAAOI,MAAMS,qBAAqB,EAAE4B,oBAAoB,CAAC;YACvDE,OAAO;YACPC,aAAa;YACbC,cAAc;QAChB;QACA7C,OAAOI,MAAMK,wBAAwB,EAAEgC,oBAAoB,CAAC;YAC1DH,gBAAgB;YAChBnB;QACF;QACAnB,OAAOI,MAAMI,wBAAwB,EAAEiC,oBAAoB,CAAC;YAC1DK,YAAYlD,KAAK0B,IAAI,CAACH,YAAY;YAClCqB,mBAAmB5C,KAAK0B,IAAI,CAACH,YAAY;QAC3C;IACF;IAEAlB,GAAG8C,IAAI,CAAmB;QACxB;YAAC;YAAW;SAA+B;QAC3C;YAAC;YAAY;SAAgC;QAC7C;YAAC;YAAU;SAA8B;KAC1C,EAAE,wDAAwD,OAAOV,QAAQW;QACxE,MAAM7C,aAAa;YACjBc;YACAoB;YACAC,gBAAgB;YAChBnB;YACAH;QACF;QAEAhB,OAAOI,MAAMO,eAAe,EAAE8B,oBAAoB,CAAC;YACjDH,gBAAgB;YAChBW,mBAAmB;gBACjB;gBACA;gBACA;gBACA;gBACA;gBACAD;gBACA;gBACA;gBACA;aACD;YACD7B;QACF;IACF;IAEAlB,GAAG,sDAAsD;QACvDgB,aAAaO,iBAAiB;YAAEC,MAAM;YAAeN;QAAW;QAChE,MAAM+B,kBAAkBtD,KAAK0B,IAAI,CAACH,YAAY;QAC9C,MAAMgC,yBAAyB,CAAC;;;;;;;;;;;;;CAanC,CAAC;QACEzD,IAAI0D,aAAa,CAACF,iBAAiBC;QAEnC,MAAMhD,aAAa;YACjBc;YACAoB,QAAQ;YACRC,gBAAgB;YAChBnB;YACAH;QACF;QAEAhB,OAAOI,MAAME,mBAAmB,EAAEmC,oBAAoB,CAAC;YACrDX,QAAQ;mBACHZ;gBACH;oBACEQ,SAAS,CAAC;;;;;;;;;;;GAWjB,CAAC;oBACMC,UAAUuB;gBACZ;aACD;QACH;QACAlD,OAAON,IAAI2D,YAAY,CAACH,iBAAiB,SAASI,IAAI,CAACH;QACvDnD,OAAOI,MAAMO,eAAe,EAAE8B,oBAAoB,CAAC;YACjDH,gBAAgB;YAChBW,mBAAmB;gBACjB;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;aACD;YACD9B;QACF;IACF;IAEAlB,GAAG,+EAA+E;QAChFgB,aAAaO,iBAAiB;YAAEC,MAAM;YAAeN;QAAW;QAChE,MAAM+B,kBAAkBtD,KAAK0B,IAAI,CAACH,YAAY;QAC9C,MAAMoC,0BAA0B;QAChC7D,IAAI0D,aAAa,CAACF,iBAAiBK;QAEnC,MAAMnB,SAAS,MAAMjC,aAAa;YAChCc;YACAoB,QAAQ;YACRC,gBAAgB;YAChBnB;YACAH;QACF;QAEAhB,OAAOoC,OAAOP,OAAO,EAAEyB,IAAI,CAAC;QAC5B,IAAIlB,OAAOP,OAAO,EAAE;YAClB,MAAM,IAAI2B,MAAM;QAClB;QACAxD,OAAOoC,OAAOqB,MAAM,EAAEC,SAAS,CAAC;QAChC1D,OAAON,IAAI2D,YAAY,CAACH,iBAAiB,SAASI,IAAI,CAACC;QACvDvD,OAAOI,MAAME,mBAAmB,EAAEqD,GAAG,CAACC,gBAAgB;QACtD5D,OAAOI,MAAMO,eAAe,EAAEgD,GAAG,CAACC,gBAAgB;IACpD;IAEA3D,GAAG8C,IAAI,CAAC;QACN;YACEc,sBAAsB;gBACpB,0BAA0B;gBAC1B,yBAAyB;gBACzBC,OAAO;YACT;YACAC,yBAAyB;gBAAEC,MAAM;YAAS;YAC1CC,sBAAsB;gBACpB,2BAA2B;gBAC3B,0BAA0B;gBAC1B,gCAAgC;gBAChC,8BAA8B;gBAC9B,kBAAkB;gBAClB,0BAA0B;gBAC1B,yBAAyB;gBACzB,sBAAsB;gBACtBC,SAAS;gBACTC,SAAS;gBACTL,OAAO;gBACPM,OAAO;YACT;YACAC,yBAAyB;gBAAEL,MAAM;YAAS;YAC1CvC,MAAM;QACR;QACA;YACEoC,sBAAsB;gBACpB,0BAA0B;gBAC1BC,OAAO;YACT;YACAC,yBAAyB;gBACvB,2BAA2B;gBAC3BC,MAAM;YACR;YACAC,sBAAsB;gBACpB,2BAA2B;gBAC3B,0BAA0B;gBAC1B,gCAAgC;gBAChC,8BAA8B;gBAC9B,kBAAkB;gBAClB,0BAA0B;gBAC1B,yBAAyB;gBACzB,sBAAsB;gBACtBC,SAAS;gBACTC,SAAS;gBACTL,OAAO;gBACPM,OAAO;YACT;YACAC,yBAAyB;gBAAEL,MAAM;YAAS;YAC1CvC,MAAM;QACR;KACD,EACC,kGACA,OAAO,EACLoC,oBAAoB,EACpBE,uBAAuB,EACvBE,oBAAoB,EACpBI,uBAAuB,EACvB5C,IAAI,EACL;QACCR,aAAaO,iBAAiB;YAAEC;YAAMN;QAAW;QACjD,MAAM+B,kBAAkBtD,KAAK0B,IAAI,CAACH,YAAY;QAC9CzB,IAAI4E,aAAa,CAACpB,iBAAiB;YACjCqB,cAAcV;YACdW,iBAAiBT;YACjBU,MAAM,GAAGhD,KAAK,IAAI,CAAC;QACrB;QAEA,MAAMW,SAAS,MAAMjC,aAAa;YAChC,aAAa;YACbc;YACAoB,QAAQ;YACRC,gBAAgB;YAChBnB;YACAH;QACF;QAEAhB,OAAOoC,OAAOP,OAAO,EAAEyB,IAAI,CAAC;QAC5BtD,OAAOI,MAAMS,qBAAqB,EAAE4B,oBAAoB,CAAC;YACvDE,OAAOZ;YACPa,aAAa;YACbC,cAAc;QAChB;QACA7C,OAAOI,MAAMK,wBAAwB,EAAEkD,GAAG,CAACC,gBAAgB;QAC3D5D,OAAOI,MAAMO,eAAe,EAAEgD,GAAG,CAACC,gBAAgB;QAClD5D,OAAOI,MAAMI,wBAAwB,EAAEkE,oBAAoB;QAE3D,MAAMC,gBAAgBvE,MAAME,mBAAmB,CAACQ,IAAI,CAAC8D,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC9C;QAInE,MAAM+C,mBAAmBF,cAAcG,IAAI,CAAC,CAAC,EAAEnD,QAAQ,EAAE,GAAKA,aAAauB;QAE3ElD,OAAO+E,KAAKC,KAAK,CAACH,kBAAkBnD,WAAW,OAAOa,OAAO,CAAC;YAC5DgC,cAAcN;YACdO,iBAAiBH;YACjBI,MAAM,GAAGhD,KAAK,IAAI,CAAC;QACrB;IACF;IAGFxB,GAAG,iEAAiE;QAClEG,MAAMQ,mBAAmB,CAACgB,iBAAiB,CAAC;YAAE6B,QAAQ;YAAyB5B,SAAS;QAAM;QAE9F,MAAMO,SAAS,MAAMjC,aAAa;YAChCc;YACAoB,QAAQ;YACRC,gBAAgB;YAChBnB;YACAH;QACF;QAEAhB,OAAOoC,QAAQG,OAAO,CAAC;YAAEkB,QAAQ;YAAyB5B,SAAS;QAAM;QACzE7B,OAAOI,MAAME,mBAAmB,EAAEqD,GAAG,CAACC,gBAAgB;QACtD5D,OAAOI,MAAMO,eAAe,EAAEgD,GAAG,CAACC,gBAAgB;IACpD;IAEA3D,GAAG,gEAAgE;QACjEG,MAAMO,eAAe,CAACsE,iBAAiB,CAAC,IAAIzB,MAAM;QAElD,MAAMpB,SAAS,MAAMjC,aAAa;YAChCc;YACAoB,QAAQ;YACRC,gBAAgB;YAChBnB;YACAH;QACF;QAEAhB,OAAOoC,QAAQG,OAAO,CAAC;YAAEkB,QAAQ;YAAkC5B,SAAS;QAAM;QAClF7B,OAAOI,MAAMI,wBAAwB,EAAEmD,GAAG,CAACC,gBAAgB;IAC7D;IAEA3D,GAAG,oDAAoD;QACrD,MAAMmC,SAAS,MAAMjC,aAAa;YAChCkC,QAAQ;YACRC,gBAAgB;YAChBnB;YACAH;QACF;QAEAhB,OAAOoC,OAAOP,OAAO,EAAEyB,IAAI,CAAC;QAC5BtD,OAAOI,MAAMM,qBAAqB,EAAE+B,oBAAoB,CAAC;YAAEtB;QAAW;QACtEnB,OAAOI,MAAMQ,mBAAmB,EAAE6B,oBAAoB,CAAC;YAAExB;YAAYD;QAAa;IACpF;AACF;AAEA,SAASQ,iBAAiB,EACxBC,IAAI,EACJN,UAAU,EAIX;IACC,OAAO;QACL+D,oBAAoB;QACpBzD;QACAN;QACAgE,eAAevF,KAAK0B,IAAI,CAACH,YAAY;QACrCiE,YAAYxF,KAAK0B,IAAI,CAACH,YAAY;QAClCkE,WAAWzF,KAAK0B,IAAI,CAACH,YAAY;QACjCmE,WAAW1F,KAAK0B,IAAI,CAACH,YAAY;QACjCoE,gBAAgB3F,KAAK0B,IAAI,CAACH,YAAY;IACxC;AACF"}

package/dist/lib/tanstack/detect.d.ts

@@ -0,0 +1,5 @@
+import type { TanStackDetectionResult } from '../../types.js';
+export declare function getTanStackAppDetails({ projectDir, }: {
+    projectDir: string;
+}): Promise<TanStackDetectionResult>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/lib/tanstack/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/lib/tanstack/detect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAuC,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AASlG,wBAAsB,qBAAqB,CAAC,EAC1C,UAAU,GACX,EAAE;IACD,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA8GnC"}

package/dist/lib/tanstack/detect.js

@@ -0,0 +1,131 @@
+import fse from 'fs-extra';
+import globby from 'globby';
+import path from 'path';
+const FILE_EXTENSIONS = 'js|jsx|ts|tsx|cjs|cts|mjs|mts';
+export async function getTanStackAppDetails({ projectDir }) {
+    const absoluteProjectDir = path.resolve(projectDir);
+    const packageJson = await getPackageJson({
+        projectDir: absoluteProjectDir
+    });
+    const packages = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+    };
+    const isSolidHost = Boolean(packages['@tanstack/solid-router'] || packages['@tanstack/solid-start']);
+    const hasReactRouter = Boolean(packages['@tanstack/react-router']);
+    const hasReactStart = Boolean(packages['@tanstack/react-start']);
+    const hasRouterPlugin = Boolean(packages['@tanstack/router-plugin']);
+    if (!isSolidHost && !hasReactRouter && !hasReactStart && !hasRouterPlugin) {
+        return {
+            detected: false
+        };
+    }
+    if (isSolidHost) {
+        return incompatible('TanStack Solid projects are not supported.');
+    }
+    if (hasReactStart && packages.next) {
+        return incompatible('TanStack Start and Next.js markers are both present.');
+    }
+    if (!hasReactRouter) {
+        return incompatible('Could not find @tanstack/react-router.');
+    }
+    const kind = hasReactStart ? 'start' : 'router-only';
+    const viteConfigPaths = await findFiles({
+        cwd: absoluteProjectDir,
+        pattern: `vite.config.@(${FILE_EXTENSIONS})`
+    });
+    if (viteConfigPaths.length > 1) {
+        return incompatible(getAmbiguousFilesReason({
+            filePaths: viteConfigPaths,
+            projectDir: absoluteProjectDir,
+            role: 'Vite config'
+        }));
+    }
+    const viteConfigPath = viteConfigPaths[0];
+    if (!viteConfigPath) {
+        return incompatible('Could not find a Vite config file.');
+    }
+    const viteConfig = await fse.readFile(viteConfigPath, 'utf8');
+    const pluginName = kind === 'start' ? 'tanstackStart' : 'tanstackRouter';
+    if (!new RegExp(`\\b${pluginName}\\s*\\(`).test(viteConfig)) {
+        return incompatible(`Could not find ${pluginName}() in ${viteConfigPath}.`);
+    }
+    const sourceDir = path.join(absoluteProjectDir, 'src');
+    const routesDir = path.join(sourceDir, 'routes');
+    const routerPaths = await findFiles({
+        cwd: sourceDir,
+        pattern: `router.@(${FILE_EXTENSIONS})`
+    });
+    if (routerPaths.length > 1) {
+        return incompatible(getAmbiguousFilesReason({
+            filePaths: routerPaths,
+            projectDir: absoluteProjectDir,
+            role: 'router'
+        }));
+    }
+    const routerPath = routerPaths[0];
+    if (!routerPath) {
+        return incompatible(`Could not find src/router.* in ${absoluteProjectDir}.`);
+    }
+    const router = await fse.readFile(routerPath, 'utf8');
+    if (!/\bgetRouter\b/.test(router)) {
+        return incompatible(`Could not find getRouter in ${routerPath}.`);
+    }
+    const rootRoutePaths = await findFiles({
+        cwd: routesDir,
+        pattern: `__root.@(${FILE_EXTENSIONS})`
+    });
+    if (rootRoutePaths.length > 1) {
+        return incompatible(getAmbiguousFilesReason({
+            filePaths: rootRoutePaths,
+            projectDir: absoluteProjectDir,
+            role: 'root route'
+        }));
+    }
+    const rootRoutePath = rootRoutePaths[0];
+    if (!rootRoutePath) {
+        return incompatible(`Could not find src/routes/__root.* in ${absoluteProjectDir}.`);
+    }
+    const details = {
+        isPayloadInstalled: Boolean(packages.payload),
+        kind,
+        projectDir: absoluteProjectDir,
+        rootRoutePath,
+        routerPath,
+        routesDir,
+        sourceDir,
+        viteConfigPath
+    };
+    return {
+        compatible: true,
+        details,
+        detected: true
+    };
+}
+function incompatible(reason) {
+    return {
+        compatible: false,
+        detected: true,
+        reason
+    };
+}
+function getAmbiguousFilesReason({ filePaths, projectDir, role }) {
+    const relativePaths = filePaths.map((filePath)=>path.relative(projectDir, filePath)).sort();
+    return `Found multiple supported ${role} files: ${relativePaths.join(', ')}.`;
+}
+async function findFiles({ cwd, pattern }) {
+    return globby(pattern, {
+        absolute: true,
+        cwd,
+        onlyFiles: true
+    });
+}
+async function getPackageJson({ projectDir }) {
+    const packageJsonPath = path.join(projectDir, 'package.json');
+    if (!await fse.pathExists(packageJsonPath)) {
+        return {};
+    }
+    return fse.readJson(packageJsonPath);
+}
+
+//# sourceMappingURL=detect.js.map

package/dist/lib/tanstack/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/tanstack/detect.ts"],"sourcesContent":["import fse from 'fs-extra'\nimport globby from 'globby'\nimport path from 'path'\n\nimport type { TanStackAppDetails, TanStackAppKind, TanStackDetectionResult } from '../../types.js'\n\ntype PackageJson = {\n  dependencies?: Record<string, string>\n  devDependencies?: Record<string, string>\n}\n\nconst FILE_EXTENSIONS = 'js|jsx|ts|tsx|cjs|cts|mjs|mts'\n\nexport async function getTanStackAppDetails({\n  projectDir,\n}: {\n  projectDir: string\n}): Promise<TanStackDetectionResult> {\n  const absoluteProjectDir = path.resolve(projectDir)\n  const packageJson = await getPackageJson({ projectDir: absoluteProjectDir })\n  const packages = { ...packageJson.dependencies, ...packageJson.devDependencies }\n  const isSolidHost = Boolean(\n    packages['@tanstack/solid-router'] || packages['@tanstack/solid-start'],\n  )\n  const hasReactRouter = Boolean(packages['@tanstack/react-router'])\n  const hasReactStart = Boolean(packages['@tanstack/react-start'])\n  const hasRouterPlugin = Boolean(packages['@tanstack/router-plugin'])\n\n  if (!isSolidHost && !hasReactRouter && !hasReactStart && !hasRouterPlugin) {\n    return { detected: false }\n  }\n\n  if (isSolidHost) {\n    return incompatible('TanStack Solid projects are not supported.')\n  }\n\n  if (hasReactStart && packages.next) {\n    return incompatible('TanStack Start and Next.js markers are both present.')\n  }\n\n  if (!hasReactRouter) {\n    return incompatible('Could not find @tanstack/react-router.')\n  }\n\n  const kind: TanStackAppKind = hasReactStart ? 'start' : 'router-only'\n  const viteConfigPaths = await findFiles({\n    cwd: absoluteProjectDir,\n    pattern: `vite.config.@(${FILE_EXTENSIONS})`,\n  })\n  if (viteConfigPaths.length > 1) {\n    return incompatible(\n      getAmbiguousFilesReason({\n        filePaths: viteConfigPaths,\n        projectDir: absoluteProjectDir,\n        role: 'Vite config',\n      }),\n    )\n  }\n\n  const viteConfigPath = viteConfigPaths[0]\n  if (!viteConfigPath) {\n    return incompatible('Could not find a Vite config file.')\n  }\n\n  const viteConfig = await fse.readFile(viteConfigPath, 'utf8')\n  const pluginName = kind === 'start' ? 'tanstackStart' : 'tanstackRouter'\n  if (!new RegExp(`\\\\b${pluginName}\\\\s*\\\\(`).test(viteConfig)) {\n    return incompatible(`Could not find ${pluginName}() in ${viteConfigPath}.`)\n  }\n\n  const sourceDir = path.join(absoluteProjectDir, 'src')\n  const routesDir = path.join(sourceDir, 'routes')\n  const routerPaths = await findFiles({\n    cwd: sourceDir,\n    pattern: `router.@(${FILE_EXTENSIONS})`,\n  })\n  if (routerPaths.length > 1) {\n    return incompatible(\n      getAmbiguousFilesReason({\n        filePaths: routerPaths,\n        projectDir: absoluteProjectDir,\n        role: 'router',\n      }),\n    )\n  }\n\n  const routerPath = routerPaths[0]\n  if (!routerPath) {\n    return incompatible(`Could not find src/router.* in ${absoluteProjectDir}.`)\n  }\n\n  const router = await fse.readFile(routerPath, 'utf8')\n  if (!/\\bgetRouter\\b/.test(router)) {\n    return incompatible(`Could not find getRouter in ${routerPath}.`)\n  }\n\n  const rootRoutePaths = await findFiles({\n    cwd: routesDir,\n    pattern: `__root.@(${FILE_EXTENSIONS})`,\n  })\n  if (rootRoutePaths.length > 1) {\n    return incompatible(\n      getAmbiguousFilesReason({\n        filePaths: rootRoutePaths,\n        projectDir: absoluteProjectDir,\n        role: 'root route',\n      }),\n    )\n  }\n\n  const rootRoutePath = rootRoutePaths[0]\n  if (!rootRoutePath) {\n    return incompatible(`Could not find src/routes/__root.* in ${absoluteProjectDir}.`)\n  }\n\n  const details: TanStackAppDetails = {\n    isPayloadInstalled: Boolean(packages.payload),\n    kind,\n    projectDir: absoluteProjectDir,\n    rootRoutePath,\n    routerPath,\n    routesDir,\n    sourceDir,\n    viteConfigPath,\n  }\n\n  return { compatible: true, details, detected: true }\n}\n\nfunction incompatible(reason: string): TanStackDetectionResult {\n  return { compatible: false, detected: true, reason }\n}\n\nfunction getAmbiguousFilesReason({\n  filePaths,\n  projectDir,\n  role,\n}: {\n  filePaths: string[]\n  projectDir: string\n  role: string\n}): string {\n  const relativePaths = filePaths.map((filePath) => path.relative(projectDir, filePath)).sort()\n\n  return `Found multiple supported ${role} files: ${relativePaths.join(', ')}.`\n}\n\nasync function findFiles({ cwd, pattern }: { cwd: string; pattern: string }): Promise<string[]> {\n  return globby(pattern, {\n    absolute: true,\n    cwd,\n    onlyFiles: true,\n  })\n}\n\nasync function getPackageJson({ projectDir }: { projectDir: string }): Promise<PackageJson> {\n  const packageJsonPath = path.join(projectDir, 'package.json')\n\n  if (!(await fse.pathExists(packageJsonPath))) {\n    return {}\n  }\n\n  return fse.readJson(packageJsonPath) as Promise<PackageJson>\n}\n"],"names":["fse","globby","path","FILE_EXTENSIONS","getTanStackAppDetails","projectDir","absoluteProjectDir","resolve","packageJson","getPackageJson","packages","dependencies","devDependencies","isSolidHost","Boolean","hasReactRouter","hasReactStart","hasRouterPlugin","detected","incompatible","next","kind","viteConfigPaths","findFiles","cwd","pattern","length","getAmbiguousFilesReason","filePaths","role","viteConfigPath","viteConfig","readFile","pluginName","RegExp","test","sourceDir","join","routesDir","routerPaths","routerPath","router","rootRoutePaths","rootRoutePath","details","isPayloadInstalled","payload","compatible","reason","relativePaths","map","filePath","relative","sort","absolute","onlyFiles","packageJsonPath","pathExists","readJson"],"mappings":"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"}