@slates-integrations/sharepoint 0.2.0-rc.9 → 0.3.0

package/docs/SPEC.md

@@ -41,7 +41,9 @@ Key SharePoint-related scopes for Microsoft Graph include:
 - `User.Read`, `offline_access`
 - `Sites.Selected` — restricts an application's access to specific site collections. Now lists, list items, folders, and files are also supported, and all Selected scopes support delegated and application modes.
 
-Application permissions typically require admin consent. Access tokens generated for Microsoft Graph resources are not valid for the SharePoint REST API — use the correct audience (`https://graph.microsoft.com` vs. `https://{tenant}.sharepoint.com`) depending on which API you call.
+SharePoint REST-backed list and column operations require the Office 365 SharePoint Online delegated `AllSites.Manage` permission. Microsoft Graph `Sites.Manage.All` is a separate permission and does not authorize SharePoint REST calls. Custom Entra applications must configure both API resources, grant tenant consent when required, and reconnect after permission changes.
+
+Application permissions typically require admin consent. Access tokens generated for Microsoft Graph resources are not valid for the SharePoint REST API — use the correct audience (`https://graph.microsoft.com` vs. `https://{tenant}.sharepoint.com`) depending on which API you call. SharePoint REST-backed tools derive the tenant SharePoint host from Microsoft Graph and exchange the refresh token for a SharePoint resource token. Connection health requires complete, unexpired auth state for both resources.
 
 ### Certificate-Based Authentication
 
@@ -57,6 +59,12 @@ The SharePoint API in Microsoft Graph supports access to SharePoint sites, lists
 
 Lists are the foundation for data storage in SharePoint. You can create lists to store a variety of business data, from a simple customer contact list to a custom business application. When you use columns to define your schema, SharePoint can protect the integrity of your data as well as enable rich indexing, querying, and search capabilities. The API supports full CRUD operations on lists and list items, including defining custom columns.
 
+SharePoint URL/Hyperlink columns use the SharePoint `URL` field type with `Url` and `Description` values. Microsoft Graph list column metadata can omit the `hyperlinkOrPicture` facet for list columns, so list item updates for Hyperlink object values use SharePoint REST field metadata and `SP.FieldUrlValue` while ordinary scalar field updates continue to use Microsoft Graph.
+
+### Site Users and Person Fields
+
+SharePoint Person/Group list columns store the numeric site-scoped user ID, not the user's Microsoft Entra object ID. The SharePoint REST API exposes site users through `/_api/web/siteusers`, including `GetByEmail(email)`, which returns the numeric `Id`, `LoginName`, `Email`, and `Title` values needed to update Person/Group fields through Graph list item field payloads such as `{fieldName}LookupId`.
+
 ### Document Libraries and Files
 
 SharePoint stores files in a special list type called a document library. You can use the OneDrive API to work with a library as a drive, or the SharePoint API to work with it as a list. Just like a regular list, you can extend the schema of a Document Library to support your business needs with custom columns. This includes uploading, downloading, moving, copying, and versioning files.

package/package.json

@@ -4,19 +4,22 @@
   "type": "module",
   "scripts": {
     "build": "bunx @vercel/ncc build src/index.ts -o dist -m -s",
+    "test": "vitest run --config vitest.config.ts --passWithNoTests",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@slates/oauth-microsoft": "1.0.0-rc.5",
+    "@slates/oauth-microsoft": "1.0.0-rc.6",
     "@lowerdeck/error": "^1.1.0",
     "@types/node": "^20",
-    "slates": "1.0.0-rc.14",
+    "slates": "1.0.0-rc.17",
     "zod": "^4.2"
   },
   "devDependencies": {
+    "@slates/test": "1.0.0-rc.14",
+    "vitest": "^3.1.2",
     "typescript": "^5"
   },
-  "version": "0.2.0-rc.9",
+  "version": "0.3.0",
   "files": [
     "dist/**",
     "docs/**",

package/slate.json

@@ -1,12 +1,14 @@
 {
   "name": "@microsoft/sharepoint",
-  "description": "Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.",
+  "description": "Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.",
   "categories": ["apis-and-http-requests", "document-processing", "email-and-messaging"],
   "skills": [
     "manage sites and libraries",
     "upload and download files",
     "create and manage lists",
     "CRUD list items",
+    "resolve site users",
+    "populate person fields",
     "search files and sites",
     "manage permissions",
     "define content types",