@pnp/logging 2.10.0 → 2.13.0

package/LICENSE

@@ -1,25 +1,25 @@
-SharePoint Patterns and Practices (PnP)
-
-The MIT License (MIT)
-
-Copyright (c) Microsoft Corporation
-
-All rights reserved.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SharePoint Patterns and Practices (PnP)
+
+The MIT License (MIT)
+
+Copyright (c) Microsoft Corporation
+
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./logger.js";
-export * from "./listeners.js";
+export * from "./logger.js";
+export * from "./listeners.js";
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,3 +1,3 @@
-export * from "./logger.js";
-export * from "./listeners.js";
+export * from "./logger.js";
+export * from "./listeners.js";
 //# sourceMappingURL=index.js.map

package/listeners.d.ts

@@ -1,40 +1,40 @@
-import { ILogEntry, ILogListener } from "./logger.js";
-/**
- * Implementation of LogListener which logs to the console
- *
- */
-export declare class ConsoleListener implements 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;
-    /**
-     * Formats the message
-     *
-     * @param entry The information to format into a string
-     */
-    private format;
-}
-/**
- * Implementation of LogListener which logs to the supplied function
- *
- */
-export declare class FunctionListener implements ILogListener {
-    private method;
-    /**
-     * Creates a new instance of the FunctionListener class
-     *
-     * @constructor
-     * @param  method The method to which any logging data will be passed
-     */
-    constructor(method: (entry: ILogEntry) => void);
-    /**
-     * 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;
-}
+import { ILogEntry, ILogListener } from "./logger.js";
+/**
+ * Implementation of LogListener which logs to the console
+ *
+ */
+export declare class ConsoleListener implements 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;
+    /**
+     * Formats the message
+     *
+     * @param entry The information to format into a string
+     */
+    private format;
+}
+/**
+ * Implementation of LogListener which logs to the supplied function
+ *
+ */
+export declare class FunctionListener implements ILogListener {
+    private method;
+    /**
+     * Creates a new instance of the FunctionListener class
+     *
+     * @constructor
+     * @param  method The method to which any logging data will be passed
+     */
+    constructor(method: (entry: ILogEntry) => void);
+    /**
+     * 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;
+}
 //# sourceMappingURL=listeners.d.ts.map

package/listeners.js

@@ -1,74 +1,74 @@
-/**
- * Implementation of LogListener which logs to the console
- *
- */
-var ConsoleListener = /** @class */ (function () {
-    function ConsoleListener() {
-    }
-    /**
-     * Any associated data that a given logging listener may choose to log or ignore
-     *
-     * @param entry The information to be logged
-     */
-    ConsoleListener.prototype.log = function (entry) {
-        var msg = this.format(entry);
-        switch (entry.level) {
-            case 0 /* Verbose */:
-            case 1 /* Info */:
-                console.log(msg);
-                break;
-            case 2 /* Warning */:
-                console.warn(msg);
-                break;
-            case 3 /* Error */:
-                console.error(msg);
-                break;
-        }
-    };
-    /**
-     * Formats the message
-     *
-     * @param entry The information to format into a string
-     */
-    ConsoleListener.prototype.format = function (entry) {
-        var msg = [];
-        msg.push("Message: " + entry.message);
-        if (entry.data !== undefined) {
-            try {
-                msg.push(" Data: " + JSON.stringify(entry.data));
-            }
-            catch (e) {
-                msg.push(" Data: Error in stringify of supplied data " + e);
-            }
-        }
-        return msg.join("");
-    };
-    return ConsoleListener;
-}());
-export { ConsoleListener };
-/**
- * Implementation of LogListener which logs to the supplied function
- *
- */
-var FunctionListener = /** @class */ (function () {
-    /**
-     * Creates a new instance of the FunctionListener class
-     *
-     * @constructor
-     * @param  method The method to which any logging data will be passed
-     */
-    function FunctionListener(method) {
-        this.method = method;
-    }
-    /**
-     * Any associated data that a given logging listener may choose to log or ignore
-     *
-     * @param entry The information to be logged
-     */
-    FunctionListener.prototype.log = function (entry) {
-        this.method(entry);
-    };
-    return FunctionListener;
-}());
-export { FunctionListener };
+/**
+ * Implementation of LogListener which logs to the console
+ *
+ */
+var ConsoleListener = /** @class */ (function () {
+    function ConsoleListener() {
+    }
+    /**
+     * Any associated data that a given logging listener may choose to log or ignore
+     *
+     * @param entry The information to be logged
+     */
+    ConsoleListener.prototype.log = function (entry) {
+        var msg = this.format(entry);
+        switch (entry.level) {
+            case 0 /* Verbose */:
+            case 1 /* Info */:
+                console.log(msg);
+                break;
+            case 2 /* Warning */:
+                console.warn(msg);
+                break;
+            case 3 /* Error */:
+                console.error(msg);
+                break;
+        }
+    };
+    /**
+     * Formats the message
+     *
+     * @param entry The information to format into a string
+     */
+    ConsoleListener.prototype.format = function (entry) {
+        var msg = [];
+        msg.push("Message: " + entry.message);
+        if (entry.data !== undefined) {
+            try {
+                msg.push(" Data: " + JSON.stringify(entry.data));
+            }
+            catch (e) {
+                msg.push(" Data: Error in stringify of supplied data " + e);
+            }
+        }
+        return msg.join("");
+    };
+    return ConsoleListener;
+}());
+export { ConsoleListener };
+/**
+ * Implementation of LogListener which logs to the supplied function
+ *
+ */
+var FunctionListener = /** @class */ (function () {
+    /**
+     * Creates a new instance of the FunctionListener class
+     *
+     * @constructor
+     * @param  method The method to which any logging data will be passed
+     */
+    function FunctionListener(method) {
+        this.method = method;
+    }
+    /**
+     * Any associated data that a given logging listener may choose to log or ignore
+     *
+     * @param entry The information to be logged
+     */
+    FunctionListener.prototype.log = function (entry) {
+        this.method(entry);
+    };
+    return FunctionListener;
+}());
+export { FunctionListener };
 //# sourceMappingURL=listeners.js.map

package/logger.d.ts

@@ -1,94 +1,94 @@
-/**
- * Class used to subscribe ILogListener and log messages throughout an application
- *
- */
-export declare class Logger {
-    private static _instance;
-    /**
-   * Gets or sets the active log level to apply for log filtering
-   */
-    static get activeLogLevel(): LogLevel;
-    static set activeLogLevel(value: LogLevel);
-    private static get instance();
-    /**
-   * Adds ILogListener instances to the set of subscribed listeners
-   *
-   * @param listeners One or more listeners to subscribe to this log
-   */
-    static subscribe(...listeners: ILogListener[]): void;
-    /**
-   * Clears the subscribers collection, returning the collection before modification
-   */
-    static clearSubscribers(): ILogListener[];
-    /**
-   * Gets the current subscriber count
-   */
-    static get count(): number;
-    /**
-   * Writes the supplied string to the subscribed listeners
-   *
-   * @param message The message to write
-   * @param level [Optional] if supplied will be used as the level of the entry (Default: LogLevel.Info)
-   */
-    static write(message: string, level?: LogLevel): void;
-    /**
-   * Writes the supplied string to the subscribed listeners
-   *
-   * @param json The json object to stringify and write
-   * @param level [Optional] if supplied will be used as the level of the entry (Default: LogLevel.Info)
-   */
-    static writeJSON(json: any, level?: LogLevel): void;
-    /**
-   * Logs the supplied entry to the subscribed listeners
-   *
-   * @param entry The message to log
-   */
-    static log(entry: ILogEntry): void;
-    /**
-   * Logs an error object to the subscribed listeners
-   *
-   * @param err The error object
-   */
-    static error(err: Error): void;
-}
-/**
- * A set of logging levels
- */
-export declare const enum LogLevel {
-    Verbose = 0,
-    Info = 1,
-    Warning = 2,
-    Error = 3,
-    Off = 99
-}
-/**
- * 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;
-}
-/**
- * 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;
-}
+/**
+ * Class used to subscribe ILogListener and log messages throughout an application
+ *
+ */
+export declare class Logger {
+    private static _instance;
+    /**
+   * Gets or sets the active log level to apply for log filtering
+   */
+    static get activeLogLevel(): LogLevel;
+    static set activeLogLevel(value: LogLevel);
+    private static get instance();
+    /**
+   * Adds ILogListener instances to the set of subscribed listeners
+   *
+   * @param listeners One or more listeners to subscribe to this log
+   */
+    static subscribe(...listeners: ILogListener[]): void;
+    /**
+   * Clears the subscribers collection, returning the collection before modification
+   */
+    static clearSubscribers(): ILogListener[];
+    /**
+   * Gets the current subscriber count
+   */
+    static get count(): number;
+    /**
+   * Writes the supplied string to the subscribed listeners
+   *
+   * @param message The message to write
+   * @param level [Optional] if supplied will be used as the level of the entry (Default: LogLevel.Info)
+   */
+    static write(message: string, level?: LogLevel): void;
+    /**
+   * Writes the supplied string to the subscribed listeners
+   *
+   * @param json The json object to stringify and write
+   * @param level [Optional] if supplied will be used as the level of the entry (Default: LogLevel.Info)
+   */
+    static writeJSON(json: any, level?: LogLevel): void;
+    /**
+   * Logs the supplied entry to the subscribed listeners
+   *
+   * @param entry The message to log
+   */
+    static log(entry: ILogEntry): void;
+    /**
+   * Logs an error object to the subscribed listeners
+   *
+   * @param err The error object
+   */
+    static error(err: Error): void;
+}
+/**
+ * A set of logging levels
+ */
+export declare const enum LogLevel {
+    Verbose = 0,
+    Info = 1,
+    Warning = 2,
+    Error = 3,
+    Off = 99
+}
+/**
+ * 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;
+}
+/**
+ * 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;
+}
 //# sourceMappingURL=logger.d.ts.map

package/logger.js

@@ -1,142 +1,142 @@
-/**
- * Class used to subscribe ILogListener and log messages throughout an application
- *
- */
-var Logger = /** @class */ (function () {
-    function Logger() {
-    }
-    Object.defineProperty(Logger, "activeLogLevel", {
-        /**
-       * Gets or sets the active log level to apply for log filtering
-       */
-        get: function () {
-            return Logger.instance.activeLogLevel;
-        },
-        set: function (value) {
-            Logger.instance.activeLogLevel = value;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Logger, "instance", {
-        get: function () {
-            if (Logger._instance === undefined || Logger._instance === null) {
-                Logger._instance = new LoggerImpl();
-            }
-            return Logger._instance;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    /**
-   * Adds ILogListener instances to the set of subscribed listeners
-   *
-   * @param listeners One or more listeners to subscribe to this log
-   */
-    Logger.subscribe = function () {
-        var listeners = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            listeners[_i] = arguments[_i];
-        }
-        listeners.forEach(function (listener) { return Logger.instance.subscribe(listener); });
-    };
-    /**
-   * Clears the subscribers collection, returning the collection before modification
-   */
-    Logger.clearSubscribers = function () {
-        return Logger.instance.clearSubscribers();
-    };
-    Object.defineProperty(Logger, "count", {
-        /**
-       * Gets the current subscriber count
-       */
-        get: function () {
-            return Logger.instance.count;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    /**
-   * Writes the supplied string to the subscribed listeners
-   *
-   * @param message The message to write
-   * @param level [Optional] if supplied will be used as the level of the entry (Default: LogLevel.Info)
-   */
-    Logger.write = function (message, level) {
-        if (level === void 0) { level = 1 /* Info */; }
-        Logger.instance.log({ level: level, message: message });
-    };
-    /**
-   * Writes the supplied string to the subscribed listeners
-   *
-   * @param json The json object to stringify and write
-   * @param level [Optional] if supplied will be used as the level of the entry (Default: LogLevel.Info)
-   */
-    Logger.writeJSON = function (json, level) {
-        if (level === void 0) { level = 1 /* Info */; }
-        this.write(JSON.stringify(json), level);
-    };
-    /**
-   * Logs the supplied entry to the subscribed listeners
-   *
-   * @param entry The message to log
-   */
-    Logger.log = function (entry) {
-        Logger.instance.log(entry);
-    };
-    /**
-   * Logs an error object to the subscribed listeners
-   *
-   * @param err The error object
-   */
-    Logger.error = function (err) {
-        Logger.instance.log({ data: err, level: 3 /* Error */, message: err.message });
-    };
-    return Logger;
-}());
-export { Logger };
-var LoggerImpl = /** @class */ (function () {
-    function LoggerImpl(activeLogLevel, subscribers) {
-        if (activeLogLevel === void 0) { activeLogLevel = 2 /* Warning */; }
-        if (subscribers === void 0) { subscribers = []; }
-        this.activeLogLevel = activeLogLevel;
-        this.subscribers = subscribers;
-    }
-    LoggerImpl.prototype.subscribe = function (listener) {
-        this.subscribers.push(listener);
-    };
-    LoggerImpl.prototype.clearSubscribers = function () {
-        var s = this.subscribers.slice(0);
-        this.subscribers.length = 0;
-        return s;
-    };
-    Object.defineProperty(LoggerImpl.prototype, "count", {
-        get: function () {
-            return this.subscribers.length;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    LoggerImpl.prototype.write = function (message, level) {
-        if (level === void 0) { level = 1 /* Info */; }
-        this.log({ level: level, message: message });
-    };
-    LoggerImpl.prototype.log = function (entry) {
-        if (entry !== undefined && this.activeLogLevel <= entry.level) {
-            this.subscribers.map(function (subscriber) { return subscriber.log(entry); });
-        }
-    };
-    return LoggerImpl;
-}());
-/**
- * A set of logging levels
- */
-export var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["Verbose"] = 0] = "Verbose";
-    LogLevel[LogLevel["Info"] = 1] = "Info";
-    LogLevel[LogLevel["Warning"] = 2] = "Warning";
-    LogLevel[LogLevel["Error"] = 3] = "Error";
-    LogLevel[LogLevel["Off"] = 99] = "Off";
-})(LogLevel || (LogLevel = {}));
+/**
+ * Class used to subscribe ILogListener and log messages throughout an application
+ *
+ */
+var Logger = /** @class */ (function () {
+    function Logger() {
+    }
+    Object.defineProperty(Logger, "activeLogLevel", {
+        /**
+       * Gets or sets the active log level to apply for log filtering
+       */
+        get: function () {
+            return Logger.instance.activeLogLevel;
+        },
+        set: function (value) {
+            Logger.instance.activeLogLevel = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Logger, "instance", {
+        get: function () {
+            if (Logger._instance === undefined || Logger._instance === null) {
+                Logger._instance = new LoggerImpl();
+            }
+            return Logger._instance;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+   * Adds ILogListener instances to the set of subscribed listeners
+   *
+   * @param listeners One or more listeners to subscribe to this log
+   */
+    Logger.subscribe = function () {
+        var listeners = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            listeners[_i] = arguments[_i];
+        }
+        listeners.forEach(function (listener) { return Logger.instance.subscribe(listener); });
+    };
+    /**
+   * Clears the subscribers collection, returning the collection before modification
+   */
+    Logger.clearSubscribers = function () {
+        return Logger.instance.clearSubscribers();
+    };
+    Object.defineProperty(Logger, "count", {
+        /**
+       * Gets the current subscriber count
+       */
+        get: function () {
+            return Logger.instance.count;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+   * Writes the supplied string to the subscribed listeners
+   *
+   * @param message The message to write
+   * @param level [Optional] if supplied will be used as the level of the entry (Default: LogLevel.Info)
+   */
+    Logger.write = function (message, level) {
+        if (level === void 0) { level = 1 /* Info */; }
+        Logger.instance.log({ level: level, message: message });
+    };
+    /**
+   * Writes the supplied string to the subscribed listeners
+   *
+   * @param json The json object to stringify and write
+   * @param level [Optional] if supplied will be used as the level of the entry (Default: LogLevel.Info)
+   */
+    Logger.writeJSON = function (json, level) {
+        if (level === void 0) { level = 1 /* Info */; }
+        this.write(JSON.stringify(json), level);
+    };
+    /**
+   * Logs the supplied entry to the subscribed listeners
+   *
+   * @param entry The message to log
+   */
+    Logger.log = function (entry) {
+        Logger.instance.log(entry);
+    };
+    /**
+   * Logs an error object to the subscribed listeners
+   *
+   * @param err The error object
+   */
+    Logger.error = function (err) {
+        Logger.instance.log({ data: err, level: 3 /* Error */, message: err.message });
+    };
+    return Logger;
+}());
+export { Logger };
+var LoggerImpl = /** @class */ (function () {
+    function LoggerImpl(activeLogLevel, subscribers) {
+        if (activeLogLevel === void 0) { activeLogLevel = 2 /* Warning */; }
+        if (subscribers === void 0) { subscribers = []; }
+        this.activeLogLevel = activeLogLevel;
+        this.subscribers = subscribers;
+    }
+    LoggerImpl.prototype.subscribe = function (listener) {
+        this.subscribers.push(listener);
+    };
+    LoggerImpl.prototype.clearSubscribers = function () {
+        var s = this.subscribers.slice(0);
+        this.subscribers.length = 0;
+        return s;
+    };
+    Object.defineProperty(LoggerImpl.prototype, "count", {
+        get: function () {
+            return this.subscribers.length;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    LoggerImpl.prototype.write = function (message, level) {
+        if (level === void 0) { level = 1 /* Info */; }
+        this.log({ level: level, message: message });
+    };
+    LoggerImpl.prototype.log = function (entry) {
+        if (entry !== undefined && this.activeLogLevel <= entry.level) {
+            this.subscribers.map(function (subscriber) { return subscriber.log(entry); });
+        }
+    };
+    return LoggerImpl;
+}());
+/**
+ * A set of logging levels
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["Verbose"] = 0] = "Verbose";
+    LogLevel[LogLevel["Info"] = 1] = "Info";
+    LogLevel[LogLevel["Warning"] = 2] = "Warning";
+    LogLevel[LogLevel["Error"] = 3] = "Error";
+    LogLevel[LogLevel["Off"] = 99] = "Off";
+})(LogLevel || (LogLevel = {}));
 //# sourceMappingURL=logger.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pnp/logging",
-    "version": "2.10.0",
+    "version": "2.13.0",
     "description": "pnp - light-weight, subscribable logging framework",
     "main": "./index.js",
     "typings": "./index",

package/readme.md

@@ -1,22 +1,22 @@
-![SharePoint Patterns and Practices](https://devofficecdn.azureedge.net/media/Default/PnP/sppnp.png)
-
-The SharePoint Patterns and Practices client side libraries were created to help enable developers to do their best work, without worrying about the exact
-REST api details. Built with feedback from the community they represent a way to simplify your day-to-day dev cycle while relying on tested and proven
-patterns.
-
-Please use [http://aka.ms/sppnp](http://aka.ms/sppnp) for the latest updates around the whole *SharePoint Patterns and Practices (PnP) initiative*.
-
-## Source & Docs
-
-This code is managed within the [main pnp repo](https://github.com/pnp/pnp), please report issues and submit pull requests there.
-
-Please see the public site for [package documentation](https://pnp.github.io/pnpjs/).
-
-### Code of Conduct
-
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
-
-### "Sharing is Caring"
-
-### Disclaimer
+![SharePoint Patterns and Practices](https://devofficecdn.azureedge.net/media/Default/PnP/sppnp.png)
+
+The SharePoint Patterns and Practices client side libraries were created to help enable developers to do their best work, without worrying about the exact
+REST api details. Built with feedback from the community they represent a way to simplify your day-to-day dev cycle while relying on tested and proven
+patterns.
+
+Please use [http://aka.ms/sppnp](http://aka.ms/sppnp) for the latest updates around the whole *SharePoint Patterns and Practices (PnP) initiative*.
+
+## Source & Docs
+
+This code is managed within the [main pnp repo](https://github.com/pnp/pnp), please report issues and submit pull requests there.
+
+Please see the public site for [package documentation](https://pnp.github.io/pnpjs/).
+
+### Code of Conduct
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+### "Sharing is Caring"
+
+### Disclaimer
 **THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**