create-packkit 2.3.0 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-packkit",
-  "version": "2.3.0",
+  "version": "2.4.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',

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

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/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: [