@zxncij2390/monorepo3 3.18.0

package/docs/graph/behaviors.md

@@ -0,0 +1,267 @@
+# @pnp/graph : behaviors
+
+The article describes the behaviors exported by the `@pnp/graph` library. Please also see available behaviors in [@pnp/core](../core/behaviors.md), [@pnp/queryable](../queryable/behaviors.md), [@pnp/sp](../sp/behaviors.md), and [@pnp/nodejs](../nodejs/behaviors.md).
+
+## DefaultInit
+
+The `DefaultInit` behavior, itself a composed behavior includes Telemetry, RejectOnError, and ResolveOnData. Additionally, it sets the cache and credentials properties of the RequestInit and ensures the request url is absolute.
+
+```TypeScript
+import { graphfi, DefaultInit } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(DefaultInit());
+
+await graph.users();
+```
+
+## DefaultHeaders
+
+The `DefaultHeaders` behavior uses InjectHeaders to set the Content-Type header.
+
+```TypeScript
+import { graphfi, DefaultHeaders } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(DefaultHeaders());
+
+await graph.users();
+```
+
+> DefaultInit and DefaultHeaders are separated to make it easier to create your own default headers or init behavior. You should include both if composing your own default behavior.
+
+## Paged
+
+_Added in 3.4.0_
+
+The Paged behavior allows you to access the information in a collection through a series of pages. While you can use it directly, you will likely use the `paged` method of the collections which handles things for you.
+
+> Note that not all entity types support `count` and where it is unsupported it will return 0.
+
+Basic example, read all users:
+
+```TypeScript
+import { graphfi, DefaultHeaders } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(DefaultHeaders());
+
+const allUsers = [];
+let users = await graph.users.top(300).paged();
+
+allUsers.push(...users.value);
+
+while (users.hasNext) {
+  users = await users.next();
+  allUsers.push(...users.value);
+}
+
+console.log(`All users: ${JSON.stringify(allUsers)}`);
+```
+
+Beyond the basics other query operations are supported such as filter and select.
+
+```TypeScript
+import { graphfi, DefaultHeaders } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(DefaultHeaders());
+
+const allUsers = [];
+let users = await graph.users.top(50).select("userPrincipalName", "displayName").filter("startswith(displayName, 'A')").paged();
+
+allUsers.push(...users.value);
+
+while (users.hasNext) {
+  users = await users.next();
+  allUsers.push(...users.value);
+}
+
+console.log(`All users: ${JSON.stringify(allUsers)}`);
+```
+
+And similarly for groups, showing the same pattern for different types of collections
+
+```TypeScript
+import { graphfi, DefaultHeaders } from "@pnp/graph";
+import "@pnp/graph/groups";
+
+const graph = graphfi().using(DefaultHeaders());
+
+const allGroups = [];
+let groups = await graph.groups.paged();
+
+allGroups.push(...groups.value);
+
+while (groups.hasNext) {
+  groups = await groups.next();
+  allGroups.push(...groups.value);
+}
+
+console.log(`All groups: ${JSON.stringify(allGroups)}`);
+```
+
+## Endpoint
+
+This behavior is used to change the endpoint to which requests are made, either "beta" or "v1.0". This allows you to easily switch back and forth between the endpoints as needed.
+
+```TypeScript
+import { graphfi, Endpoint } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const beta = graphfi().using(Endpoint("beta"));
+
+const vOne = graphfi().using(Endpoint("v1.0"));
+
+await beta.users();
+
+await vOne.users();
+```
+
+It can also be used at any point in the fluid chain to switch an isolated request to a different endpoint.
+
+```TypeScript
+import { graphfi, Endpoint } from "@pnp/graph";
+import "@pnp/graph/users";
+
+// will point to v1 by default
+const graph = graphfi().using();
+
+const user = graph.users.getById("{id}");
+
+// this only applies to the "user" instance now
+const userInfoFromBeta = user.using(Endpoint("beta"))();
+```
+
+Finally, if you always want to make your requests to the beta end point (as an example) it is more efficient to set it in the graphfi factory.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+
+const beta = graphfi("https://graph.microsoft.com/beta");
+```
+
+## GraphBrowser
+
+A composed behavior suitable for use within a SPA or other scenario outside of SPFx. It includes DefaultHeaders, DefaultInit, BrowserFetchWithRetry, and DefaultParse. As well it adds a pre observer to try and ensure the request url is absolute if one is supplied in props.
+
+The baseUrl prop can be used to configure the graph endpoint to which requests will be sent.
+
+> If you are building a SPA you likely need to handle authentication. For this we support the [msal library](../concepts/authentication.md#MSAL-in-Browser) which you can use directly or as a pattern to roll your own MSAL implementation behavior.
+
+```TypeScript
+import { graphfi, GraphBrowser } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(GraphBrowser());
+
+await graph.users();
+```
+
+You can also set a baseUrl. This is equivelent to calling graphfi with an absolute url.
+
+```TypeScript
+import { graphfi, GraphBrowser } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(GraphBrowser({ baseUrl: "https://graph.microsoft.com/v1.0" }));
+
+// this is the same as the above, and maybe a litter easier to read, and is more efficient
+// const graph = graphfi("https://graph.microsoft.com/v1.0").using(GraphBrowser());
+
+await graph.users();
+```
+
+## SPFx
+
+This behavior is designed to work closely with SPFx. The only parameter is the current SPFx Context. `SPFx` is a composed behavior including DefaultHeaders, DefaultInit, BrowserFetchWithRetry, and DefaultParse. It also replaces any authentication present with a method to get a token from the SPFx aadTokenProviderFactory.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/users";
+
+// this.context represents the context object within an SPFx webpart, application customizer, or ACE.
+const graph = graphfi(...).using(SPFx(this.context));
+
+await graph.users();
+```
+
+Note that both the sp and graph libraries export an SPFx behavior. They are unique to their respective libraries and cannot be shared, i.e. you can't use the graph SPFx to setup sp and vice-versa.
+
+```TypeScript
+import { GraphFI, graphfi, SPFx as graphSPFx } from '@pnp/graph'
+import { SPFI, spfi, SPFx as spSPFx } from '@pnp/sp'
+
+const sp = spfi().using(spSPFx(this.context));
+const graph = graphfi().using(graphSPFx(this.context));
+```
+
+If you want to use a different form of authentication you can apply that behavior after `SPFx` to override it. In this case we are using the [client MSAL authentication](../msaljsclient).
+
+## SPFxToken
+
+_Added in 3.12_
+
+Allows you to include the SharePoint Framework application token in requests. This behavior is include within the SPFx behavior, but is available separately should you wish to compose it into your own behaviors.
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/users";
+
+// this.context represents the context object within an SPFx webpart, application customizer, or ACE.
+const graph = graphfi(...).using(SPFxToken(this.context));
+
+await graph.users();
+```
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import { MSAL } from "@pnp/msaljsclient";
+import "@pnp/graph/users";
+
+// this.context represents the context object within an SPFx webpart, application customizer, or ACE.
+const graph = graphfi().using(SPFx(this.context), MSAL({ /* proper MSAL settings */}));
+
+await graph.users();
+```
+
+## Telemetry
+
+This behavior helps provide usage statistics to us about the number of requests made to the service using this library, as well as the methods being called. We do not, and cannot, access any PII information or tie requests to specific users. The data aggregates at the tenant level. We use this information to better understand how the library is being used and look for opportunities to improve high-use code paths.
+
+> You can always opt out of the telemetry by creating your own default behaviors and leaving it out. However, we encourgage you to include it as it helps us understand usage and impact of the work.
+
+```TypeScript
+import { graphfi, Telemetry } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(Telemetry());
+
+await graph.users();
+```
+
+## ConsistencyLevel
+
+Using this behavior you can set the consistency level of your requests. You likely won't need to use this directly as we include it where needed.
+
+Basic usage:
+
+```TypeScript
+import { graphfi, ConsistencyLevel } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(ConsistencyLevel());
+
+await graph.users();
+```
+
+If in the future there is another value other than "eventual" you can supply it to the behavior. For now only "eventual" is a valid value, which is the default, so you do not need to pass it as a param.
+
+```TypeScript
+import { graphfi, ConsistencyLevel } from "@pnp/graph";
+import "@pnp/graph/users";
+
+const graph = graphfi().using(ConsistencyLevel("{level value}"));
+
+await graph.users();
+```

