@teispace/next-maker 1.20.1 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # 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)
 
 

package/README.md

@@ -100,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)
 
@@ -393,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
@@ -749,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
@@ -796,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.
 
 ---