CookieModule

Module for cookie parsing and setting. The module is provided with the @tramvai/module-common.

Installation

Module is already provided with the @tramvai/module-common so no additional actions are needed if you are already use common module. Otherwise install @tramvai/module-cookie manually.

Explanation

Implements interface CookieManager and adds provider COOKIE_MANAGER_TOKEN from the @tramvai/module-common

Features

• Isomorphic code that works on server and client
• Uses deduplication for the same cookie entries on server
• Uses secure parameter by default

How to

Working with cookies

import { Module, provide } from '@tramvai/core';
import { COOKIE_MANAGER_TOKEN } from '@tramvai/module-common';

@Module({
  providers: [
    provide({
      provide: 'my_module',
      useFactory: ({ cookie }) => {
        cookie.set('sid', 'ads.api3');
        cookie.get('sid'); // > ads.api3
      },
      deps: {
        cookie: COOKIE_MANAGER_TOKEN,
      },
    }),
  ],
})
class MyModule {}

Set multiple cookies with the same key

By default, cookies with the same key are deduplicated on the server-side. To set multiple cookies with the same key, you can use a unique identifier for each cookie with the ResponseManager.setCookie method:

import { Module, provide } from '@tramvai/core';
import { RESPONSE_MANAGER_TOKEN } from '@tramvai/module-common';

@Module({
  providers: [
    provide({
      provide: 'my_module',
      useFactory: ({ responseManager }) => {
        responseManager.setCookie('b', `b=b; Path=/; SameSite=Strict`);
        // different identifier 'b-subpath' to avoid deduplication, will not affect the cookie name
        responseManager.setCookie('b-subpath', `b=b; Path=/foo/bar/; SameSite=Strict`);
      },
      deps: {
        responseManager: RESPONSE_MANAGER_TOKEN,
      },
    }),
  ],
})
class MyModule {}

Exported tokens

COOKIE_MANAGER_TOKEN

Instance of cookie manager

interface CookieSetOptions {
  name: string;
  value: string;
  expires?: number | Date | string;
  domain?: string;
  path?: string;
  secure?: boolean;
  httpOnly?: boolean;
  sameSite?: boolean | 'lax' | 'strict' | 'none';
}

interface CookieManager {
  get(name: any): string;
  all(): Record<string, string>;
  set({ name, value, ...options }: CookieSetOptions): void;
  remove(name: string): void;
}