package/docs/graph/bookings.md

@@ -0,0 +1,180 @@
+# @pnp/graph/bookings
+
+Represents the Bookings services available to a user.
+
+You can learn more  by reading the [Official Microsoft Graph Documentation](https://docs.microsoft.com/en-us/graph/api/resources/booking-api-overview?view=graph-rest-1.0).
+
+## IBookingCurrencies, IBookingCurrency, IBookingBusinesses, IBookingBusiness, IBookingAppointments, IBookingAppointment, IBookingCustomers, IBookingCustomer, IBookingServices, IBookingService, IBookingStaffMembers, IBookingStaffMember,  IBookingCustomQuestions, IBookingCustomQuestion
+
+[![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 Booking Currencies
+
+Get the supported currencies
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/bookings";
+
+const graph = graphfi(...);
+
+// Get all the currencies
+const currencies = await graph.bookingCurrencies();
+// get the details of the first currency
+const currency = await graph.bookingCurrencies.getById(currencies[0].id)();
+```
+
+## Work with Booking Businesses
+
+Get the bookings businesses
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/bookings";
+
+const graph = graphfi(...);
+
+// Get all the businesses
+const businesses = await graph.bookingBusinesses();
+// get the details of the first business
+const business = graph.bookingBusinesses.getById(businesses[0].id)();
+const businessDetails = await business();
+// get the business calendar
+const calView = await business.calendarView("2022-06-01", "2022-08-01")();
+// publish the business
+await business.publish();
+// unpublish the business
+await business.unpublish();
+```
+
+## Work with Booking Services
+
+Get the bookings business services
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/bookings";
+import { BookingService } from "@microsoft/microsoft-graph-types";
+
+const graph = graphfi(...);
+
+const business = graph.bookingBusinesses.getById({Booking Business Id})();
+// get the business services
+const services = await business.services();
+// add a service
+const newServiceDesc: BookingService = {booking service details -- see Microsoft Graph documentation};
+const newService = services.add(newServiceDesc);
+// get service by id
+const service = await business.services.getById({service id})();
+// update service
+const updateServiceDesc: BookingService = {booking service details -- see Microsoft Graph documentation};
+const update = await business.services.getById({service id}).update(updateServiceDesc);
+// delete service
+await business.services.getById({service id}).delete();
+```
+
+## Work with Booking Customers
+
+Get the bookings business customers
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/bookings";
+import { BookingCustomer } from "@microsoft/microsoft-graph-types";
+
+const graph = graphfi(...);
+
+const business = graph.bookingBusinesses.getById({Booking Business Id})();
+// get the business customers
+const customers = await business.customers();
+// add a customer
+const newCustomerDesc: BookingCustomer = {booking customer details -- see Microsoft Graph documentation};
+const newCustomer = customers.add(newCustomerDesc);
+// get customer by id
+const customer = await business.customers.getById({customer id})();
+// update customer
+const updateCustomerDesc: BookingCustomer = {booking customer details -- see Microsoft Graph documentation};
+const update = await business.customers.getById({customer id}).update(updateCustomerDesc);
+// delete customer
+await business.customers.getById({customer id}).delete();
+```
+
+## Work with Booking StaffMembers
+
+Get the bookings business staffmembers
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/bookings";
+import { BookingStaffMember } from "@microsoft/microsoft-graph-types";
+
+const graph = graphfi(...);
+
+const business = graph.bookingBusinesses.getById({Booking Business Id})();
+// get the business staff members
+const staffmembers = await business.staffMembers();
+// add a staff member
+const newStaffMemberDesc: BookingStaffMember = {booking staff member details -- see Microsoft Graph documentation};
+const newStaffMember = staffmembers.add(newStaffMemberDesc);
+// get staff member by id
+const staffmember = await business.staffMembers.getById({staff member id})();
+// update staff member
+const updateStaffMemberDesc: BookingStaffMember = {booking staff member details -- see Microsoft Graph documentation};
+const update = await business.staffMembers.getById({staff member id}).update(updateStaffMemberDesc);
+// delete staffmember
+await business.staffMembers.getById({staff member id}).delete();
+```
+
+## Work with Booking Appointments
+
+Get the bookings business appointments
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/bookings";
+import { BookingAppointment } from "@microsoft/microsoft-graph-types";
+
+const graph = graphfi(...);
+
+const business = graph.bookingBusinesses.getById({Booking Business Id})();
+// get the business appointments
+const appointments = await business.appointments();
+// add a appointment
+const newAppointmentDesc: BookingAppointment = {booking appointment details -- see Microsoft Graph documentation};
+const newAppointment = appointments.add(newAppointmentDesc);
+// get appointment by id
+const appointment = await business.appointments.getById({appointment id})();
+// cancel the appointment
+await appointment.cancel();
+// update appointment
+const updateAppointmentDesc: BookingAppointment = {booking appointment details -- see Microsoft Graph documentation};
+const update = await business.appointments.getById({appointment id}).update(updateAppointmentDesc);
+// delete appointment
+await business.appointments.getById({appointment id}).delete();
+```
+
+## Work with Booking Custom Questions
+
+Get the bookings business custom questions
+
+```TypeScript
+import { graphfi } from "@pnp/graph";
+import "@pnp/graph/bookings";
+import { BookingCustomQuestion } from "@microsoft/microsoft-graph-types";
+
+const graph = graphfi(...);
+
+const business = graph.bookingBusinesses.getById({Booking Business Id})();
+// get the business custom questions
+const customQuestions = await business.customQuestions();
+// add a custom question
+const newCustomQuestionDesc: BookingCustomQuestion = {booking custom question details -- see Microsoft Graph documentation};
+const newCustomQuestion = customQuestions.add(newCustomQuestionDesc);
+// get custom question by id
+const customquestion = await business.customQuestions.getById({customquestion id})();
+// update custom question
+const updateCustomQuestionDesc: BookingCustomQuestion = {booking custom question details -- see Microsoft Graph documentation};
+const update = await business.customQuestions.getById({custom question id}).update(updateCustomQuestionDesc);
+// delete custom question
+await business.customQuestions.getById({customquestion id}).delete();
+```