@zxncij2390/monorepo3 3.18.0

package/docs/logging/index.md

@@ -0,0 +1,262 @@
+# @pnp/logging
+
+[![npm version](https://badge.fury.io/js/%40pnp%2Flogging.svg)](https://badge.fury.io/js/%40pnp%2Flogging)
+
+The logging module provides light weight subscribable and extensible logging framework which is used internally and available for use in your projects. This article outlines how to setup logging and use the various loggers.
+
+## Getting Started
+
+Install the logging module, it has no other dependencies
+
+`npm install @pnp/logging --save`
+
+## Understanding the Logging Framework
+
+The logging framework is centered on the Logger class to which any number of listeners can be subscribed. Each of these listeners will receive each of the messages logged. Each listener must implement the _ILogListener_ interface, shown below. There is only one method to implement and it takes an instance of the LogEntry interface as a parameter.
+
+```TypeScript
+/**
+ * Interface that defines a log listener
+ *
+ */
+export interface ILogListener {
+    /**
+     * Any associated data that a given logging listener may choose to log or ignore
+     *
+     * @param entry The information to be logged
+     */
+    log(entry: ILogEntry): void;
+}
+
+/**
+ * Interface that defines a log entry
+ *
+ */
+export interface ILogEntry {
+    /**
+     * The main message to be logged
+     */
+    message: string;
+    /**
+     * The level of information this message represents
+     */
+    level: LogLevel;
+    /**
+     * Any associated data that a given logging listener may choose to log or ignore
+     */
+    data?: any;
+}
+```
+
+### Log Levels
+
+```TypeScript
+export const enum LogLevel {
+    Verbose = 0,
+    Info = 1,
+    Warning = 2,
+    Error = 3,
+    Off = 99,
+}
+```
+
+## Writing to the Logger
+
+To write information to a logger you can use either write, writeJSON, or log.
+
+```TypeScript
+import {
+    Logger,
+    LogLevel
+} from "@pnp/logging";
+
+// write logs a simple string as the message value of the LogEntry
+Logger.write("This is logging a simple string");
+
+// optionally passing a level, default level is Verbose
+Logger.write("This is logging a simple string", LogLevel.Error);
+
+// this will convert the object to a string using JSON.stringify and set the message with the result
+Logger.writeJSON({ name: "value", name2: "value2"});
+
+// optionally passing a level, default level is Verbose
+Logger.writeJSON({ name: "value", name2: "value2"}, LogLevel.Warning);
+
+// specify the entire LogEntry interface using log
+Logger.log({
+    data: { name: "value", name2: "value2"},
+    level: LogLevel.Warning,
+    message: "This is my message"
+});
+```
+
+## Log an error
+
+There exists a shortcut method to log an error to the Logger. This will log an entry to the subscribed loggers where the data property will be the Error
+instance passed in, the level will be 'Error', and the message will be the Error instance's message property.
+
+```TypeScript
+const e = Error("An Error");
+
+Logger.error(e);
+```
+
+## Subscribing a Listener
+
+By default no listeners are subscribed, so if you would like to get logging information you need to subscribe at least one listener. This is done as shown below by importing the Logger and your listener(s) of choice. Here we are using the provided ConsoleListener. We are also setting the active log level, which controls the level of logging that will be output. Be aware that Verbose produces a substantial amount of data about each request.
+
+```TypeScript
+import {
+    Logger,
+    ConsoleListener,
+    LogLevel
+} from "@pnp/logging";
+
+// subscribe a listener
+Logger.subscribe(ConsoleListener());
+
+// set the active log level
+Logger.activeLogLevel = LogLevel.Info;
+```
+
+## Available Listeners
+
+There are two listeners included in the library, ConsoleListener and FunctionListener.
+
+### ConsoleListener
+
+This listener outputs information to the console and works in Node as well as within browsers. It can be used without settings and writes to the appropriate console method based on message level. For example a LogEntry with level Warning will be written to console.warn. Basic usage is shown in the example above.
+
+#### Configuration Options
+
+Although ConsoleListener can be used without configuration, there are some additional options available to you. ConsoleListener supports adding a prefix to every output (helpful for filtering console messages) and specifying text color for messages (including by LogLevel).
+
+##### Using a Prefix
+
+To add a prefix to all output, supply a string in the constructor:
+
+```TypeScript
+import {
+    Logger,
+    ConsoleListener,
+    LogLevel
+} from "@pnp/logging";
+
+const LOG_SOURCE: string = 'MyAwesomeWebPart';
+Logger.subscribe(ConsoleListener(LOG_SOURCE));
+Logger.activeLogLevel = LogLevel.Info;
+```
+
+With the above configuration, `Logger.write("My special message");` will be output to the console as:
+```
+MyAwesomeWebPart - My special message
+```
+
+##### Customizing Text Color
+
+You can also specify text color for your messages by supplying an `IConsoleListenerColors` object. You can simply specify `color` to set the default color for all logging levels or you can set one or more logging level specific text colors (if you only want to set color for a specific logging level(s), leave `color` out and all other log levels will use the default color).
+
+Colors can be specified the same way [color values are specified in CSS](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value) (named colors, hex values, rgb, rgba, hsl, hsla, etc.):
+
+```TypeScript
+import {
+    Logger,
+    ConsoleListener,
+    LogLevel
+} from "@pnp/logging";
+
+const LOG_SOURCE: string = 'MyAwesomeWebPart';
+Logger.subscribe(ConsoleListener(LOG_SOURCE, {color:'#0b6a0b',warningColor:'magenta'}));
+Logger.activeLogLevel = LogLevel.Info;
+```
+
+With the above configuration:
+
+```TypeScript
+Logger.write("My special message");
+Logger.write("A warning!", LogLevel.Warning);
+```
+
+Will result in messages that look like this:
+
+![ConsoleListener with Colors](../img/ConsoleListenerColors.png)
+
+Color options:
+
+- `color`: Default text color for all logging levels unless they're specified
+- `verboseColor`: Text color to use for messages with LogLevel.Verbose
+- `infoColor`: Text color to use for messages with LogLevel.Info
+- `warningColor`: Text color to use for messages with LogLevel.Warning
+- `errorColor`: Text color to use for messages with LogLevel.Error
+
+To set colors without a prefix, specify either `undefined` or an empty string for the first parameter:
+
+```TypeScript
+Logger.subscribe(ConsoleListener(undefined, {color:'purple'}));
+```
+
+### FunctionListener
+
+The FunctionListener allows you to wrap any functionality by creating a function that takes a LogEntry as its single argument. This produces the same result as implementing the LogListener interface, but is useful if you already have a logging method or framework to which you want to pass the messages.
+
+```TypeScript
+import {
+    Logger,
+    FunctionListener,
+    ILogEntry
+} from "@pnp/logging";
+
+let listener = new FunctionListener((entry: ILogEntry) => {
+
+    // pass all logging data to an existing framework
+    MyExistingCompanyLoggingFramework.log(entry.message);
+});
+
+Logger.subscribe(listener);
+```
+
+### Create a Custom Listener
+
+If desirable for your project you can create a custom listener to perform any logging action you would like. This is done by implementing the ILogListener interface.
+
+```TypeScript
+import {
+    Logger,
+    ILogListener,
+    ILogEntry
+} from "@pnp/logging";
+
+class MyListener implements ILogListener {
+
+    log(entry: ILogEntry): void {
+        // here you would do something with the entry
+    }
+}
+
+Logger.subscribe(new MyListener());
+```
+
+## Logging Behavior
+
+To allow seamless logging with v3 we have introduced the `PnPLogging` behavior. It takes a single augument representing the log level of _that behavior_, allowing you to be very selective in what logging you want to get. As well the log level applied here ignores any global level set with `activeLogLevel` on Logger.
+
+```TypeScript
+import { LogLevel, PnPLogging, Logger, ConsoleListener } from "@pnp/logging";
+import { spfi, SPFx } from "@pnp/sp";
+import "@pnp/sp/webs";
+import "@pnp/sp/lists";
+
+// subscribe a listener
+Logger.subscribe(ConsoleListener());
+
+// at the root we only want to log errors, which will be sent to all subscribed loggers on Logger
+const sp = spfi().using(SPFx(this.context), PnPLogging(LogLevel.Error));
+
+
+const list = sp.web.lists.getByTitle("My List");
+// use verbose logging with this particular list because you are trying to debug something
+list.using(PnPLogging(LogLevel.Verbose));
+
+const listData = await list();
+```
+

package/docs/msaljsclient/index.md

@@ -0,0 +1,33 @@
+# @pnp/msaljsclient
+
+This library provides a thin wrapper around the [msal](https://github.com/AzureAD/microsoft-authentication-library-for-js) library to make it easy to integrate MSAL authentication in the browser.
+
+You will first need to install the package:
+
+`npm install @pnp/msaljsclient --save`
+
+The configuration and authParams
+
+```TypeScript
+import { spfi, SPBrowser } from "@pnp/sp";
+import { MSAL } from "@pnp/msaljsclient";
+import "@pnp/sp/webs";
+
+const configuation = {
+    auth: {
+        authority: "https://login.microsoftonline.com/common",
+        clientId: "{client id}",
+    }
+};
+
+const authParams = {
+    scopes: ["https://{tenant}.sharepoint.com/.default"],
+};
+
+const sp = spfi("https://tenant.sharepoint.com/sites/dev").using(SPBrowser(), MSAL(configuration, authParams));
+
+const webData = await sp.web();
+```
+
+Please see more scenarios in the [authentication article](../concepts/authentication.md).
+

package/docs/news/2020-year-in-review.md

@@ -0,0 +1,162 @@
+# 2020 Year End Report
+
+Welcome to our first year in review report for PnPjs. This year has marked usage milestones, seen more contributors than ever, and expanded the core maintainers team. But none of this would be possible without everyones support and participation - so we start by saying Thank You! We deeply appreciate everyone that has used, helped us grow, and improved the library over the last year.
+
+This year we introduced MSAL clients for node and browser, improved our testing/local development plumbing, and updated the libraries to work with the node 15 module resolution rules.
+
+We fixed 43 reported bugs, answered 131 questions, and made 55 suggested enhancements to the library - all driven by feedback from users and the community.
+
+Planned for release in January 2021 we also undertook the work to enable isolated runtimes, a long requested feature. This allows you to operate on multiple independently configured "roots" such as "sp" or "graph" from the same application. Previously the library was configured globally, so this opens new possibilities for both client and server side scenarios.
+
+Finally we made many tooling and project improvements such as moving to GitHub actions, updating the tests to use MSAL, and exploring ways to enhance the developer experience.
+
+## Usage
+
+In 2020 we tracked steady month/month growth in raw usage measured by requests as well as in the number of tenants deploying the library. Starting the year we were used in 14605 tenants and by December that number grew to 21,227.
+
+These tenants generated 6.1 billion requests to the service in January growing to 9.2 billion by December, peaking at 10.1 billion requests in November.
+
+![Graph showing requests and tenants/month for @pnp/sp](../img/usage-2020-eoy.png)
+
+> 1) There was a data glitch in October so the numbers do not fully represent usage. 2) These numbers only include public cloud SPO usage, true usage is higher than we can track due to on-premesis and gov/sovereign clouds
+
+## Releases
+
+We continued our monthly release cadence as it represents a good pace for addressing issues while not expecting folks to update too often and keeping each update to a reasonable size. All changes can be tracked in our [change log](https://github.com/pnp/pnpjs/blob/version-2/CHANGELOG.md), updated with each release. You can check our scheduled releases through [project milestones](https://github.com/pnp/pnpjs/milestones), understanding there are occasionally delays. Monthly releases allows us to ensure bugs do not linger and we continually improve and expand the capabilities of the libraries.
+
+### NPM Package download statistics (@pnp/sp):
+
+| Month    | Count   | *   | Month       | Count  |
+| -------- | ------- | --- | ----------- | ------ |
+| January  | 100,686 | *   | July        | 36,805 |
+| February | 34,437  | *   | August      | 38,897 |
+| March    | 34,574  | *   | September   | 45,968 |
+| April    | 32,436  | *   | October     | 46,655 |
+| May      | 34,482  | *   | November    | 45,511 |
+| June     | 34,408  | *   | December    | 58,977 |
+|          |         |     |             |        |
+|          |         |     | Grand Total | 543,836|
+
+With 2020 our total all time downloads of @pnp/sp is now at: 949,638
+
+> Stats from https://npm-stat.com/
+
+## Future Plans
+
+Looking to the future we will continue to actively grow and improve v2 of the library, guided by feedback and reported issues. Additionally, we are beginning to discuss v3 and doing initial planning and prototyping. The v3 work will continue through 2021 with no currently set release date, though we will keep everyone up to date.
+
+Additionally in 2021 there will be a general focus on improving not just the code but our tooling, build pipeline, and library contributor experience. We will also look at automatic canary releases with each merge, and other improvements.
+
+## New Lead Maintainer
+
+With the close of 2020 we are very excited to announce a new lead maintainer for PnPjs, [Julie Turner](https://github.com/juliemturner)! Julie brings deep expertise with SharePoint Framework, TypeScript, and SharePoint development to the team, coupled with dedication and care in the work.
+
+Over the last year she has gotten more involved with handling releases, responding to issues, and helping to keep the code updated and clean.
+
+We are very lucky to have her working on the project and look forward to seeing her lead the growth and direction for years to come.
+
+## Contributors
+
+As always we have abundant thanks and appreciation for your contributors. Taking your time to help improve PnPjs for the community is massive and valuable to ensure our sustainability. Thank you for all your help in 2020! If you are interested in becoming a contributor [check out our guide](../contributing/index.md) on ways to get started.
+
+<a href="https://github.com/AJIXuMuK" style="margin:10px" title=AJIXuMuK>
+    <img src="https://avatars3.githubusercontent.com/u/17036219?v=4" alt="AJIXuMuK" width="50" height="50" />
+</a><a href="https://github.com/Ashikpaul" style="margin:10px" title=Ashikpaul>
+    <img src="https://avatars2.githubusercontent.com/u/17526871?v=4" alt="Ashikpaul" width="50" height="50" />
+</a><a href="https://github.com/cesarhoeflich" style="margin:10px" title=cesarhoeflich>
+    <img src="https://avatars0.githubusercontent.com/u/6339165?v=4" alt="cesarhoeflich" width="50" height="50" />
+</a><a href="https://github.com/dcashpeterson" style="margin:10px" title=dcashpeterson>
+    <img src="https://avatars2.githubusercontent.com/u/45491456?v=4" alt="dcashpeterson" width="50" height="50" />
+</a><a href="https://github.com/apps/dependabot" style="margin:10px" title=dependabot[bot]>
+    <img src="https://avatars0.githubusercontent.com/in/29110?v=4" alt="dependabot[bot]" width="50" height="50" />
+</a><a href="https://github.com/derhallim" style="margin:10px" title=derhallim>
+    <img src="https://avatars1.githubusercontent.com/u/7239963?v=4" alt="derhallim" width="50" height="50" />
+</a><a href="https://github.com/DRamalho92" style="margin:10px" title=DRamalho92>
+    <img src="https://avatars1.githubusercontent.com/u/40799678?v=4" alt="DRamalho92" width="50" height="50" />
+</a><a href="https://github.com/f1nzer" style="margin:10px" title=f1nzer>
+    <img src="https://avatars3.githubusercontent.com/u/1970236?v=4" alt="f1nzer" width="50" height="50" />
+</a><a href="https://github.com/Harshagracy" style="margin:10px" title=Harshagracy>
+    <img src="https://avatars3.githubusercontent.com/u/14230498?v=4" alt="Harshagracy" width="50" height="50" />
+</a><a href="https://github.com/holylander" style="margin:10px" title=holylander>
+    <img src="https://avatars1.githubusercontent.com/u/2032683?v=4" alt="holylander" width="50" height="50" />
+</a><a href="https://github.com/hugoabernier" style="margin:10px" title=hugoabernier>
+    <img src="https://avatars2.githubusercontent.com/u/13972467?v=4" alt="hugoabernier" width="50" height="50" />
+</a><a href="https://github.com/JakeStanger" style="margin:10px" title=JakeStanger>
+    <img src="https://avatars0.githubusercontent.com/u/5057870?v=4" alt="JakeStanger" width="50" height="50" />
+</a><a href="https://github.com/jaywellings" style="margin:10px" title=jaywellings>
+    <img src="https://avatars2.githubusercontent.com/u/1410735?v=4" alt="jaywellings" width="50" height="50" />
+</a><a href="https://github.com/JMTeamway" style="margin:10px" title=JMTeamway>
+    <img src="https://avatars2.githubusercontent.com/u/42567407?v=4" alt="JMTeamway" width="50" height="50" />
+</a><a href="https://github.com/joelfmrodrigues" style="margin:10px" title=joelfmrodrigues>
+    <img src="https://avatars3.githubusercontent.com/u/19577724?v=4" alt="joelfmrodrigues" width="50" height="50" />
+</a><a href="https://github.com/juliemturner" style="margin:10px" title=juliemturner>
+    <img src="https://avatars0.githubusercontent.com/u/7570936?v=4" alt="juliemturner" width="50" height="50" />
+</a><a href="https://github.com/jusper-dk" style="margin:10px" title=jusper-dk>
+    <img src="https://avatars0.githubusercontent.com/u/27721442?v=4" alt="jusper-dk" width="50" height="50" />
+</a><a href="https://github.com/KEMiCZA" style="margin:10px" title=KEMiCZA>
+    <img src="https://avatars2.githubusercontent.com/u/3862716?v=4" alt="KEMiCZA" width="50" height="50" />
+</a><a href="https://github.com/koltyakov" style="margin:10px" title=koltyakov>
+    <img src="https://avatars2.githubusercontent.com/u/7816483?v=4" alt="koltyakov" width="50" height="50" />
+</a><a href="https://github.com/kunj-sangani" style="margin:10px" title=kunj-sangani>
+    <img src="https://avatars3.githubusercontent.com/u/25693207?v=4" alt="kunj-sangani" width="50" height="50" />
+</a><a href="https://github.com/MarkyDeParky" style="margin:10px" title=MarkyDeParky>
+    <img src="https://avatars1.githubusercontent.com/u/16799069?v=4" alt="MarkyDeParky" width="50" height="50" />
+</a><a href="https://github.com/mikezimm" style="margin:10px" title=mikezimm>
+    <img src="https://avatars1.githubusercontent.com/u/49648086?v=4" alt="mikezimm" width="50" height="50" />
+</a><a href="https://github.com/mrebuffet" style="margin:10px" title=mrebuffet>
+    <img src="https://avatars0.githubusercontent.com/u/3445077?v=4" alt="mrebuffet" width="50" height="50" />
+</a><a href="https://github.com/naugtur" style="margin:10px" title=naugtur>
+    <img src="https://avatars1.githubusercontent.com/u/509375?v=4" alt="naugtur" width="50" height="50" />
+</a><a href="https://github.com/NZainchkovskiy" style="margin:10px" title=NZainchkovskiy>
+    <img src="https://avatars0.githubusercontent.com/u/19357901?v=4" alt="NZainchkovskiy" width="50" height="50" />
+</a><a href="https://github.com/PaoloPia" style="margin:10px" title=PaoloPia>
+    <img src="https://avatars2.githubusercontent.com/u/7582026?v=4" alt="PaoloPia" width="50" height="50" />
+</a><a href="https://github.com/patrick-rodgers" style="margin:10px" title=patrick-rodgers>
+    <img src="https://avatars3.githubusercontent.com/u/13154702?v=4" alt="patrick-rodgers" width="50" height="50" />
+</a><a href="https://github.com/ravichandran-blog" style="margin:10px" title=ravichandran-blog>
+    <img src="https://avatars2.githubusercontent.com/u/21125180?v=4" alt="ravichandran-blog" width="50" height="50" />
+</a><a href="https://github.com/RoelVB" style="margin:10px" title=RoelVB>
+    <img src="https://avatars3.githubusercontent.com/u/10999128?v=4" alt="RoelVB" width="50" height="50" />
+</a><a href="https://github.com/siddharth-vaghasia" style="margin:10px" title=siddharth-vaghasia>
+    <img src="https://avatars0.githubusercontent.com/u/9557557?v=4" alt="siddharth-vaghasia" width="50" height="50" />
+</a><a href="https://github.com/simonagren" style="margin:10px" title=simonagren>
+    <img src="https://avatars0.githubusercontent.com/u/16558321?v=4" alt="simonagren" width="50" height="50" />
+</a><a href="https://github.com/tavikukko" style="margin:10px" title=tavikukko>
+    <img src="https://avatars0.githubusercontent.com/u/2223355?v=4" alt="tavikukko" width="50" height="50" />
+</a><a href="https://github.com/ValerasNarbutas" style="margin:10px" title=ValerasNarbutas>
+    <img src="https://avatars0.githubusercontent.com/u/16476453?v=4" alt="ValerasNarbutas" width="50" height="50" />
+</a>
+
+## Sponsors
+
+We want to thank our sponsors for their support in 2020! This year we put the money towards helping offset the cost and shipping of hoodies to contributors and sponsors. Your continued generosity makes a big difference in our ability to recognize and reward the folks building PnPjs.
+
+**Thank You**
+
+<a href="https://github.com/KEMiCZA" style="margin:20px" title="KEMiCZA">
+    <img src="https://avatars0.githubusercontent.com/u/3862716?v=4" alt="KEMiCZA" width="100" height="100" />
+</a><a href="https://github.com/Sympraxis-Consulting" style="margin:20px" title="Sympraxis Consulting">
+    <img src="https://avatars3.githubusercontent.com/u/19271832?v=4" alt="Sympraxis Consulting" width="100" height="100" />
+</a><a href="https://github.com/thechriskent" style="margin:20px" title="thechriskent">
+    <img src="https://avatars0.githubusercontent.com/u/8364109?v=4" alt="thechriskent" width="100" height="100" />
+</a><a href="https://github.com/erwinvanhunen" style="margin:20px" title="erwinvanhunen">
+    <img src="https://avatars0.githubusercontent.com/u/7666381?v=4" alt="erwinvanhunen" width="100" height="100" />
+</a><a href="https://github.com/PopWarner" style="margin:20px" title="PopWarner">
+    <img src="https://avatars0.githubusercontent.com/u/10676147?v=4" alt="PopWarner" width="100" height="100" />
+</a><a href="https://github.com/VesaJuvonen" style="margin:20px" title="VesaJuvonen">
+    <img src="https://avatars0.githubusercontent.com/u/7446437?v=4" alt="VesaJuvonen" width="100" height="100" />
+</a><a href="https://github.com/LauraKokkarinen" style="margin:20px" title="LauraKokkarinen">
+    <img src="https://avatars0.githubusercontent.com/u/41330990?v=4" alt="LauraKokkarinen" width="100" height="100" />
+</a><a href="https://github.com/ricardocarneiro" style="margin:20px" title="ricardocarneiro">
+    <img src="https://avatars0.githubusercontent.com/u/4666947?v=4" alt="ricardocarneiro" width="100" height="100" />
+</a><a href="https://github.com/andrewconnell" style="margin:20px" title="andrewconnell">
+    <img src="https://avatars0.githubusercontent.com/u/2068657?v=4" alt="andrewconnell" width="100" height="100" />
+</a>
+
+## Closing
+
+In closing we want say _Thank You_ to everyone who uses, contributes to, and participates in PnPjs and the SharePoint Patterns and Practices program.
+
+Wishing you the very best for 2021,
+
+The PnPjs Team

package/docs/news/2021-year-in-review.md

@@ -0,0 +1,148 @@
+# 2021 Year End Report
+
+Welcome to our second year in review report for PnPjs. 2021 found us planning, building, testing, and documenting a whole new version of PnPjs. The goal is to deliver a much improved and flexible experience and none of that would have been possible without the support and participation of everyone in the PnP community - so we start by saying Thank You! We deeply appreciate everyone that has used, helped us grow, and improved the library over the last year.
+
+Because of the huge useage we've seen with the library and issues we found implementing some of the much requested enhancements, we felt we really needed to start from the ground up and rearchitect the library completely. This new design, built on the concept of a "Timeline", enabled us to build a significantly lighter weight solution that is more extensible than ever. And bonus, we were able to keep the overall development experience largly unchanged, so that makes transitioning all that much easier. In addition we took extra effort to validate our development efforts by making sure all our tests passed so that we could better ensure quality of the library. Check out our [Transition Guide](../transition-guide.md) and [ChangeLog](https://github.com/pnp/pnpjs/blob/version-3/CHANGELOG.md) for all the details.
+
+In other news, we fixed 47 reported bugs, answered 89 questions, and made 51 suggested enhancements to version 2 of the library - all driven by feedback from users and the community.
+
+## Usage
+
+In 2021 we transitioned from rapid growth to slower growth but maintaining a request/month rate over 11 billion, approaching 13 billion by the end of the year. These requests came from more than 25 thousand tenants including some of the largest M365 customers. Due to some data cleanup we don't have the full year's information, but the below graph shows the final 7 months of the year.
+
+![Graph showing requests and tenants/month for @pnp/sp](../img/usage-2021-eoy.png)
+
+## Releases
+
+We continued our monthly release cadence as it represents a good pace for addressing issues while not expecting folks to update too often and keeping each update to a reasonable size. All changes can be tracked in our [change log](https://github.com/pnp/pnpjs/blob/main/CHANGELOG.md), updated with each release. You can check our scheduled releases through [project milestones](https://github.com/pnp/pnpjs/milestones), understanding there are occasionally delays. Monthly releases allows us to ensure bugs do not linger and we continually improve and expand the capabilities of the libraries.
+
+### NPM Package download statistics (@pnp/sp)
+
+| Month    | Count   | *   | Month       | Count  |
+| -------- | ------- | --- | ----------- | ------ |
+| January  | 49,446  | *   | July        | 73,491 |
+| February | 56,054  | *   | August      | 74,236 |
+| March    | 66,113  | *   | September   | 69,179 |
+| April    | 58,526  | *   | October     | 77,645 |
+| May      | 62,747  | *   | November    | 74,966 |
+| June     | 69,349  | *   | December    | 61,995 |
+|          |         |     |             |        |
+|          |         |     | Grand Total | 793,747|
+
+For comparison our total downloads in 2020 was 543,836.
+
+With 2021 our total all time downloads of @pnp/sp is now at: 1,743,385
+
+In 2020 the all time total was 949,638.
+
+> Stats from <https://npm-stat.com/>
+
+## Future Plans
+
+Looking to the future we will continue to actively grow and improve v3 of the library, guided by feedback and reported issues. Additionally, we are looking to expand our contributions documentation to make it easier for community members to contibute their ideas and updates to the library.
+
+## Contributors
+
+As always we have abundant thanks and appreciation for your contributors. Taking your time to help improve PnPjs for the community is massive and valuable to ensure our sustainability. Thank you for all your help in 2020! If you are interested in becoming a contributor [check out our guide](../contributing/index.md) on ways to get started.
+
+<a href="https://github.com/AJIXuMuK" style="margin:10px" title=AJIXuMuK>
+    <img src="https://avatars3.githubusercontent.com/u/17036219?v=4" alt="AJIXuMuK" width="50" height="50" />
+</a><a href="https://github.com/Ashikpaul" style="margin:10px" title=Ashikpaul>
+    <img src="https://avatars2.githubusercontent.com/u/17526871?v=4" alt="Ashikpaul" width="50" height="50" />
+</a><a href="https://github.com/cesarhoeflich" style="margin:10px" title=cesarhoeflich>
+    <img src="https://avatars0.githubusercontent.com/u/6339165?v=4" alt="cesarhoeflich" width="50" height="50" />
+</a><a href="https://github.com/dcashpeterson" style="margin:10px" title=dcashpeterson>
+    <img src="https://avatars2.githubusercontent.com/u/45491456?v=4" alt="dcashpeterson" width="50" height="50" />
+</a><a href="https://github.com/apps/dependabot" style="margin:10px" title=dependabot[bot]>
+    <img src="https://avatars0.githubusercontent.com/in/29110?v=4" alt="dependabot[bot]" width="50" height="50" />
+</a><a href="https://github.com/derhallim" style="margin:10px" title=derhallim>
+    <img src="https://avatars1.githubusercontent.com/u/7239963?v=4" alt="derhallim" width="50" height="50" />
+</a><a href="https://github.com/DRamalho92" style="margin:10px" title=DRamalho92>
+    <img src="https://avatars1.githubusercontent.com/u/40799678?v=4" alt="DRamalho92" width="50" height="50" />
+</a><a href="https://github.com/f1nzer" style="margin:10px" title=f1nzer>
+    <img src="https://avatars3.githubusercontent.com/u/1970236?v=4" alt="f1nzer" width="50" height="50" />
+</a><a href="https://github.com/Harshagracy" style="margin:10px" title=Harshagracy>
+    <img src="https://avatars3.githubusercontent.com/u/14230498?v=4" alt="Harshagracy" width="50" height="50" />
+</a><a href="https://github.com/holylander" style="margin:10px" title=holylander>
+    <img src="https://avatars1.githubusercontent.com/u/2032683?v=4" alt="holylander" width="50" height="50" />
+</a><a href="https://github.com/hugoabernier" style="margin:10px" title=hugoabernier>
+    <img src="https://avatars2.githubusercontent.com/u/13972467?v=4" alt="hugoabernier" width="50" height="50" />
+</a><a href="https://github.com/JakeStanger" style="margin:10px" title=JakeStanger>
+    <img src="https://avatars0.githubusercontent.com/u/5057870?v=4" alt="JakeStanger" width="50" height="50" />
+</a><a href="https://github.com/jaywellings" style="margin:10px" title=jaywellings>
+    <img src="https://avatars2.githubusercontent.com/u/1410735?v=4" alt="jaywellings" width="50" height="50" />
+</a><a href="https://github.com/JMTeamway" style="margin:10px" title=JMTeamway>
+    <img src="https://avatars2.githubusercontent.com/u/42567407?v=4" alt="JMTeamway" width="50" height="50" />
+</a><a href="https://github.com/joelfmrodrigues" style="margin:10px" title=joelfmrodrigues>
+    <img src="https://avatars3.githubusercontent.com/u/19577724?v=4" alt="joelfmrodrigues" width="50" height="50" />
+</a><a href="https://github.com/juliemturner" style="margin:10px" title=juliemturner>
+    <img src="https://avatars0.githubusercontent.com/u/7570936?v=4" alt="juliemturner" width="50" height="50" />
+</a><a href="https://github.com/jusper-dk" style="margin:10px" title=jusper-dk>
+    <img src="https://avatars0.githubusercontent.com/u/27721442?v=4" alt="jusper-dk" width="50" height="50" />
+</a><a href="https://github.com/KEMiCZA" style="margin:10px" title=KEMiCZA>
+    <img src="https://avatars2.githubusercontent.com/u/3862716?v=4" alt="KEMiCZA" width="50" height="50" />
+</a><a href="https://github.com/koltyakov" style="margin:10px" title=koltyakov>
+    <img src="https://avatars2.githubusercontent.com/u/7816483?v=4" alt="koltyakov" width="50" height="50" />
+</a><a href="https://github.com/kunj-sangani" style="margin:10px" title=kunj-sangani>
+    <img src="https://avatars3.githubusercontent.com/u/25693207?v=4" alt="kunj-sangani" width="50" height="50" />
+</a><a href="https://github.com/MarkyDeParky" style="margin:10px" title=MarkyDeParky>
+    <img src="https://avatars1.githubusercontent.com/u/16799069?v=4" alt="MarkyDeParky" width="50" height="50" />
+</a><a href="https://github.com/mikezimm" style="margin:10px" title=mikezimm>
+    <img src="https://avatars1.githubusercontent.com/u/49648086?v=4" alt="mikezimm" width="50" height="50" />
+</a><a href="https://github.com/mrebuffet" style="margin:10px" title=mrebuffet>
+    <img src="https://avatars0.githubusercontent.com/u/3445077?v=4" alt="mrebuffet" width="50" height="50" />
+</a><a href="https://github.com/naugtur" style="margin:10px" title=naugtur>
+    <img src="https://avatars1.githubusercontent.com/u/509375?v=4" alt="naugtur" width="50" height="50" />
+</a><a href="https://github.com/NZainchkovskiy" style="margin:10px" title=NZainchkovskiy>
+    <img src="https://avatars0.githubusercontent.com/u/19357901?v=4" alt="NZainchkovskiy" width="50" height="50" />
+</a><a href="https://github.com/PaoloPia" style="margin:10px" title=PaoloPia>
+    <img src="https://avatars2.githubusercontent.com/u/7582026?v=4" alt="PaoloPia" width="50" height="50" />
+</a><a href="https://github.com/patrick-rodgers" style="margin:10px" title=patrick-rodgers>
+    <img src="https://avatars3.githubusercontent.com/u/13154702?v=4" alt="patrick-rodgers" width="50" height="50" />
+</a><a href="https://github.com/ravichandran-blog" style="margin:10px" title=ravichandran-blog>
+    <img src="https://avatars2.githubusercontent.com/u/21125180?v=4" alt="ravichandran-blog" width="50" height="50" />
+</a><a href="https://github.com/RoelVB" style="margin:10px" title=RoelVB>
+    <img src="https://avatars3.githubusercontent.com/u/10999128?v=4" alt="RoelVB" width="50" height="50" />
+</a><a href="https://github.com/siddharth-vaghasia" style="margin:10px" title=siddharth-vaghasia>
+    <img src="https://avatars0.githubusercontent.com/u/9557557?v=4" alt="siddharth-vaghasia" width="50" height="50" />
+</a><a href="https://github.com/simonagren" style="margin:10px" title=simonagren>
+    <img src="https://avatars0.githubusercontent.com/u/16558321?v=4" alt="simonagren" width="50" height="50" />
+</a><a href="https://github.com/tavikukko" style="margin:10px" title=tavikukko>
+    <img src="https://avatars0.githubusercontent.com/u/2223355?v=4" alt="tavikukko" width="50" height="50" />
+</a><a href="https://github.com/ValerasNarbutas" style="margin:10px" title=ValerasNarbutas>
+    <img src="https://avatars0.githubusercontent.com/u/16476453?v=4" alt="ValerasNarbutas" width="50" height="50" />
+</a>
+
+## Sponsors
+
+We want to thank our sponsors for their support in 2020! This year we put the money towards helping offset the cost and shipping of hoodies to contributors and sponsors. Your continued generosity makes a big difference in our ability to recognize and reward the folks building PnPjs.
+
+**Thank You**
+
+<a href="https://github.com/KEMiCZA" style="margin:20px" title="KEMiCZA">
+    <img src="https://avatars0.githubusercontent.com/u/3862716?v=4" alt="KEMiCZA" width="100" height="100" />
+</a><a href="https://github.com/Sympraxis-Consulting" style="margin:20px" title="Sympraxis Consulting">
+    <img src="https://avatars3.githubusercontent.com/u/19271832?v=4" alt="Sympraxis Consulting" width="100" height="100" />
+</a><a href="https://github.com/thechriskent" style="margin:20px" title="thechriskent">
+    <img src="https://avatars0.githubusercontent.com/u/8364109?v=4" alt="thechriskent" width="100" height="100" />
+</a><a href="https://github.com/erwinvanhunen" style="margin:20px" title="erwinvanhunen">
+    <img src="https://avatars0.githubusercontent.com/u/7666381?v=4" alt="erwinvanhunen" width="100" height="100" />
+</a><a href="https://github.com/PopWarner" style="margin:20px" title="PopWarner">
+    <img src="https://avatars0.githubusercontent.com/u/10676147?v=4" alt="PopWarner" width="100" height="100" />
+</a><a href="https://github.com/VesaJuvonen" style="margin:20px" title="VesaJuvonen">
+    <img src="https://avatars0.githubusercontent.com/u/7446437?v=4" alt="VesaJuvonen" width="100" height="100" />
+</a><a href="https://github.com/LauraKokkarinen" style="margin:20px" title="LauraKokkarinen">
+    <img src="https://avatars0.githubusercontent.com/u/41330990?v=4" alt="LauraKokkarinen" width="100" height="100" />
+</a><a href="https://github.com/ricardocarneiro" style="margin:20px" title="ricardocarneiro">
+    <img src="https://avatars0.githubusercontent.com/u/4666947?v=4" alt="ricardocarneiro" width="100" height="100" />
+</a><a href="https://github.com/andrewconnell" style="margin:20px" title="andrewconnell">
+    <img src="https://avatars0.githubusercontent.com/u/2068657?v=4" alt="andrewconnell" width="100" height="100" />
+</a>
+
+## Closing
+
+In closing we want say _Thank You_ to everyone who uses, contributes to, and participates in PnPjs and the SharePoint Patterns and Practices program.
+
+Wishing you the very best for 2022,
+
+The PnPjs Team