Works fine for development but having issue in build

[bisw4sh]

My main concern is i want to have swagger in my local setup/ develop branch, and also have the swagger in my staging branch but not in my main branch which will be prod.

1. I though i could disable the swagger with

//index.ts
if (process.env.NODE_ENV !== "production") {
	app.use(openAPIRouter);
}

//package.json
	"scripts": {
		"start": "node dist/index.js",
		"start:worker": "node dist/common/queues/worker.js",
		"dev": "tsx --import ./src/api-docs/zod-extend.ts --env-file .env --watch ./src/index.ts",
		"dev:worker": "tsx --import ./src/api-docs/zod-extend.ts --env-file .env --watch ./src/common/queues/worker.ts",
		"dev:all": "concurrently \"npm run dev\" \"npm run dev:worker\"",
		"build": "tsc",
		"prisma:generate": "prisma generate",
		"prisma:migrate": "prisma migrate dev",
		"studio": "prisma studio"
	}

//zod-extend.ts

import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
import { z } from "zod/v4";

extendZodWithOpenApi(z);

//openAPIRouter.ts

import express, { type Request, type Response, type Router } from "express";
import swaggerUi from "swagger-ui-express";
import { generateOpenAPIDocument } from "./generateOpenAPIDocument";

export const openAPIRouter: Router = (() => {
	const router = express.Router();
	const openAPIDocument = generateOpenAPIDocument();

	router.get("/swagger.json", (_req: Request, res: Response) => {
		res.setHeader("Content-Type", "application/json");
		res.send(openAPIDocument);
	});

	router.use(
		"/api-docs",
		swaggerUi.serve,
		swaggerUi.setup(openAPIDocument, {
			customCss: ".swagger-ui .topbar { display: none }",
			customSiteTitle: "FATC API Docs",
			swaggerOptions: {
				persistAuthorization: true,
			},
		}),
	);

	return router;
})();

//generateOpenAPIDocument.ts

import { testRegistry } from "@/api/test/test.router";
import {
	OpenAPIRegistry,
	OpenApiGeneratorV3,
} from "@asteasolutions/zod-to-openapi";

export function generateOpenAPIDocument() {
	const registry = new OpenAPIRegistry([
		testRegistry,
	]);
	const generator = new OpenApiGeneratorV3(registry.definitions);

	const openApiDocument = generator.generateDocument({
		openapi: "3.0.0",
		info: {
			version: "1.0.0",
			title: "FATC API",
		},
		externalDocs: {
			description: "List of available api end points",
			url: "/swagger.json",
		},
	});

	openApiDocument.components = {
		securitySchemes: {
			BearerAuth: {
				type: "http",
				scheme: "bearer",
				bearerFormat: "JWT",
				description:
					'JWT authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"',
			},
		},
	};

	return openApiDocument;
}

//Dockerfile

# ===== Base Stage =====
FROM node:20-alpine AS base
WORKDIR /usr/src/app
COPY package*.json ./

# ===== Development Stage =====
FROM base AS development
RUN npm install -g tsx concurrently
RUN npm install
COPY . .
CMD ["npm", "run", "dev"]

# ===== Build Stage =====
FROM base AS build
RUN npm ci
COPY . .
RUN npm run build

# ===== Production Stage =====
FROM node:20-alpine AS production
WORKDIR /usr/src/app
COPY --from=build /usr/src/app/package*.json ./
COPY --from=build /usr/src/app/dist ./dist
RUN npm install --omit=dev
CMD ["npm", "run", "start"]

docker-compose.yml

services:
  app:
    container_name: my_app
    build:
      context: .
      dockerfile: Dockerfile
      target: ${DOCKER_TARGET:-development} # Default target is dev
    command: ${DOCKER_COMMAND:-npm run dev}
    ports:
      - "3000:3000"
    env_file:
      - .env
    depends_on:
      - postgres
      - redis
    volumes:
      - .:/usr/src/app
      - /usr/src/app/node_modules
    networks:
      - app_network

  postgres:
    image: postgres:16
    container_name: postgres_db
    restart: always
    environment:
      POSTGRES_USER: ${POSTGRES_USER:-postgres}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-password}
      POSTGRES_DB: ${POSTGRES_DB:-fatc}
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - app_network

  pgadmin:
    image: dpage/pgadmin4:latest
    container_name: pgadmin
    environment:
      PGADMIN_DEFAULT_EMAIL: [email protected]
      PGADMIN_DEFAULT_PASSWORD: admin
    ports:
      - "5050:80"
    depends_on:
      - postgres
    networks:
      - app_network

  redis:
    image: redis:7
    container_name: redis_cache
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    networks:
      - app_network

  networks:
  app_network:
    driver: bridge

volumes:
  postgres_data:
  redis_data:

this has me bugging for a while, on previous version this --import ./src/api-docs/zod-extend.ts wasn't required at all.

error

bisw4sh@d14 fatc ( main) $ npm run start

> [email protected] start
> node dist/index.js

node:internal/modules/cjs/loader:1408
  throw err;
  ^

Error: Cannot find module '@/api/event/event.router'
Require stack:
- /home/bisw4sh/Desktop/fatc/dist/api-docs/generateOpenAPIDocument.js
- /home/bisw4sh/Desktop/fatc/dist/api-docs/openAPIRouter.js
- /home/bisw4sh/Desktop/fatc/dist/index.js
    at Function._resolveFilename (node:internal/modules/cjs/loader:1405:15)
    at defaultResolveImpl (node:internal/modules/cjs/loader:1061:19)
    at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1066:22)
    at Function._load (node:internal/modules/cjs/loader:1215:37)
    at TracingChannel.traceSync (node:diagnostics_channel:322:14)
    at wrapModuleLoad (node:internal/modules/cjs/loader:235:24)
    at Module.require (node:internal/modules/cjs/loader:1491:12)
    at require (node:internal/modules/helpers:135:16)
    at Object.<anonymous> (/home/bisw4sh/Desktop/fatc/dist/api-docs/generateOpenAPIDocument.js:4:24)
    at Module._compile (node:internal/modules/cjs/loader:1734:14) {
  code: 'MODULE_NOT_FOUND',
  requireStack: [
    '/home/bisw4sh/Desktop/fatc/dist/api-docs/generateOpenAPIDocument.js',
    '/home/bisw4sh/Desktop/fatc/dist/api-docs/openAPIRouter.js',
    '/home/bisw4sh/Desktop/fatc/dist/index.js'
  ]
}

Node.js v23.10.0

[Sumpy1]

+1

[bisw4sh]

instead of doing
"dev": "tsx --import ./src/api-docs/zod-extend.ts --env-file .env --watch ./src/index.ts"

import "./api-docs/zod-extend";
In index.ts, the project entry file is included.
and replaced the compiling step of tsc with tsup.