ms-graph-types 2.43.1

package/README.md

@@ -0,0 +1,117 @@
+[![npm version badge](https://img.shields.io/npm/v/@microsoft/microsoft-graph-types.svg)](https://www.npmjs.com/package/@microsoft/microsoft-graph-types)
+
+# Microsoft Graph TypeScript Types
+The Microsoft Graph TypeScript definitions enable editors to provide intellisense on Microsoft Graph objects including users, messages, and groups.
+
+> **_NOTE:_**  The **Microsoft Graph TypeScript Types Beta** [npm package](https://www.npmjs.com/package/@microsoft/microsoft-graph-types-beta) and [GitHub repo](https://github.com/microsoftgraph/msgraph-beta-typescript-typings) is now available. Imports from the `microsoftgraph/msgraph-typescript-typings#beta` branch will no longer be supported.
+ 
+## Installation
+
+We recommend including the .d.ts file by downloading this package through [npm](https://www.npmjs.com/).
+
+```bash
+
+# Install types and save in package.json as a development dependency
+npm install @microsoft/microsoft-graph-types --save-dev
+
+```
+
+![GIF showing intellisense and autocompletion for Microsoft Graph entities in Visual Studio Code ](https://github.com/microsoftgraph/msgraph-typescript-typings/raw/master/typings-demo.gif)
+
+## Examples
+The following examples assume that you have a valid access token. The following example uses [isomorphic-fetch](https://www.npmjs.com/package/isomorphic-fetch) and [Microsoft Graph JavaScript client library](https://github.com/microsoftgraph/msgraph-sdk-javascript) -
+
+```typescript
+import { User } from "@microsoft/microsoft-graph-types-beta";
+
+import { Client } from "@microsoft/microsoft-graph-client";
+
+import 'isomorphic-fetch';
+
+const client = Client.initWithMiddleware({
+	defaultVersion: 'beta',
+    ...
+});
+
+const response = await client.api("/me").get();
+const user = response as User;
+```
+
+### Example of creating an object
+```typescript
+// Create the message object
+
+// Note that all the properties must follow the interface definitions.
+// For example, this will not compile if you try to type "xml" instead of "html" for contentType.
+
+let mail:MicrosoftGraphBeta.Message = {
+    subject: "Microsoft Graph TypeScript Sample",
+    toRecipients: [{
+        emailAddress: {
+            address: "microsoftgraph@example.com"
+        }
+    }],
+    body: {
+        content: "<h1>Microsoft Graph TypeScript Sample</h1>Try modifying the sample",
+        contentType: "html"
+    }
+}
+```
+
+## Example of using v1 types and beta types together
+```json
+  "devDependencies": {
+    // import published v1.0 types with a version from NPM
+    "@microsoft/microsoft-graph-types": "^0.4.0",
+    // import beta types with a version from NPM
+    "@microsoft/microsoft-graph-types-beta": "^0.1.0-preview"
+  }
+}
+```
+
+```typescript
+import * as MicrosoftGraph from "@microsoft/microsoft-graph-types"
+
+import * as MicrosoftGraphBeta from "@microsoft/microsoft-graph-types-beta"
+
+const v1User: MicrosoftGraph.User = {
+	givenName: "V1 User"
+}
+
+const betaUser: MicrosoftGraphBeta.User = {
+	givenName: "Beta User"
+}
+
+```
+
+## Supported editors
+Any TypeScript project can consume these types when using at least TypeScript 2.0.  We've tested including the types as a dependency in the following editors.
+* Visual Studio Code
+* WebStorm
+* Atom with the [atom-typescript](https://atom.io/packages/atom-typescript) plugin
+
+## Questions and comments
+
+We'd love to get your feedback about the TypeScript definitions project. You can send your questions and suggestions to us in the [Issues](https://github.com/microsoftgraph/msgraph-typescript-typings/issues) section of this repository.
+
+
+## Contributing
+Please see the [contributing guidelines](CONTRIBUTING.md).
+
+## Additional resources
+
+* [Microsoft Graph](https://graph.microsoft.io)
+* [Office Dev Center](http://dev.office.com/)
+* [Microsoft Graph JavaScript Client Library](https://github.com/microsoftgraph/msgraph-sdk-javascript)
+
+## Security Reporting
+
+If you find a security issue with our libraries or services please report it to [secure@microsoft.com](mailto:secure@microsoft.com) with as much detail as possible. Your submission may be eligible for a bounty through the [Microsoft Bounty](http://aka.ms/bugbounty) program. Please do not post security issues to GitHub Issues or any other public site. We will contact you shortly upon receiving the information. We encourage you to get notifications of when security incidents occur by visiting [this page](https://technet.microsoft.com/en-us/security/dd252948) and subscribing to Security Advisory Alerts.
+
+## License
+
+Copyright (c) Microsoft Corporation.  All rights reserved. Licensed under the MIT License (the "License");
+
+## We Value and Adhere to the Microsoft Open Source 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.

package/SECURITY.md

@@ -0,0 +1,41 @@
+<!-- BEGIN MICROSOFT SECURITY.MD V0.0.8 BLOCK -->
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
+
+If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). 
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+  * Full paths of source file(s) related to the manifestation of the issue
+  * The location of the affected source code (tag/branch/commit or direct URL)
+  * Any special configuration required to reproduce the issue
+  * Step-by-step instructions to reproduce the issue
+  * Proof-of-concept or exploit code (if possible)
+  * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->