npmpackage.info

Gathering detailed insights and metrics for nestjs-cookie-session

Other packages similar to nestjs-cookie-session

@nest-middlewares/cookie-session

10.0.0

NestJS Middleware for Cookie Session

@nest-middleware-collection/cookie-session

9.0.0

NestJS Middleware for Cookie Session

@next-nest-auth/nextauth

0.0.9

NextAuth is a frontend authentication package designed for Next.js applications, providing easy integration with NestJS-based backends. It supports login, session management, and token handling (including JWT and refresh tokens) to ensure secure user auth

Gathering detailed insights and metrics for nestjs-cookie-session

nestjs-cookie-session - 4.0.0 | npmpackage.info

nestjs-cookie-session

Idiomatic Cookie Session Module for NestJS. Built on top of `cookie-session` 😻

4.0.0

MIT

JavaScript

9.74 kB

4.1

Installations

npm install nestjs-cookie-session

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Min. Node Version

>=18

Node Version

22.13.0

NPM Version

10.9.2 Pull Requests

Open

9

Total

1,450

Closed

538

Merged

903

Issues

Open

0

Total

4

Closed

4

Releases

4.0.0: nestjs@11 support

4.0.0

Updated on Jan 23, 2025

3.0.1: fix nest@8 compatibility of useFactory return type

3.0.1

Updated on Aug 17, 2023

3.0.0: drop support of nestjs<8 and node<16, update ci, deps, readme

3.0.0

Updated on Aug 16, 2023

2.0.1: add License and strict engine check

2.0.1

Updated on Aug 30, 2021

2.0.0: nestjs6+ support

2.0.0

Updated on Aug 30, 2021

View All 5 releases

Languages

JavaScript

TypeScript

JavaScript (58.12%)

TypeScript (41.88%)

Developer

iamolegga

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

54 Stars

1,411 Commits

3 Forks

2 Watchers

15 Branches

4 Contributors

Updated on Jul 01, 2025

Maintainers

View All 4 Contributors

Package Meta Information

Latest Version

4.0.0

Package Id

nestjs-cookie-session@4.0.0

Unpacked Size

9.74 kB

Size

3.74 kB

File Count

NPM Version

10.9.2

Node Version

22.13.0

Published on

Jan 23, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

nestjs-cookie-session

Dependabot

Idiomatic Cookie Session Module for NestJS. Built on top of cookie-session 😎

This module implements a session with storing data directly in Cookie.

If you want to store data in one of external stores and passing ID of session to client via Cookie/Set-Cookie headers, you can look at nestjs-session.

Example

1// app.module.ts
2import { Module } from '@nestjs/common';
3import {
4  NestCookieSessionOptions,
5  CookieSessionModule,
6} from 'nestjs-cookie-session';
7import { ViewsController } from './views.controller';
8
9@Module({
10  imports: [
11    // sync params:
12
13    CookieSessionModule.forRoot({
14      session: { secret: 'keyboard cat' },
15    }),
16
17    // or async:
18
19    CookieSessionModule.forRootAsync({
20      imports: [ConfigModule],
21      inject: [Config],
22      //              TIP: to get autocomplete in return object
23      //                  add `NestCookieSessionOptions` here ↓↓↓
24      useFactory: async (config: Config): Promise<NestCookieSessionOptions> => {
25        return {
26          session: { secret: config.secret },
27        };
28      },
29    }),
30  ],
31  controllers: [ViewsController],
32})
33export class AppModule {}

Use in controllers with NestJS built-in Session decorator:

1// views.controller.ts
2import { Controller, Get, Session } from '@nestjs/common';
3
4@Controller('views')
5export class ViewsController {
6  @Get()
7  getViews(@Session() session: { views?: number }) {
8    session.views = (session.views || 0) + 1;
9    return session.views;
10  }
11}

To run examples:

1git clone https://github.com/iamolegga/nestjs-cookie-session.git
2cd nestjs-cookie-session
3npm i
4npm run build
5cd example
6npm i
7npm start

Install

1npm i nestjs-cookie-session cookie-session @types/cookie-session

API

CookieSessionModule

CookieSessionModule class has two static methods, that returns DynamicModule, that you need to import:

CookieSessionModule.forRoot for sync configuration without dependencies
CookieSessionModule.forRootAsync for sync/async configuration with dependencies

CookieSessionModule.forRoot

Accept NestCookieSessionOptions. Returns NestJS DynamicModule for import.

CookieSessionModule.forRootAsync

Accept NestCookieSessionAsyncOptions. Returns NestJS DynamicModule for import.

NestCookieSessionOptions

NestCookieSessionOptions is the interface of all options, has next properties:

session - required - cookie-session options.
forRoutes - optional - same as NestJS built-in MiddlewareConfigProxy['forRoutes'] See examples in official docs. Specify routes, that should have access to session. If forRoutes and exclude will not be set, then sessions will be set to all routes.
exclude - optional - same as NestJS built-in MiddlewareConfigProxy['exclude'] See examples in official docs. Specify routes, that should not have access to session. If forRoutes and exclude will not be set, then sessions will be set to all routes.

NestCookieSessionAsyncOptions

NestCookieSessionOptions is the interface of options to create cookie session module, that depends on other modules, has next properties:

imports - optional - modules, that cookie session module depends on. See official docs.
inject - optional - providers from imports-property modules, that will be passed as arguments to useFactory method.
useFactory - required - method, that returns NestCookieSessionOptions.

Migration

v2

cookie-session and @types/cookie-session are moved to peer dependencies, so you can update them independently.

Do you use this library?
Don't be shy to give it a star! ★

Also if you are into NestJS you might be interested in one of my other NestJS libs.

No vulnerabilities found.

10

Maintained

Determines if the project is "actively maintained".

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

4

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 4

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-lint-test.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/build-lint-test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-lint-test.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/build-lint-test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build-lint-test.yml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/build-lint-test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-alpha.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/publish-alpha.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-alpha.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/publish-alpha.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-coverage.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/publish-coverage.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-coverage.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/publish-coverage.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish-coverage.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/publish-coverage.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-with-git-tag-version.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/publish-with-git-tag-version.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-with-git-tag-version.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/publish-with-git-tag-version.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish-with-git-tag-version.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/iamolegga/nestjs-cookie-session/publish-with-git-tag-version.yml/master?enable=pin
Warn: npmCommand not pinned by hash: .github/workflows/build-lint-test.yml:41
Info: 0 out of 9 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 2 third-party GitHubAction dependencies pinned
Info: 3 out of 4 npmCommand dependencies pinned

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

4.1

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to nestjs-cookie-session

Other packages similar to nestjs-cookie-session

nestjs-cookie-session

Installations

Developer Guide

No

CommonJS

>=18

22.13.0

10.9.2

Pull Requests

9

1,450

538

903

Issues

0

4

4

Releases

Languages

Developer

iamolegga

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

nestjs-cookie-session

Example

Install

API

CookieSessionModule

CookieSessionModule.forRoot

CookieSessionModule.forRootAsync

NestCookieSessionOptions

NestCookieSessionAsyncOptions

Migration

v2

Do you use this library?Don't be shy to give it a star! ★

Also if you are into NestJS you might be interested in one of my other NestJS libs.

10

10

10

10

4

0

0

0

0

0

0

0

4.1

/10

Do you use this library?
Don't be shy to give it a star! ★