@teispace/next-maker 1.20.0 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [2.0.0](https://github.com/teispace/npm-packages/compare/next-maker-v1.20.1...next-maker-v2.0.0) (2026-05-15)
+
+
+### ⚠ BREAKING CHANGES
+
+* **next-maker:** apps generated before this release are missing shared/ and api-url.ts. Run `next-maker doctor --fix` or `next-maker setup http-client` to restore them.
+* **next-maker:** services generated by `next-maker service <name>` or `next-maker service <name> --crud` now emit bare-path endpoints. Any hand-rolled endpoints in app-apis.ts that still use \`\${API_PREFIX}\` will double-prefix once the rest of the template (getApiBaseUrl) lands — strip the interpolation when migrating.
+* **next-maker:** apps generated before this release are missing shared/ and api-url.ts. Run `next-maker doctor --fix` or `next-maker setup http-client` to restore them.
+
+### Features
+
+* **next-maker:** emit bare-path endpoints in generated AppApis entries ([#71](https://github.com/teispace/npm-packages/issues/71)) ([0d836b3](https://github.com/teispace/npm-packages/commit/0d836b3dab9dd84dae3b04f74c4671b59e28b75b))
+* **next-maker:** sync http-client setup with shared/ + api-url layout ([#70](https://github.com/teispace/npm-packages/issues/70)) ([3df79a4](https://github.com/teispace/npm-packages/commit/3df79a4c6de1698f1488311ab22f7fd80b662cdc))
+
+
+### Documentation
+
+* **next-maker:** sync README with shared/ + api-url layout ([#72](https://github.com/teispace/npm-packages/issues/72)) ([3d64863](https://github.com/teispace/npm-packages/commit/3d648636ce1b88fa88c6f0788eb6538ea717b154))
+
+
+### Tests
+
+* **next-maker:** cover copyHttpClientFiles and crudApiConfigTemplate ([#73](https://github.com/teispace/npm-packages/issues/73)) ([10597cf](https://github.com/teispace/npm-packages/commit/10597cfee2ec70000d79419a7f25669351caffcc))
+
+## [1.20.1](https://github.com/teispace/npm-packages/compare/next-maker-v1.20.0...next-maker-v1.20.1) (2026-05-06)
+
+
+### Bug Fixes
+
+* **next-themes:** sync runtime props, validate cookies, harden hooks ([#68](https://github.com/teispace/npm-packages/issues/68)) ([05dc87c](https://github.com/teispace/npm-packages/commit/05dc87c5155d0919a1b179b8e7b842beebe65596))
+
 ## [1.20.0](https://github.com/teispace/npm-packages/compare/next-maker-v1.19.2...next-maker-v1.20.0) (2026-05-06)
 
 

package/README.md

@@ -38,6 +38,7 @@ next-maker <command> [args] [options]
 | Config | `locale [code]` | Add a new language/locale |
 | Code | `hook <name>` | Custom React hook |
 | Code | `test <file>` | Sibling test stub for a component/hook/slice |
+| Assets | `favicon` | Generate `favicon.ico` (and optionally PWA / OG / Apple icons) from a source image |
 
 Run `npx @teispace/next-maker <command> --help` for the full option list of any command.
 
@@ -99,7 +100,7 @@ The starter at [`teispace/nextjs-starter`](https://github.com/teispace/nextjs-st
 - Pino structured logger with redaction
 - Zod-validated env schema in `src/lib/env/`
 - Feature-based DDD architecture
-- Result-based HTTP clients (when enabled)
+- Dual HTTP clients (`fetchClient` + `axiosClient`) on a shared foundation: runtime-aware cookie forwarding (browser jar in CSR, `next/headers` injection in RSC), automatic `X-Request-Id` correlation, single `parseApiError` pipeline, cookie-mode auth by default, typed query params via `{ params }`
 - Hardened security headers in `next.config.ts`
 - `scripts/sync-env.ts` and `scripts/check-deprecated.ts` (used by the `validate` chain)
 
@@ -392,6 +393,8 @@ npx @teispace/next-maker service <name> [options]
 
 CRUD mode also generates `<Name>Summary` (list view) and `<Name>Detail` (detail view) types, `Create<Name>Dto`, `Update<Name>Dto`, and registers the endpoints in `app-apis.ts`.
 
+Endpoints are emitted as **bare paths** (e.g. `'/users'`, `` `/users/${id}` ``) — the `/api/v{n}` prefix is owned by `getApiBaseUrl()` in `src/lib/config/api-url.ts` and applied at request time. Don't add `${API_PREFIX}` interpolation in `app-apis.ts`; the base URL composer handles it.
+
 ```bash
 npx @teispace/next-maker service payment --axios
 npx @teispace/next-maker service users --fetch --crud
@@ -540,6 +543,64 @@ Requires `setup --tests` first.
 
 ---
 
+### `favicon` — Generate icons from a source image
+
+Generates `favicon.ico` (multi-size) into the App Router root, with optional `icon.png`, `apple-icon.png`, `opengraph-image.png`, `twitter-image.png`, and PWA manifest icons. Source can be PNG, JPG, JPEG, WebP, SVG, or AVIF.
+
+```bash
+npx @teispace/next-maker favicon [options]
+```
+
+| Flag | Effect |
+| --- | --- |
+| `--path <file>` | Source image. If omitted, you'll be prompted. |
+| `--out <dir>` | Output directory (default: auto-detected `src/app` or `app`) |
+| `--icon` | Also emit `icon.png` (512×512) |
+| `--apple` | Also emit `apple-icon.png` (180×180) |
+| `--og` | Also emit `opengraph-image.png` (1200×630) |
+| `--og-source <file>` | Use a separate image for the OG/Twitter card |
+| `--twitter` | Also emit `twitter-image.png` (1200×600) |
+| `--all` | Shorthand for `--icon --apple --og` |
+| `--pwa` | Detect PWA setup and emit manifest icons (192/512); errors if not detected |
+| `--pwa-init` | Bootstrap `public/manifest.webmanifest` with icons |
+| `--shape <shape>` | `square` \| `rounded` \| `circle` \| `squircle` (default: `square`) |
+| `--radius <percent>` | Corner radius % when `--shape=rounded` (0–50, default: 20) |
+| `--bg <color>` | Background: `transparent`, hex (`#0f172a`), CSS name, or `rgb()`/`rgba()`/`hsl()`/`hsla()` (default: `transparent`) |
+| `--padding <percent>` | Padding around source content (0–30, default: 0) |
+| `--fit <fit>` | `contain` \| `cover` \| `clip` (default: `contain`) |
+| `--sizes <list>` | Comma-separated ICO sizes (default: `16,32,48`) |
+| `--quality <n>` | PNG compression 1–100 (higher = smaller; PNG is lossless, default: 90) |
+| `--force` | Overwrite existing files without prompt |
+| `--dry-run` | Show what would be written without writing |
+
+```bash
+# Minimal: just favicon.ico from a source PNG
+npx @teispace/next-maker favicon --path ./brand/logo.png
+
+# Full set: favicon + icon + apple-icon + OG image, rounded with brand background
+npx @teispace/next-maker favicon \
+  --path ./brand/logo.svg \
+  --all \
+  --shape rounded --radius 24 \
+  --bg "#0f172a" \
+  --padding 8
+
+# PWA: emit manifest icons and bootstrap public/manifest.webmanifest
+npx @teispace/next-maker favicon --path ./brand/logo.png --pwa-init
+
+# Separate OG art
+npx @teispace/next-maker favicon \
+  --path ./brand/logo.png \
+  --og --og-source ./brand/social-card.png
+
+# Preview without writing
+npx @teispace/next-maker favicon --path ./brand/logo.png --all --dry-run
+```
+
+Outputs land in your App Router root (`src/app/` or `app/`) so Next.js auto-resolves them via the file conventions for [`favicon.ico`](https://nextjs.org/docs/app/api-reference/file-conventions/metadata/app-icons), [`opengraph-image`](https://nextjs.org/docs/app/api-reference/file-conventions/metadata/opengraph-image), and [`apple-icon`](https://nextjs.org/docs/app/api-reference/file-conventions/metadata/app-icons) — no `<head>` wiring required.
+
+---
+
 ## End-to-end examples
 
 ### Quick start
@@ -663,7 +724,11 @@ my-project/
 │   │   ├── not-found.tsx
 │   │   ├── robots.ts
 │   │   ├── sitemap.ts
-│   │   └── favicon.ico
+│   │   ├── favicon.ico                # `favicon` command
+│   │   ├── icon.png                   # (opt, `favicon --icon`/`--all`) 512×512
+│   │   ├── apple-icon.png             # (opt, `favicon --apple`/`--all`) 180×180
+│   │   ├── opengraph-image.png        # (opt, `favicon --og`/`--all`) 1200×630
+│   │   └── twitter-image.png          # (opt, `favicon --twitter`) 1200×600
 │   ├── proxy.ts                       # (opt, i18n) Next 16 middleware replacement
 │   ├── features/                      # Feature modules (feature-first DDD)
 │   │   └── counter/                   # (opt, redux) example feature
@@ -686,17 +751,18 @@ my-project/
 │   │   ├── api/                       # API service barrel
 │   │   └── storage/                   # react-secure-storage wrapper
 │   ├── lib/
-│   │   ├── config/                    # seo, app-apis, app-paths, app-locales, constants
+│   │   ├── config/                    # seo, app-apis, app-paths, app-locales, constants, api-url (getApiBaseUrl)
 │   │   ├── env/                       # Zod-validated env schema (schema.ts, validate.ts)
 │   │   ├── logger/                    # Pino logger with auto-redaction
-│   │   ├── errors/                    # ApiException, catchError
+│   │   ├── errors/                    # ApiException (carries requestId), catchError
 │   │   ├── enums/
 │   │   └── utils/
 │   │       ├── http/                  # (opt, http-client)
+│   │       │   ├── shared/            # runtime detection, cookie injection, request-id, parseApiError, toSearchParams
 │   │       │   ├── axios-client/      # interceptors, token refresh, Result-based
-│   │       │   ├── fetch-client/      # same Result pattern on native fetch
+│   │       │   ├── fetch-client/      # same Result pattern on native fetch, typed `params`
 │   │       │   ├── client-utils.ts
-│   │       │   └── token-store.ts
+│   │       │   └── token-store.ts    # inert in cookie-mode (the default)
 │   │       └── validations/
 │   ├── i18n/                          # (opt, i18n) routing, request, navigation, translations/
 │   ├── styles/globals.css             # Tailwind v4 directives
@@ -733,7 +799,7 @@ Features that have first-class opt-out prompts during `init`: `httpClient`, `dar
 
 **CLI:** TypeScript, esbuild, Commander.js, Enquirer, Vitest, degit.
 
-**Generated apps:** Next.js 16+, TypeScript, Tailwind CSS v4, Biome, Pino, Zod, Redux Toolkit, `@teispace/next-themes`, next-intl, Axios, Vitest + RTL, React Compiler.
+**Generated apps:** Next.js 16+, TypeScript, Tailwind CSS v4, Biome, Pino, Zod, Redux Toolkit, `@teispace/next-themes`, next-intl, Fetch / Axios HTTP clients (shared foundation), Vitest + RTL, React Compiler.
 
 ---