Office365-REST-Python-Client 3.1.0__py3-none-any.whl → 3.2.0__py3-none-any.whl

office365/sharepoint/convergence/addnoliveblobsinodcservicestateapi.py

@@ -1,3 +1,6 @@
+from typing_extensions import Self
+
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
 
 
@@ -5,3 +8,9 @@ class AddNoLiveBlobsInOdcServiceStateApi(Entity):
     @property
     def entity_type_name(self) -> str:
         return "Microsoft.SharePoint.Convergence.AddNoLiveBlobsInOdcServiceStateApi"
+
+    def add_state(self) -> Self:
+        """AddState operation."""
+        qry = ServiceOperationQuery(self, "AddState", None, {}, None, None)
+        self.context.add_query(qry)
+        return self

office365/sharepoint/convergence/consumer_permissions.py

@@ -1,4 +1,7 @@
+from typing_extensions import Self
+
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
 
 
@@ -11,3 +14,15 @@ class ConsumerPermissions(Entity):
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Convergence.ConsumerPermissions"
+
+    def grant_consumer_site_permissions(self) -> Self:
+        """GrantConsumerSitePermissions operation."""
+        qry = ServiceOperationQuery(self, "GrantConsumerSitePermissions", None, {}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    def revoke_consumer_site_permissions(self) -> Self:
+        """RevokeConsumerSitePermissions operation."""
+        qry = ServiceOperationQuery(self, "RevokeConsumerSitePermissions", None, {}, None, None)
+        self.context.add_query(qry)
+        return self

office365/sharepoint/convergence/migration_complete_state_api.py

@@ -1,3 +1,8 @@
+from typing_extensions import Self
+
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.function import FunctionQuery
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
 
 
@@ -7,3 +12,23 @@ class MigrationCompleteStateApi(Entity):
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.Convergence.MigrationCompleteStateApi"
+
+    def add_state(self) -> Self:
+        """AddState operation."""
+        qry = ServiceOperationQuery(self, "AddState", None, {}, None, None)
+        self.context.add_query(qry)
+        return self
+
+    def is_doclib_contributor_owner_enabled(self) -> ClientResult[bool]:
+        """IsDoclibContributorOwnerEnabled operation."""
+        return_type = ClientResult(self.context, bool())
+        qry = FunctionQuery(self, "IsDoclibContributorOwnerEnabled", [], return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    def is_suspended(self) -> ClientResult[bool]:
+        """IsSuspended operation."""
+        return_type = ClientResult(self.context, bool())
+        qry = FunctionQuery(self, "IsSuspended", [], return_type)
+        self.context.add_query(qry)
+        return return_type

office365/sharepoint/convergence/odcmetadatacleanedupapi.py

@@ -1,3 +1,6 @@
+from typing_extensions import Self
+
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 from office365.sharepoint.entity import Entity
 
 
@@ -5,3 +8,9 @@ class OdcMetadataCleanedUpApi(Entity):
     @property
     def entity_type_name(self) -> str:
         return "Microsoft.SharePoint.Convergence.OdcMetadataCleanedUpApi"
+
+    def add_state(self) -> Self:
+        """AddState operation."""
+        qry = ServiceOperationQuery(self, "AddState", None, {}, None, None)
+        self.context.add_query(qry)
+        return self

office365/sharepoint/documentmanagement/document_id.py

@@ -73,3 +73,15 @@ class DocumentId(Entity):
     @property
     def entity_type_id(self):
         return "fb7276a2-cd36-448b-8a60-a589205f5a8f"
+
+    def reset_doc_id_by_server_relative_path(self, decoded_url: str) -> Self:
+        """ResetDocIdByServerRelativePath operation.
+
+        Args:
+            decoded_url (str): DecodedUrl parameter
+        """
+        qry = ServiceOperationQuery(
+            self, "ResetDocIdByServerRelativePath", None, {"DecodedUrl": decoded_url}, None, None
+        )
+        self.context.add_query(qry)
+        return self

office365/sharepoint/entity.py

@@ -12,6 +12,7 @@ from office365.runtime.http.url import get_absolute_url
 from office365.runtime.paths.v3.entity import EntityPath
 from office365.runtime.queries.delete_entity import DeleteEntityQuery
 from office365.runtime.queries.update_entity import UpdateEntityQuery
+from office365.sharepoint.thresholds import Limits, limit
 
 if TYPE_CHECKING:
     from office365.sharepoint.client_context import ClientContext
@@ -35,11 +36,13 @@ class Entity(ClientObject):
         self.context.execute_query_with_incremental_retry(max_retry, max_delay=max_delay, jitter=jitter)
         return self
 
+    @limit(Limits.BATCH_ITEMS, arg="items_per_batch")
     def execute_batch(
         self,
-        items_per_batch: int = 100,
+        items_per_batch: int = Limits.BATCH_ITEMS.value,
         success_callback: Optional[Callable[[List[Union[ClientObject, ClientResult]]], None]] = None,
         max_batch_bytes: Optional[int] = None,
+        concurrency: int = 1,
     ) -> Self:
         """
         Construct and submit a batch request to the server
@@ -48,11 +51,17 @@ class Entity(ClientObject):
             items_per_batch: Number of items per batch (default: 100)
             success_callback: Callback function for successful batch execution
             max_batch_bytes: Maximum estimated batch payload size in bytes
+            concurrency: Maximum number of concurrent batch requests (default 1)
 
         Returns:
             self: Supports method chaining
         """
-        self.context.execute_batch(items_per_batch, success_callback, max_batch_bytes=max_batch_bytes)
+        self.context.execute_batch(
+            items_per_batch,
+            success_callback,
+            concurrency=concurrency,
+            max_batch_bytes=max_batch_bytes,
+        )
         return self
 
     def with_credentials(self, credentials: Union[UserCredential, ClientCredential]) -> Self:

office365/sharepoint/entity_collection.py

@@ -3,16 +3,16 @@ from __future__ import annotations
 from typing import TYPE_CHECKING, Optional, Type, cast
 
 from office365.runtime.client_object import ClientObjectT
-from office365.runtime.client_object_collection import ClientObjectCollection
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.paths.v3.entity import EntityPath
+from office365.runtime.record_collection import RecordCollection
 from office365.sharepoint.entity import Entity
 
 if TYPE_CHECKING:
     from office365.sharepoint.client_context import ClientContext
 
 
-class EntityCollection(ClientObjectCollection[ClientObjectT]):
+class EntityCollection(RecordCollection[ClientObjectT]):
     """A type-safe collection of SharePoint entities.
 
     Provides strongly-typed access to SharePoint entity collections with support for:

office365/sharepoint/exceptions.py

@@ -0,0 +1,194 @@
+"""SharePoint-specific request exceptions.
+
+These self-register with
+:func:`~office365.runtime.client_request_exception.register_error_type` so the
+product-agnostic dispatcher in the runtime can classify SharePoint error
+responses without importing this package.
+
+Classification never matches translated messages: SharePoint encodes the error
+as ``"<HRESULT>, <dotnet-type>"`` (e.g. ``"-2130575169,
+Microsoft.SharePoint.SPDuplicateValuesFoundException"``), so the concrete types
+below key off the numeric code and/or the embedded .NET type name — both locale
+independent. Any remaining ``Microsoft.SharePoint.*`` error is caught by
+:class:`SharePointException`.
+"""
+
+from __future__ import annotations
+
+from office365.runtime.client_request_exception import (
+    ClientRequestException,
+    ErrorPayload,
+    register_error_type,
+)
+from office365.runtime.exceptions import FileLockedException
+from office365.sharepoint.thresholds import LIST_VIEW_THRESHOLD, SAFE_PAGE_SIZE
+
+#: SharePoint-flavoured alias of :class:`~office365.runtime.exceptions.FileLockedException`.
+#: Raised when a file is open for coauthoring (HTTP 423 /
+#: ``Microsoft.SharePoint.SPFileLockException``) and therefore cannot be
+#: overwritten. See ``FileLockedException.GUIDANCE`` for the available options.
+SPFileLockedException = FileLockedException
+
+
+class SharePointException(ClientRequestException):
+    """Base class for SharePoint server exceptions (``Microsoft.SharePoint.*``).
+
+    Serves as a catch-all so callers can ``except SharePointException`` for any
+    otherwise-unclassified SharePoint error. Concrete subclasses set
+    :attr:`_HRESULTS` and/or :attr:`_TYPE_NAMES`; they are picked over this base
+    by :attr:`ClientRequestException.MATCH_PRIORITY`.
+    """
+
+    MATCH_PRIORITY = 0
+
+    _HRESULTS: tuple[str, ...] = ()
+    _TYPE_NAMES: tuple[str, ...] = ()
+
+    @classmethod
+    def matches(cls, payload: ErrorPayload) -> bool:
+        if not cls._HRESULTS and not cls._TYPE_NAMES:
+            # Catch-all: any SharePoint-flavoured code, whatever the concrete type.
+            return "microsoft.sharepoint." in payload.code.lower()
+        error_type = (payload.error_type or "").lower()
+        if payload.hresult is not None and payload.hresult in cls._HRESULTS:
+            return True
+        return any(name.lower() in error_type for name in cls._TYPE_NAMES)
+
+
+class SecurityValidationException(SharePointException):
+    """Raised when SharePoint rejects an expired/invalid form digest (HTTP 403)."""
+
+    MATCH_PRIORITY = 10
+    _HRESULTS = ("-2130575251",)
+
+
+class SPQueryThrottledException(SharePointException):
+    """Raised when a query exceeds the SharePoint **list view threshold**.
+
+    SharePoint blocks (HTTP 500) queries that filter or sort on a **non-indexed**
+    column and would scan/return more than the threshold (5,000 items by default),
+    and sometimes single-shot collection loads of a large collection. See
+    https://learn.microsoft.com/en-us/microsoft-365/community/how-to-handle-list-view-threshold
+
+    Classification keys off the stable error code (``-2147024860``) and the
+    embedded type name, so localized messages are handled the same way.
+    """
+
+    MATCH_PRIORITY = 10
+    _HRESULTS = ("-2147024860",)
+    _TYPE_NAMES = ("SPQueryThrottledException",)
+
+    GUIDANCE = (
+        f"This exceeds the SharePoint list view threshold ({LIST_VIEW_THRESHOLD:,} items by default). "
+        f"To fix it, either: (1) page through the data with get_all(page_size<={SAFE_PAGE_SIZE}) "
+        "(for list items) or Folder.get_files() / List.get_items(query, page_size=...); "
+        "(2) filter/sort on an indexed column - add one with List.ensure_indexed('Column'); "
+        "or (3) filter on ID (always indexed)."
+    )
+
+    def __str__(self) -> str:
+        return f"{super().__str__()}\n{self.GUIDANCE}"
+
+
+class SPFileCheckOutException(SharePointException):
+    """Raised when a file operation is rejected because of its check-out state.
+
+    SharePoint returns HTTP 423 here too, but this is a *check-out* lock (an
+    explicit reservation), not the shared coauthoring lock behind
+    :class:`~office365.runtime.exceptions.FileLockedException`. A check-out can
+    be released by its owner, so it is actionable rather than permanent.
+    """
+
+    MATCH_PRIORITY = 15  # beats the status-only HTTP 423 match on FileLockedException
+    _HRESULTS = ("-2130575306",)
+    _TYPE_NAMES = ("SPFileCheckOutException",)
+
+    GUIDANCE = (
+        "The file is checked out (reserved for editing) by another session. Unlike a shared "
+        "coauthoring lock, a check-out can be released: the owner can call File.checkin(...) to "
+        "keep the changes or File.undocheckout() to discard them (permissions permitting)."
+    )
+
+    def __str__(self) -> str:
+        return f"{super().__str__()}\n{self.GUIDANCE}"
+
+
+class SPListDataValidationException(SharePointException):
+    """Raised when a list-level or field-level validation formula rejects a value.
+
+    SharePoint reports both list validation and (field) value validation with
+    this type: ``-2130575162`` for the list formula, ``-2130575163`` for the field.
+    """
+
+    MATCH_PRIORITY = 15
+    _HRESULTS = ("-2130575162", "-2130575163")
+    _TYPE_NAMES = ("SPListDataValidationException",)
+
+
+class SPFieldValidationException(SharePointException):
+    """Raised when a field value (or schema) is rejected — e.g. an unknown term."""
+
+    MATCH_PRIORITY = 15
+    _HRESULTS = ("-2146232832",)
+    _TYPE_NAMES = ("SPFieldValidationException",)
+
+
+class SPFieldValueException(SharePointException):
+    """Raised when a field value is malformed or otherwise invalid."""
+
+    MATCH_PRIORITY = 15
+    _TYPE_NAMES = ("SPFieldValueException",)
+
+
+class SPDuplicateValuesFoundException(SharePointException):
+    """Raised when a value already exists in a column that enforces unique values."""
+
+    MATCH_PRIORITY = 15
+    _HRESULTS = ("-2130575169",)
+    _TYPE_NAMES = ("SPDuplicateValuesFoundException",)
+
+
+class SPInvalidLookupValuesException(SharePointException):
+    """Raised when a lookup value does not reference an existing item."""
+
+    MATCH_PRIORITY = 15
+    _TYPE_NAMES = ("SPInvalidLookupValuesException",)
+
+
+class SPContentTypeReadOnlyException(SharePointException):
+    """Raised when mutating a read-only content type."""
+
+    MATCH_PRIORITY = 15
+    _TYPE_NAMES = ("SPContentTypeReadOnlyException",)
+
+
+class SPContentTypeSealedException(SharePointException):
+    """Raised when mutating a sealed content type."""
+
+    MATCH_PRIORITY = 15
+    _TYPE_NAMES = ("SPContentTypeSealedException",)
+
+
+_SP_EXCEPTION_TYPES = (
+    SecurityValidationException,
+    SPQueryThrottledException,
+    SPFileCheckOutException,
+    SPListDataValidationException,
+    SPFieldValidationException,
+    SPFieldValueException,
+    SPDuplicateValuesFoundException,
+    SPInvalidLookupValuesException,
+    SPContentTypeReadOnlyException,
+    SPContentTypeSealedException,
+)
+
+
+# Register the catch-all first so concrete types share its precedence baseline,
+# then the concrete types (all higher priority).
+def _register_exceptions() -> None:
+    register_error_type(SharePointException)
+    for exc_type in _SP_EXCEPTION_TYPES:
+        register_error_type(exc_type)
+
+
+_register_exceptions()

office365/sharepoint/fields/builtin_field_id.py

@@ -1,38 +1,49 @@
-class SPBuiltInFieldId:
-    """Retrieves identifiers for the fields that ship with Microsoft SharePoint Foundation."""
-
-    Author = "Author"
-    """Identifies a field that contains the specified author of the SharePoint Foundation object."""
-
-    Created = "Created"
-    """Identifies a field that contains the date and time when the specified SharePoint Foundation object was created"""
-
-    FSObjType = "FSObjType"
-    """Identifies a field that contains information about the file system type"""
+"""GUIDs of the built-in SharePoint fields (MS-WSSTS "Data Fields").
 
-    FileDirRef = "FileDirRef"
-    """Identifies a field that contains information about the file directory for the specified
-    SharePoint Foundation object."""
+Complements :class:`~office365.sharepoint.fields.builtin_field_name.SPBuiltInFieldName`
+(names) with the stable field IDs from the MS-WSSTS specification
+(https://learn.microsoft.com/en-us/openspecs/sharepoint_protocols/ms-wssts/83747ceb-f9a5-456b-bc45-692671c6ce6b).
+"""
 
-    FileLeafRef = "FileLeafRef"
-    """Identifies a field that contains information about the server-relative URL for the file node that is
-    associated with the specified SharePoint Foundation object."""
+from __future__ import annotations
 
-    FileType = "FileType"
-    """Identifies a field that contains information about the file type for version history of the specified
-    SharePoint Foundation library picture object."""
 
-    FirstName = "FirstName"
-    """Identifies a field that contains the first name for the specified SharePoint Foundation contact object."""
-
-    FormData = "FormData"
-    """Identifies a field that contains the FormData property for the specified
-    Microsoft SharePoint Foundation contact object."""
-
-    FormURN = "FormURN"
-    """Identifies a field that contains the FormURN property for the specified
-    Microsoft SharePoint Foundation contact object."""
-
-    fRecurrence = "fRecurrence"
-    """Identifies a field that contains information about the recurrence field of the specified SharePoint Foundation
-    calendar event object."""
+class SPBuiltInFieldId:
+    """GUIDs of the fields that ship with Microsoft SharePoint Foundation."""
+
+    _CopySource = "{6b4e226d-3d88-4a36-808d-a129bf52bccf}"
+    _HasCopyDestinations = "{26d0756c-986a-48a7-af35-bf18ab85ff4a}"
+    _IsCurrentVersion = "{c101c3e7-122d-4d4d-bc34-58e94a38c816}"
+    _Level = "{43bdd51b-3c5b-4e78-90a8-fb2087f71e70}"
+    _ModerationStatus = "{fdc3b2ed-5bf2-4835-a4bc-b885f3396a61}"
+    _UIVersion = "{7841bf41-43d0-4434-9f50-a673baef7631}"
+    _UIVersionString = "{dce8262a-3ae9-45aa-aab4-83bd75fb738a}"
+    Author = "{1df5e554-ec7e-46a6-901d-d85a3881cb18}"
+    BaseName = "{7615464b-559e-4302-b8e2-8f440b913101}"
+    ContentType = "{c042a256-787d-4a6f-8a8a-cf6ab767f12d}"
+    ContentTypeId = "{03e45e84-1992-4d42-9116-26f756012634}"
+    Created = "{8c06beca-0777-48f7-91c7-6da68bc07b69}"
+    Created_x0020_Date = "{998b5cff-4a35-47a7-92f3-3914aa6aa4a2}"
+    Editor = "{d31655d1-1d5b-4511-95a1-7a09e9b75bf2}"
+    EncodedAbsUrl = "{7177cfc7-f399-4d4d-905d-37dd51bc90bf}"
+    File_x0020_Type = "{39360f11-34cf-4356-9945-25c44e68dade}"
+    FileDirRef = "{56605df6-8fa1-47e4-a04c-5b384d59609f}"
+    FileLeafRef = "{8553196d-ec8d-4564-9861-3dbe931050c8}"
+    FileRef = "{94f89715-e097-4e8b-ba79-ea02aa8b7adb}"
+    FolderChildCount = "{960ff01f-2b6d-4f1b-9c3f-e19ad8927341}"
+    FSObjType = "{30bb605f-5bae-48fe-b4e3-1f81d9772af9}"
+    ID = "{1d22ea11-1e32-424e-89ab-9fedbadb6ce1}"
+    InstanceID = "{50a54da4-1528-4e67-954a-e2d24f1e9efb}"
+    ItemChildCount = "{b824e17e-a1b3-426e-aecf-f0184d900485}"
+    Last_x0020_Modified = "{173f76c8-aebd-446a-9bc9-769a2bd2c18f}"
+    MetaInfo = "{687c7f94-686a-42d3-9b67-2782eac4b4f8}"
+    Modified = "{28cf69c5-fa48-462a-b5cd-27b6f9d2bd5f}"
+    Order = "{ca4addac-796f-4b23-b093-d2a3f65c0774}"
+    owshiddenversion = "{d4e44a66-ee3a-4d02-88c9-4ec5ff3f4cd5}"
+    PermMask = "{BA3C27EE-4791-4867-8821-FF99000BAC98}"
+    ProgId = "{c5c4b81c-f1d9-4b43-a6a2-090df32ebb68}"
+    ScopeId = "{dddd2420-b270-4735-93b5-92b713d0944d}"
+    ServerUrl = "{105f76ce-724a-4bba-aece-f81f2fce58f5}"
+    SortBehavior = "{423874f8-c300-4bfb-b7a1-42e2159e3b19}"
+    SyncClientId = "{6d2c4fde-3605-428e-a236-ce5f3dc2b4d4}"
+    UniqueId = "{4b7403de-8d94-43e8-9f0f-137a3e298126}"

office365/sharepoint/fields/builtin_field_name.py

@@ -0,0 +1,123 @@
+"""Built-in SharePoint field internal names — the single source of truth.
+
+The names come from the MS-WSSTS "Data Fields" specification
+(https://learn.microsoft.com/en-us/openspecs/sharepoint_protocols/ms-wssts/83747ceb-f9a5-456b-bc45-692671c6ce6b).
+Use :data:`SYSTEM_FIELD_NAMES` to filter system/bookkeeping columns out of a
+projection or schema (migration, assessment, exporters).
+"""
+
+from __future__ import annotations
+
+
+class SPBuiltInFieldName:
+    """Internal names of the built-in (system) SharePoint fields (MS-WSSTS)."""
+
+    _CopySource = "_CopySource"
+    _HasCopyDestinations = "_HasCopyDestinations"
+    _IsCurrentVersion = "_IsCurrentVersion"
+    _Level = "_Level"
+    _ModerationStatus = "_ModerationStatus"
+    _UIVersion = "_UIVersion"
+    _UIVersionString = "_UIVersionString"
+    Author = "Author"
+    BaseName = "BaseName"
+    ContentType = "ContentType"
+    ContentTypeId = "ContentTypeId"
+    Created = "Created"
+    Created_x0020_Date = "Created_x0020_Date"
+    Editor = "Editor"
+    EncodedAbsUrl = "EncodedAbsUrl"
+    File_x0020_Type = "File_x0020_Type"
+    FileDirRef = "FileDirRef"
+    FileLeafRef = "FileLeafRef"
+    FileRef = "FileRef"
+    FolderChildCount = "FolderChildCount"
+    FSObjType = "FSObjType"
+    ID = "ID"
+    InstanceID = "InstanceID"
+    ItemChildCount = "ItemChildCount"
+    Last_x0020_Modified = "Last_x0020_Modified"
+    MetaInfo = "MetaInfo"
+    Modified = "Modified"
+    Order = "Order"
+    owshiddenversion = "owshiddenversion"
+    PermMask = "PermMask"
+    ProgId = "ProgId"
+    ScopeId = "ScopeId"
+    ServerUrl = "ServerUrl"
+    SortBehavior = "SortBehavior"
+    SyncClientId = "SyncClientId"
+    UniqueId = "UniqueId"
+
+    ALL: frozenset[str] = frozenset(
+        {
+            _CopySource,
+            _HasCopyDestinations,
+            _IsCurrentVersion,
+            _Level,
+            _ModerationStatus,
+            _UIVersion,
+            _UIVersionString,
+            Author,
+            BaseName,
+            ContentType,
+            ContentTypeId,
+            Created,
+            Created_x0020_Date,
+            Editor,
+            EncodedAbsUrl,
+            File_x0020_Type,
+            FileDirRef,
+            FileLeafRef,
+            FileRef,
+            FolderChildCount,
+            FSObjType,
+            ID,
+            InstanceID,
+            ItemChildCount,
+            Last_x0020_Modified,
+            MetaInfo,
+            Modified,
+            Order,
+            owshiddenversion,
+            PermMask,
+            ProgId,
+            ScopeId,
+            ServerUrl,
+            SortBehavior,
+            SyncClientId,
+            UniqueId,
+        }
+    )
+
+    @classmethod
+    def is_builtin(cls, name: str) -> bool:
+        """Whether ``name`` is a built-in SharePoint field internal name."""
+        return name in cls.ALL
+
+
+# System/bookkeeping columns that SharePoint exposes but the MS-WSSTS "Data
+# Fields" list does not enumerate (moderation, versioning, app metadata, ...).
+EXTRA_SYSTEM_FIELD_NAMES: frozenset[str] = frozenset(
+    {
+        "AppAuthor",
+        "AppEditor",
+        "Attachments",
+        "ComplianceAssetId",
+        "EffectivePermMask",
+        "GUID",
+        "Version",
+        "VirusStatus",
+        "WorkflowVersion",
+        "_CheckinComment",
+        "_ColorHex",
+        "_ColorTag",
+        "_CopySource",
+        "_Emoji",
+        "_HasCopyDestinations",
+        "_ModerationComments",
+    }
+)
+
+#: Every known system column internal name (spec + library extras).
+SYSTEM_FIELD_NAMES: frozenset[str] = SPBuiltInFieldName.ALL | EXTRA_SYSTEM_FIELD_NAMES