create-soda 0.1.1 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-soda",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Create a Soda project: bun create soda my-app",
   "keywords": [
     "soda",
@@ -25,13 +25,15 @@
   },
   "files": [
     "dist",
-    "template",
-    "core-version.json"
+    "templates"
   ],
   "engines": {
     "node": ">=20"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.build.json && bun scripts/write-core-version.ts"
+    "build": "rm -rf dist && bun build src/index.ts --target node --outfile dist/index.js"
+  },
+  "devDependencies": {
+    "@clack/prompts": "^1.9.0"
   }
 }

package/{template → templates/demo}/README.md

@@ -4,9 +4,13 @@ Created with `create-soda`. Requires [Bun](https://bun.sh).
 
 ```bash
 bun install
-bun dev        # bun --hot: reloads on change
-bun test
+bun dev          # bun --hot: reloads on change
+bun debug        # the same, with the inspector
+bun test         # test:watch, test:cov
 bun typecheck
+bun lint         # oxlint; lint:fix
+bun run build    # bundles src/main.ts into dist/
+bun start:prod   # runs the bundle
 ```
 
 - `src/main.ts`: creates the application, CORS, graceful shutdown.

package/templates/demo/_oxlintrc.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": [
+    "typescript",
+    "unicorn",
+    "oxc",
+    "import"
+  ],
+  "categories": {
+    "correctness": "error",
+    "suspicious": "warn"
+  },
+  "rules": {
+    "typescript/no-extraneous-class": [
+      "warn",
+      {
+        "allowWithDecorator": true
+      }
+    ]
+  },
+  "ignorePatterns": [
+    "dist"
+  ]
+}

package/templates/demo/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "soda-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "bun --hot src/main.ts",
+    "debug": "bun --inspect --hot src/main.ts",
+    "start": "bun src/main.ts",
+    "build": "bun build src/main.ts --target bun --outdir dist --minify --sourcemap=linked",
+    "start:prod": "bun dist/main.js",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:cov": "bun test --coverage",
+    "typecheck": "bun check",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix"
+  },
+  "dependencies": {
+    "@getsoda/core": "workspace",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "oxlint": "^1.93.0",
+    "typescript": "^7.0.2"
+  }
+}

package/templates/minimal/README.md

@@ -0,0 +1,18 @@
+# Soda app
+
+Created with `create-soda`. Requires [Bun](https://bun.sh).
+
+```bash
+bun install
+bun dev          # bun --hot: reloads on change
+bun debug        # the same, with the inspector
+bun test         # test:watch, test:cov
+bun typecheck
+bun lint         # oxlint; lint:fix
+bun run build    # bundles src/main.ts into dist/
+bun start:prod   # runs the bundle
+```
+
+- `src/main.ts`: creates the application and starts listening.
+- `src/app.module.ts`: the root module.
+- `src/app.controller.ts`, `src/app.service.ts`: `GET /` answers `Hello Soda!`.

package/templates/minimal/_gitignore

@@ -0,0 +1,11 @@
+node_modules
+dist
+*.tgz
+coverage
+
+.env
+.env.local
+.env.*.local
+
+.DS_Store
+.idea

package/templates/minimal/_oxlintrc.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": [
+    "typescript",
+    "unicorn",
+    "oxc",
+    "import"
+  ],
+  "categories": {
+    "correctness": "error",
+    "suspicious": "warn"
+  },
+  "rules": {
+    "typescript/no-extraneous-class": [
+      "warn",
+      {
+        "allowWithDecorator": true
+      }
+    ]
+  },
+  "ignorePatterns": [
+    "dist"
+  ]
+}

package/templates/minimal/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "soda-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "bun --hot src/main.ts",
+    "debug": "bun --inspect --hot src/main.ts",
+    "start": "bun src/main.ts",
+    "build": "bun build src/main.ts --target bun --outdir dist --minify --sourcemap=linked",
+    "start:prod": "bun dist/main.js",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:cov": "bun test --coverage",
+    "typecheck": "bun check",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix"
+  },
+  "dependencies": {
+    "@getsoda/core": "workspace"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "oxlint": "^1.93.0",
+    "typescript": "^7.0.2"
+  }
+}

package/templates/minimal/src/app.controller.ts

@@ -0,0 +1,12 @@
+import { Controller, Get, inject } from '@getsoda/core'
+import { AppService } from './app.service.ts'
+
+@Controller()
+export class AppController {
+  readonly #app = inject(AppService)
+
+  @Get()
+  getHello(): string {
+    return this.#app.getHello()
+  }
+}

package/templates/minimal/src/app.module.ts

@@ -0,0 +1,6 @@
+import { Module } from '@getsoda/core'
+import { AppController } from './app.controller.ts'
+import { AppService } from './app.service.ts'
+
+@Module({ providers: [AppService], controllers: [AppController] })
+export class AppModule {}

