create-packkit 2.3.0 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-packkit",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "Highly configurable scaffolder for modern npm packages and CLIs — pick your stack (TS/JS, bundler, tests, linter, CI, releases) from a CLI or a web configurator.",
   "type": "module",
   "bin": {

package/src/cli/args.js

@@ -15,6 +15,7 @@ const OVERRIDE_FLAGS = {
   license: 'license',
   pm: 'packageManager',
   node: 'nodeVersion',
+  server: 'serviceFramework',
   author: 'author',
   description: 'description',
   repo: 'repo',
@@ -55,6 +56,7 @@ export function parseCliArgs(argv) {
       'pkg-checks': { type: 'boolean' },
       knip: { type: 'boolean' },
       'size-limit': { type: 'boolean' },
+      doctor: { type: 'boolean' },
       jsr: { type: 'boolean' },
       help: { type: 'boolean', short: 'h' },
       version: { type: 'boolean', short: 'v' },
@@ -85,6 +87,7 @@ export function parseCliArgs(argv) {
   if (values['pkg-checks']) overrides.pkgChecks = true;
   if (values.knip) overrides.knip = true;
   if (values['size-limit']) overrides.sizeLimit = true;
+  if (values.doctor) overrides.doctor = true;
   if (values.jsr) overrides.jsr = true;
   for (const [flag, key] of Object.entries(NEGATABLE)) {
     if (values[flag]) overrides[key] = false;

package/src/cli/index.js

@@ -39,6 +39,7 @@ Options:
   --pm <manager>      npm | pnpm | yarn | bun
   --language <ts|js>  --module <esm|cjs|dual>  --framework <none|react|vue|svelte>
   --target <library|cli|service|app>   (repeatable)   --storybook
+  --server <hono|fastify|express>   (HTTP service framework)
   --bundler <tsup|tsdown|unbuild|rollup|none>   --minify
   --test <vitest|jest|node|none>   --e2e (Playwright, for apps)
   --env (type-safe env validation, services/CLIs)   --no-sourcemaps
@@ -47,7 +48,7 @@ Options:
   --workflows <ci|npm-publish|pages|codeql|codecov|stale>   (repeatable)
   --deps <renovate|dependabot|none>  --license <MIT|Apache-2.0|ISC|none>
   --pkg-checks (publint + are-the-types-wrong)   --knip   --jsr   --canary
-  --size-limit (bundle-size budget, libraries)
+  --size-limit (bundle-size budget, libraries)   --doctor (env check)
   --no-coverage  --no-community  --no-agents  --no-vscode  --no-editorconfig
   --schema            Print the full option/preset schema as JSON (for tools/agents)
   -h, --help          Show this help

package/src/cli/wizard.js

@@ -36,6 +36,9 @@ export async function runWizard(seed = {}) {
     cfg.minify = bail(await p.confirm({ message: 'Minify the build output?', initialValue: false }));
   }
   cfg.test = bail(await p.select({ message: 'Test runner', options: asOptions('test'), initialValue: OPTIONS.test.default }));
+  if (cfg.target.includes('service')) {
+    cfg.serviceFramework = bail(await p.select({ message: 'Service framework', options: asOptions('serviceFramework'), initialValue: OPTIONS.serviceFramework.default }));
+  }
   if (cfg.target.includes('app')) {
     cfg.e2e = bail(await p.confirm({ message: 'Add Playwright end-to-end tests?', initialValue: false }));
   }

package/src/core/features/doctor.js

@@ -0,0 +1,54 @@
+// A tiny environment doctor: checks the local Node and package manager match
+// what this project expects, and warns (never fails) otherwise. `npm run doctor`
+// runs it any time; for private projects it also runs on postinstall. It is NOT
+// wired to postinstall for publishable packages — that would run in every
+// consumer's install.
+
+export default {
+  id: 'doctor',
+  active: (cfg) => cfg.doctor && !cfg.monorepo,
+  apply(cfg) {
+    const files = { 'scripts/doctor.mjs': script(cfg) };
+    const pkg = { scripts: { doctor: 'node scripts/doctor.mjs' } };
+    if (!cfg.publishable) pkg.scripts.postinstall = 'node scripts/doctor.mjs';
+    return { files, pkg };
+  },
+};
+
+function script(cfg) {
+  return [
+    `/* global process, console, URL */`,
+    `// Checks your environment matches this project. Warns only — never fails.`,
+    `import { readFileSync } from 'node:fs';`,
+    ``,
+    `const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));`,
+    `const gte = (a, b) => {`,
+    `\tconst pa = String(a).split('.').map(Number);`,
+    `\tconst pb = String(b).split('.').map(Number);`,
+    `\tfor (let i = 0; i < 3; i++) if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) > (pb[i] || 0);`,
+    `\treturn true;`,
+    `};`,
+    ``,
+    `let issues = 0;`,
+    `const floor = (pkg.engines?.node || '').replace(/[^0-9.]/g, '');`,
+    `const node = process.versions.node;`,
+    `if (floor && !gte(node, floor)) {`,
+    "\tconsole.warn(`⚠  Node ${node} is below the required >=${floor} — run: nvm install ${floor.split('.')[0]}`);",
+    `\tissues++;`,
+    `} else {`,
+    "\tconsole.log(`✓ Node ${node}`);",
+    `}`,
+    ``,
+    `const expectedPm = '${cfg.packageManager}';`,
+    `const usingPm = (process.env.npm_config_user_agent || '').split('/')[0];`,
+    `if (usingPm && usingPm !== expectedPm) {`,
+    "\tconsole.warn(`⚠  This project uses ${expectedPm}, but you ran ${usingPm}.`);",
+    `\tissues++;`,
+    `} else {`,
+    "\tconsole.log(`✓ Package manager: ${expectedPm}`);",
+    `}`,
+    ``,
+    `if (issues) console.warn('\\nSee the README "Requirements" section to fix these.');`,
+    ``,
+  ].join('\n');
+}

package/src/core/features/index.js

@@ -22,6 +22,7 @@ import storybook from './storybook.js';
 import community from './community.js';
 import agents from './agents.js';
 import vscode from './vscode.js';
+import doctor from './doctor.js';
 import gitfiles from './gitfiles.js';
 
 export default [
@@ -46,5 +47,6 @@ export default [
   community,
   agents,
   vscode,
+  doctor,
   gitfiles,
 ];

package/src/core/features/service.js

@@ -1,14 +1,16 @@
-// HTTP service target (Hono). Splits the app (testable) from the server entry
-// (which listens), adds start/dev scripts, and a Dockerfile.
+// HTTP service target. Supports Hono (default), Fastify and Express. Splits the
+// app (testable) from the server entry (which listens), adds start/dev scripts,
+// and a production Dockerfile.
 
 export default {
   id: 'service',
   active: (cfg) => cfg.hasService,
   apply(cfg) {
     const ext = cfg.ext;
+    const fw = cfg.serviceFramework || 'hono';
     const files = {
-      [`src/app.${ext}`]: appFile(cfg),
-      [`src/index.${ext}`]: serverFile(cfg),
+      [`src/app.${ext}`]: appFile(cfg, fw),
+      [`src/index.${ext}`]: serverFile(cfg, fw),
       Dockerfile: dockerfile(cfg),
       '.dockerignore': ['node_modules', 'dist', 'coverage', '.git', '.github', '.env', '.env.*', '!.env.example', '*.log', 'Dockerfile', '.dockerignore', ''].join('\n'),
     };
@@ -20,15 +22,50 @@ export default {
           start: 'node dist/index.js',
           dev: cfg.isTs ? 'tsx watch src/index.ts' : 'node --watch src/index.js',
         },
-        dependencies: { hono: '^4.5.0', '@hono/node-server': '^2.0.0' },
-        ...(cfg.isTs ? { devDependencies: { tsx: '^4.0.0' } } : {}),
+        dependencies: deps(fw),
+        devDependencies: {
+          ...(cfg.isTs ? { tsx: '^4.0.0' } : {}),
+          ...(cfg.isTs ? typeDeps(fw) : {}),
+        },
       },
     };
   },
 };
 
-function appFile(cfg) {
-  const t = cfg.isTs;
+function deps(fw) {
+  if (fw === 'fastify') return { fastify: '^5.0.0' };
+  if (fw === 'express') return { express: '^5.0.0' };
+  return { hono: '^4.5.0', '@hono/node-server': '^2.0.0' };
+}
+
+function typeDeps(fw) {
+  if (fw === 'express') return { '@types/express': '^5.0.0' };
+  return {};
+}
+
+function appFile(cfg, fw) {
+  if (fw === 'fastify') {
+    return [
+      `import Fastify from 'fastify';`,
+      ``,
+      `export const app = Fastify();`,
+      ``,
+      `app.get('/', async () => ({ ok: true, service: '${cfg.name}' }));`,
+      `app.get('/health', async () => 'ok');`,
+      ``,
+    ].join('\n');
+  }
+  if (fw === 'express') {
+    return [
+      `import express from 'express';`,
+      ``,
+      `export const app = express();`,
+      ``,
+      `app.get('/', (_req, res) => res.json({ ok: true, service: '${cfg.name}' }));`,
+      `app.get('/health', (_req, res) => res.send('ok'));`,
+      ``,
+    ].join('\n');
+  }
   return [
     `import { Hono } from 'hono';`,
     ``,
@@ -40,13 +77,43 @@ function appFile(cfg) {
   ].join('\n');
 }
 
-function serverFile(cfg) {
+function serverFile(cfg, fw) {
+  const port = cfg.env ? 'env.PORT' : 'Number(process.env.PORT) || 3000';
+  const envImport = cfg.env ? `import { env } from './env.js';` : null;
+
+  if (fw === 'fastify') {
+    return [
+      `import { app } from './app.js';`,
+      envImport,
+      ``,
+      `const port = ${port};`,
+      `app.listen({ port, host: '0.0.0.0' }).then((url) => {`,
+      `\tconsole.log(\`Listening on \${url}\`);`,
+      `}).catch((err) => {`,
+      `\tapp.log.error(err);`,
+      `\tprocess.exit(1);`,
+      `});`,
+      ``,
+    ].filter((l) => l !== null).join('\n');
+  }
+  if (fw === 'express') {
+    return [
+      `import { app } from './app.js';`,
+      envImport,
+      ``,
+      `const port = ${port};`,
+      `app.listen(port, () => {`,
+      `\tconsole.log(\`Listening on http://localhost:\${port}\`);`,
+      `});`,
+      ``,
+    ].filter((l) => l !== null).join('\n');
+  }
   return [
     `import { serve } from '@hono/node-server';`,
     `import { app } from './app.js';`,
-    cfg.env ? `import { env } from './env.js';` : null,
+    envImport,
     ``,
-    `const port = ${cfg.env ? 'env.PORT' : 'Number(process.env.PORT) || 3000'};`,
+    `const port = ${port};`,
     `serve({ fetch: app.fetch, port }, (info) => {`,
     `\tconsole.log(\`Listening on http://localhost:\${info.port}\`);`,
     `});`,

package/src/core/features/test.js

@@ -68,6 +68,12 @@ export default {
       files[`src/index.test.${testExt}`] = exampleTest('node', cfg);
     }
 
+    // Express services test through supertest (no built-in inject).
+    if (cfg.hasService && cfg.serviceFramework === 'express') {
+      pkg.devDependencies.supertest = '^7.0.0';
+      if (cfg.isTs) pkg.devDependencies['@types/supertest'] = '^6.0.0';
+    }
+
     return { files, pkg };
   },
 };
@@ -82,13 +88,28 @@ function exampleTest(runner, cfg) {
   const imp = importPath(runner, cfg);
   if (cfg.hasService) {
     const api = runner === 'jest' ? '' : `import { describe, it, expect } from 'vitest';\n`;
+    const fw = cfg.serviceFramework || 'hono';
+    let imports, call, statusProp;
+    if (fw === 'fastify') {
+      imports = `import { app } from './app.js';`;
+      call = `await app.inject({ method: 'GET', url: '/' })`;
+      statusProp = 'statusCode';
+    } else if (fw === 'express') {
+      imports = `import request from 'supertest';\nimport { app } from './app.js';`;
+      call = `await request(app).get('/')`;
+      statusProp = 'status';
+    } else {
+      imports = `import { app } from './app.js';`;
+      call = `await app.request('/')`;
+      statusProp = 'status';
+    }
     return [
-      api + `import { app } from './app.js';`,
+      api + imports,
       ``,
       `describe('app', () => {`,
       `\tit('responds on /', async () => {`,
-      `\t\tconst res = await app.request('/');`,
-      `\t\texpect(res.status).toBe(200);`,
+      `\t\tconst res = ${call};`,
+      `\t\texpect(res.${statusProp}).toBe(200);`,
       `\t});`,
       `});`,
       ``,

package/src/core/options.js

@@ -34,6 +34,14 @@ export const OPTIONS = {
       { value: 'cjs', label: 'CommonJS only' },
     ],
   },
+  serviceFramework: {
+    group: 'core', type: 'select', label: 'Service framework (HTTP service)', default: 'hono',
+    choices: [
+      { value: 'hono', label: 'Hono (fast, web-standard)' },
+      { value: 'fastify', label: 'Fastify' },
+      { value: 'express', label: 'Express' },
+    ],
+  },
   target: {
     group: 'core', type: 'multiselect', label: 'What are you building?', default: ['library'],
     choices: [
@@ -103,6 +111,7 @@ export const OPTIONS = {
   pkgChecks: { group: 'quality', type: 'boolean', label: 'Package checks (publint + are-the-types-wrong)', default: false },
   knip: { group: 'quality', type: 'boolean', label: 'Knip (unused files / deps / exports)', default: false },
   sizeLimit: { group: 'quality', type: 'boolean', label: 'size-limit (bundle-size budget, libraries)', default: false },
+  doctor: { group: 'quality', type: 'boolean', label: 'Env doctor (warn on Node / package-manager mismatch)', default: false },
 
   // ---- lint / format ----
   lint: {