[office-js][office-js-preview] (common) Document device permission API

[samantharamon]

Please fill in this template.

• Use a meaningful title for the pull request. Include the name of the package modified.
• Test the change in your own code. (Compile and run.)
• Add or edit tests to reflect the change.
• Follow the advice from the readme.
• Avoid common mistakes.
• Run pnpm test <package to test>.

If changing an existing definition:

• Provide a URL to documentation or source code which provides context for the suggested changes: None.
• If this PR brings the type definitions up to date with a new version of the JS library, update the version number in the package.json.

[typescript-bot]

@samantharamon Thank you for submitting this PR!

This is a live comment which I will keep updated.

2 packages in this PR

• office-js-preview — on npm, on unpkg (author is owner)
  • owner-approval: @Rick-Kirkham
• office-js — on npm, on unpkg (author is owner)
  • owner-approval: @Rick-Kirkham

Code Reviews

Because this PR edits multiple packages, it can be merged once it's reviewed by a DT maintainer.

You can test the changes of this PR in the Playground.

Status

• ✅ No merge conflicts
• ✅ Continuous integration tests have passed
• 🕐 A DT maintainer needs to approve changes which affect more than one package

Once every item on this list is checked, I'll ask you for permission to merge and publish the changes.

---

Diagnostic Information: What the bot saw about this PR

{
  "type": "info",
  "now": "-",
  "pr_number": 69592,
  "author": "samantharamon",
  "headCommitOid": "279223e2a39d84a9e60c7011f945f5edd3e2f4ea",
  "mergeBaseOid": "4bb4074c7626d9ed78c2c5243476539d6dc161b0",
  "lastPushDate": "2024-05-13T16:55:05.000Z",
  "lastActivityDate": "2024-05-16T18:35:11.000Z",
  "hasMergeConflict": false,
  "isFirstContribution": false,
  "tooManyFiles": false,
  "hugeChange": false,
  "popularityLevel": "Popular",
  "pkgInfo": [
    {
      "name": "office-js-preview",
      "kind": "edit",
      "files": [
        {
          "path": "types/office-js-preview/index.d.ts",
          "kind": "definition"
        }
      ],
      "owners": [
        "OfficeDev",
        "Rick-Kirkham",
        "AlexJerabek",
        "ElizabethSamuel-MSFT",
        "alison-mk",
        "samantharamon"
      ],
      "addedOwners": [],
      "deletedOwners": [],
      "popularityLevel": "Well-liked by everyone"
    },
    {
      "name": "office-js",
      "kind": "edit",
      "files": [
        {
          "path": "types/office-js/index.d.ts",
          "kind": "definition"
        }
      ],
      "owners": [
        "OfficeDev",
        "Rick-Kirkham",
        "AlexJerabek",
        "ElizabethSamuel-MSFT",
        "alison-mk",
        "samantharamon"
      ],
      "addedOwners": [],
      "deletedOwners": [],
      "popularityLevel": "Popular"
    }
  ],
  "reviews": [
    {
      "type": "approved",
      "reviewer": "Rick-Kirkham",
      "date": "2024-05-16T17:30:24.000Z",
      "isMaintainer": false
    },
    {
      "type": "stale",
      "reviewer": "AlexJerabek",
      "date": "2024-05-13T17:33:24.000Z",
      "abbrOid": "f9c8afb"
    }
  ],
  "mainBotCommentID": 2108222179,
  "ciResult": "pass"
}

[typescript-bot]

🔔 @OfficeDev @Rick-Kirkham @AlexJerabek @ElizabethSamuel-MSFT @alison-mk — please review this PR in the next few days. Be sure to explicitly select Approve or Request Changes in the GitHub UI so I know what's going on.

[samantharamon]

@AlexJerabek tagging for review.

[AlexJerabek]

Some suggestions. Please repeat them in the other d.ts file too.

[typescript-bot]

@samantharamon One or more reviewers has requested changes. Please address their comments. I'll be back once they sign off or you've pushed new commits. Thank you!

[typescript-bot]

@AlexJerabek Thank you for reviewing this PR! The author has pushed new commits since your last review. Could you take another look and submit a fresh review?

[typescript-bot]

@AlexJerabek Thank you for reviewing this PR! The author has pushed new commits since your last review. Could you take another look and submit a fresh review?