feat(auth)!: Migrate auth-related functionalities from @spuxx/nest-utils to new package @spuxx/nest-auth

.release-please/config.json

@@ -2,6 +2,7 @@
   "packages": {
     "packages/js-utils": {},
     "packages/browser-utils": {},
+    "packages/nest-auth": {},
     "packages/nest-utils": {},
     "packages/nest-testing": {},
     "packages/solid": {}

README.md

@@ -22,12 +22,14 @@
 
 ## <a name='Description'></a>Description
 
-A monorepo containing various libraries for JavaScript, TypeScript, Nest.js and Solid.js applications. Find out more about each package here:
+A monorepo containing various libraries for JavaScript, TypeScript, NestJS and SolidJS applications. Find out more about each package here:
 
 - [@spuxx/js-utils](https://github.com/spuxx-dev/jslibs/tree/main/packages/js-utils)
 - [@spuxx/browser-utils](https://github.com/spuxx-dev/jslibs/tree/main/packages/browser-utils)
 - [@spuxx/nest-utils](https://github.com/spuxx-dev/jslibs/tree/main/packages/nest-utils)
+- [@spuxx/nest-auth](https://github.com/spuxx-dev/jslibs/tree/main/packages/nest-auth)
 - [@spuxx/nest-testing](https://github.com/spuxx-dev/jslibs/tree/main/packages/nest-testing)
+- [@spuxx/solid](https://github.com/spuxx-dev/jslibs/tree/main/packages/solid)
 
 ## <a name='Documentation'></a>Documentation
 

apps/nest/package.json

@@ -13,12 +13,13 @@
     "test:vitest": "vitest run --coverage"
   },
   "dependencies": {
-    "@nanogiants/nestjs-swagger-api-exception-decorator": "1.7.0",
+    "@nanogiants/nestjs-swagger-api-exception-decorator": "1.7.2",
     "@nestjs/common": "11.0.11",
     "@nestjs/core": "11.0.11",
     "@nestjs/platform-express": "11.0.11",
     "@nestjs/swagger": "11.0.6",
     "@spuxx/js-utils": "workspace:@spuxx/js-utils@*",
+    "@spuxx/nest-auth": "workspace:@spuxx/nest-auth@*",
     "@spuxx/nest-utils": "workspace:@spuxx/nest-utils@*",
     "class-transformer": "0.5.1",
     "class-validator": "0.14.1",

apps/nest/src/app.controller.test.ts

@@ -1,7 +1,7 @@
 import { beforeEach, describe, expect, it } from 'vitest';
 import { AppController } from './app.controller';
 import { TestContainer, Supertest } from '@spuxx/nest-testing';
-import { AuthModule } from '@spuxx/nest-utils';
+import { AuthModule } from '@spuxx/nest-auth';
 import { authConfig, AuthRole } from './auth/auth.config';
 
 describe('AppController', () => {

apps/nest/src/app.controller.ts

@@ -9,15 +9,10 @@ import {
 } from '@nestjs/common';
 import { EnvModule } from './env/env.module';
 import type { Request } from 'express';
-import {
-  AuthGuard,
-  getSession,
-  HttpLoggingInterceptor,
-  isAuthenticated,
-  Roles,
-} from '@spuxx/nest-utils';
+import { HttpLoggingInterceptor } from '@spuxx/nest-utils';
 import { AuthRole } from './auth/auth.config';
 import { ApiException } from '@nanogiants/nestjs-swagger-api-exception-decorator';
+import { AuthGuard, getSession, isAuthenticated, Roles } from '@spuxx/nest-auth';
 
 @Controller()
 @UseInterceptors(HttpLoggingInterceptor)

apps/nest/src/app.module.ts

@@ -1,9 +1,10 @@
 import { Module } from '@nestjs/common';
 import { AppController } from './app.controller';
-import { AuthModule, MappingModule } from '@spuxx/nest-utils';
+import { MappingModule } from '@spuxx/nest-utils';
 import { EnvModule } from './env/env.module';
 import { authConfig } from './auth/auth.config';
 import { CatsModule } from './cats/cats.module';
+import { AuthModule } from '@spuxx/nest-auth';
 
 @Module({
   imports: [EnvModule.register(), AuthModule.forRoot(authConfig), MappingModule, CatsModule],

apps/nest/src/auth/auth.config.ts

@@ -1,4 +1,4 @@
-import { AuthOptions } from '@spuxx/nest-utils';
+import { AuthOptions } from '@spuxx/nest-auth';
 import { EnvModule } from '../env/env.module';
 
 export const AuthRole = {

apps/nest/src/main.ts

@@ -1,11 +1,12 @@
 import { Logger } from '@nestjs/common';
 import { NestFactory } from '@nestjs/core';
 import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
-import { CustomLogger, AuthModule } from '@spuxx/nest-utils';
+import { CustomLogger } from '@spuxx/nest-utils';
 import { auth } from 'express-openid-connect';
 import { AppModule } from './app.module';
 import { authConfig } from './auth/auth.config';
 import { EnvModule } from './env/env.module';
+import { AuthModule } from '@spuxx/nest-auth';
 
 async function bootstrap() {
   const logger = new CustomLogger({

packages/nest-auth/.npmignore

@@ -0,0 +1,5 @@
+/*
+!/dist
+!package.json
+!LICENSE.md
+!README.md

packages/nest-auth/CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

packages/nest-auth/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2024] [spuxx]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/nest-auth/README.md

@@ -0,0 +1,26 @@
+# @spuxx/nest-auth
+
+![Main pipeline](https://github.com/spuxx-dev/jslibs/actions/workflows/main.yml/badge.svg)
+![Release pipeline](https://github.com/spuxx-dev/jslibs/actions/workflows/release_nest_auth.yml/badge.svg)
+![npm version](https://img.shields.io/npm/v/%40spuxx%2Fnest-auth)
+![npm bundle size](https://img.shields.io/bundlephobia/min/%40spuxx%2Fnest-auth)
+![License](https://img.shields.io/github/license/spuxx-dev/jslibs)
+
+<!-- vscode-markdown-toc -->
+
+- [Description](#Description)
+- [Links](#Links)
+
+<!-- vscode-markdown-toc-config
+	numbering=false
+	autoSave=true
+	/vscode-markdown-toc-config -->
+<!-- /vscode-markdown-toc -->
+
+## <a name='Description'></a>Description
+
+`@spuxx/nest-auth` contains a selection of auth-related utilities that I keep reusing in my NestJS applications.
+
+## <a name='Links'></a>Links
+
+- [Source](https://github.com/spuxx-dev/jslibs)

packages/nest-auth/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@spuxx/nest-auth",
+  "version": "0.0.0",
+  "description": "A package containing auth-related functionalities for my NestJS applications.",
+  "license": "MIT",
+  "author": {
+    "name": "spuxx",
+    "email": "hi@spuxx.dev",
+    "url": "https://spuxx.dev"
+  },
+  "keywords": [
+    "spuxx"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/spuxx-dev/jslibs"
+  },
+  "homepage": "https://github.com/spuxx-dev/jslibs/blob/main/packages/nest-auth/README.md",
+  "bugs": {
+    "url": "https://github.com/spuxx-dev/jslibs/issues"
+  },
+  "type": "module",
+  "main": "dist/main.js",
+  "module": "dist/main.js",
+  "types": "dist/main.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "import": "./dist/main.js",
+      "default": "./dist/main.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "types": "tsc --noEmit",
+    "test": "pnpm run test:vitest",
+    "test:vitest": "vitest run --coverage"
+  },
+  "peerDependencies": {
+    "@nanogiants/nestjs-swagger-api-exception-decorator": "^1.7.2",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/swagger": "^11.0.0",
+    "@spuxx/js-utils": "^1.3.0",
+    "class-transformer": "^0.5.0",
+    "class-validator": "^0.14.0",
+    "express-openid-connect": "^2.17.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "16.0.0",
+    "@spuxx/js-utils": "1.3.0",
+    "@spuxx/nest-testing": "workspace:@spuxx/nest-testing@*",
+    "@types/express": "5.0.0",
+    "@vitest/coverage-v8": "3.0.5",
+    "typescript": "5.7.3",
+    "unplugin-swc": "1.5.1",
+    "vite": "6.1.0",
+    "vite-plugin-dts": "4.5.0",
+    "vite-tsconfig-paths": "5.1.4",
+    "vitest": "3.0.7"
+  }
+}

packages/nest-auth/src/main.ts

@@ -0,0 +1,6 @@
+// +++ IMPORTANT ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+// Make sure to re-export all components, functions and services from this file.
+// Otherwise, they will not be included into the bundle.
+// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+export * from './auth';
+export * from './constants';

packages/nest-auth/tests/vitest.setup.ts

@@ -0,0 +1,6 @@
+import { vi, afterEach } from 'vitest';
+
+afterEach(() => {
+  vi.unstubAllEnvs();
+  vi.unstubAllGlobals();
+});

packages/nest-auth/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "include": ["./src"],
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "skipLibCheck": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "declaration": true,
+    "allowSyntheticDefaultImports": true,
+    "baseUrl": "."
+  }
+}

packages/nest-auth/vite.config.ts

@@ -0,0 +1,69 @@
+/// <reference types="vitest" />
+import { defineConfig } from 'vite';
+import { resolve } from 'path';
+import { peerDependencies } from './package.json';
+import dts from 'vite-plugin-dts';
+import tsconfigPaths from 'vite-tsconfig-paths';
+
+import swc from 'unplugin-swc';
+
+export default defineConfig({
+  plugins: [
+    dts({
+      include: ['src/**/*'],
+      exclude: ['*.{test,spec}.*'],
+      tsconfigPath: './tsconfig.json',
+      rollupTypes: true,
+    }),
+    tsconfigPaths(),
+    // esbuild doesn't support a couple of features that nestjs requires, so instead
+    // we use swc. For example, see: https://github.com/nestjs/nest/issues/9228
+    swc.vite({
+      module: { type: 'es6' },
+      jsc: {
+        target: 'esnext',
+        parser: {
+          syntax: 'typescript',
+          decorators: true,
+        },
+        transform: {
+          legacyDecorator: true,
+          decoratorMetadata: true,
+        },
+        keepClassNames: true,
+        preserveAllComments: true,
+      },
+    }),
+  ],
+  ssr: {
+    target: 'node',
+  },
+  build: {
+    ssr: true,
+    minify: false,
+    lib: {
+      entry: {
+        main: resolve(__dirname, 'src/main.ts'),
+      },
+      name: '@spuxx/nest-testing',
+      formats: ['es'],
+    },
+    rollupOptions: {
+      external: [...Object.keys(peerDependencies)],
+    },
+  },
+  test: {
+    environment: 'node',
+    silent: true,
+    setupFiles: './tests/vitest.setup.ts',
+    reporters: ['default', 'junit'],
+    outputFile: 'reports/junit/junit.xml',
+    coverage: {
+      provider: 'v8',
+      all: true,
+      include: ['**/*.ts'],
+      reportsDirectory: 'reports/vitest/coverage',
+      reporter: ['text', 'json'],
+    },
+  },
+});

packages/nest-utils/package.json

@@ -44,24 +44,16 @@
     "test:vitest": "vitest run --coverage"
   },
   "peerDependencies": {
-    "@nanogiants/nestjs-swagger-api-exception-decorator": "^1.6.0",
     "@nestjs/common": "^11.0.0",
-    "@nestjs/config": "^3.0.0",
     "@nestjs/core": "^11.0.0",
     "@nestjs/swagger": "^11.0.0",
     "@spuxx/js-utils": "^1.3.0",
     "class-transformer": "^0.5.0",
     "class-validator": "^0.14.0",
     "dotenv": "^16.0.0",
-    "express-openid-connect": "^2.17.0",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.0"
   },
-  "peerDependenciesMeta": {
-    "express-openid-connect": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@rollup/plugin-node-resolve": "16.0.0",
     "@spuxx/js-utils": "1.3.0",

packages/nest-utils/src/main.ts

@@ -3,9 +3,7 @@
 // Otherwise, they will not be included into the bundle.
 // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 export * from './env';
-export * from './auth';
 export * from './logging';
 export * from './transformers';
 export * from './http';
 export * from './mapping';
-export * from './constants';