Class Cookie

packages/cookie/src/lib/cookie.ts:50–244

 * secret rotation to easily rotate secrets without breaking existing cookies.
 */
export class Cookie implements CookieProperties {
  #name: string
  #decode: Coder
  #encode: Coder
  #secrets: string[]
  #domain: string | undefined
  #expires: Date | undefined
  #httpOnly: boolean | undefined
  #maxAge: number | undefined
  #partitioned: boolean | undefined
  #path: string
  #sameSite: SameSiteValue
  #secure: boolean | undefined

  /**
   * @param name The name of the cookie
   * @param options Options for the cookie
   */
  constructor(name: string, options?: CookieOptions) {
    let {
      decode = decodeURIComponent,
      encode = encodeURIComponent,
      secrets = [],
      domain,
      expires,
      httpOnly,
      maxAge,
      path = '/',
      partitioned,
      secure,
      sameSite = 'Lax',
    } = options ?? {}

    if (partitioned === true) {
      // Partitioned cookies must be set with Secure
      // See https://developer.mozilla.org/en-US/docs/Web/Privacy/Guides/Privacy_sandbox/Partitioned_cookies
      secure = true
    }

    this.#name = name
    this.#decode = decode
    this.#encode = encode
    this.#secrets = secrets
    this.#domain = domain
    this.#expires = expires
    this.#httpOnly = httpOnly
    this.#maxAge = maxAge
    this.#partitioned = partitioned
    this.#path = path
    this.#sameSite = sameSite
    this.#secure = secure
  }

  /**
   * The domain of the cookie.
   *
   * [MDN Reference](https://developer.mozilla.org/en-US/Web/HTTP/Headers/Set-Cookie#domaindomain-value)
   */