@teispace/next-maker 1.20.1 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## [2.1.0](https://github.com/teispace/npm-packages/compare/next-maker-v2.0.0...next-maker-v2.1.0) (2026-05-15)
+
+
+### Features
+
+* **next-maker:** add WebSocket setup service + manifest ([#79](https://github.com/teispace/npm-packages/issues/79)) ([7e2dc3f](https://github.com/teispace/npm-packages/commit/7e2dc3f72616309da18b6d815a60a7e727d571f8))
+* **next-maker:** add ws prompt + detection (data flow only) ([#78](https://github.com/teispace/npm-packages/issues/78)) ([f79c4d1](https://github.com/teispace/npm-packages/commit/f79c4d1002995ac0b3f55c1d1f4e96ee3788a6c2))
+* **next-maker:** cleanup WebSocket layer when opted out at init ([#80](https://github.com/teispace/npm-packages/issues/80)) ([4d3d421](https://github.com/teispace/npm-packages/commit/4d3d421a5056097f7fdefa88f2340f3523faa850))
+
+
+### Bug Fixes
+
+* **next-maker:** strip intl from seo.ts and sitemap.ts when i18n is off ([#75](https://github.com/teispace/npm-packages/issues/75)) ([a99d566](https://github.com/teispace/npm-packages/commit/a99d566ee634f551679525fff129bf62fcf0f578))
+* **next-maker:** sync http-client with universal/server entry split + bundle sentinel ([#77](https://github.com/teispace/npm-packages/issues/77)) ([cebc885](https://github.com/teispace/npm-packages/commit/cebc88569bbe3b65ccba9e40ea64fe8d262af908))
+
+
+### Documentation
+
+* **next-maker:** document ws feature + http universal/server entry split ([#81](https://github.com/teispace/npm-packages/issues/81)) ([e804700](https://github.com/teispace/npm-packages/commit/e80470001ec8ca03df2182e306340de4de0d6fbd))
+
+## [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

@@ -76,7 +76,7 @@ npx @teispace/next-maker init my-app -y --package-manager pnpm
 | HTTP client | `fetch` |
 | dark mode, redux, i18n, tests, react-compiler | ✅ on |
 | pre-commit hooks, commitizen, copy `.env` | ✅ on |
-| docker, GitHub Actions, bundle-analyzer, community files (CODE_OF_CONDUCT etc.) | ⏭ off |
+| WebSocket (requires Redux), docker, GitHub Actions, bundle-analyzer, community files (CODE_OF_CONDUCT etc.) | ⏭ off |
 
 Anything you don't want? `next-maker remove <feature>` after init.
 
@@ -87,7 +87,7 @@ The starter at [`teispace/nextjs-starter`](https://github.com/teispace/nextjs-st
 | Section | Prompts |
 | --- | --- |
 | Identity | project name, description, author, version, support email, package manager, GitHub repo / issues / homepage |
-| Architecture | HTTP client (axios / fetch / both / none), dark mode, Redux Toolkit, i18n, testing, React Compiler, Bundle Analyzer |
+| Architecture | HTTP client (axios / fetch / both / none), dark mode, Redux Toolkit, WebSocket (requires Redux), i18n, testing, React Compiler, Bundle Analyzer |
 | Tooling | community files (CODE_OF_CONDUCT, CONTRIBUTING, SECURITY), README, Docker, CI/CD, pre-commit hooks (Husky/Commitlint/Lint-staged), Commitizen, copy `.env.example` → `.env` |
 | Templates | keep GitHub issue/PR templates? include `react-secure-storage`? |
 
@@ -100,7 +100,8 @@ 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: two entry points (`@/lib/utils/http` universal, `@/lib/utils/http/server` for Server Components), automatic `X-Request-Id` correlation, single `parseApiError` pipeline, cookie-mode auth by default, typed query params via `{ params }`. A build-time `__bundle-sentinel__` rejects future regressions of the universal/server split.
+- WebSocket transport — **opt-in via the `ws` prompt** (requires Redux): typed `socket.io-client` wrapper, lazy singleton, `useWsEvent` / `useWsEmit` / `useWsStatus` hooks, Redux bridge into a dedicated (non-persisted) `wsReducer`. Cookie-mode auth by default; browser-only (SSR throws).
 - Hardened security headers in `next.config.ts`
 - `scripts/sync-env.ts` and `scripts/check-deprecated.ts` (used by the `validate` chain)
 
@@ -119,6 +120,7 @@ npx @teispace/next-maker setup [options]
 | `--http-client` | Adds the axios and/or fetch Result-based clients under `src/lib/utils/http/` |
 | `--dark-theme` | Installs `@teispace/next-themes` and adds `CustomThemeProvider` |
 | `--redux` | Redux Toolkit + `react-redux` + `redux-persist`, `StoreProvider`, `src/store` |
+| `--ws` | WebSocket transport — `socket.io-client@^4.8.3`, `src/lib/utils/ws/` subtree, non-persisted `wsReducer`, `attachWsBridge` mount in `StoreProvider`. Requires `--redux` to be installed first. |
 | `--i18n` | `next-intl` + `[locale]` routing + `proxy.ts` + `RootProvider` wiring |
 | `--tests` | Vitest + React Testing Library + jsdom + `test/test-utils.tsx` |
 | `--react-compiler` | `reactCompiler: true` in `next.config.ts` + `babel-plugin-react-compiler` |
@@ -135,6 +137,7 @@ npx @teispace/next-maker setup
 
 # Specific feature
 npx @teispace/next-maker setup --redux
+npx @teispace/next-maker setup --ws            # adds WebSocket layer (run after --redux)
 npx @teispace/next-maker setup --security-headers
 npx @teispace/next-maker setup --validate-scripts
 ```
@@ -393,6 +396,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
@@ -745,21 +750,34 @@ my-project/
 │   │   ├── CustomThemeProvider.tsx    # (opt, dark-mode) @teispace/next-themes
 │   │   └── index.ts                   # Barrel — `next-maker provider <name>` keeps it sorted
 │   ├── store/                         # (opt, redux) makeStore, rootReducer, typed hooks
+│   │   └── slices/ws.slice.ts         # (opt, ws) non-persisted connection state slice
 │   ├── services/
 │   │   ├── 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 guards, 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`
+│   │       │   ├── __bundle-sentinel__/  # build-time regression gate ('use client' check)
 │   │       │   ├── client-utils.ts
-│   │       │   └── token-store.ts
+│   │       │   ├── token-store.ts    # inert in cookie-mode (the default)
+│   │       │   ├── index.ts          # universal entry — safe in client/server/edge
+│   │       │   └── server.ts         # server-only entry — forwards next/headers cookies
+│   │       ├── ws/                    # (opt, ws) socket.io-client wrapper, hooks, Redux bridge
+│   │       │   ├── client/            # WsClient + lazy `wsClient` singleton (Proxy)
+│   │       │   ├── hooks/             # useWsStatus, useWsEvent, useWsEmit
+│   │       │   ├── redux/             # bridge (the only WS dispatcher) + selectors
+│   │       │   ├── shared/            # SSR guard, auth carrier, URL composer
+│   │       │   ├── types/             # ClientToServerEvents/ServerToClientEvents, payloads
+│   │       │   ├── constants.ts       # namespace, heartbeat, reconnection bounds
+│   │       │   └── index.ts           # public barrel
 │   │       └── validations/
 │   ├── i18n/                          # (opt, i18n) routing, request, navigation, translations/
 │   ├── styles/globals.css             # Tailwind v4 directives
@@ -788,7 +806,7 @@ my-project/
 └── package.json
 ```
 
-Features that have first-class opt-out prompts during `init`: `httpClient`, `darkMode`, `redux`, `i18n`, `tests`, `reactCompiler`, `bundleAnalyzer`, `docker`, `ci`, `preCommitHooks`, `commitizen`, `communityFiles`, `readme`, `copyEnv`. Each opt-out has a matching `setup --<feature>` to re-add later. `doctor` and `remove` cover the whole installed footprint via manifests.
+Features that have first-class opt-in/opt-out prompts during `init`: `httpClient`, `darkMode`, `redux`, `ws` (opt-in, requires `redux`), `i18n`, `tests`, `reactCompiler`, `bundleAnalyzer`, `docker`, `ci`, `preCommitHooks`, `commitizen`, `communityFiles`, `readme`, `copyEnv`. Each opt-out has a matching `setup --<feature>` to re-add later. `doctor` and `remove` cover the whole installed footprint via manifests.
 
 ---
 
@@ -796,7 +814,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), `socket.io-client` (opt-in via `ws` prompt), Vitest + RTL, React Compiler.
 
 ---
 
@@ -846,6 +864,7 @@ node ../dist/index.js test src/hooks/useDebounce.ts --force
 
 # Maintenance
 node ../dist/index.js doctor
+node ../dist/index.js setup --ws            # add WebSocket layer (project must already have --redux)
 node ../dist/index.js remove redux --dry-run
 ```