@vltpkg/registry-client 0.0.0-3 → 0.0.0-31

package/dist/esm/cache-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-entry.js","sourceRoot":"","sources":["../../src/cache-entry.ts"],"names":[],"mappings":"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","sourcesContent":["// A response object in the cache.\n//\n// The cache stores Buffer objects, and it's convenient to have headers/body\n// together, so we have a simple data structure for this.\n//\n// The shape of it is:\n//\n// [head length]\n// <status code in ascii>\n// [headers]\n// [body]\n//\n// The [UInt32BE head length] is 4 bytes specifying the full length of the\n// status code plus all header keys and values.\n//\n// The [headers] section is key/value/key2/value2/... where each key and value\n// is a 4-byte Uint32BE length, followed by that many bytes.\n//\n// From there, the body can be of any indeterminate length, and is the rest\n// of the file.\n\nimport { error } from '@vltpkg/error-cause'\nimport type { Integrity, JSONField } from '@vltpkg/types'\nimport ccp from 'cache-control-parser'\nimport { createHash } from 'crypto'\nimport { inspect } from 'util'\nimport type { InspectOptions } from 'util'\nimport { gunzipSync } from 'zlib'\nimport { getRawHeader, setRawHeader } from './raw-header.ts'\n\nexport type JSONObj = Record<string, JSONField>\n\nconst readSize = (buf: Buffer, offset: number) => {\n  const a = buf[offset]\n  const b = buf[offset + 1]\n  const c = buf[offset + 2]\n  const d = buf[offset + 3]\n\n  // not possible, we check the length\n  /* c8 ignore start */\n  if (\n    a === undefined ||\n    b === undefined ||\n    c === undefined ||\n    d === undefined\n  ) {\n    throw error('Invalid buffer, not long enough to readSize', {\n      found: buf.length,\n    })\n  }\n  /* c8 ignore stop */\n\n  return (a << 24) | (b << 16) | (c << 8) | d\n}\n\nconst kCustomInspect = Symbol.for('nodejs.util.inspect.custom')\n\nexport class CacheEntry {\n  #statusCode: number\n  #headers: Buffer[]\n  #body: Buffer[] = []\n  #bodyLength = 0\n  #integrity?: Integrity\n  #integrityActual?: Integrity\n  #json?: JSONObj\n\n  constructor(\n    statusCode: number,\n    headers: Buffer[],\n    integrity?: Integrity,\n  ) {\n    this.#integrity = integrity\n    this.#statusCode = statusCode\n    this.#headers = headers\n  }\n\n  get #headersAsObject(): [string, string][] {\n    const ret: [string, string][] = []\n    for (let i = 0; i < this.#headers.length - 1; i += 2) {\n      const key = String(this.#headers[i])\n      const val = String(this.#headers[i + 1])\n      ret.push([key, val])\n    }\n    return ret\n  }\n\n  [kCustomInspect](depth: number, options: InspectOptions): string {\n    const str = inspect(\n      {\n        statusCode: this.statusCode,\n        headers: this.#headersAsObject,\n        text: this.text(),\n      },\n      {\n        depth,\n        ...options,\n      },\n    )\n    return `@vltpkg/registry-client.CacheEntry ${str}`\n  }\n\n  /**\n   * `true` if the entry represents a cached response that is still\n   * valid to use.\n   */\n  get valid(): boolean {\n    const cc_ = this.getHeader('cache-control')?.toString()\n    const cc = cc_ ? ccp.parse(cc_) : {}\n    const ct = this.getHeader('content-type')?.toString() ?? ''\n    const dh = this.getHeader('date')?.toString()\n\n    // immutable = never changes\n    if (cc.immutable) return true\n\n    // some registries do text/json, some do application/json,\n    // some do application/vnd.npm.install-v1+json\n    // If it's NOT json, it's an immutable tarball\n    if (ct !== '' && !/\\bjson\\b/.test(ct)) return true\n\n    // see if the max-age has not yet been crossed\n    // default to 5m if maxage is not set, as some registries\n    // do not set a cache control header at all.\n    const ma = cc['max-age'] || cc['s-maxage'] || 300\n    if (ma && dh) {\n      return Date.parse(dh) + ma * 1000 > Date.now()\n    }\n    return false\n  }\n\n  addBody(b: Buffer) {\n    this.#body.push(b)\n    this.#bodyLength += b.byteLength\n  }\n\n  get statusCode() {\n    return this.#statusCode\n  }\n  get headers() {\n    return this.#headers\n  }\n\n  /**\n   * check that the sri integrity string that was provided to the ctor\n   * matches the body that we actually received. This should only be called\n   * AFTER the entire body has been completely downloaded.\n   *\n   * Note that this will *usually* not be true if the value is coming out of\n   * the cache, because the cache entries are un-gzipped in place. It should\n   * _only_ be called for artifacts that come from an actual http response.\n   */\n  checkIntegrity(): boolean {\n    if (!this.#integrity) return false\n    return this.integrityActual === this.#integrity\n  }\n  get integrityActual(): Integrity {\n    if (this.#integrityActual) return this.#integrityActual\n    const hash = createHash('sha512')\n    for (const buf of this.#body) hash.update(buf)\n    this.#integrityActual = `sha512-${hash.digest('base64')}`\n    return this.#integrityActual\n  }\n  get integrity() {\n    return this.#integrity\n  }\n\n  /**\n   * Give it a key, and it'll return the buffer of that header value\n   */\n  getHeader(h: string) {\n    return getRawHeader(this.#headers, h)\n  }\n\n  /**\n   * Set a header to a specific value\n   */\n  setHeader(h: string, value: Buffer | string) {\n    this.#headers = setRawHeader(this.#headers, h, value)\n  }\n\n  /**\n   * Return the body of the entry as a Buffer\n   */\n  buffer(): Buffer {\n    const b = this.#body[0]\n    if (!b) return Buffer.allocUnsafe(0)\n    if (this.#body.length === 1) return b\n    const cat = Buffer.concat(this.#body, this.#bodyLength)\n    this.#body = [cat]\n    return cat\n  }\n\n  // return the buffer if it's a tarball, or the parsed\n  // JSON if it's not.\n  get body(): Buffer | Record<string, any> {\n    return this.isJSON ? this.json() : this.buffer()\n  }\n\n  #isJSON?: boolean\n  get isJSON(): boolean {\n    if (this.#isJSON !== undefined) return this.#isJSON\n    const ct = this.getHeader('content-type')?.toString()\n    // if it says it's json, assume json\n    if (ct) return (this.#isJSON = /\\bjson\\b/.test(ct))\n    const text = this.text()\n    // don't cache, because we might just not have it yet.\n    if (!text) return false\n    // all registry json starts with {, and no tarball ever can.\n    this.#isJSON = text.startsWith('{')\n    if (this.#isJSON) this.setHeader('content-type', 'text/json')\n    return this.#isJSON\n  }\n\n  #isGzip?: boolean\n  get isGzip(): boolean {\n    if (this.#isGzip !== undefined) return this.#isGzip\n    const ce = this.getHeader('content-encoding')?.toString()\n    if (ce && !/\\bgzip\\b/.test(ce)) return (this.#isGzip = false)\n    const buf = this.buffer()\n    if (buf.length < 2) return false\n    this.#isGzip = buf[0] === 0x1f && buf[1] === 0x8b\n    if (this.#isGzip) {\n      this.setHeader('content-encoding', 'gzip')\n    } else {\n      this.setHeader('content-encoding', 'identity')\n      this.setHeader('content-length', String(this.#bodyLength))\n    }\n    return this.#isGzip\n  }\n\n  /**\n   * Un-gzip encode the body.\n   * Returns true if it was previously gzip (so something was done), otherwise\n   * returns false.\n   */\n  unzip() {\n    if (this.isGzip) {\n      // we know that if we know it's gzip, that the body has been\n      // flattened to a single buffer, so save the extra call.\n      /* c8 ignore start */\n      if (this.#body[0] == null)\n        throw error('Invalid buffer, cant unzip')\n      /* c8 ignore stop */\n      const b = gunzipSync(this.#body[0])\n      this.setHeader('content-encoding', 'identity')\n      this.#body = [b]\n      this.#bodyLength = b.byteLength\n      this.setHeader('content-length', String(this.#bodyLength))\n      this.#isGzip = false\n      return true\n    }\n    return false\n  }\n\n  /**\n   * Return the body of the entry as utf8 text\n   * Automatically unzips if the content is gzip encoded\n   */\n  text() {\n    this.unzip()\n    return this.buffer().toString()\n  }\n\n  /**\n   * Parse the entry body as JSON and return the result\n   */\n  json(): JSONObj {\n    if (this.#json !== undefined) return this.#json\n    const obj = JSON.parse(this.text()) as JSONObj\n    this.#json = obj\n    return obj\n  }\n\n  /**\n   * Pass the contents of a @vltpkg/cache.Cache object as a buffer,\n   * and this static method will decode it into a CacheEntry representing\n   * the cached response.\n   */\n  static decode(buffer: Buffer): CacheEntry {\n    if (buffer.length < 4) {\n      return new CacheEntry(0, [])\n    }\n    const headSize = readSize(buffer, 0)\n    if (buffer.length < headSize) {\n      return new CacheEntry(0, [])\n    }\n    const statusCode = Number(buffer.subarray(4, 7).toString())\n    const headersBuffer = buffer.subarray(7, headSize)\n    // walk through the headers array, building up the rawHeaders Buffer[]\n    const headers: Buffer[] = []\n    let i = 0\n    while (i < headersBuffer.length - 4) {\n      const size = readSize(headersBuffer, i)\n      headers.push(headersBuffer.subarray(i + 4, i + size))\n      i += size\n    }\n    const c = new CacheEntry(statusCode, headers)\n    const body = buffer.subarray(headSize)\n    c.#body = [body]\n    c.#bodyLength = body.byteLength\n    c.setHeader('content-length', String(c.#bodyLength))\n    if (c.isJSON) {\n      try {\n        c.json()\n      } catch {\n        return new CacheEntry(0, [])\n      }\n    }\n    return c\n  }\n\n  /**\n   * Encode the entry as a single Buffer for writing to the cache\n   */\n  // TODO: should this maybe not concat, and just return Buffer[]?\n  // Then we can writev it to the cache file and save the memory copy\n  encode(): Buffer {\n    // store json results as a serialized object.\n    if (this.isJSON) this.json()\n    const sb = Buffer.from(String(this.#statusCode))\n    const chunks: Buffer[] = [sb]\n    let headLength = sb.byteLength + 4\n    for (const h of this.#headers) {\n      const hlBuf = Buffer.allocUnsafe(4)\n      const hl = h.byteLength + 4\n      headLength += hl\n      hlBuf.set(\n        [\n          (hl >> 24) & 0xff,\n          (hl >> 16) & 0xff,\n          (hl >> 8) & 0xff,\n          hl & 0xff,\n        ],\n        0,\n      )\n      chunks.push(hlBuf, h)\n    }\n\n    const hlBuf = Buffer.allocUnsafe(4)\n    hlBuf.set(\n      [\n        (headLength >> 24) & 0xff,\n        (headLength >> 16) & 0xff,\n        (headLength >> 8) & 0xff,\n        headLength & 0xff,\n      ],\n      0,\n    )\n    chunks.unshift(hlBuf)\n    chunks.push(...this.#body)\n    return Buffer.concat(chunks, headLength + this.#bodyLength)\n  }\n}\n"]}
+{"version":3,"file":"cache-entry.js","sourceRoot":"","sources":["../../src/cache-entry.ts"],"names":[],"mappings":"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","sourcesContent":["// A response object in the cache.\n//\n// The cache stores Buffer objects, and it's convenient to have headers/body\n// together, so we have a simple data structure for this.\n//\n// The shape of it is:\n//\n// [head length]\n// <status code in ascii>\n// [headers]\n// [body]\n//\n// The [UInt32BE head length] is 4 bytes specifying the full length of the\n// status code plus all header keys and values.\n//\n// The [headers] section is key/value/key2/value2/... where each key and value\n// is a 4-byte Uint32BE length, followed by that many bytes.\n//\n// From there, the body can be of any indeterminate length, and is the rest\n// of the file.\n\nimport type { ErrorCauseOptions } from '@vltpkg/error-cause'\nimport { error } from '@vltpkg/error-cause'\nimport type { Integrity, JSONField } from '@vltpkg/types'\nimport ccp from 'cache-control-parser'\nimport { createHash } from 'node:crypto'\nimport type { InspectOptions } from 'node:util'\nimport { inspect } from 'node:util'\nimport { gunzipSync } from 'node:zlib'\nimport { getRawHeader, setRawHeader } from './raw-header.ts'\nimport {\n  getDecodedValue,\n  getEncondedValue,\n} from './string-encoding.ts'\n\nexport type JSONObj = Record<string, JSONField>\n\nconst readSize = (buf: Uint8Array, offset: number) => {\n  const a = buf[offset]\n  const b = buf[offset + 1]\n  const c = buf[offset + 2]\n  const d = buf[offset + 3]\n\n  // not possible, we check the length\n  /* c8 ignore start */\n  if (\n    a === undefined ||\n    b === undefined ||\n    c === undefined ||\n    d === undefined\n  ) {\n    throw error('Invalid buffer, not long enough to readSize', {\n      found: buf.length,\n    })\n  }\n  /* c8 ignore stop */\n\n  return (a << 24) | (b << 16) | (c << 8) | d\n}\n\nconst kCustomInspect = Symbol.for('nodejs.util.inspect.custom')\n\nexport type CacheEntryOptions = {\n  /**\n   * An optional body to use.\n   *\n   * This is used when decoding a cache entry from a buffer, and the body\n   * is already in a ArrayBuffer we can use. When this option is\n   * provided the `addBody` method should not be used.\n   */\n  body?: Uint8Array\n\n  /**\n   * An optional content length of the body to use, if undefined the\n   * content-length header will be used.\n   */\n  contentLength?: number\n\n  /**\n   * The expected integrity value for this response body\n   */\n  integrity?: Integrity\n  /**\n   * Whether to trust the integrity, or calculate the actual value.\n   *\n   * This indicates that we just accept whatever the integrity is as the actual\n   * integrity for saving back to the cache, because it's coming directly from\n   * the registry that we fetched a packument from, and is an initial gzipped\n   * artifact request.\n   */\n  trustIntegrity?: boolean\n\n  /**\n   * If the server does not serve a `stale-while-revalidate` value in the\n   * `cache-control` header, then this multiplier is applied to the `max-age`\n   * or `s-maxage` values.\n   *\n   * By default, this is `60`, so for example a response that is cacheable for\n   * 5 minutes will allow a stale response while revalidating for up to 5\n   * hours.\n   *\n   * If the server *does* provide a `stale-while-revalidate` value, then that\n   * is always used.\n   *\n   * Set to 0 to prevent any `stale-while-revalidate` behavior unless\n   * explicitly allowed by the server's `cache-control` header.\n   */\n  'stale-while-revalidate-factor'?: number\n}\n\nexport class CacheEntry {\n  #statusCode: number\n  /** The raw headers as an array of buffers */\n  #headers: Uint8Array[]\n  /** The body buffer, used if the content length is known. */\n  #body?: Uint8Array\n  /**\n   * If the content length is unknown we save the body in multiple parts\n   * in order to only concatenate once at the end and save extra memory copies.\n   */\n  #bodyParts: Uint8Array[] = []\n  /** Used to track the length of the body while reading chunks */\n  #bodyLength = 0\n  /** The total length of the body, if known */\n  #contentLength?: number\n  #integrity?: Integrity\n  #integrityActual?: Integrity\n  #json?: JSONObj\n  #trustIntegrity\n  #staleWhileRevalidateFactor\n\n  constructor(\n    statusCode: number,\n    headers: Uint8Array[],\n    {\n      body,\n      integrity,\n      trustIntegrity = false,\n      'stale-while-revalidate-factor':\n        staleWhileRevalidateFactor = 60,\n      contentLength,\n    }: CacheEntryOptions = {},\n  ) {\n    this.#headers = headers\n    this.#statusCode = statusCode\n    this.#trustIntegrity = trustIntegrity\n    this.#staleWhileRevalidateFactor = staleWhileRevalidateFactor\n    if (integrity) this.integrity = integrity\n\n    // if content-legnth is known then we'll only allocate that much memory\n    // and we'll avoid copying memory around when adding new chunks.\n    if (contentLength != null && typeof contentLength === 'number') {\n      this.#contentLength = contentLength\n    }\n\n    // if a body is provided then use that, in this case the `addBody`\n    // method should no longer be used.\n    if (body) {\n      const buffer = new ArrayBuffer(body.byteLength)\n      this.#body = new Uint8Array(buffer, 0, body.byteLength)\n      this.#body.set(body, 0)\n      this.#bodyLength = body.byteLength\n      /* c8 ignore start */\n    } else if (this.#contentLength) {\n      const buffer = new ArrayBuffer(this.#contentLength)\n      this.#body = new Uint8Array(buffer, 0, this.#contentLength)\n      this.#bodyLength = 0\n    }\n    /* c8 ignore stop */\n  }\n\n  get #headersAsObject(): [string, string][] {\n    const ret: [string, string][] = []\n    for (let i = 0; i < this.#headers.length - 1; i += 2) {\n      const key = getDecodedValue(this.#headers[i])\n      const val = getDecodedValue(this.#headers[i + 1])\n      ret.push([key, val])\n    }\n    return ret\n  }\n\n  toJSON() {\n    const {\n      statusCode,\n      valid,\n      staleWhileRevalidate,\n      cacheControl,\n      date,\n      contentType,\n      integrity,\n      maxAge,\n      isGzip,\n      isJSON,\n    } = this\n    /* c8 ignore start */\n    const age =\n      date ?\n        Math.floor((Date.now() - date.getTime()) / 1000)\n      : undefined\n    const expires =\n      date ? new Date(date.getTime() + this.maxAge * 1000) : undefined\n    /* c8 ignore end */\n    return Object.fromEntries(\n      Object.entries({\n        statusCode,\n        headers: this.#headersAsObject,\n        contentType,\n        integrity,\n        date,\n        expires,\n        cacheControl,\n        valid,\n        staleWhileRevalidate,\n        age,\n        maxAge,\n        isGzip,\n        isJSON,\n      }).filter(([_, v]) => v !== undefined),\n    )\n  }\n\n  [kCustomInspect](depth: number, options: InspectOptions): string {\n    const str = inspect(this.toJSON(), {\n      depth,\n      ...options,\n    })\n    return `@vltpkg/registry-client.CacheEntry ${str}`\n  }\n\n  #date?: Date\n  get date(): Date | undefined {\n    if (this.#date) return this.#date\n    const dh = this.getHeaderString('date')\n    if (dh) this.#date = new Date(dh)\n    return this.#date\n  }\n\n  #maxAge?: number\n  get maxAge(): number {\n    if (this.#maxAge !== undefined) return this.#maxAge\n    // see if the max-age has not yet been crossed\n    // default to 5m if maxage is not set, as some registries\n    // do not set a cache control header at all.\n    const cc = this.cacheControl\n    this.#maxAge = cc['max-age'] || cc['s-maxage'] || 300\n    return this.#maxAge\n  }\n\n  #cacheControl?: ccp.CacheControl\n  get cacheControl(): ccp.CacheControl {\n    if (this.#cacheControl) return this.#cacheControl\n    const cc = this.getHeaderString('cache-control')\n    this.#cacheControl = cc ? ccp.parse(cc) : {}\n    return this.#cacheControl\n  }\n\n  #staleWhileRevalidate?: boolean\n  get staleWhileRevalidate(): boolean {\n    if (this.#staleWhileRevalidate !== undefined)\n      return this.#staleWhileRevalidate\n    if (this.valid || !this.date) return true\n    const swv =\n      this.cacheControl['stale-while-revalidate'] ??\n      this.maxAge * this.#staleWhileRevalidateFactor\n\n    this.#staleWhileRevalidate =\n      this.date.getTime() + swv * 1000 > Date.now()\n    return this.#staleWhileRevalidate\n  }\n\n  #contentType?: string\n  get contentType() {\n    if (this.#contentType !== undefined) return this.#contentType\n    this.#contentType = this.getHeaderString('content-type') ?? ''\n    return this.#contentType\n  }\n\n  /**\n   * `true` if the entry represents a cached response that is still\n   * valid to use.\n   */\n  #valid?: boolean\n  get valid(): boolean {\n    if (this.#valid !== undefined) return this.#valid\n\n    // immutable = never changes\n    if (this.cacheControl.immutable) return (this.#valid = true)\n\n    // some registries do text/json, some do application/json,\n    // some do application/vnd.npm.install-v1+json\n    // If it's NOT json, it's an immutable tarball\n    const ct = this.contentType\n    if (ct && !/\\bjson\\b/.test(ct)) return (this.#valid = true)\n\n    // see if the max-age has not yet been crossed\n    // default to 5m if maxage is not set, as some registries\n    // do not set a cache control header at all.\n    if (!this.date) return (this.#valid = false)\n    this.#valid =\n      this.date.getTime() + this.maxAge * 1000 > Date.now()\n    return this.#valid\n  }\n\n  /**\n   * Add contents to the entry body.\n   */\n  addBody(b: Uint8Array) {\n    // when the content length is uknown we store each chunk in an array that\n    // later on is concatenate into a single buffer, otherwise we just append\n    // the new chunk of bytes to the already allocated buffer keeping track\n    // of the current offset in the `this.#bodyLength` property.\n    if (!this.#body) {\n      this.#bodyParts.push(b)\n      this.#bodyLength += b.byteLength\n    } else {\n      this.#body.set(b, this.#bodyLength)\n      this.#bodyLength += b.byteLength\n    }\n  }\n\n  get statusCode() {\n    return this.#statusCode\n  }\n  get headers(): Uint8Array[] {\n    return this.#headers\n  }\n\n  /**\n   * Returns the body as a single Uint8Array, concatenating parts if needed.\n   */\n  get _body(): Uint8Array {\n    // if the body is known we'll just use that\n    if (this.#body) return this.#body\n    // otherwise we concatenate the body parts into a single buffer\n    const buffer = new ArrayBuffer(this.#bodyLength)\n    const b = new Uint8Array(buffer, 0, this.#bodyLength)\n    let off = 0\n    for (const part of this.#bodyParts) {\n      b.set(part, off)\n      off += part.byteLength\n    }\n    return b\n  }\n\n  /**\n   * Check that the sri integrity string that was provided to the ctor\n   * matches the body that we actually received. This should only be called\n   * AFTER the entire body has been completely downloaded.\n   *\n   * This method **will throw** if the integrity values do not match.\n   *\n   * Note that this will *usually* not be true if the value is coming out of\n   * the cache, because the cache entries are un-gzipped in place. It should\n   * _only_ be called for artifacts that come from an actual http response.\n   *\n   * Returns true if anything was actually verified.\n   */\n  checkIntegrity(\n    context: ErrorCauseOptions = {},\n  ): this is CacheEntry & { integrity: Integrity } {\n    if (!this.#integrity) return false\n    if (this.integrityActual !== this.#integrity) {\n      throw error('Integrity check failure', {\n        code: 'EINTEGRITY',\n        response: this,\n        wanted: this.#integrity,\n        found: this.integrityActual,\n        ...context,\n      })\n    }\n    return true\n  }\n\n  get integrityActual(): Integrity {\n    if (this.#integrityActual) return this.#integrityActual\n    const hash = createHash('sha512')\n    hash.update(this._body)\n    const i: Integrity = `sha512-${hash.digest('base64')}`\n    this.integrityActual = i\n    return i\n  }\n\n  set integrityActual(i: Integrity) {\n    this.#integrityActual = i\n    this.setHeader('integrity', i)\n  }\n\n  set integrity(i: Integrity | undefined) {\n    if (!this.#integrity && i) {\n      this.#integrity = i\n      if (this.#trustIntegrity) this.integrityActual = i\n    }\n  }\n  get integrity() {\n    return this.#integrity\n  }\n\n  /**\n   * Give it a key, and it'll return the buffer of that header value\n   */\n  getHeader(h: string): Uint8Array | undefined {\n    return getRawHeader(this.#headers, h)\n  }\n\n  /**\n   * Give it a key, and it'll return the decoded string of that header value\n   */\n  getHeaderString(h: string): string | undefined {\n    const value = getRawHeader(this.#headers, h)\n    if (value) {\n      return getDecodedValue(value)\n    }\n  }\n\n  /**\n   * Set a header to a specific value\n   */\n  setHeader(h: string, value: Uint8Array | string) {\n    this.#headers = setRawHeader(this.#headers, h, value)\n  }\n\n  /**\n   * Return the body of the entry as a Buffer\n   */\n  buffer(): Buffer {\n    return Buffer.from(\n      this._body.buffer,\n      this._body.byteOffset,\n      this._body.byteLength,\n    )\n  }\n\n  // return the buffer if it's a tarball, or the parsed\n  // JSON if it's not.\n  get body(): Uint8Array | Record<string, any> {\n    return this.isJSON ? this.json() : this.buffer()\n  }\n\n  #isJSON?: boolean\n  get isJSON(): boolean {\n    if (this.#isJSON !== undefined) return this.#isJSON\n    const ct = this.getHeaderString('content-type')\n    // if it says it's json, assume json\n    if (ct) return (this.#isJSON = /\\bjson\\b/.test(ct))\n    const text = this.text()\n    // don't cache, because we might just not have it yet.\n    if (!text) return false\n    // all registry json starts with {, and no tarball ever can.\n    this.#isJSON = text.startsWith('{')\n    if (this.#isJSON) this.setHeader('content-type', 'text/json')\n    return this.#isJSON\n  }\n\n  #isGzip?: boolean\n  get isGzip(): boolean {\n    if (this.#isGzip !== undefined) return this.#isGzip\n    const ce = this.getHeaderString('content-encoding')\n    if (ce && !/\\bgzip\\b/.test(ce)) return (this.#isGzip = false)\n    const buf = this._body\n    if (buf.length < 2) return false\n    this.#isGzip = buf[0] === 0x1f && buf[1] === 0x8b\n    if (this.#isGzip) {\n      this.setHeader('content-encoding', 'gzip')\n    } else {\n      this.setHeader('content-encoding', 'identity')\n      this.setHeader('content-length', String(this.#bodyLength))\n    }\n    return this.#isGzip\n  }\n\n  /**\n   * Un-gzip encode the body.\n   * Returns true if it was previously gzip (so something was done), otherwise\n   * returns false.\n   */\n  unzip() {\n    if (this.isGzip) {\n      // we know that if we know it's gzip, that the body has been\n      // flattened to a single buffer, so save the extra call.\n      /* c8 ignore start */\n      if (this._body.length === 0)\n        throw error('Invalid buffer, cant unzip')\n      /* c8 ignore stop */\n      const b = gunzipSync(this._body)\n      this.setHeader('content-encoding', 'identity')\n      const u8 = new Uint8Array(b.buffer, b.byteOffset, b.byteLength)\n      this.#body = u8\n      this.#bodyLength = u8.byteLength\n      this.#contentLength = u8.byteLength\n      this.setHeader('content-length', String(this.#contentLength))\n      this.#isGzip = false\n      return true\n    }\n    return false\n  }\n\n  /**\n   * Return the body of the entry as utf8 text\n   * Automatically unzips if the content is gzip encoded\n   */\n  text() {\n    this.unzip()\n    return getDecodedValue(this._body)\n  }\n\n  /**\n   * Parse the entry body as JSON and return the result\n   */\n  json(): JSONObj {\n    if (this.#json !== undefined) return this.#json\n    const text = this.text()\n    const obj = JSON.parse(text || '{}') as JSONObj\n    this.#json = obj\n    return obj\n  }\n\n  /**\n   * Pass the contents of a @vltpkg/cache.Cache object as a buffer,\n   * and this static method will decode it into a CacheEntry representing\n   * the cached response.\n   */\n  static decode(buffer: Uint8Array): CacheEntry {\n    if (buffer.length < 4) {\n      return emptyCacheEntry\n    }\n    const headSize = readSize(buffer, 0)\n    if (buffer.length < headSize) {\n      return emptyCacheEntry\n    }\n    const statusCode = Number(getDecodedValue(buffer.subarray(4, 7)))\n    const headersBuffer = buffer.subarray(7, headSize)\n    // walk through the headers array, building up the rawHeaders\n    const headers: Uint8Array[] = []\n    let i = 0\n    let integrity: Integrity | undefined = undefined\n    while (i < headersBuffer.length - 4) {\n      const size = readSize(headersBuffer, i)\n      const val = headersBuffer.subarray(i + 4, i + size)\n      // if the last one was the key integrity, then this one is the value\n      if (headers.length % 2 === 1) {\n        const k = getDecodedValue(\n          headers[headers.length - 1],\n        ).toLowerCase()\n        if (k === 'integrity')\n          integrity = getDecodedValue(val) as Integrity\n      }\n      headers.push(val)\n      i += size\n    }\n    const body = buffer.subarray(headSize)\n\n    const c = new CacheEntry(\n      statusCode,\n      setRawHeader(\n        headers,\n        'content-length',\n        String(body.byteLength),\n      ),\n      {\n        body,\n        integrity,\n        trustIntegrity: true,\n        contentLength: body.byteLength,\n      },\n    )\n\n    if (c.isJSON) {\n      try {\n        c.json()\n      } catch {\n        return emptyCacheEntry\n      }\n    }\n    return c\n  }\n\n  static isGzipEntry(buffer: Uint8Array): boolean {\n    if (buffer.length < 4) return false\n    const headSize = readSize(buffer, 0)\n    const gzipBytes = buffer.subarray(headSize, headSize + 2)\n    return gzipBytes[0] === 0x1f && gzipBytes[1] === 0x8b\n  }\n\n  /**\n   * Encode the entry as a single Buffer for writing to the cache\n   */\n  encode(): Buffer {\n    if (this.isJSON) this.json()\n    const statusStr = String(this.#statusCode)\n    const statusBytes = getEncondedValue(statusStr)\n\n    // compute headLength = 4 (length field itself) + statusBytes + Σ(4 + headerLen) for each header item\n    let headLength = 4 + statusBytes.byteLength\n    for (const h of this.#headers) headLength += 4 + h.byteLength\n\n    // allocate and fill head length prefix (big-endian)\n    const headLenBytes = new Uint8Array(4)\n    headLenBytes[0] = (headLength >> 24) & 0xff\n    headLenBytes[1] = (headLength >> 16) & 0xff\n    headLenBytes[2] = (headLength >> 8) & 0xff\n    headLenBytes[3] = headLength & 0xff\n\n    // header chunks: [len, bytes] for each header item\n    const headerChunks: Uint8Array[] = []\n    for (const h of this.#headers) {\n      const l = headLenBytes.byteLength + h.byteLength\n      const lb = new Uint8Array(4)\n      lb[0] = (l >> 24) & 0xff\n      lb[1] = (l >> 16) & 0xff\n      lb[2] = (l >> 8) & 0xff\n      lb[3] = l & 0xff\n      headerChunks.push(lb, h)\n    }\n\n    // total size\n    const total =\n      headLenBytes.byteLength +\n      statusBytes.byteLength +\n      headerChunks.reduce((n, b) => n + b.byteLength, 0) +\n      this._body.byteLength\n\n    // returns the concatenate buffer with all the pieces\n    const outBuffer = new ArrayBuffer(total)\n    const out = Buffer.from(outBuffer, 0, total)\n    let off = 0\n    out.set(headLenBytes, off)\n    off += headLenBytes.byteLength\n    out.set(statusBytes, off)\n    off += statusBytes.byteLength\n    for (const chunk of headerChunks) {\n      out.set(chunk, off)\n      off += chunk.byteLength\n    }\n    out.set(this._body, off)\n    return out\n  }\n}\n\nconst emptyCacheEntry = new CacheEntry(0, [], { contentLength: 0 })\n"]}

