@zxncij2390/monorepo3 3.18.0

package/docs/graph/photos.md

@@ -0,0 +1,71 @@
+# @pnp/graph/photos
+
+A profile photo of a user, group or an Outlook contact accessed from Exchange Online or Azure Active Directory (AAD). It's binary data not encoded in base-64.
+
+You can learn more about Microsoft Graph users by reading the [Official Microsoft Graph Documentation](https://docs.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0).
+
+## IPhoto
+
+[![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
+
+## Current User Photo
+
+This example shows the getBlob() endpoint, there is also a getBuffer() endpoint to support node.js
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/users";
+import "@pnp/graph/photos";
+
+const graph = graphfi(...);
+
+const photoValue = await graph.me.photo.getBlob();
+const url = window.URL || window.webkitURL;
+const blobUrl = url.createObjectURL(photoValue);
+document.getElementById("photoElement").setAttribute("src", blobUrl);
+```
+
+## Current Group Photo
+
+This example shows the getBlob() endpoint, there is also a getBuffer() endpoint to support node.js
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/groups";
+import "@pnp/graph/photos";
+
+const graph = graphfi(...);
+
+const photoValue = await graph.groups.getById("7d2b9355-0891-47d3-84c8-bf2cd9c62177").photo.getBlob();
+const url = window.URL || window.webkitURL;
+const blobUrl = url.createObjectURL(photoValue);
+document.getElementById("photoElement").setAttribute("src", blobUrl);
+```
+
+## Set User Photo
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/users";
+import "@pnp/graph/photos";
+
+const graph = graphfi(...);
+
+const input = <HTMLInputElement>document.getElementById("thefileinput");
+const file = input.files[0];
+await graph.me.photo.setContent(file);
+```
+
+## Set Group Photo
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/users";
+import "@pnp/graph/photos";
+
+const graph = graphfi(...);
+
+const input = <HTMLInputElement>document.getElementById("thefileinput");
+const file = input.files[0];
+await graph.me.photo.setContent(file);
+```

package/docs/graph/planner.md

@@ -0,0 +1,249 @@
+# @pnp/graph/planner
+
+The ability to manage plans and tasks in Planner is a capability introduced in version 1.2.4 of @pnp/graph. Through the methods described
+you can add, update and delete items in Planner.
+
+## IInvitations
+
+[![Invokable Banner](https://img.shields.io/badge/Invokable-informational.svg)](../concepts/invokable.md) [![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
+
+## Get Plans by Id
+
+Using the planner.plans.getById() you can get a specific Plan.
+Planner.plans is not an available endpoint, you need to get a specific Plan.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const plan = await graph.planner.plans.getById('planId')();
+
+```
+
+## Add new Plan
+
+Using the planner.plans.add() you can create a new Plan.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const newPlan = await graph.planner.plans.add('groupObjectId', 'title');
+
+```
+
+## Get Tasks in Plan
+
+Using the tasks() you can get the Tasks in a Plan.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const planTasks = await graph.planner.plans.getById('planId').tasks();
+
+```
+
+## Get Buckets in Plan
+
+Using the buckets() you can get the Buckets in a Plan.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const planBuckets = await graph.planner.plans.getById('planId').buckets();
+
+```
+
+## Get Details in Plan
+
+Using the details() you can get the details in a Plan.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const planDetails = await graph.planner.plans.getById('planId').details();
+
+```
+
+## Delete Plan
+
+Using the delete() you can get delete a Plan.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const delPlan = await graph.planner.plans.getById('planId').delete('planEtag');
+
+```
+
+## Update Plan
+
+Using the update() you can get update a Plan.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const updPlan = await graph.planner.plans.getById('planId').update({title: 'New Title', eTag: 'planEtag'});
+
+```
+
+## Get Task by Id
+
+Using the planner.tasks.getById() you can get a specific Task.
+Planner.tasks is not an available endpoint, you need to get a specific Task.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const task = await graph.planner.tasks.getById('taskId')();
+
+```
+
+## Add new Task
+
+Using the planner.tasks.add() you can create a new Task.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const newTask = await graph.planner.tasks.add('planId', 'title');
+
+```
+
+## Get Details in Task
+
+Using the details() you can get the details in a Task.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const taskDetails = await graph.planner.tasks.getById('taskId').details();
+
+```
+
+## Delete Task
+
+Using the delete() you can get delete a Task.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const delTask = await graph.planner.tasks.getById('taskId').delete('taskEtag');
+
+```
+
+## Update Task
+
+Using the update() you can get update a Task.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const updTask = await graph.planner.tasks.getById('taskId').update({properties, eTag:'taskEtag'});
+
+```
+
+## Get Buckets by Id
+
+Using the planner.buckets.getById() you can get a specific Bucket.
+planner.buckets is not an available endpoint, you need to get a specific Bucket.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const bucket = await graph.planner.buckets.getById('bucketId')();
+
+```
+
+## Add new Bucket
+
+Using the planner.buckets.add() you can create a new Bucket.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const newBucket = await graph.planner.buckets.add('name', 'planId');
+
+```
+
+## Update Bucket
+
+Using the update() you can get update a Bucket.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const updBucket = await graph.planner.buckets.getById('bucketId').update({name: "Name", eTag:'bucketEtag'});
+
+```
+
+## Delete Bucket
+
+Using the delete() you can get delete a Bucket.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const delBucket = await graph.planner.buckets.getById('bucketId').delete(eTag:'bucketEtag');
+
+```
+
+## Get Bucket Tasks
+
+Using the tasks() you can get Tasks in a Bucket.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/planner";
+
+const graph = graphfi(...);
+
+const bucketTasks = await graph.planner.buckets.getById('bucketId').tasks();
+
+```

package/docs/graph/search.md

@@ -0,0 +1,25 @@
+# @pnp/graph/search
+
+The search module allows you to access the Microsoft Graph Search API. You can read full details of using the API, for library examples please see below.
+
+[![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
+
+## Call graph.query
+
+This example shows calling the search API via the `query` method of the root graph object.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/search";
+
+const graph = graphfi(...);
+
+const results = await graph.query({
+    entityTypes: ["site"],
+    query: {
+        queryString: "test"
+    },
+});
+```
+
+> Note: This library allows you to pass multiple search requests to the `query` method as the value consumed by the server is an array, but it only a single requests works at this time. Eventually this may change and no updates will be required.

package/docs/graph/shares.md

@@ -0,0 +1,44 @@
+# @pnp/graph/shares
+
+The shares module allows you to access shared files, or any file in the tenant using encoded file urls.
+
+[![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)
+
+## Access a Share by Id
+
+```TS
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/shares";
+
+const graph = graphfi(...);
+
+const shareInfo = await graph.shares.getById("{shareId}")();
+```
+
+## Encode a Sharing Link
+
+If you don't have a share id but have the absolute path to a file you can encode it into a sharing link, allowing you to access it directly using the /shares endpoint.
+
+```TS
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/shares";
+
+const graph = graphfi(...);
+
+const shareLink: string = graph.shares.encodeSharingLink("https://{tenant}.sharepoint.com/sites/dev/Shared%20Documents/new.pptx");
+
+const shareInfo = await graph.shares.getById(shareLink)();
+```
+
+## Access a Share's driveItem resource
+
+You can also access the full functionality of the driveItem via a share. Find [more details on the capabilities of driveItem here](./onedrive.md).
+
+```TS
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/shares";
+
+const graph = graphfi(...);
+
+const driveItemInfo = await graph.shares.getById("{shareId}").driveItem();
+```

package/docs/graph/sites.md

@@ -0,0 +1,47 @@
+# @pnp/graph/sites
+
+The search module allows you to access the Microsoft Graph Sites API.
+
+[![Selective Imports Banner](https://img.shields.io/badge/Selective%20Imports-informational.svg)](../concepts/selective-imports.md)  
+
+## Call graph.sites
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/sites";
+
+const graph = graphfi(...);
+
+const sitesInfo = await graph.sites();
+```
+
+## Call graph.sites.getById
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/sites";
+
+const graph = graphfi(...);
+
+const siteInfo = await graph.sites.getById("{site identifier}")();
+```
+
+## Call graph.sites.getByUrl
+
+Using the sites.getByUrl() you can get a site using url instead of identifier
+
+![Known Issue Banner](https://img.shields.io/badge/Known%20Issue-important.svg) If you get a site with this method, the graph does not support chaining a request further than .drive. We will review and try and create a work around for this issue.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/sites";
+
+const graph = graphfi(...);
+const sharepointHostName = "contoso.sharepoint.com";
+const serverRelativeUrl = "/sites/teamsite1";
+const siteInfo = await graph.sites.getByUrl(sharepointHostName, serverRelativeUrl)();
+```
+
+## Make additional calls or recieve items from lists
+
+We don't currently implement all of the available options in graph for sites, rather focusing on the sp library. While we do accept PRs to add functionality, you can [also make calls by path.](./items.md)

package/docs/graph/subscriptions.md

@@ -0,0 +1,79 @@
+# @pnp/graph/subscriptions
+
+The ability to manage subscriptions is a capability introduced in version 1.2.9 of @pnp/graph. A subscription allows a client app to receive notifications about changes to data in Microsoft graph. Currently, subscriptions are enabled for the following resources:
+
+* Mail, events, and contacts from Outlook.
+* Conversations from Office Groups.
+* Drive root items from OneDrive.
+* Users and Groups from Azure Active Directory.
+* Alerts from the Microsoft Graph Security API.
+
+## Get all of the Subscriptions
+
+Using the subscriptions(). If successful this method returns a 200 OK response code and a list of subscription objects in the response body.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/subscriptions";
+
+const graph = graphfi(...);
+
+const subscriptions = await graph.subscriptions();
+
+```
+
+## Create a new Subscription
+
+Using the subscriptions.add(). Creating a subscription requires read scope to the resource. For example, to get notifications messages, your app needs the Mail.Read permission. To learn more about the scopes visit [this](https://docs.microsoft.com/en-us/graph/api/subscription-post-subscriptions?view=graph-rest-1.0) url.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/subscriptions";
+
+const graph = graphfi(...);
+
+const addedSubscription = await graph.subscriptions.add("created,updated", "https://webhook.azurewebsites.net/api/send/myNotifyClient", "me/mailFolders('Inbox')/messages", "2019-11-20T18:23:45.9356913Z");
+
+```
+
+## Get Subscription by Id
+
+Using the subscriptions.getById() you can get one of the subscriptions
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/subscriptions";
+
+const graph = graphfi(...);
+
+const subscription = await graph.subscriptions.getById('subscriptionId')();
+
+```
+
+## Delete a Subscription
+
+Using the subscriptions.getById().delete() you can remove one of the Subscriptions
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/subscriptions";
+
+const graph = graphfi(...);
+
+const delSubscription = await graph.subscriptions.getById('subscriptionId').delete();
+
+```
+
+## Update a Subscription
+
+Using the subscriptions.getById().update() you can update one of the Subscriptions
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/subscriptions";
+
+const graph = graphfi(...);
+
+const updSubscription = await graph.subscriptions.getById('subscriptionId').update({changeType: "created,updated,deleted" });
+
+```