cdk-ecr-deployment 3.2.2 → 3.3.1

package/node_modules/hpagent/test/needle.test.js

@@ -1,103 +0,0 @@
-'use strict'
-
-const needle = require('needle')
-const test = require('ava')
-const {
-  createServer,
-  createSecureServer,
-  createProxy,
-  createSecureProxy
-} = require('./utils')
-const { HttpProxyAgent, HttpsProxyAgent } = require('../')
-
-test('http to http', async t => {
-  const server = await createServer()
-  const proxy = await createProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await needle('get', `http://${server.address().address}:${server.address().port}`, {
-    agent: new HttpProxyAgent({
-      keepAlive: true,
-      keepAliveMsecs: 1000,
-      maxSockets: 256,
-      maxFreeSockets: 256,
-      scheduling: 'lifo',
-      proxy: `http://${proxy.address().address}:${proxy.address().port}`
-    })
-  })
-
-  t.is(response.body.toString(), 'ok')
-  t.is(response.statusCode, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('https to http', async t => {
-  const server = await createServer()
-  const proxy = await createSecureProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await needle('get', `http://${server.address().address}:${server.address().port}`, {
-    agent: new HttpProxyAgent({
-      keepAlive: true,
-      keepAliveMsecs: 1000,
-      maxSockets: 256,
-      maxFreeSockets: 256,
-      scheduling: 'lifo',
-      proxy: `https://${proxy.address().address}:${proxy.address().port}`
-    })
-  })
-
-  t.is(response.body.toString(), 'ok')
-  t.is(response.statusCode, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('http to https', async t => {
-  const server = await createSecureServer()
-  const proxy = await createProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await needle('get', `https://${server.address().address}:${server.address().port}`, {
-    agent: new HttpsProxyAgent({
-      keepAlive: true,
-      keepAliveMsecs: 1000,
-      maxSockets: 256,
-      maxFreeSockets: 256,
-      scheduling: 'lifo',
-      proxy: `http://${proxy.address().address}:${proxy.address().port}`
-    })
-  })
-
-  t.is(response.body.toString(), 'ok')
-  t.is(response.statusCode, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('https to https', async t => {
-  const server = await createSecureServer()
-  const proxy = await createSecureProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await needle('get', `https://${server.address().address}:${server.address().port}`, {
-    agent: new HttpsProxyAgent({
-      keepAlive: true,
-      keepAliveMsecs: 1000,
-      maxSockets: 256,
-      maxFreeSockets: 256,
-      scheduling: 'lifo',
-      proxy: `https://${proxy.address().address}:${proxy.address().port}`
-    })
-  })
-
-  t.is(response.body.toString(), 'ok')
-  t.is(response.statusCode, 200)
-
-  server.close()
-  proxy.close()
-})

package/node_modules/hpagent/test/node-fetch.test.js

@@ -1,103 +0,0 @@
-'use strict'
-
-const fetch = require('node-fetch')
-const test = require('ava')
-const {
-  createServer,
-  createSecureServer,
-  createProxy,
-  createSecureProxy
-} = require('./utils')
-const { HttpProxyAgent, HttpsProxyAgent } = require('../')
-
-test('http to http', async t => {
-  const server = await createServer()
-  const proxy = await createProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await fetch(`http://${server.address().address}:${server.address().port}`, {
-    agent: new HttpProxyAgent({
-      keepAlive: true,
-      keepAliveMsecs: 1000,
-      maxSockets: 256,
-      maxFreeSockets: 256,
-      scheduling: 'lifo',
-      proxy: `http://${proxy.address().address}:${proxy.address().port}`
-    })
-  })
-
-  t.is(await response.text(), 'ok')
-  t.is(response.status, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('https to http', async t => {
-  const server = await createServer()
-  const proxy = await createSecureProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await fetch(`http://${server.address().address}:${server.address().port}`, {
-    agent: new HttpProxyAgent({
-      keepAlive: true,
-      keepAliveMsecs: 1000,
-      maxSockets: 256,
-      maxFreeSockets: 256,
-      scheduling: 'lifo',
-      proxy: `https://${proxy.address().address}:${proxy.address().port}`
-    })
-  })
-
-  t.is(await response.text(), 'ok')
-  t.is(response.status, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('http to https', async t => {
-  const server = await createSecureServer()
-  const proxy = await createProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await fetch(`https://${server.address().address}:${server.address().port}`, {
-    agent: new HttpsProxyAgent({
-      keepAlive: true,
-      keepAliveMsecs: 1000,
-      maxSockets: 256,
-      maxFreeSockets: 256,
-      scheduling: 'lifo',
-      proxy: `http://${proxy.address().address}:${proxy.address().port}`
-    })
-  })
-
-  t.is(await response.text(), 'ok')
-  t.is(response.status, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('https to https', async t => {
-  const server = await createSecureServer()
-  const proxy = await createSecureProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await fetch(`https://${server.address().address}:${server.address().port}`, {
-    agent: new HttpsProxyAgent({
-      keepAlive: true,
-      keepAliveMsecs: 1000,
-      maxSockets: 256,
-      maxFreeSockets: 256,
-      scheduling: 'lifo',
-      proxy: `https://${proxy.address().address}:${proxy.address().port}`
-    })
-  })
-
-  t.is(await response.text(), 'ok')
-  t.is(response.status, 200)
-
-  server.close()
-  proxy.close()
-})

package/node_modules/hpagent/test/simple-get.test.js

@@ -1,139 +0,0 @@
-'use strict'
-
-const sget = require('simple-get')
-const test = require('ava')
-const {
-  createServer,
-  createSecureServer,
-  createProxy,
-  createSecureProxy
-} = require('./utils')
-const { HttpProxyAgent, HttpsProxyAgent } = require('..')
-
-test('http to http', async t => {
-  const server = await createServer()
-  const proxy = await createProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await new Promise((resolve, reject) => {
-    sget.concat({
-      url: `http://${server.address().address}:${server.address().port}`,
-      agent: new HttpProxyAgent({
-        keepAlive: true,
-        keepAliveMsecs: 1000,
-        maxSockets: 256,
-        maxFreeSockets: 256,
-        scheduling: 'lifo',
-        proxy: `http://${proxy.address().address}:${proxy.address().port}`
-      })
-    }, function (err, response, data) {
-      if (err) {
-        return reject(err)
-      }
-      t.is(data.toString(), 'ok')
-
-      return resolve(response)
-    })
-  })
-
-  t.is(response.statusCode, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('https to http', async t => {
-  const server = await createServer()
-  const proxy = await createSecureProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await new Promise((resolve, reject) => {
-    sget.concat({
-      url: `http://${server.address().address}:${server.address().port}`,
-      agent: new HttpProxyAgent({
-        keepAlive: true,
-        keepAliveMsecs: 1000,
-        maxSockets: 256,
-        maxFreeSockets: 256,
-        scheduling: 'lifo',
-        proxy: `https://${proxy.address().address}:${proxy.address().port}`
-      })
-    }, function (err, response, data) {
-      if (err) {
-        return reject(err)
-      }
-      t.is(data.toString(), 'ok')
-
-      return resolve(response)
-    })
-  })
-
-  t.is(response.statusCode, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('http to https', async t => {
-  const server = await createSecureServer()
-  const proxy = await createProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await new Promise((resolve, reject) => {
-    sget.concat({
-      url: `https://${server.address().address}:${server.address().port}`,
-      agent: new HttpsProxyAgent({
-        keepAlive: true,
-        keepAliveMsecs: 1000,
-        maxSockets: 256,
-        maxFreeSockets: 256,
-        scheduling: 'lifo',
-        proxy: `http://${proxy.address().address}:${proxy.address().port}`
-      })
-    }, function (err, response, data) {
-      if (err) {
-        return reject(err)
-      }
-      t.is(data.toString(), 'ok')
-
-      return resolve(response)
-    })
-  })
-
-  t.is(response.statusCode, 200)
-
-  server.close()
-  proxy.close()
-})
-
-test('https to https', async t => {
-  const server = await createSecureServer()
-  const proxy = await createSecureProxy()
-  server.on('request', (req, res) => res.end('ok'))
-
-  const response = await new Promise((resolve, reject) => {
-    sget.concat({
-      url: `https://${server.address().address}:${server.address().port}`,
-      agent: new HttpsProxyAgent({
-        keepAlive: true,
-        keepAliveMsecs: 1000,
-        maxSockets: 256,
-        maxFreeSockets: 256,
-        scheduling: 'lifo',
-        proxy: `https://${proxy.address().address}:${proxy.address().port}`
-      })
-    }, function (err, response, data) {
-      if (err) {
-        return reject(err)
-      }
-      t.is(data.toString(), 'ok')
-
-      return resolve(response)
-    })
-  })
-
-  t.is(response.statusCode, 200)
-
-  server.close()
-  proxy.close()
-})

package/node_modules/hpagent/test/ssl.cert

@@ -1,19 +0,0 @@
------BEGIN CERTIFICATE-----
-MIIDBzCCAe+gAwIBAgIJALbQMeb7k/WqMA0GCSqGSIb3DQEBBQUAMBoxGDAWBgNV
-BAMMD3d3dy5mYXN0aWZ5Lm9yZzAeFw0xNzAyMDcyMDE5NDJaFw0yNzAyMDUyMDE5
-NDJaMBoxGDAWBgNVBAMMD3d3dy5mYXN0aWZ5Lm9yZzCCASIwDQYJKoZIhvcNAQEB
-BQADggEPADCCAQoCggEBAKtfXzDMmU+n3A7oVVOiqp6Z5cgu1t+qgj7TadwXONvO
-RZvuOcE8BZpM9tQEDE5XEIdcszDx0tWKHHSobgZAxDaEuK1PMhh/RTNvw1KzYJFm
-2G38mqgm11JUni87xmIFqpgJfeCApHnWUv+3/npuQniOoVSL13jdXEifeFM8onQn
-R73TVDyvMOjljTulMo0n9V8pYhVSzPnm2uxTu03p5+HosQE2bU0QKj7k8/8dwRVX
-EqnTtbLoW+Wf7V2W3cr/UnfPH8JSaBWTqct0pgXqYIqOSTiWQkO7pE69mGPHrRlm
-7+whp4WRriTacB3Ul+Cbx28wHU+D83ver4A8LKGVDSECAwEAAaNQME4wHQYDVR0O
-BBYEFHVzTr/tNziIUrR75UHXXA84yqmgMB8GA1UdIwQYMBaAFHVzTr/tNziIUrR7
-5UHXXA84yqmgMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEBAKVSdGeF
-vYcZOi0TG2WX7O3tSmu4G4nGxTldFiEVF89G0AU+HhNy9iwKXQLjDB7zMe/ZKbtJ
-cQgc6s8eZWxBk/OoPD1WNFGstx2EO2kRkSUBKhwnOct7CIS5X+NPXyHx2Yi03JHX
-unMA4WaHyo0dK4vAuali4OYdQqajNwL74avkRIxXFnZQeHzaq6tc6gX+ryB4dDSr
-tYn46Lo14D5jH6PtZ8DlGK+jIzM4IE7TEp2iv0CgaTU4ryt/SHPnLxfwZUpl7gSO
-EqkMAy3TlRMpv0oXM2Vh/CsyJzq2P/nY/O3bolsashSPWo9WsQTH4giYVA51ZVDK
-lGksQD+oWpfa3X0=
------END CERTIFICATE-----

package/node_modules/hpagent/test/ssl.key

@@ -1,27 +0,0 @@
------BEGIN RSA PRIVATE KEY-----
-MIIEpQIBAAKCAQEAq19fMMyZT6fcDuhVU6KqnpnlyC7W36qCPtNp3Bc4285Fm+45
-wTwFmkz21AQMTlcQh1yzMPHS1YocdKhuBkDENoS4rU8yGH9FM2/DUrNgkWbYbfya
-qCbXUlSeLzvGYgWqmAl94ICkedZS/7f+em5CeI6hVIvXeN1cSJ94UzyidCdHvdNU
-PK8w6OWNO6UyjSf1XyliFVLM+eba7FO7Tenn4eixATZtTRAqPuTz/x3BFVcSqdO1
-suhb5Z/tXZbdyv9Sd88fwlJoFZOpy3SmBepgio5JOJZCQ7ukTr2YY8etGWbv7CGn
-hZGuJNpwHdSX4JvHbzAdT4Pze96vgDwsoZUNIQIDAQABAoIBAG278ys/R8he1yVg
-lgqo9ZH7P8zwWTz9ZMsv+vAomor9SUtwvuDCO2AzejYGpY6gZ4AV1tQ3dOaxukjk
-9Rbh8AJs+AhZ1t0i2b/3B95z6BkS/vFmt+2GeYhJkMT0BLMNp9AU+9p+5VLy71C5
-k6T3525k/l8x8HZ/YDFMk/LQt8GhvM6A3J3BNElKraiDVO6ZIWgQQ5wiefJkApo1
-BsptHNTx83FbnkEbAahmOR8PfKcRdKY/mZDM2WrlfoU2uwVzPV0/KdYucpsfg2et
-jb5bdJzcvZDuDF4GsPi1asCSC1c403R0XGuPFW9TiBuOPxbfhYK2o60yTggX6H2X
-39WBc/ECgYEA3KNGgXEWzDSLpGciUisP+MzulOdQPawBTUHNykpQklEppnZbNWCX
-07dv6uasnp0pFHG4WlhZJ4+IQBpZH6xAVy9y68PvN7IDYdgMiEiYPSyqQu0rvJGa
-2ZR79SHDokZ8K5oofocC839RzleNRqWqxIwhHt29sxVs73kvml6OQm0CgYEAxtbA
-zbQwf6DXtFwutSgfOLgdXQK72beBdyeTcpUGbkonl5xHSbtz0CFmRpKiPnXfgg4W
-GXlTrqlYF/o048B7dU9+jCKY5DXx1Yzg/EFisEIClad3WXMhNOz1vBYVH6xU3Zq1
-YuYr5dcqiCWDv89e6Y6WJOhwIDZi6RqikD2EJQUCgYEAnWSAJFCnIa8OOo4z5oe/
-kg2m2GQWUphEKXeatQbEaUwquQvPTsmEJUzDMr+xPkkAiAwDpbdGijkSyh/Bmh2H
-nGpFwbf5CzMaxI6ZihK3P1SAdNO5koAQBcytjJW0eCtt4rDK2E+5pDgcBGVia5Y8
-to78BYfLDlhnaIF7mtR/CRUCgYEAvGCuzvOcUv4F/eirk5NMaQb9QqYZZD2XWVTU
-O2T2b7yvX9J+M1t1cESESe4X6cbwlp1T0JSCdGIZhLXWL8Om80/52zfX07VLxP6w
-FCy6G7SeEDxVNRh+6E5qzOO65YP17vDoUacxBZJgyBWKiUkkaW9dzd+sgsgj0yYZ
-xz+QlyUCgYEAxdNWQnz0pR5Rt2dbIedPs7wmiZ7eAe0VjCdhMa52IyJpejdeB6Bn
-Es+3lkHr0Xzty8XlQZcpbswhM8UZRgPVoBvvwQdQbv5yV+LdUu69pLM7InsdZy8u
-opPY/+q9lRdJt4Pbep3pOWYeLP7k5l4vei2vOEMHRjHnoqM5etSb6RU=
------END RSA PRIVATE KEY-----

package/node_modules/hpagent/test/utils.js

@@ -1,59 +0,0 @@
-'use strict'
-
-// We are using self-signed certificates
-process.env.NODE_TLS_REJECT_UNAUTHORIZED = 0
-
-const proxy = require('proxy')
-const { readFileSync } = require('fs')
-const { join } = require('path')
-const http = require('http')
-const https = require('https')
-
-const ssl = {
-  key: readFileSync(join(__dirname, 'ssl.key')),
-  cert: readFileSync(join(__dirname, 'ssl.cert'))
-}
-
-function createProxy () {
-  return new Promise((resolve, reject) => {
-    const server = proxy(http.createServer())
-    server.listen(0, '127.0.0.1', () => {
-      resolve(server)
-    })
-  })
-}
-
-function createSecureProxy () {
-  return new Promise((resolve, reject) => {
-    const server = proxy(https.createServer(ssl))
-    server.listen(0, '127.0.0.1', () => {
-      resolve(server)
-    })
-  })
-}
-
-function createServer (handler, callback) {
-  return new Promise((resolve, reject) => {
-    const server = http.createServer()
-    server.listen(0, '127.0.0.1', () => {
-      resolve(server)
-    })
-  })
-}
-
-function createSecureServer (handler, callback) {
-  return new Promise((resolve, reject) => {
-    const server = https.createServer(ssl)
-    server.listen(0, '127.0.0.1', () => {
-      resolve(server)
-    })
-  })
-}
-
-module.exports = {
-  ssl,
-  createProxy,
-  createSecureProxy,
-  createServer,
-  createSecureServer
-}

package/node_modules/http-cache-semantics/LICENSE

@@ -1,9 +0,0 @@
-Copyright 2016-2018 Kornel Lesiński
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/node_modules/http-cache-semantics/README.md

@@ -1,203 +0,0 @@
-# Can I cache this? [![Build Status](https://travis-ci.org/kornelski/http-cache-semantics.svg?branch=master)](https://travis-ci.org/kornelski/http-cache-semantics)
-
-`CachePolicy` tells when responses can be reused from a cache, taking into account [HTTP RFC 7234](http://httpwg.org/specs/rfc7234.html) rules for user agents and shared caches.
-It also implements [RFC 5861](https://tools.ietf.org/html/rfc5861), implementing `stale-if-error` and `stale-while-revalidate`.
-It's aware of many tricky details such as the `Vary` header, proxy revalidation, and authenticated responses.
-
-## Usage
-
-Cacheability of an HTTP response depends on how it was requested, so both `request` and `response` are required to create the policy.
-
-```js
-const policy = new CachePolicy(request, response, options);
-
-if (!policy.storable()) {
-    // throw the response away, it's not usable at all
-    return;
-}
-
-// Cache the data AND the policy object in your cache
-// (this is pseudocode, roll your own cache (lru-cache package works))
-letsPretendThisIsSomeCache.set(
-    request.url,
-    { policy, response },
-    policy.timeToLive()
-);
-```
-
-```js
-// And later, when you receive a new request:
-const { policy, response } = letsPretendThisIsSomeCache.get(newRequest.url);
-
-// It's not enough that it exists in the cache, it has to match the new request, too:
-if (policy && policy.satisfiesWithoutRevalidation(newRequest)) {
-    // OK, the previous response can be used to respond to the `newRequest`.
-    // Response headers have to be updated, e.g. to add Age and remove uncacheable headers.
-    response.headers = policy.responseHeaders();
-    return response;
-}
-```
-
-It may be surprising, but it's not enough for an HTTP response to be [fresh](#yo-fresh) to satisfy a request. It may need to match request headers specified in `Vary`. Even a matching fresh response may still not be usable if the new request restricted cacheability, etc.
-
-The key method is `satisfiesWithoutRevalidation(newRequest)`, which checks whether the `newRequest` is compatible with the original request and whether all caching conditions are met.
-
-### Constructor options
-
-Request and response must have a `headers` property with all header names in lower case. `url`, `status` and `method` are optional (defaults are any URL, status `200`, and `GET` method).
-
-```js
-const request = {
-    url: '/',
-    method: 'GET',
-    headers: {
-        accept: '*/*',
-    },
-};
-
-const response = {
-    status: 200,
-    headers: {
-        'cache-control': 'public, max-age=7234',
-    },
-};
-
-const options = {
-    shared: true,
-    cacheHeuristic: 0.1,
-    immutableMinTimeToLive: 24 * 3600 * 1000, // 24h
-    ignoreCargoCult: false,
-};
-```
-
-If `options.shared` is `true` (default), then the response is evaluated from a perspective of a shared cache (i.e. `private` is not cacheable and `s-maxage` is respected). If `options.shared` is `false`, then the response is evaluated from a perspective of a single-user cache (i.e. `private` is cacheable and `s-maxage` is ignored). `shared: true` is recommended for HTTP clients.
-
-`options.cacheHeuristic` is a fraction of response's age that is used as a fallback cache duration. The default is 0.1 (10%), e.g. if a file hasn't been modified for 100 days, it'll be cached for 100\*0.1 = 10 days.
-
-`options.immutableMinTimeToLive` is a number of milliseconds to assume as the default time to cache responses with `Cache-Control: immutable`. Note that [per RFC](http://httpwg.org/http-extensions/immutable.html) these can become stale, so `max-age` still overrides the default.
-
-If `options.ignoreCargoCult` is true, common anti-cache directives will be completely ignored if the non-standard `pre-check` and `post-check` directives are present. These two useless directives are most commonly found in bad StackOverflow answers and PHP's "session limiter" defaults.
-
-### `storable()`
-
-Returns `true` if the response can be stored in a cache. If it's `false` then you MUST NOT store either the request or the response.
-
-### `satisfiesWithoutRevalidation(newRequest)`
-
-This is the most important method. Use this method to check whether the cached response is still fresh in the context of the new request.
-
-If it returns `true`, then the given `request` matches the original response this cache policy has been created with, and the response can be reused without contacting the server. Note that the old response can't be returned without being updated, see `responseHeaders()`.
-
-If it returns `false`, then the response may not be matching at all (e.g. it's for a different URL or method), or may require to be refreshed first (see `revalidationHeaders()`).
-
-### `responseHeaders()`
-
-Returns updated, filtered set of response headers to return to clients receiving the cached response. This function is necessary, because proxies MUST always remove hop-by-hop headers (such as `TE` and `Connection`) and update response's `Age` to avoid doubling cache time.
-
-```js
-cachedResponse.headers = cachePolicy.responseHeaders(cachedResponse);
-```
-
-### `timeToLive()`
-
-Returns approximate time in _milliseconds_ until the response becomes stale (i.e. not fresh).
-
-After that time (when `timeToLive() <= 0`) the response might not be usable without revalidation. However, there are exceptions, e.g. a client can explicitly allow stale responses, so always check with `satisfiesWithoutRevalidation()`.
-`stale-if-error` and `stale-while-revalidate` extend the time to live of the cache, that can still be used if stale.
-
-### `toObject()`/`fromObject(json)`
-
-Chances are you'll want to store the `CachePolicy` object along with the cached response. `obj = policy.toObject()` gives a plain JSON-serializable object. `policy = CachePolicy.fromObject(obj)` creates an instance from it.
-
-### Refreshing stale cache (revalidation)
-
-When a cached response has expired, it can be made fresh again by making a request to the origin server. The server may respond with status 304 (Not Modified) without sending the response body again, saving bandwidth.
-
-The following methods help perform the update efficiently and correctly.
-
-#### `revalidationHeaders(newRequest)`
-
-Returns updated, filtered set of request headers to send to the origin server to check if the cached response can be reused. These headers allow the origin server to return status 304 indicating the response is still fresh. All headers unrelated to caching are passed through as-is.
-
-Use this method when updating cache from the origin server.
-
-```js
-updateRequest.headers = cachePolicy.revalidationHeaders(updateRequest);
-```
-
-#### `revalidatedPolicy(revalidationRequest, revalidationResponse)`
-
-Use this method to update the cache after receiving a new response from the origin server. It returns an object with two keys:
-
--   `policy` — A new `CachePolicy` with HTTP headers updated from `revalidationResponse`. You can always replace the old cached `CachePolicy` with the new one.
--   `modified` — Boolean indicating whether the response body has changed.
-    -   If `false`, then a valid 304 Not Modified response has been received, and you can reuse the old cached response body. This is also affected by `stale-if-error`.
-    -   If `true`, you should use new response's body (if present), or make another request to the origin server without any conditional headers (i.e. don't use `revalidationHeaders()` this time) to get the new resource.
-
-```js
-// When serving requests from cache:
-const { oldPolicy, oldResponse } = letsPretendThisIsSomeCache.get(
-    newRequest.url
-);
-
-if (!oldPolicy.satisfiesWithoutRevalidation(newRequest)) {
-    // Change the request to ask the origin server if the cached response can be used
-    newRequest.headers = oldPolicy.revalidationHeaders(newRequest);
-
-    // Send request to the origin server. The server may respond with status 304
-    const newResponse = await makeRequest(newRequest);
-
-    // Create updated policy and combined response from the old and new data
-    const { policy, modified } = oldPolicy.revalidatedPolicy(
-        newRequest,
-        newResponse
-    );
-    const response = modified ? newResponse : oldResponse;
-
-    // Update the cache with the newer/fresher response
-    letsPretendThisIsSomeCache.set(
-        newRequest.url,
-        { policy, response },
-        policy.timeToLive()
-    );
-
-    // And proceed returning cached response as usual
-    response.headers = policy.responseHeaders();
-    return response;
-}
-```
-
-# Yo, FRESH
-
-![satisfiesWithoutRevalidation](fresh.jpg)
-
-## Used by
-
--   [ImageOptim API](https://imageoptim.com/api), [make-fetch-happen](https://github.com/zkat/make-fetch-happen), [cacheable-request](https://www.npmjs.com/package/cacheable-request) ([got](https://www.npmjs.com/package/got)), [npm/registry-fetch](https://github.com/npm/registry-fetch), [etc.](https://github.com/kornelski/http-cache-semantics/network/dependents)
-
-## Implemented
-
--   `Cache-Control` response header with all the quirks.
--   `Expires` with check for bad clocks.
--   `Pragma` response header.
--   `Age` response header.
--   `Vary` response header.
--   Default cacheability of statuses and methods.
--   Requests for stale data.
--   Filtering of hop-by-hop headers.
--   Basic revalidation request
--   `stale-if-error`
-
-## Unimplemented
-
--   Merging of range requests, `If-Range` (but correctly supports them as non-cacheable)
--   Revalidation of multiple representations
-
-### Trusting server `Date`
-
-Per the RFC, the cache should take into account the time between server-supplied `Date` and the time it received the response. The RFC-mandated behavior creates two problems:
-
- * Servers with incorrectly set timezone may add several hours to cache age (or more, if the clock is completely wrong).
- * Even reasonably correct clocks may be off by a couple of seconds, breaking `max-age=1` trick (which is useful for reverse proxies on high-traffic servers).
-
-Previous versions of this library had an option to ignore the server date if it was "too inaccurate". To support the `max-age=1` trick the library also has to ignore dates that pretty accurate. There's no point of having an option to trust dates that are only a bit inaccurate, so this library won't trust any server dates. `max-age` will be interpreted from the time the response has been received, not from when it has been sent. This will affect only [RFC 1149 networks](https://tools.ietf.org/html/rfc1149).