package/dist/esm/cache-revalidate.d.ts

@@ -0,0 +1,2 @@
+export declare const register: (path: string, method: "HEAD" | "GET", url: string | URL) => void;
+//# sourceMappingURL=cache-revalidate.d.ts.map

package/dist/esm/cache-revalidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-revalidate.d.ts","sourceRoot":"","sources":["../../src/cache-revalidate.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,QAAQ,SACb,MAAM,UACJ,MAAM,GAAG,KAAK,OACjB,MAAM,GAAG,GAAG,KAChB,IASF,CAAA"}

package/dist/esm/cache-revalidate.js

@@ -0,0 +1,66 @@
+import { spawn } from 'node:child_process';
+import { __CODE_SPLIT_SCRIPT_NAME } from "./revalidate.js";
+import { pathToFileURL } from 'node:url';
+const isDeno = globalThis.Deno != undefined;
+let didProcessBeforeExitHook = false;
+const registered = new Map();
+export const register = (path, method, url) => {
+    const r = registered.get(path) ?? new Set();
+    const key = `${method} ${url}`;
+    r.add(key);
+    registered.set(path, r);
+    if (!didProcessBeforeExitHook) {
+        didProcessBeforeExitHook = true;
+        process.on('beforeExit', handleBeforeExit);
+    }
+};
+const handleBeforeExit = () => {
+    for (const [path, r] of registered) {
+        /* c8 ignore next */
+        if (!r.size)
+            return;
+        const env = { ...process.env };
+        const args = [];
+        /* c8 ignore start */
+        // When compiled the script to be run is passed as an
+        // environment variable and then routed by the main entry point
+        if (process.env.__VLT_INTERNAL_COMPILED) {
+            env.__VLT_INTERNAL_MAIN = pathToFileURL(__CODE_SPLIT_SCRIPT_NAME).toString();
+            args.push(path);
+        }
+        else {
+            // If we are running deno from source we need to add the
+            // unstable flags we need. The '-A' flag does not need
+            // to be passed in as Deno supplies that automatically.
+            if (isDeno) {
+                args.push('--unstable-node-globals', '--unstable-bare-node-builtins');
+            }
+            /* c8 ignore stop */
+            args.push(__CODE_SPLIT_SCRIPT_NAME, path);
+        }
+        registered.delete(path);
+        // Deno on Windows does not support detached processes
+        // https://github.com/denoland/deno/issues/25867
+        // TODO: figure out something better to do here?
+        /* c8 ignore next */
+        const detached = !(isDeno && process.platform === 'win32');
+        const proc = spawn(process.execPath, args, {
+            detached,
+            stdio: ['pipe', 'ignore', 'ignore'],
+            env,
+        });
+        for (const key of r) {
+            proc.stdin.write(`${key}\0`);
+        }
+        proc.stdin.end();
+        // Another Deno oddity. Calling unref on a spawned process will kill the
+        // process unless it is detached. https://github.com/denoland/deno/issues/21446
+        // So in this case Deno on Windows will be slower to exit the main process
+        // since it will wait for the child process to exit.
+        // TODO: figure out something better to do here?
+        if (detached) {
+            proc.unref();
+        }
+    }
+};
+//# sourceMappingURL=cache-revalidate.js.map

