@karmaniverous/smoz 0.1.6 → 0.1.7

package/README.md

@@ -12,9 +12,7 @@
 
 </div>
 
-SMOZ is a small, pragmatic toolkit for authoring AWS Lambda handlers with
-[Middy] and [Zod], then aggregating Serverless functions and hand‑crafted
-OpenAPI 3.1 paths from a single, schema‑first application definition.
+SMOZ is a small, pragmatic toolkit for authoring AWS Lambda handlers with [Middy] and [Zod], then aggregating Serverless functions and hand‑crafted OpenAPI 3.1 paths from a single, schema‑first application definition.
 
 - Keep prod code testable and framework‑agnostic
 - HTTP middleware with validation, shaping, errors, CORS, negotiation, and HEAD
@@ -41,14 +39,7 @@ OpenAPI 3.1 paths from a single, schema‑first application definition.
 ## Install
 
 ```bash
-npm i @karmaniverous/smoz zod zod-openapi @middy/core \
-  @middy/http-header-normalizer \
-  @middy/http-event-normalizer \
-  @middy/http-json-body-parser \
-  @middy/http-content-negotiation \
-  @middy/http-error-handler \
-  @middy/http-cors \
-  @middy/http-response-serializer
+npm i @karmaniverous/smoz zod zod-openapi
 ```
 
 ## Dev tooling (recommended):

package/dist/cli/index.cjs

@@ -796,8 +796,7 @@ const launchInline = async (root, opts) => {
  * Scaffolds a new project from packaged templates.
  * - Copies ./templates/project/ into the target root (shared boilerplate)
  * - Copies ./templates/<template>/ into the target root (default: minimal)
- * - Seeds app/generated/register.*.ts (empty modules) if missing
- * - Idempotent: copy-if-absent; if a file exists, writes <name>.example alongside
+ * - Seeds app/generated/register.*.ts (empty modules) if missing * - Idempotent: copy-if-absent; if a file exists, writes <name>.example alongside
  * - Additive merge of template manifest (deps/devDeps/scripts) into package.json
  * - Optional dependency installation via --install[=<pm>]
  */
@@ -971,6 +970,33 @@ const runInit = async (root, template = 'minimal', opts) => {
     }
     // 2) Copy selected template
     await copyDirIdempotent(srcBase, root, created, skipped, examples);
+    // 2.5) Convert template 'gitignore' into real '.gitignore'
+    // NPM often excludes '.gitignore' from published packages; shipping 'gitignore'
+    // and converting here ensures downstream projects get a proper .gitignore.
+    try {
+        const giSrc = path.join(root, 'gitignore');
+        const giDot = path.join(root, '.gitignore');
+        if (fs.existsSync(giSrc)) {
+            if (!fs.existsSync(giDot)) {
+                await fs.promises.rename(giSrc, giDot);
+                created.push(path.posix.normalize(giDot));
+            }
+            else {
+                // Both exist: preserve the template as an example (if not already present),
+                // then remove the extra 'gitignore' to avoid clutter.
+                const example = path.join(root, 'gitignore.example');
+                if (!fs.existsSync(example)) {
+                    const data = await fs.promises.readFile(giSrc, 'utf8');
+                    await fs.promises.writeFile(example, data, 'utf8');
+                    examples.push(path.posix.normalize(example));
+                }
+                await fs.promises.rm(giSrc, { force: true });
+            }
+        }
+    }
+    catch {
+        // best-effort; ignore conversion errors
+    }
     // Seed app/generated/register.*.ts (empty modules) if missing
     const genDir = path.resolve(root, 'app', 'generated');
     const seeds = [

package/package.json

@@ -185,5 +185,5 @@
     "templates:lint": "eslint --fix -c templates/.check/eslint.templates.config.ts \"templates/**/*.{ts,tsx,js,jsx}\" && eslint --fix --no-ignore templates/.check/eslint.templates.config.ts"
   },
   "type": "module",
-  "version": "0.1.6"
+  "version": "0.1.7"
 }

package/templates/project/README.md

@@ -23,34 +23,27 @@ This template provides a minimal, convention‑friendly baseline for new SMOZ ap
 
 1. Install dependencies
    - Run: `npm install`
-
 2. Type checking
    - Run: `npm run typecheck`
-
 3. Linting
    - Run: `npm run lint` (or `npm run lint:fix` to auto‑fix)
-
 4. Tests (baseline suite OK)
    - Run: `npm run test`
-
 5. Docs (TypeDoc baseline loads)
    - Run: `npm run docs`
-
 6. Generate OpenAPI (if your app config and endpoints are present)
    - Run: `npm run openapi`
 
 ## SMOZ CLI — register
 
-The CLI scans `app/functions/**` for `lambda.ts`, `openapi.ts`, and optional `serverless.ts`
-and generates side‑effect registration files under `app/generated/`.
+The CLI scans `app/functions/**` for `lambda.ts`, `openapi.ts`, and optional `serverless.ts` and generates side‑effect registration files under `app/generated/`.
 
 - Build CLI (if packaged locally): `npm run cli:build`
 - Register: `npx smoz register`
   - Idempotent: rewrites files only when content changes
   - Formats output with Prettier when available
 
-Tip: Commit `app/generated/register.*.ts` so typecheck is stable without running the CLI.
-Teams often keep `app/generated/openapi.json` untracked in VCS (optional).
+Tip: Commit `app/generated/register.*.ts` so typecheck is stable without running the CLI. Teams often keep `app/generated/openapi.json` untracked in VCS (optional).
 
 ## Notes
 
@@ -70,9 +63,7 @@ Teams often keep `app/generated/openapi.json` untracked in VCS (optional).
 
 ## Path hygiene (cross‑platform)
 
-Windows uses backslashes in paths, which can leak into string comparisons and
-generated artifacts. Normalize separators consistently using the helper exported
-by the toolkit:
+Windows uses backslashes in paths, which can leak into string comparisons and generated artifacts. Normalize separators consistently using the helper exported by the toolkit:
 
 ```ts
 import { toPosixPath } from '@karmaniverous/smoz';
@@ -82,4 +73,4 @@ import { fileURLToPath } from 'node:url';
 export const APP_ROOT_ABS = toPosixPath(
   fileURLToPath(new URL('..', import.meta.url)),
 );
-```
+```

package/templates/project/gitignore

@@ -0,0 +1,42 @@
+# Dependencies
+node_modules/
+
+# Build outputs and caches
+dist/
+.tsbuild/
+**/.tsbuild/
+*.tsbuildinfo
+**/.rollup.cache/
+
+# Serverless packaging
+.serverless/
+
+# Test coverage
+coverage/
+
+# Generated artifacts
+# Teams often keep registers tracked for typecheck stability,
+# but the OpenAPI JSON is usually untracked.
+app/generated/openapi.json
+
+# Environment files (local only; do not commit secrets)
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# OS / editor files
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+
+# Misc
+*.swp
+*.swo