👷 Switch to pnpm package manager in starter templates

Author: mashabek

starter/_base/.dockerignore

@@ -4,7 +4,7 @@
 .gitlab
 .gitlab-ci.yml
 .huskyrc.json
-.npm
+.pnpm-store
 Dockerfile
 LICENSE
 README.md

starter/_base/.gitignore

@@ -2,4 +2,6 @@ node_modules
 dist
 tsconfig.tsbuildinfo
 junit.xml
-coverage
+coverage
+.pnpm-store
+pnpm-debug.log*

starter/_base/Dockerfile

@@ -1,6 +1,5 @@
 # BUILDER IMAGE
 FROM node:24.5.0 AS builder
-ARG NPM_TOKEN
 ENV NODE_PATH=.
 ENV JOBS="max"
 WORKDIR /usr/src/app
@@ -14,19 +13,19 @@ ENV TINI_VERSION v0.19.0
 RUN wget -q https://github.com/krallin/tini/releases/download/${TINI_VERSION}/tini -O /tini && \
   chmod +x /tini
 
-# important, otherwise postinstall hook fails
-RUN npm set progress=false
-RUN npm set loglevel=error
+ENV PNPM_VERSION=10.33.0
+RUN curl -fsSL "https://github.com/pnpm/pnpm/releases/download/v${PNPM_VERSION}/pnpm-linux-x64" \
+    -o /usr/local/bin/pnpm && chmod +x /usr/local/bin/pnpm
 # copy all relevant files
 COPY . .
-# RUN echo "//registry.npmjs.org//:_authToken=$NPM_TOKEN" >> .npmrc
 # install dependencies
-RUN npm ci
+RUN pnpm install --frozen-lockfile
 # compile typescript
-RUN npm run build
+RUN pnpm run build
 
 # MAIN IMAGE
 FROM node:24.5.0-slim
+COPY --from=builder /usr/local/bin/pnpm /usr/local/bin/pnpm
 
 ENV NODE_PATH=dist
 ENV CFG_JSON_PATH="/config/secrets.json"

starter/_base/README.md

@@ -17,8 +17,8 @@ Application configuration is handled by [Configuru](https://github.com/AckeeCZ/c
 The whole codebase is checked and improved using lint and prettier, run `lint:fix` and `prettier:fix` before committing changes to git.
 
 ```bash
-npm run lint:fix
-npm run prettier:fix
+pnpm lint:fix
+pnpm prettier:fix
 ```
 
 ## ✅ Tests
@@ -35,19 +35,19 @@ If you need any prerequisites during tests, use the [setup.ts](src/test/setup.ts
 To run tests use the test command:
 
 ```bash
-npm run test
+pnpm test
 ```
 
 ## 🚀 Quick start
 
 1. Build the code
 
 ```bash
-npm run build
+pnpm build
 ```
 
 2. Start the entrypoint / server
 
 ```bash
-npm run start
+pnpm start
 ```

starter/_base/package.json

@@ -6,12 +6,12 @@
     "test": "mocha",
     "build": "tsc",
     "start": "node -r source-map-support/register dist/index.js",
-    "ci-test:no-coverage": "npm run test -- --parallel=false -R mocha-multi-reporters --reporter-options configFile=.mocha-junit-config.json",
-    "ci-test": "nyc -a -r cobertura --report-dir output npm run ci-test:no-coverage",
+    "ci-test:no-coverage": "pnpm test --parallel=false -R mocha-multi-reporters --reporter-options configFile=.mocha-junit-config.json",
+    "ci-test": "nyc -a -r cobertura --report-dir output pnpm run ci-test:no-coverage",
     "prettier": "prettier --check --write '**/*.{ts,js,json,jsonc,md}'",
     "lint": "eslint '**/*.ts' -f codeframe --fix",
-    "codestyle": "npm run lint && npm run prettier",
-    "ci-lint": "npm run lint -- -f checkstyle -o ./output/checkstyle-result.xml",
+    "codestyle": "pnpm lint && pnpm prettier",
+    "ci-lint": "pnpm lint -f checkstyle -o ./output/checkstyle-result.xml",
     "cli": "tsx ./src/view/cli/cli.ts"
   },
   "keywords": [],
@@ -42,5 +42,11 @@
     "typescript": "^5.0.0",
     "yargs": "^18.0.0"
   },
-  "type": "module"
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm"
+    }
+  },
+  "type": "module",
+  "packageManager": "pnpm@10.33.0"
 }

starter/api/graphql/package.json

@@ -3,9 +3,9 @@
   "version": "1.0.0",
   "main": "index.js",
   "scripts": {
-    "generate:api": "graphql-codegen --config codegen.yml && npm run codestyle",
+    "generate:api": "graphql-codegen --config codegen.yml && pnpm run codestyle",
     "build:copy-schema": "mkdir -p ./dist/view/graphql/schema && cp -r ./src/view/graphql/schema ./dist/view/graphql/schema",
-    "build": "npm run build:copy-schema && tsc"
+    "build": "pnpm run build:copy-schema && tsc"
   },
   "keywords": [],
   "author": "",
@@ -30,6 +30,7 @@
     "@graphql-eslint/eslint-plugin": "^4.4.0",
     "@types/express": "^5.0.0",
     "@types/supertest": "^6.0.0",
+    "graphql-tag": "^2.0.0",
     "supertest": "^7.0.0"
   },
   "type": "module"

starter/api/rest/package.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "main": "index.js",
   "scripts": {
-    "generate:api": "npm run cli openapi generate src/view/rest/spec/openapi.yml && npm run codestyle"
+    "generate:api": "pnpm run cli openapi generate src/view/rest/spec/openapi.yml && pnpm run codestyle"
   },
   "keywords": [],
   "author": "",

starter/api/rest/src/view/cli/openapi/generate.ts

@@ -16,8 +16,8 @@ export const run = async (argv: any): Promise<void> => {
 
   await new Promise((resolve, reject) => {
     const process = spawn(
-      'npx',
-      ['openapi-typescript', yamlFilePath, '--output', tsFilePath],
+      'pnpm',
+      ['exec', 'openapi-typescript', yamlFilePath, '--output', tsFilePath],
       { stdio: 'inherit' }
     )
     process.on('exit', resolve)

starter/pipeline/cloudrun-gitlab/.gitlab-ci.yml

@@ -48,12 +48,12 @@ include:
   - component: $CI_SERVER_FQDN/Backend/gitlab-components/audit@v1.0.0
     inputs:
       job-stage: test
-      audit-command: npm audit --production --audit-level=high
+      audit-command: pnpm audit --prod --audit-level=high
   # TEST
   - component: $CI_SERVER_FQDN/Backend/gitlab-components/test@v1.0.0
     inputs:
       job-stage: test
-      test-command: DB_CONNECTION_STRING="postgres://node-app_docker:node-app_docker@postgres:5432/postgres" npm run ci-test
+      test-command: DB_CONNECTION_STRING="postgres://node-app_docker:node-app_docker@postgres:5432/postgres" pnpm ci-test
       postgres-user: node-app_docker
       postgres-password: node-app_docker
       postgres-db: postgres