Fix(app) init scaffolding (#14)

* fix(webdocs): use 302 redirect for /install route

* fix(app): fix scaffolded project to work out of the box

 - Replace auth/login.http (non-existent endpoint) with posts/create.http
 - Add missing userId variable to treq.jsonc config
 - Simplify generated run.ts (remove flag parsing, warnings boilerplate)
 - Use @t-req/core "latest" instead of "^0.1.0"
 - Scaffold tsconfig.json and type devDependencies per runtime

* chore: add changeset

Author: andrewmelchor

.changeset/deep-paws-dig.md

@@ -0,0 +1,5 @@
+---
+"@t-req/app": minor
+---
+
+Fix treq init to scaffold projects that work immediately — replace broken auth/login

packages/app/src/cmd/init.ts

@@ -199,17 +199,21 @@ async function createProjectStructure(projectPath: string, config: ProjectConfig
   // Create directories using Bun shell
   await $`mkdir -p ${projectPath}`.quiet();
   await $`mkdir -p ${join(projectPath, '.treq')}`.quiet();
-  await $`mkdir -p ${join(projectPath, 'collection', 'auth')}`.quiet();
+  await $`mkdir -p ${join(projectPath, 'collection', 'posts')}`.quiet();
   await $`mkdir -p ${join(projectPath, 'collection', 'users')}`.quiet();
 
   // Write root files
   await Bun.write(join(projectPath, 'treq.jsonc'), generateConfig());
   await Bun.write(join(projectPath, 'run.ts'), generateRunScript(config.runtime));
   await Bun.write(join(projectPath, 'package.json'), generatePackageJson(projectName, config));
+  await Bun.write(join(projectPath, 'tsconfig.json'), generateTsconfig(config.runtime));
   await Bun.write(join(projectPath, '.gitignore'), generateGitignore());
 
   // Write collection
-  await Bun.write(join(projectPath, 'collection', 'auth', 'login.http'), generateLoginRequest());
+  await Bun.write(
+    join(projectPath, 'collection', 'posts', 'create.http'),
+    generateCreatePostRequest()
+  );
   await Bun.write(
     join(projectPath, 'collection', 'users', 'list.http'),
     generateListUsersRequest()
@@ -222,7 +226,8 @@ export function generateConfig(): string {
   "variables": {
     // Default base URL for the included sample requests.
     // Switch profiles with: treq run ... --profile dev
-    "baseUrl": "https://jsonplaceholder.typicode.com"
+    "baseUrl": "https://jsonplaceholder.typicode.com",
+    "userId": 1
     // Example substitutions:
     // "apiKey": "{env:API_KEY}",
     // "authToken": "{file:./secrets/token.txt}"
@@ -251,48 +256,23 @@ export function generateConfig(): string {
 export function generateRunScript(runtime: Runtime): string {
   const shebang = runtime === 'bun' ? '#!/usr/bin/env bun' : '#!/usr/bin/env npx tsx';
 
+  const nodeImport =
+    runtime === 'node' ? "\nimport { createNodeIO } from '@t-req/core/runtime';" : '';
+  const ioOption = runtime === 'node' ? '\n  io: createNodeIO(),' : '';
+
   return `${shebang}
 import { createClient } from '@t-req/core';
-import { resolveProjectConfig } from '@t-req/core/config';
-${runtime === 'node' ? "import { createNodeIO } from '@t-req/core/runtime';" : ''}
-
-function getFlagValue(name: string): string | undefined {
-  const idx = process.argv.indexOf(name);
-  if (idx === -1) return undefined;
-  const value = process.argv[idx + 1];
-  return value && !value.startsWith('-') ? value : undefined;
-}
+import { resolveProjectConfig } from '@t-req/core/config';${nodeImport}
 
-const profile = getFlagValue('--profile') ?? process.env.TREQ_PROFILE;
-const { config, meta } = await resolveProjectConfig({
-  startDir: process.cwd(),
-  profile: profile || undefined,
-});
-
-for (const warning of meta.warnings) {
-  console.warn(\`Warning: \${warning}\`);
-}
+const { config } = await resolveProjectConfig({ startDir: process.cwd() });
 
-const client = createClient({
-  ${runtime === 'node' ? 'io: createNodeIO(),' : ''}
+const client = createClient({${ioOption}
   variables: config.variables,
-  // Map config defaults into the client (timeout + headers/redirects/ssl/proxy).
-  timeout: config.defaults.timeoutMs,
   defaults: config.defaults,
 });
 
-// Example: Get a user
-console.log('Fetching user...');
-const response = await client.run('./collection/users/get.http', {
-  variables: { userId: 1 },
-});
-
-if (response.ok) {
-  const user = await response.json();
-  console.log('User:', user);
-} else {
-  console.error('Failed to fetch user:', response.status, response.statusText);
-}
+const response = await client.run('./collection/users/get.http');
+console.log(response.status, await response.json());
 `;
 }
 
@@ -308,12 +288,17 @@ export function generatePackageJson(projectName: string, config: ProjectConfig):
       start: runCommand
     },
     dependencies: {
-      '@t-req/core': '^0.1.0'
+      '@t-req/core': 'latest'
     }
   };
 
-  if (config.runtime === 'node') {
+  if (config.runtime === 'bun') {
+    pkg['devDependencies'] = {
+      '@types/bun': 'latest'
+    };
+  } else {
     pkg['devDependencies'] = {
+      '@types/node': '^22.0.0',
       tsx: '^4.0.0'
     };
   }
@@ -333,11 +318,33 @@ dist/
 `;
 }
 
-export function generateLoginRequest(): string {
-  return `POST {{baseUrl}}/auth/login
+export function generateTsconfig(runtime: Runtime): string {
+  const types = runtime === 'bun' ? 'bun-types' : 'node';
+  return `${JSON.stringify(
+    {
+      compilerOptions: {
+        target: 'ESNext',
+        module: 'ESNext',
+        moduleResolution: 'bundler',
+        types: [types],
+        strict: true,
+        noEmit: true
+      }
+    },
+    null,
+    2
+  )}\n`;
+}
+
+export function generateCreatePostRequest(): string {
+  return `POST {{baseUrl}}/posts
 Content-Type: application/json
 
-{"email": "{{email}}", "password": "{{password}}"}
+{
+  "title": "Hello from t-req",
+  "body": "This is a sample post.",
+  "userId": 1
+}
 `;
 }
 

packages/app/test/cmd/init.test.ts

@@ -1,10 +1,13 @@
 import { describe, expect, test } from 'bun:test';
 import {
   generateConfig,
+  generateCreatePostRequest,
+  generateGetUserRequest,
   generateGitignore,
-  generateLoginRequest,
+  generateListUsersRequest,
   generatePackageJson,
   generateRunScript,
+  generateTsconfig,
   getInstallCommand,
   getNextSteps,
   validateProjectName
@@ -102,16 +105,24 @@ describe('generated file contents', () => {
     expect(pkg.private).toBe(true);
   });
 
-  test('should add tsx devDependency for node runtime', () => {
+  test('should add type devDependencies per runtime', () => {
     const bunPkg = JSON.parse(
       generatePackageJson('test', { name: 'test', runtime: 'bun', packageManager: 'bun' })
     ) as { devDependencies?: Record<string, string> };
-    expect(bunPkg.devDependencies).toBeUndefined();
+    expect(bunPkg.devDependencies?.['@types/bun']).toBe('latest');
 
     const nodePkg = JSON.parse(
       generatePackageJson('test', { name: 'test', runtime: 'node', packageManager: 'npm' })
     ) as { devDependencies?: Record<string, string> };
     expect(nodePkg.devDependencies?.tsx).toBe('^4.0.0');
+    expect(nodePkg.devDependencies?.['@types/node']).toBe('^22.0.0');
+  });
+
+  test('should use latest for @t-req/core dependency', () => {
+    const pkg = JSON.parse(
+      generatePackageJson('test', { name: 'test', runtime: 'bun', packageManager: 'bun' })
+    ) as { dependencies: Record<string, string> };
+    expect(pkg.dependencies['@t-req/core']).toBe('latest');
   });
 
   test('should generate .gitignore with common patterns', () => {
@@ -132,11 +143,44 @@ describe('generated file contents', () => {
   });
 
   test('should generate sample HTTP request files', () => {
-    const loginRequest = generateLoginRequest();
-    expect(loginRequest).toContain('POST');
-    expect(loginRequest).toContain('{{baseUrl}}');
-    expect(loginRequest).toContain('{{email}}');
-    expect(loginRequest).toContain('{{password}}');
+    const createPost = generateCreatePostRequest();
+    expect(createPost).toContain('POST');
+    expect(createPost).toContain('{{baseUrl}}/posts');
+    expect(createPost).toContain('"title"');
+    expect(createPost).not.toContain('{{email}}');
+    expect(createPost).not.toContain('{{password}}');
+  });
+
+  test('should generate run script with resolveProjectConfig and without getFlagValue', () => {
+    const script = generateRunScript('bun');
+    expect(script).toContain('resolveProjectConfig');
+    expect(script).not.toContain('getFlagValue');
+    expect(script).not.toContain('meta.warnings');
+  });
+
+  test('should generate tsconfig with bun-types for bun runtime', () => {
+    const tsconfig = JSON.parse(generateTsconfig('bun'));
+    expect(tsconfig.compilerOptions.types).toEqual(['bun-types']);
+  });
+
+  test('should generate tsconfig with node types for node runtime', () => {
+    const tsconfig = JSON.parse(generateTsconfig('node'));
+    expect(tsconfig.compilerOptions.types).toEqual(['node']);
+  });
+
+  test('all template variables should be defined in config', () => {
+    const config = generateConfig();
+    const templates = [
+      generateCreatePostRequest(),
+      generateListUsersRequest(),
+      generateGetUserRequest()
+    ];
+    for (const tpl of templates) {
+      const vars = [...tpl.matchAll(/\{\{(\w+)\}\}/g)].map((m) => m[1]);
+      for (const v of vars) {
+        expect(config).toContain(`"${v}"`);
+      }
+    }
   });
 });
 

packages/webdocs/public/_redirects

@@ -1 +1 @@
-/install https://raw.githubusercontent.com/tensorix-labs/t-req/main/install 200
+/install https://raw.githubusercontent.com/tensorix-labs/t-req/main/install 302