@tanstack/cta-engine 0.11.3 → 0.12.0

package/dist/cli.js

@@ -77,13 +77,13 @@ export function cli({ name, appName, forcedMode, forcedAddOns, }) {
     program.action(async (projectName, options) => {
         if (options.listAddOns) {
             await listAddOns(options, {
-                forcedMode,
+                forcedMode: forcedMode,
                 forcedAddOns,
             });
         }
         else if (options.mcp || options.mcpSse) {
             await runServer(!!options.mcpSse, {
-                forcedMode,
+                forcedMode: forcedMode,
                 forcedAddOns,
                 appName,
             });
@@ -97,14 +97,14 @@ export function cli({ name, appName, forcedMode, forcedAddOns, }) {
                 if (forcedMode) {
                     cliOptions.template = forcedMode;
                 }
-                let finalOptions = await normalizeOptions(cliOptions, forcedAddOns);
+                let finalOptions = await normalizeOptions(cliOptions, forcedMode, forcedAddOns);
                 if (finalOptions) {
                     intro(`Creating a new ${appName} app in ${projectName}...`);
                 }
                 else {
                     intro(`Let's configure your ${appName} application`);
                     finalOptions = await promptForOptions(cliOptions, {
-                        forcedMode,
+                        forcedMode: forcedMode,
                         forcedAddOns,
                     });
                 }

package/dist/create-app.js

@@ -492,6 +492,6 @@ Use the following commands to start your app:
 % cd ${options.projectName}
 % ${startCommand}
 
-Please read the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`);
+Please check the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`);
     }
 }

package/dist/options.js

@@ -4,7 +4,7 @@ import { DEFAULT_TOOLCHAIN, SUPPORTED_TOOLCHAINS } from './toolchain.js';
 import { CODE_ROUTER, DEFAULT_FRAMEWORK, FILE_ROUTER } from './constants.js';
 import { finalizeAddOns, getAllAddOns, loadRemoteAddOn } from './add-ons.js';
 // If all CLI options are provided, use them directly
-export async function normalizeOptions(cliOptions, forcedAddOns) {
+export async function normalizeOptions(cliOptions, forcedMode, forcedAddOns) {
     // in some cases, if you use windows/powershell, the argument for addons
     // if sepparated by comma is not really passed as an array, but as a string
     // with spaces, We need to normalize this edge case.
@@ -46,7 +46,9 @@ export async function normalizeOptions(cliOptions, forcedAddOns) {
                     ...cliOptions.addOns,
                 ]));
             }
-            chosenAddOns = await finalizeAddOns(cliOptions.framework || DEFAULT_FRAMEWORK, cliOptions.template === 'file-router' ? FILE_ROUTER : CODE_ROUTER, finalAddOns);
+            chosenAddOns = await finalizeAddOns(cliOptions.framework || DEFAULT_FRAMEWORK, forcedMode || cliOptions.template === 'file-router'
+                ? FILE_ROUTER
+                : CODE_ROUTER, finalAddOns);
             tailwind = true;
             typescript = true;
         }

package/dist/types/cli.d.ts

@@ -1,6 +1,7 @@
+import type { Mode } from './types.js';
 export declare function cli({ name, appName, forcedMode, forcedAddOns, }: {
     name: string;
     appName: string;
-    forcedMode?: 'typescript' | 'javascript' | 'file-router';
+    forcedMode?: Mode;
     forcedAddOns?: Array<string>;
 }): void;

package/dist/types/options.d.ts

@@ -1,6 +1,6 @@
-import type { CliOptions, Options } from './types.js';
-export declare function normalizeOptions(cliOptions: CliOptions, forcedAddOns?: Array<string>): Promise<Options | undefined>;
+import type { CliOptions, Mode, Options, TemplateOptions } from './types.js';
+export declare function normalizeOptions(cliOptions: CliOptions, forcedMode?: Mode, forcedAddOns?: Array<string>): Promise<Options | undefined>;
 export declare function promptForOptions(cliOptions: CliOptions, { forcedAddOns, forcedMode, }: {
     forcedAddOns?: Array<string>;
-    forcedMode?: 'typescript' | 'javascript' | 'file-router';
+    forcedMode?: TemplateOptions;
 }): Promise<Required<Options>>;

package/dist/types/types.d.ts

@@ -3,6 +3,7 @@ import type { PackageManager } from './package-manager.js';
 import type { ToolChain } from './toolchain.js';
 export type Framework = 'solid' | 'react';
 export type TemplateOptions = 'typescript' | 'javascript' | 'file-router';