package/templates/minimal/src/app.service.ts

@@ -0,0 +1,5 @@
+export class AppService {
+  getHello(): string {
+    return 'Hello Soda!'
+  }
+}

package/templates/minimal/src/app.test.ts

@@ -0,0 +1,15 @@
+import { afterAll, expect, test } from 'bun:test'
+import { createApp } from '@getsoda/core'
+import { AppModule } from './app.module.ts'
+
+const app = await createApp(AppModule, { logger: false })
+const server = await app.listen(0)
+
+afterAll(() => app.close())
+
+test('GET / says hello', async () => {
+  const response = await fetch(server.url)
+
+  expect(response.status).toBe(200)
+  expect(await response.text()).toBe('Hello Soda!')
+})

package/templates/minimal/src/main.ts

@@ -0,0 +1,7 @@
+import { createApp } from '@getsoda/core'
+import { AppModule } from './app.module.ts'
+
+const app = await createApp(AppModule)
+
+app.enableShutdownSignals()
+await app.listen(Number(process.env.PORT ?? 3000))

package/templates/minimal/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    "types": ["bun"],
+
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true
+  }
+}

package/core-version.json

@@ -1 +0,0 @@
-{"version":"0.1.1"}

package/dist/project.js

@@ -1,68 +0,0 @@
-/**
- * @module
- * Creating a project from the template: names, target directory, files.
- *
- * Rules from `create-vite`: the target directory is cleaned of characters
- * file systems refuse, a directory holding only `.git` counts as empty, the
- * package name is made valid for npm, and `.gitignore` is stored as
- * `_gitignore` because npm drops `.gitignore` files from published packages.
- */
-import { existsSync } from 'node:fs';
-import { cp, readdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
-import { basename, join, resolve } from 'node:path';
-/** Template files renamed when copied. */
-const RENAMED = { _gitignore: '.gitignore' };
-/** `' my-app/ '` → `'my-app'`. */
-export const formatTargetDir = (dir) => dir
-    .trim()
-    .replace(/[<>:"\\|?*]/g, '')
-    .replace(/\/+$/, '');
-export const isValidPackageName = (name) => /^(?:@[a-z\d\-*~][a-z\d\-*._~]*\/)?[a-z\d\-~][a-z\d\-._~]*$/.test(name);
-/** `'My App'` → `'my-app'`. */
-export const toValidPackageName = (name) => name
-    .trim()
-    .toLowerCase()
-    .replace(/\s+/g, '-')
-    .replace(/^[._]/, '')
-    .replace(/[^a-z\d\-~]+/g, '-');
-/** `true` for a missing directory, an empty one, or one holding only `.git`. */
-export const isEmptyDir = async (dir) => {
-    if (!existsSync(dir)) {
-        return true;
-    }
-    const entries = await readdir(dir);
-    return entries.length === 0 || (entries.length === 1 && entries[0] === '.git');
-};
-/** Removes everything in `dir` but `.git`. */
-export const emptyDir = async (dir) => {
-    for (const entry of await readdir(dir)) {
-        if (entry !== '.git') {
-            await rm(join(dir, entry), { recursive: true, force: true });
-        }
-    }
-};
-/**
- * Copies the template into `dir`, renames `_gitignore`, sets the package name and the core version.
- */
-export const createProject = async (options) => {
-    const root = resolve(options.dir);
-    await cp(options.template, root, { recursive: true });
-    for (const [from, to] of Object.entries(RENAMED)) {
-        if (existsSync(join(root, from))) {
-            await rename(join(root, from), join(root, to));
-        }
-    }
-    const manifestPath = join(root, 'package.json');
-    const manifest = JSON.parse(await readFile(manifestPath, 'utf8'));
-    manifest.name = options.name ?? toValidPackageName(basename(root));
-    manifest.dependencies['@getsoda/core'] = options.coreVersion;
-    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
-};
-/**
- * Package manager the command was run with, from `npm_config_user_agent`
- * (`bun/1.4.3 npm/? node/v24…` → `bun`). Defaults to `bun`.
- */
-export const detectPackageManager = (userAgent) => {
-    const name = userAgent?.split(' ')[0]?.split('/')[0];
-    return name === undefined || name === '' ? 'bun' : name;
-};

package/template/package.json

@@ -1,20 +0,0 @@
-{
-  "name": "soda-app",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "bun --hot src/main.ts",
-    "start": "bun src/main.ts",
-    "test": "bun test",
-    "typecheck": "bun check"
-  },
-  "dependencies": {
-    "@getsoda/core": "workspace",
-    "zod": "^4.6.7"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^7.0.2"
-  }
-}