Molecule.dev

← All @molecule/* packages · App templates

@molecule/api-middleware-cookie-parser-express

Provider bond · middleware · API (Node) · v1.0.1 · Apache-2.0

Express cookie parser provider

npm install @molecule/api-middleware-cookie-parser-express

npm · Source on GitHub · Implements @molecule/api-middleware-cookie-parser

How it works

@molecule/api-middleware-cookie-parser-express is a provider bond on the API (Node) side: it implements the middleware core interface (@molecule/api-middleware-cookie-parser) with a concrete vendor or library behind it.

Your code calls the core; you wire this provider once at startup. Swapping vendors later is one line in that wiring, not a rewrite.

import { setCookieParser, setCookieParserFactory } from '@molecule/api-middleware-cookie-parser'
import { provider, cookieParserFactory } from '@molecule/api-middleware-cookie-parser-express'

setCookieParser(provider)
setCookieParserFactory(cookieParserFactory)

Works with: @molecule/api-middleware-cookie-parser

Reference

Auto-generated, AI-first package reference for the molecule.dev ecosystem. It is written to be read by coding agents as much as by people, and is generated from this package's source — edit src/index.ts JSDoc, not this file.

Express cookie parser provider for molecule.dev.

Quick Start

import { setCookieParser, setCookieParserFactory } from '@molecule/api-middleware-cookie-parser'
import { provider, cookieParserFactory } from '@molecule/api-middleware-cookie-parser-express'

setCookieParser(provider)
setCookieParserFactory(cookieParserFactory)

Type

provider

Installation

npm install @molecule/api-middleware-cookie-parser-express @molecule/api-middleware-cookie-parser cookie-parser
npm install -D @types/cookie-parser

API

Functions

cookieParserFactory(secret, options)

Factory for creating cookie parser middleware with a signing secret and custom options.

function cookieParserFactory(secret?: string | string[], options?: CookieParseOptions): Middleware
  • secret — A string or array of strings used to sign/unsign cookies. If provided, signed cookies are available on req.signedCookies.
  • options — Options passed to the cookie-parser package (e.g. decode function).

Returns: A Middleware that parses cookies with the specified secret and options.

Constants

provider

The Express cookie parser provider.

Parses Cookie header and populates req.cookies with an object keyed by the cookie names.

const provider: Middleware

Core Interface

Implements @molecule/api-middleware-cookie-parser interface.

Bond Wiring

Setup function to register this provider with the core interface:

import { setCookieParserFactory } from '@molecule/api-middleware-cookie-parser'
import { cookieParserFactory } from '@molecule/api-middleware-cookie-parser-express'

export function setupMiddlewareCookieParserExpress(): void {
  setCookieParserFactory(cookieParserFactory)
}

Injection Notes

Requirements

Peer dependencies:

  • @molecule/api-middleware-cookie-parser ^1.0.1

Runtime Dependencies

  • @molecule/api-middleware-cookie-parser

  • cookie-parser

  • Wire BOTH setters (as in the example) — wiring only the factory leaves the core cookieParser middleware throwing "not configured".

  • The default provider parses UNSIGNED cookies into req.cookies only. For signed cookies, register cookieParserFactory and create the middleware with a secret — verified values then land on req.signedCookies (tampered ones become false), while unsigned cookies remain on req.cookies.