package/dist/esm/cache-revalidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-revalidate.js","sourceRoot":"","sources":["../../src/cache-revalidate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,MAAM,GACT,UAAiD,CAAC,IAAI,IAAI,SAAS,CAAA;AAEtE,IAAI,wBAAwB,GAAG,KAAK,CAAA;AACpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAA;AAEjD,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,IAAY,EACZ,MAAsB,EACtB,GAAiB,EACX,EAAE;IACR,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAA;IACnD,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAA;IAC9B,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACV,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACvB,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,wBAAwB,GAAG,IAAI,CAAA;QAC/B,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,GAAG,EAAE;IAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;QACnC,oBAAoB;QACpB,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,OAAM;QACnB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAC9B,MAAM,IAAI,GAAG,EAAE,CAAA;QACf,qBAAqB;QACrB,qDAAqD;QACrD,+DAA+D;QAC/D,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC;YACxC,GAAG,CAAC,mBAAmB,GAAG,aAAa,CACrC,wBAAwB,CACzB,CAAC,QAAQ,EAAE,CAAA;YACZ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjB,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,sDAAsD;YACtD,uDAAuD;YACvD,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,IAAI,CACP,yBAAyB,EACzB,+BAA+B,CAChC,CAAA;YACH,CAAC;YACD,oBAAoB;YACpB,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAA;QAC3C,CAAC;QACD,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACvB,sDAAsD;QACtD,gDAAgD;QAChD,gDAAgD;QAChD,oBAAoB;QACpB,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAA;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YACzC,QAAQ;YACR,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;YACnC,GAAG;SACJ,CAAC,CAAA;QACF,KAAK,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;QAC9B,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;QAChB,wEAAwE;QACxE,+EAA+E;QAC/E,0EAA0E;QAC1E,oDAAoD;QACpD,gDAAgD;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,EAAE,CAAA;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAA","sourcesContent":["import { spawn } from 'node:child_process'\nimport { __CODE_SPLIT_SCRIPT_NAME } from './revalidate.ts'\nimport { pathToFileURL } from 'node:url'\n\nconst isDeno =\n  (globalThis as typeof globalThis & { Deno?: any }).Deno != undefined\n\nlet didProcessBeforeExitHook = false\nconst registered = new Map<string, Set<string>>()\n\nexport const register = (\n  path: string,\n  method: 'HEAD' | 'GET',\n  url: string | URL,\n): void => {\n  const r = registered.get(path) ?? new Set<string>()\n  const key = `${method} ${url}`\n  r.add(key)\n  registered.set(path, r)\n  if (!didProcessBeforeExitHook) {\n    didProcessBeforeExitHook = true\n    process.on('beforeExit', handleBeforeExit)\n  }\n}\n\nconst handleBeforeExit = () => {\n  for (const [path, r] of registered) {\n    /* c8 ignore next */\n    if (!r.size) return\n    const env = { ...process.env }\n    const args = []\n    /* c8 ignore start */\n    // When compiled the script to be run is passed as an\n    // environment variable and then routed by the main entry point\n    if (process.env.__VLT_INTERNAL_COMPILED) {\n      env.__VLT_INTERNAL_MAIN = pathToFileURL(\n        __CODE_SPLIT_SCRIPT_NAME,\n      ).toString()\n      args.push(path)\n    } else {\n      // If we are running deno from source we need to add the\n      // unstable flags we need. The '-A' flag does not need\n      // to be passed in as Deno supplies that automatically.\n      if (isDeno) {\n        args.push(\n          '--unstable-node-globals',\n          '--unstable-bare-node-builtins',\n        )\n      }\n      /* c8 ignore stop */\n      args.push(__CODE_SPLIT_SCRIPT_NAME, path)\n    }\n    registered.delete(path)\n    // Deno on Windows does not support detached processes\n    // https://github.com/denoland/deno/issues/25867\n    // TODO: figure out something better to do here?\n    /* c8 ignore next */\n    const detached = !(isDeno && process.platform === 'win32')\n    const proc = spawn(process.execPath, args, {\n      detached,\n      stdio: ['pipe', 'ignore', 'ignore'],\n      env,\n    })\n    for (const key of r) {\n      proc.stdin.write(`${key}\\0`)\n    }\n    proc.stdin.end()\n    // Another Deno oddity. Calling unref on a spawned process will kill the\n    // process unless it is detached. https://github.com/denoland/deno/issues/21446\n    // So in this case Deno on Windows will be slower to exit the main process\n    // since it will wait for the child process to exit.\n    // TODO: figure out something better to do here?\n    if (detached) {\n      proc.unref()\n    }\n  }\n}\n"]}

package/dist/esm/handle-304-response.js

@@ -2,7 +2,7 @@ export const handle304Response = (resp, entry) => {
     if (resp.statusCode !== 304 || !entry)
         return false;
     const d = String(resp.headers.date ?? '') || new Date().toUTCString();
-    entry.setHeader('date', Buffer.from(d));
+    entry.setHeader('date', d);
     // shouldn't have a body, but just in case.
     resp.body.resume();
     return true;

package/dist/esm/handle-304-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle-304-response.js","sourceRoot":"","sources":["../../src/handle-304-response.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAA6B,EAC7B,KAAkB,EACG,EAAE;IACvB,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAEnD,MAAM,CAAC,GACL,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC7D,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,2CAA2C;IAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAClB,OAAO,IAAI,CAAA;AACb,CAAC,CAAA","sourcesContent":["import type { Dispatcher } from 'undici'\nimport type { CacheEntry } from './cache-entry.ts'\n\nexport const handle304Response = (\n  resp: Dispatcher.ResponseData,\n  entry?: CacheEntry,\n): entry is CacheEntry => {\n  if (resp.statusCode !== 304 || !entry) return false\n\n  const d =\n    String(resp.headers.date ?? '') || new Date().toUTCString()\n  entry.setHeader('date', Buffer.from(d))\n  // shouldn't have a body, but just in case.\n  resp.body.resume()\n  return true\n}\n"]}
+{"version":3,"file":"handle-304-response.js","sourceRoot":"","sources":["../../src/handle-304-response.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAA6B,EAC7B,KAAkB,EACG,EAAE;IACvB,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAEnD,MAAM,CAAC,GACL,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC7D,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1B,2CAA2C;IAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAClB,OAAO,IAAI,CAAA;AACb,CAAC,CAAA","sourcesContent":["import type { Dispatcher } from 'undici'\nimport type { CacheEntry } from './cache-entry.ts'\n\nexport const handle304Response = (\n  resp: Dispatcher.ResponseData,\n  entry?: CacheEntry,\n): entry is CacheEntry => {\n  if (resp.statusCode !== 304 || !entry) return false\n\n  const d =\n    String(resp.headers.date ?? '') || new Date().toUTCString()\n  entry.setHeader('date', d)\n  // shouldn't have a body, but just in case.\n  resp.body.resume()\n  return true\n}\n"]}

package/dist/esm/index.d.ts

@@ -1,19 +1,21 @@
 import { Cache } from '@vltpkg/cache';
 import type { Integrity } from '@vltpkg/types';
-import { RetryAgent } from 'undici';
 import type { Dispatcher } from 'undici';
-import { deleteToken, getKC, isToken, keychains, setToken } from './auth.ts';
+import { RetryAgent } from 'undici';
 import type { Token } from './auth.ts';
-import { CacheEntry } from './cache-entry.ts';
+import { deleteToken, getKC, isToken, keychains, setToken } from './auth.ts';
 import type { JSONObj } from './cache-entry.ts';
+import { CacheEntry } from './cache-entry.ts';
 import type { TokenResponse } from './token-response.ts';
 import type { WebAuthChallenge } from './web-auth-challenge.ts';
-export { type JSONObj, type CacheEntry, type Token, type WebAuthChallenge, type TokenResponse, };
-export { keychains, getKC, setToken, deleteToken, isToken };
+export { CacheEntry, deleteToken, getKC, isToken, keychains, setToken, type JSONObj, type Token, type TokenResponse, type WebAuthChallenge, };
+export type CacheableMethod = 'GET' | 'HEAD';
+export declare const isCacheableMethod: (m: unknown) => m is CacheableMethod;
 export type RegistryClientOptions = {
     /**
      * Path on disk where the cache should be stored
-     * @default `$HOME/.config/vlt/cache`
+     *
+     * Defaults to the XDG cache folder for `vlt/registry-client`
      */
     cache?: string;
     /**
@@ -29,6 +31,22 @@ export type RegistryClientOptions = {
     'fetch-retry-maxtimeout'?: number;
     /** the identity to use for storing auth tokens */
     identity?: string;
+    /**
+     * If the server does not serve a `stale-while-revalidate` value in the
+     * `cache-control` header, then this multiplier is applied to the `max-age`
+     * or `s-maxage` values.
+     *
+     * By default, this is `60`, so for example a response that is cacheable for
+     * 5 minutes will allow a stale response while revalidating for up to 5
+     * hours.
+     *
+     * If the server *does* provide a `stale-while-revalidate` value, then that
+     * is always used.
+     *
+     * Set to 0 to prevent any `stale-while-revalidate` behavior unless
+     * explicitly allowed by the server's `cache-control` header.
+     */
+    'stale-while-revalidate-factor'?: number;
 };
 export type RegistryClientRequestOptions = Omit<Dispatcher.RequestOptions, 'method' | 'path'> & {
     /**
@@ -49,6 +67,12 @@ export type RegistryClientRequestOptions = Omit<Dispatcher.RequestOptions, 'meth
      * the local disk cache, items are assumed to be trustworthy.
      */
     integrity?: Integrity;
+    /**
+     * Set to true if the integrity should be trusted implicitly without
+     * a recalculation, for example if it comes from a trusted registry that
+     * also serves the tarball itself.
+     */
+    trustIntegrity?: boolean;
     /**
      * Follow up to 10 redirections by default. Set this to 0 to just return
      * the 3xx response. If the max redirections are expired, and we still get
@@ -66,7 +90,7 @@ export type RegistryClientRequestOptions = Omit<Dispatcher.RequestOptions, 'meth
      * Set to `false` to suppress ANY lookups from cache. This will also
      * prevent storing the result to the cache.
      */
-    cache?: false;
+    useCache?: false;
     /**
      * Set to pass an `npm-otp` header on the request.
      *
@@ -75,6 +99,12 @@ export type RegistryClientRequestOptions = Omit<Dispatcher.RequestOptions, 'meth
      * @internal
      */
     otp?: string;
+    /**
+     * Set to false to explicitly prevent `stale-while-revalidate` behavior,
+     * for use in revalidating while stale.
+     * @internal
+     */
+    staleWhileRevalidate?: false;
 };
 export declare const userAgent: string;
 export declare class RegistryClient {
@@ -82,6 +112,7 @@ export declare class RegistryClient {
     agent: RetryAgent;
     cache: Cache;
     identity: string;
+    staleWhileRevalidateFactor: number;
     constructor(options: RegistryClientOptions);
     /**
      * Fetch the entire set of a paginated list of objects
@@ -104,10 +135,10 @@ export declare class RegistryClient {
      */
     login(registry: string): Promise<void>;
     /**
-     * Given a {@link WebAuthChallenge}, open the `loginUrl` in a browser and
+     * Given a {@link WebAuthChallenge}, open the `authUrl` in a browser and
      * hang on the `doneUrl` until it returns a {@link TokenResponse} object.
      */
-    webAuthOpener({ doneUrl, loginUrl }: WebAuthChallenge): Promise<TokenResponse>;
+    webAuthOpener({ doneUrl, authUrl }: WebAuthChallenge): Promise<TokenResponse>;
     request(url: URL | string, options?: RegistryClientRequestOptions): Promise<CacheEntry>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}