+export type Mode = typeof CODE_ROUTER | typeof FILE_ROUTER;
 export interface Options {
     framework: Framework;
     projectName: string;
@@ -10,7 +11,7 @@ export interface Options {
     tailwind: boolean;
     packageManager: PackageManager;
     toolchain: ToolChain;
-    mode: typeof CODE_ROUTER | typeof FILE_ROUTER;
+    mode: Mode;
     addOns: boolean;
     chosenAddOns: Array<AddOn>;
     git: boolean;
@@ -100,7 +101,7 @@ export type Overlay = AddOn & {
     author: string;
     link: string;
     license: string;
-    mode: typeof CODE_ROUTER | typeof FILE_ROUTER;
+    mode: Mode;
     framework: Framework;
     typescript: boolean;
     tailwind: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/cta-engine",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "description": "Tanstack Application Builder Engine",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli.ts

@@ -16,7 +16,7 @@ import { createDefaultEnvironment } from './environment.js'
 
 import type { PackageManager } from './package-manager.js'
 import type { ToolChain } from './toolchain.js'
-import type { CliOptions, Framework } from './types.js'
+import type { CliOptions, Framework, Mode, TemplateOptions } from './types.js'
 
 export function cli({
   name,
@@ -26,7 +26,7 @@ export function cli({
 }: {
   name: string
   appName: string
-  forcedMode?: 'typescript' | 'javascript' | 'file-router'
+  forcedMode?: Mode
   forcedAddOns?: Array<string>
 }) {
   const program = new Command()
@@ -143,12 +143,12 @@ export function cli({
   program.action(async (projectName: string, options: CliOptions) => {
     if (options.listAddOns) {
       await listAddOns(options, {
-        forcedMode,
+        forcedMode: forcedMode as TemplateOptions,
         forcedAddOns,
       })
     } else if (options.mcp || options.mcpSse) {
       await runServer(!!options.mcpSse, {
-        forcedMode,
+        forcedMode: forcedMode as TemplateOptions,
         forcedAddOns,
         appName,
       })
@@ -160,16 +160,20 @@ export function cli({
         } as CliOptions
 
         if (forcedMode) {
-          cliOptions.template = forcedMode
+          cliOptions.template = forcedMode as TemplateOptions
         }
 
-        let finalOptions = await normalizeOptions(cliOptions, forcedAddOns)
+        let finalOptions = await normalizeOptions(
+          cliOptions,
+          forcedMode,
+          forcedAddOns,
+        )
         if (finalOptions) {
           intro(`Creating a new ${appName} app in ${projectName}...`)
         } else {
           intro(`Let's configure your ${appName} application`)
           finalOptions = await promptForOptions(cliOptions, {
-            forcedMode,
+            forcedMode: forcedMode as TemplateOptions,
             forcedAddOns,
           })
         }

package/src/create-app.ts

@@ -799,6 +799,6 @@ Use the following commands to start your app:
 % cd ${options.projectName}
 % ${startCommand}
 
-Please read the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`)
+Please check the README.md for more information on testing, styling, adding routes, react-query, etc.${errorStatement}`)
   }
 }

package/src/options.ts

@@ -16,11 +16,20 @@ import { DEFAULT_TOOLCHAIN, SUPPORTED_TOOLCHAINS } from './toolchain.js'
 import { CODE_ROUTER, DEFAULT_FRAMEWORK, FILE_ROUTER } from './constants.js'
 import { finalizeAddOns, getAllAddOns, loadRemoteAddOn } from './add-ons.js'
 
-import type { AddOn, CliOptions, Options, Overlay, Variable } from './types.js'
+import type {
+  AddOn,
+  CliOptions,
+  Mode,
+  Options,
+  Overlay,
+  TemplateOptions,
+  Variable,
+} from './types.js'
 
 // If all CLI options are provided, use them directly
 export async function normalizeOptions(
   cliOptions: CliOptions,
+  forcedMode?: Mode,
   forcedAddOns?: Array<string>,
 ): Promise<Options | undefined> {
   // in some cases, if you use windows/powershell, the argument for addons
@@ -80,7 +89,9 @@ export async function normalizeOptions(
       }
       chosenAddOns = await finalizeAddOns(
         cliOptions.framework || DEFAULT_FRAMEWORK,
-        cliOptions.template === 'file-router' ? FILE_ROUTER : CODE_ROUTER,
+        forcedMode || cliOptions.template === 'file-router'
+          ? FILE_ROUTER
+          : CODE_ROUTER,
         finalAddOns,
       )
       tailwind = true
@@ -154,7 +165,7 @@ export async function promptForOptions(
     forcedMode,
   }: {
     forcedAddOns?: Array<string>
-    forcedMode?: 'typescript' | 'javascript' | 'file-router'
+    forcedMode?: TemplateOptions
   },
 ): Promise<Required<Options>> {
   const options = {} as Required<Options>

package/src/types.ts

@@ -6,6 +6,8 @@ export type Framework = 'solid' | 'react'
 
 export type TemplateOptions = 'typescript' | 'javascript' | 'file-router'
 
+export type Mode = typeof CODE_ROUTER | typeof FILE_ROUTER
+
 export interface Options {
   framework: Framework
   projectName: string
@@ -13,7 +15,7 @@ export interface Options {
   tailwind: boolean
   packageManager: PackageManager
   toolchain: ToolChain
-  mode: typeof CODE_ROUTER | typeof FILE_ROUTER
+  mode: Mode
   addOns: boolean
   chosenAddOns: Array<AddOn>
   git: boolean
@@ -114,7 +116,7 @@ export type Overlay = AddOn & {
   author: string
   link: string
   license: string
-  mode: typeof CODE_ROUTER | typeof FILE_ROUTER
+  mode: Mode
   framework: Framework
   typescript: boolean
   tailwind: boolean

package/templates/react/add-on/clerk/assets/_dot_env.local.append

@@ -1,2 +1,2 @@
-# Clerk configuration, get this key from your [Dashboard](https://clerk.com/dashboard).
+# Clerk configuration, get this key from your [Dashboard](dashboard.clerk.com)
 VITE_CLERK_PUBLISHABLE_KEY=

package/templates/react/add-on/convex/assets/_dot_env.local.append

@@ -1,3 +1,3 @@
-# Convex configuration, get this URL from your [Dashboard](https://convex.dev/dashboard).
+# Convex configuration, get this URL from your [Dashboard](dashboard.convex.dev)
 CONVEX_DEPLOYMENT=
-VITE_CONVEX_URL=
+VITE_CONVEX_URL=

package/templates/react/add-on/t3env/README.md

@@ -0,0 +1,16 @@
+## T3Env
+
+- You can use T3Env to add type safety to your environment variables.
+- Add Environment variables to the `src/env.mjs` file.
+- Use the environment variables in your code.
+
+### Usage
+
+```ts
+import { env } from "@/env";
+
+console.log(env.VITE_APP_TITLE);
+```
+
+
+

package/templates/react/add-on/t3env/assets/src/env.ts

@@ -0,0 +1,39 @@
+import { createEnv } from "@t3-oss/env-core";
+import { z } from "zod";
+ 
+export const env = createEnv({
+  server: {
+    SERVER_URL: z.string().url().optional(),
+  },
+ 
+  /**
+   * The prefix that client-side variables must have. This is enforced both at
+   * a type-level and at runtime.
+   */
+  clientPrefix: "VITE_",
+ 
+  client: {
+    VITE_APP_TITLE: z.string().min(1).optional(),
+  },
+ 
+  /**
+   * What object holds the environment variables at runtime. This is usually
+   * `process.env` or `import.meta.env`.
+   */
+  runtimeEnv: import.meta.env,
+ 
+  /**
+   * By default, this library will feed the environment variables directly to
+   * the Zod validator.
+   *
+   * This means that if you have an empty string for a value that is supposed
+   * to be a number (e.g. `PORT=` in a ".env" file), Zod will incorrectly flag
+   * it as a type mismatch violation. Additionally, if you have an empty string
+   * for a value that is supposed to be a string with a default value (e.g.
+   * `DOMAIN=` in an ".env" file), the default value will never be applied.
+   *
+   * In order to solve these issues, we recommend that all new projects
+   * explicitly specify this option as true.
+   */
+  emptyStringAsUndefined: true,
+});

package/templates/react/add-on/t3env/info.json

@@ -0,0 +1,10 @@
+{
+  "name": "T3Env",
+  "description": "Add type safety to your environment variables",
+  "phase": "add-on",
+  "link": "https://github.com/t3-oss/t3-env",
+  "templates": [
+    "file-router",
+    "code-router"
+  ]
+}

package/templates/react/add-on/t3env/package.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": {
+    "zod": "^3.24.2",
+    "@t3-oss/env-core": "^0.12.0"
+  }
+}

package/templates/react/example/tanchat/assets/src/routes/api.messages.ts

@@ -0,0 +1,24 @@
+import { createAPIFileRoute } from "@tanstack/react-start/api";
+import { getEvent } from "vinxi/http";
+
+import { transports } from "@/utils/demo.sse";
+
+export const APIRoute = createAPIFileRoute("/api/messages")({
+  // @ts-ignore
+  POST: async ({ request, params }) => {
+    const body = await request.json();
+    const url = new URL(request.url);
+    const sessionId = url.searchParams.get("sessionId") as string;
+    const transport = transports[sessionId];
+    if (transport) {
+      try {
+        getEvent().node.res.statusCode = 200;
+        await transport.handleMessage(body);
+      } catch (error) {
+        getEvent().node.res.send("Error handling message");
+      }
+    } else {
+      getEvent().node.res.send("No transport found for sessionId");
+    }
+  },
+});

package/templates/react/example/tanchat/assets/src/routes/api.sse.ts

@@ -0,0 +1,23 @@
+import { createAPIFileRoute } from '@tanstack/react-start/api'
+import { getEvent } from 'vinxi/http'
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js'
+
+import { transports, server } from '@/utils/demo.sse'
+
+export const APIRoute = createAPIFileRoute('/api/sse')({
+  // @ts-ignore
+  GET: async ({}) => {
+    const transport = new SSEServerTransport(
+      '/api/messages',
+      getEvent().node.res,
+    )
+    transports[transport.sessionId] = transport
+    transport.onerror = (error) => {
+      console.error(error)
+    }
+    getEvent().node.res.on('close', () => {
+      delete transports[transport.sessionId]
+    })
+    await server.connect(transport)
+  },
+})

package/templates/react/example/tanchat/assets/src/utils/demo.sse.ts

@@ -0,0 +1,31 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { getWebRequest } from "vinxi/http";
+
+import guitars from "@/data/example-guitars";
+
+export const server = new McpServer({
+  name: "guitar-server",
+  version: "1.0.0",
+});
+export const transports: { [sessionId: string]: SSEServerTransport } = {};
+
+server.tool("getGuitars", {}, async ({}) => {
+  const port = new URL(getWebRequest().url).port;
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          guitars.map((guitar) => ({
+            id: guitar.id,
+            name: guitar.name,
+            description: guitar.description,
+            price: guitar.price,
+            image: `http://localhost:${port}${guitar.image}`,
+          }))
+        ),
+      },
+    ],
+  };
+});

package/templates/react/example/tanchat/package.json

@@ -2,6 +2,7 @@
   "dependencies": {
     "@ai-sdk/anthropic": "^1.1.17",
     "@ai-sdk/react": "^1.1.23",
+    "@modelcontextprotocol/sdk": "^1.8.0",
     "ai": "^4.1.65",
     "highlight.js": "^11.11.1",
     "react-markdown": "^9.0.1",

package/templates/solid/add-on/t3env/README.md

@@ -0,0 +1,16 @@
+## T3Env
+
+- You can use T3Env to add type safety to your environment variables.
+- Add Environment variables to the `src/env.mjs` file.
+- Use the environment variables in your code.
+
+### Usage
+
+```ts
+import { env } from "@/env";
+
+console.log(env.VITE_APP_TITLE);
+```
+
+
+

package/templates/solid/add-on/t3env/assets/src/env.ts

@@ -0,0 +1,39 @@
+import { createEnv } from "@t3-oss/env-core";
+import { z } from "zod";
+ 
+export const env = createEnv({
+  server: {
+    SERVER_URL: z.string().url().optional(),
+  },
+ 
+  /**
+   * The prefix that client-side variables must have. This is enforced both at
+   * a type-level and at runtime.
+   */
+  clientPrefix: "VITE_",
+ 
+  client: {
+    VITE_APP_TITLE: z.string().min(1).optional(),
+  },
+ 
+  /**
+   * What object holds the environment variables at runtime. This is usually
+   * `process.env` or `import.meta.env`.
+   */
+  runtimeEnv: import.meta.env,
+ 
+  /**
+   * By default, this library will feed the environment variables directly to
+   * the Zod validator.
+   *
+   * This means that if you have an empty string for a value that is supposed
+   * to be a number (e.g. `PORT=` in a ".env" file), Zod will incorrectly flag
+   * it as a type mismatch violation. Additionally, if you have an empty string
+   * for a value that is supposed to be a string with a default value (e.g.
+   * `DOMAIN=` in an ".env" file), the default value will never be applied.
+   *
+   * In order to solve these issues, we recommend that all new projects
+   * explicitly specify this option as true.
+   */
+  emptyStringAsUndefined: true,
+});

package/templates/solid/add-on/t3env/info.json

@@ -0,0 +1,10 @@
+{
+  "name": "T3Env",
+  "description": "Add type safety to your environment variables",
+  "phase": "add-on",
+  "link": "https://github.com/t3-oss/t3-env",
+  "templates": [
+    "file-router",
+    "code-router"
+  ]
+}

package/templates/solid/add-on/t3env/package.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": {
+    "zod": "^3.24.2",
+    "@t3-oss/env-core": "^0.12.0"
+  }
+}