microsoft-graph-client 1.0.52 → 1.0.53

package/dist/api/users.js.map

@@ -1 +1 @@
-{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/api/users.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/api/users.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { GraphClient } from './client.js';
 export { BaseApi, CalendarApi, ChatsApi, FilesApi, MailApi, MailFoldersApi, MailRulesApi, MessagesApi, PlacesApi, TranscriptsApi, UsersApi, } from './api/index.js';
 export { Authenticator } from './auth/index.js';
-export { encodeSharePointUrl, escapeODataString, extractChatIdFromJoinUrl, extractMeetingInfoFromJoinUrl, markdownToHtml, sanitizeHtml, } from './utils/index.js';
-export type { MeetingInfo } from './utils/index.js';
+export { RETENTION_FLAGS_PROPERTY, RETENTION_PERIOD_PROPERTY, RETENTION_PROPERTY_FILTER, RETENTION_TAG_PROPERTY, buildRetentionProperties, decodeRetentionTag, encodeRetentionTag, encodeSharePointUrl, escapeODataLiteral, extractChatIdFromJoinUrl, extractMeetingInfoFromJoinUrl, markdownToHtml, odataAnyOf, odataFilter, odataFilterValue, odataRaw, odataSearch, odataSearchValue, parseRetentionPolicy, sanitizeHtml, } from './utils/index.js';
+export type { MeetingInfo, ODataRaw, ODataTemplateValue, RetentionPolicy, RetentionPropertyPayload, SingleValueExtendedProperty, } from './utils/index.js';
 export type { GraphApiResponse, GraphClientConfig, GraphError, GetUserParams, GetUserPhotoMetadataParams, GetUserPhotoParams, GetUserPhotoResult, SearchUsersParams, User, UserPhotoMetadata, UserPhotoSize, PreferredPresenceAvailability, PresenceAvailability, SetPreferredPresenceParams, SetPresenceParams, Chat, ChatType, ConversationMember, CreateChatParams, GetChatParams, ListChatsParams, ListChatsResult, ChatMessage, ChatMessageAttachment, ChatMessageImportance, ChatMessageInfo, ChatMessageMention, DownloadHostedContentParams, DownloadHostedContentResult, GetChatMessagesParams, ItemBody, SearchHit, SearchHitsContainer, SearchMessagesParams, SearchRequest, SearchResponse, SearchResult, SendChatMessageParams, SetMessageReactionParams, UnsetMessageReactionParams, UpdateChatMessageParams, CopyMailParams, EmailAddress, FileAttachment, ListMailsParams, Message, MoveMailParams, SendMailParams, CreateMailFolderParams, DeleteMailFolderParams, GetMailFolderParams, ListChildMailFoldersParams, ListMailFoldersParams, MailFolder, MoveMailFolderParams, UpdateMailFolderParams, CreateMailRuleParams, DeleteMailRuleParams, GetMailRuleParams, ListMailRulesParams, MessageRule, MessageRuleActions, MessageRulePredicates, UpdateMailRuleParams, Attendee, CancelCalendarEventParams, CreateCalendarEventParams, DateTimeTimeZone, Event, FindMeetingTimesParams, GetCalendarEventsParams, Location, MeetingTimeSuggestion, MeetingTimeSuggestionsResult, NullableOption, DownloadSharePointFileParams, DownloadSharePointFileResult, DriveItem, DriveItemMeetingSource, GetDriveItemParams, GrantFilePermissionParams, SearchFilesParams, UpdateSharePointFileParams, UpdateSharePointFileResult, UploadToSharePointParams, UploadToSharePointResult, CallTranscript, GetMeetingByJoinUrlParams, GetTranscriptContentParams, ListTranscriptsParams, OnlineMeeting, GetScheduleParams, Room, ScheduleItem, } from './types/index.js';
 export { DEFAULT_SCOPES, USER_PHOTO_SIZES } from './types/index.js';
 export type { Client as GraphSDKClient, ResponseType } from '@microsoft/microsoft-graph-client';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,cAAc,EACd,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACd,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,6BAA6B,EAC7B,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,YAAY,EAEV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EAEV,aAAa,EACb,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,IAAI,EACJ,iBAAiB,EACjB,aAAa,EAEb,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,iBAAiB,EAEjB,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EAEf,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EAEvB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,OAAO,EACP,cAAc,EACd,cAAc,EAEd,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EAEtB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EAEpB,QAAQ,EACR,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,KAAK,EACL,sBAAsB,EACtB,uBAAuB,EACvB,QAAQ,EACR,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,EAEd,4BAA4B,EAC5B,4BAA4B,EAC5B,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EAExB,cAAc,EACd,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EAEb,iBAAiB,EACjB,IAAI,EACJ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpE,YAAY,EAAE,MAAM,IAAI,cAAc,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,cAAc,EACd,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACd,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAC7B,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAEV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EAEV,aAAa,EACb,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,IAAI,EACJ,iBAAiB,EACjB,aAAa,EAEb,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,iBAAiB,EAEjB,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EAEf,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EAEvB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,OAAO,EACP,cAAc,EACd,cAAc,EAEd,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EAEtB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EAEpB,QAAQ,EACR,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,KAAK,EACL,sBAAsB,EACtB,uBAAuB,EACvB,QAAQ,EACR,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,EAEd,4BAA4B,EAC5B,4BAA4B,EAC5B,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EAExB,cAAc,EACd,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EAEb,iBAAiB,EACjB,IAAI,EACJ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpE,YAAY,EAAE,MAAM,IAAI,cAAc,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -5,6 +5,6 @@ export { BaseApi, CalendarApi, ChatsApi, FilesApi, MailApi, MailFoldersApi, Mail
 // Auth exports
 export { Authenticator } from './auth/index.js';
 // Utility exports
-export { encodeSharePointUrl, escapeODataString, extractChatIdFromJoinUrl, extractMeetingInfoFromJoinUrl, markdownToHtml, sanitizeHtml, } from './utils/index.js';
+export { RETENTION_FLAGS_PROPERTY, RETENTION_PERIOD_PROPERTY, RETENTION_PROPERTY_FILTER, RETENTION_TAG_PROPERTY, buildRetentionProperties, decodeRetentionTag, encodeRetentionTag, encodeSharePointUrl, escapeODataLiteral, extractChatIdFromJoinUrl, extractMeetingInfoFromJoinUrl, markdownToHtml, odataAnyOf, odataFilter, odataFilterValue, odataRaw, odataSearch, odataSearchValue, parseRetentionPolicy, sanitizeHtml, } from './utils/index.js';
 export { DEFAULT_SCOPES, USER_PHOTO_SIZES } from './types/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAqB;AACrB,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,cAAc,EACd,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACd,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAExB,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,6BAA6B,EAC7B,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAiH1B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAqB;AACrB,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,cAAc,EACd,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACd,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAExB,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,kBAAkB;AAClB,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAC7B,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAwH1B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/mail.d.ts

@@ -1,5 +1,6 @@
 export type { Message, EmailAddress } from '@microsoft/microsoft-graph-types';
 export interface ListMailsParams {
+    /** Page size (default: 20). Graph clamps `$top` on `/me/messages` at 1000. */
     limit?: number;
     /** Well-known folder name or folder ID. Defaults to inbox. Well-known names: inbox, sentitems, drafts, deleteditems, junkemail, archive */
     folder?: string;
@@ -9,8 +10,8 @@ export interface ListMailsParams {
     until?: string;
     unreadOnly?: boolean;
     hasAttachments?: boolean;
-    /** Filter by sender email address */
-    from?: string;
+    /** Sender email addresses. A message matches if it came from any of them. */
+    from?: string[];
     /** Include full message body in response */
     includeBody?: boolean;
     /** Format for the body: 'text' or 'html' (default: 'html') */

package/dist/types/mail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/types/mail.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/types/mail.ts"],"names":[],"mappings":"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"}

package/dist/types/mailFolder.d.ts

@@ -2,8 +2,22 @@ export type { MailFolder } from '@microsoft/microsoft-graph-types';
 export interface ListMailFoldersParams {
     /** Page size (default: 50, max: 250). */
     limit?: number;
-    /** Expand child folders one level deep — useful for tree rendering. */
+    /**
+     * Expand child folders one level deep — useful for tree rendering.
+     *
+     * One level is the limit Graph enforces. A nested
+     * `childFolders($expand=childFolders)` is accepted and returns 200, but the
+     * grandchildren are silently absent, so a caller that needs the whole tree
+     * has to walk it.
+     */
     includeChildFolders?: boolean;
+    /**
+     * Expand each folder's retention policy (Outlook's "Assign Policy").
+     *
+     * Rides the same request at no extra round-trip and composes with
+     * `includeChildFolders`, which also carries the policy for each child.
+     */
+    includeRetentionPolicy?: boolean;
     /** Include hidden folders (default: false). Hidden folders are system-managed. */
     includeHidden?: boolean;
     /** Opaque `@odata.nextLink` from a previous response — when set, all other params are ignored. */
@@ -14,6 +28,8 @@ export interface ListChildMailFoldersParams {
     folderId: string;
     /** Page size (default: 50, max: 250). */
     limit?: number;
+    /** Expand each folder's retention policy. See {@link ListMailFoldersParams.includeRetentionPolicy}. */
+    includeRetentionPolicy?: boolean;
     /** Include hidden folders (default: false). */
     includeHidden?: boolean;
     /** Opaque `@odata.nextLink` from a previous response — when set, all other params are ignored. */
@@ -22,6 +38,8 @@ export interface ListChildMailFoldersParams {
 export interface GetMailFolderParams {
     /** Folder id, or a well-known name (`inbox`, `drafts`, `sentitems`, `deleteditems`, `junkemail`, `archive`). */
     folderId: string;
+    /** Expand the folder's retention policy. See {@link ListMailFoldersParams.includeRetentionPolicy}. */
+    includeRetentionPolicy?: boolean;
 }
 export interface CreateMailFolderParams {
     displayName: string;
@@ -36,6 +54,26 @@ export interface UpdateMailFolderParams {
     displayName?: string;
     /** Toggle visibility from system folders perspective. */
     isHidden?: boolean;
+    /**
+     * Retention tag GUID to assign (Outlook's "Assign Policy").
+     *
+     * **Graph accepts a tag that does not exist**, stores it, and reads it back
+     * perfectly; the Managed Folder Assistant then ignores it forever. Nothing
+     * here can tell the difference, so validate the GUID against the tags a
+     * mailbox actually uses before calling this.
+     */
+    retentionTag?: string;
+    /** Days before the tag's action applies. Only meaningful alongside `retentionTag`. */
+    retentionPeriodDays?: number;
+    /**
+     * Remove the folder's retention policy.
+     *
+     * Sends `value: null` for all three properties, which is the only spelling
+     * that deletes them — an empty string stores an empty string and the folder
+     * still looks policed. Exchange leaves `PR_RETENTION_FLAGS` behind as 128
+     * afterwards; a folder is policed when it has a tag, not when it has flags.
+     */
+    clearRetention?: boolean;
 }
 export interface DeleteMailFolderParams {
     folderId: string;

package/dist/types/mailFolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mailFolder.d.ts","sourceRoot":"","sources":["../../src/types/mailFolder.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAMnE,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,gHAAgH;IAChH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"mailFolder.d.ts","sourceRoot":"","sources":["../../src/types/mailFolder.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAMnE,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uGAAuG;IACvG,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,gHAAgH;IAChH,QAAQ,EAAE,MAAM,CAAC;IACjB,sGAAsG;IACtG,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/utils/index.d.ts

@@ -1,5 +1,8 @@
 export { markdownToHtml, sanitizeHtml } from './markdown.js';
-export { escapeODataLiteral, escapeODataString, odataFilterValue } from './odata.js';
+export { escapeODataLiteral, odataAnyOf, odataFilter, odataFilterValue, odataRaw, odataSearch, odataSearchValue, } from './odata.js';
+export type { ODataRaw, ODataTemplateValue } from './odata.js';
+export { RETENTION_FLAGS_PROPERTY, RETENTION_PERIOD_PROPERTY, RETENTION_PROPERTY_FILTER, RETENTION_TAG_PROPERTY, buildRetentionProperties, decodeRetentionTag, encodeRetentionTag, parseRetentionPolicy, } from './retention.js';
+export type { RetentionPolicy, RetentionPropertyPayload, SingleValueExtendedProperty } from './retention.js';
 export { encodeSharePointUrl } from './sharepoint.js';
 export { extractChatIdFromJoinUrl, extractMeetingInfoFromJoinUrl } from './teams.js';
 export type { MeetingInfo } from './teams.js';

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AACrF,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7G,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AACrF,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -1,5 +1,6 @@
 export { markdownToHtml, sanitizeHtml } from './markdown.js';
-export { escapeODataLiteral, escapeODataString, odataFilterValue } from './odata.js';
+export { escapeODataLiteral, odataAnyOf, odataFilter, odataFilterValue, odataRaw, odataSearch, odataSearchValue, } from './odata.js';
+export { RETENTION_FLAGS_PROPERTY, RETENTION_PERIOD_PROPERTY, RETENTION_PROPERTY_FILTER, RETENTION_TAG_PROPERTY, buildRetentionProperties, decodeRetentionTag, encodeRetentionTag, parseRetentionPolicy, } from './retention.js';
 export { encodeSharePointUrl } from './sharepoint.js';
 export { extractChatIdFromJoinUrl, extractMeetingInfoFromJoinUrl } from './teams.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/odata.d.ts

@@ -19,9 +19,21 @@
  *      `?$filter=...'fm & fd'...` and the server parsed the `&` as a query
  *      param separator. See test/probe-encoding.mts for the verification.
  *
- * Use `escapeODataLiteral` when you control the URL building yourself (rare).
- * Use `odataFilterValue` when you're going through the SDK's `.filter()` /
- * `.query()` methods, which is what every API class in this package does.
+ * **Build filter and search strings with the `odataFilter` / `odataSearch`
+ * tagged templates.** The tag applies the right layers to every interpolation,
+ * so the safe form is the default form instead of something each call site has
+ * to remember:
+ *
+ *     filters.push(odataFilter`from/emailAddress/address eq '${params.from}'`);
+ *
+ * Remembering to apply `odataFilterValue` by hand is exactly what let five call
+ * sites interpolate raw values for months. An untagged template
+ * literal that opens an OData string literal, or that reaches `.filter()` /
+ * `.search()` / `.query()` directly, is therefore an eslint error inside
+ * `src/api`.
+ *
+ * The value helpers below stay exported: they are what the tags are built from,
+ * and consumers of this package building their own queries need them.
  *
  * @see https://learn.microsoft.com/en-us/graph/filter-query-parameter
  */
@@ -29,8 +41,8 @@
  * Escapes single quotes in an OData string literal.
  *
  * Use this only if you are constructing a fully-formed URL yourself and your
- * URL builder will handle URL encoding separately. In most cases, prefer
- * `odataFilterValue` which combines both layers.
+ * URL builder will handle URL encoding separately. In most cases, prefer the
+ * `odataFilter` tag, which combines both layers.
  *
  * @example
  * escapeODataLiteral("Let's Talk")  // → "Let''s Talk"
@@ -44,25 +56,112 @@ export declare function escapeODataLiteral(value: string): string;
  *   1. OData literal escape (`'` → `''`)
  *   2. URL-encode the result so reserved characters don't break the request URL
  *
- * @example
- * // Building a topic filter:
- * const value = odataFilterValue("FM & FD");
- * client.api('/me/chats').filter(`contains(tolower(topic), '${value}')`).get();
- * // The SDK sends: ?$filter=contains(tolower(topic), 'fm%20%26%20fd')
+ * Prefer the `odataFilter` tag inside this package; reach for this directly
+ * only when you are assembling a value away from the string it lands in.
  *
  * @example
- * // Filtering by a name with an apostrophe:
- * const value = odataFilterValue("O'Brien");
- * client.api('/me/chats').filter(`contains(displayName, '${value}')`).get();
- * // → 'O%27%27Brien' (literal escape gives O''Brien, URL encode gives O%27%27Brien)
+ * odataFilterValue('invoice+statements@example.com');
+ * // → 'invoice%2Bstatements%40example.com'
+ * // Without the encoding, the SDK sends a raw `+`, which the server reads as
+ * // a space and the filter matches nobody.
  */
 export declare function odataFilterValue(value: string): string;
 /**
- * @deprecated Use `escapeODataLiteral` (same behavior) for the literal escape,
- * or `odataFilterValue` for the combined literal-escape + URL-encode that you
- * almost always want when going through the Graph SDK builders.
+ * Prepares a string for safe use as a `$search` value passed through the
+ * Microsoft Graph SDK's `.search()` builder.
+ *
+ * The SDK's `.search()` builder has the exact same non-encoding behavior as
+ * `.filter()` (see the module doc above) — it writes the value straight into
+ * `$search=...` on the request URL with no URL-encoding. `$search` values are
+ * plain quoted phrases, not OData string literals, so there's no literal
+ * layer to apply here (unlike `odataFilterValue`) — this is URL-encoding
+ * only.
+ *
+ * **It does not neutralize a literal `"` in the value.** The server percent-
+ * decodes `$search` before parsing it as KQL, so an embedded quote is restored
+ * and closes the phrase the caller wrapped around it. Verified against Graph:
+ * searching `Anthropic" OR from:someone@example.com` comes back as
+ * `Syntax error: character ':' is not valid at position 19 in
+ * '"Anthropic" OR from:someone@example.com"'` — the server quoting back the
+ * decoded string. That fails loud rather than mis-parsing silently, but a
+ * caller needing to search for a literal quote cannot express it here. What
+ * the encoding does buy is `+`, `&` and `#` surviving the URL.
+ *
+ * Prefer the `odataSearch` tag inside this package.
+ *
+ * @example
+ * odataSearchValue('from:invoice+statements@example.com');
+ * // → 'from%3Ainvoice%2Bstatements%40example.com'
+ */
+export declare function odataSearchValue(value: string): string;
+/**
+ * An already-built OData fragment, interpolated into a tag verbatim.
+ *
+ * Produced only by {@link odataRaw}. Carrying a nominal type rather than a bare
+ * string is the point: the tags encode anything they are handed, and the only
+ * way past that is to say so explicitly at the call site.
+ */
+export declare class ODataRaw {
+    readonly fragment: string;
+    constructor(fragment: string);
+}
+/**
+ * Marks an interpolation as OData *syntax* rather than a *value*, so the tags
+ * pass it through unencoded.
+ *
+ * This is the escape hatch, and it exists for one legitimate shape: composing
+ * clauses that the tags already built, where the parentheses, quotes and
+ * operators are structure and encoding them would destroy the expression.
+ *
+ * Never hand it something a caller supplied. If a value reaches `odataRaw`,
+ * the encoding is gone and nothing else will catch it.
+ *
+ * @example
+ * const clauses = addresses.map((a) => odataFilter`from/emailAddress/address eq '${a}'`);
+ * const anyOf = odataFilter`(${odataRaw(clauses.join(' or '))})`;
+ */
+export declare function odataRaw(fragment: string): ODataRaw;
+/** What a tag accepts in an interpolation slot. */
+export type ODataTemplateValue = string | number | boolean | ODataRaw;
+/**
+ * Builds an OData `$filter` expression, escaping and URL-encoding every
+ * interpolated value (see {@link odataFilterValue}).
+ *
+ * Write the OData syntax — including the quotes around a string literal — in
+ * the template; interpolate only values. Numbers, booleans and unquoted
+ * datetime literals are safe to interpolate as-is: encoding leaves them intact
+ * apart from characters that genuinely have to be encoded, such as the `+` in a
+ * timezone offset.
+ *
+ * @example
+ * odataFilter`from/emailAddress/address eq '${'invoice+statements@example.com'}'`;
+ * // → "from/emailAddress/address eq 'invoice%2Bstatements%40example.com'"
+ */
+export declare function odataFilter(strings: TemplateStringsArray, ...values: ODataTemplateValue[]): string;
+/**
+ * Builds an OData `$search` expression, URL-encoding every interpolated value
+ * (see {@link odataSearchValue}).
+ *
+ * Write the phrase quotes and any KQL operators in the template; interpolate
+ * only values.
+ *
+ * @example
+ * odataSearch`"mail:${'a+b@example.com'}" OR "displayName:${'a+b@example.com'}"`;
+ * // → '"mail:a%2Bb%40example.com" OR "displayName:a%2Bb%40example.com"'
+ */
+export declare function odataSearch(strings: TemplateStringsArray, ...values: ODataTemplateValue[]): string;
+/**
+ * Joins already-built clauses into an any-of group, parenthesised only when
+ * there is more than one.
  *
- * Kept temporarily for backwards compatibility with the old name.
+ * The parentheses matter: an `or` group spliced into a filter that also has
+ * `and` clauses would otherwise bind wrongly and widen the query instead of
+ * narrowing it. This exists so that composing clauses — the one legitimate use
+ * of {@link odataRaw} — has a name, rather than each new any-of filter reaching
+ * for the escape hatch and copying the last call site that did.
+ *
+ * @example
+ * odataAnyOf(addresses.map((a) => odataFilter`from/emailAddress/address eq '${a}'`));
  */
-export declare function escapeODataString(value: string): string;
+export declare function odataAnyOf(clauses: string[]): string;
 //# sourceMappingURL=odata.d.ts.map

package/dist/utils/odata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"odata.d.ts","sourceRoot":"","sources":["../../src/utils/odata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD"}
+{"version":3,"file":"odata.d.ts","sourceRoot":"","sources":["../../src/utils/odata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;GAMG;AACH,qBAAa,QAAQ;aACgB,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CACpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAEnD;AAED,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAgBtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAElG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAElG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpD"}

package/dist/utils/odata.js

@@ -19,9 +19,21 @@
  *      `?$filter=...'fm & fd'...` and the server parsed the `&` as a query
  *      param separator. See test/probe-encoding.mts for the verification.
  *
- * Use `escapeODataLiteral` when you control the URL building yourself (rare).
- * Use `odataFilterValue` when you're going through the SDK's `.filter()` /
- * `.query()` methods, which is what every API class in this package does.
+ * **Build filter and search strings with the `odataFilter` / `odataSearch`
+ * tagged templates.** The tag applies the right layers to every interpolation,
+ * so the safe form is the default form instead of something each call site has
+ * to remember:
+ *
+ *     filters.push(odataFilter`from/emailAddress/address eq '${params.from}'`);
+ *
+ * Remembering to apply `odataFilterValue` by hand is exactly what let five call
+ * sites interpolate raw values for months. An untagged template
+ * literal that opens an OData string literal, or that reaches `.filter()` /
+ * `.search()` / `.query()` directly, is therefore an eslint error inside
+ * `src/api`.
+ *
+ * The value helpers below stay exported: they are what the tags are built from,
+ * and consumers of this package building their own queries need them.
  *
  * @see https://learn.microsoft.com/en-us/graph/filter-query-parameter
  */
@@ -29,8 +41,8 @@
  * Escapes single quotes in an OData string literal.
  *
  * Use this only if you are constructing a fully-formed URL yourself and your
- * URL builder will handle URL encoding separately. In most cases, prefer
- * `odataFilterValue` which combines both layers.
+ * URL builder will handle URL encoding separately. In most cases, prefer the
+ * `odataFilter` tag, which combines both layers.
  *
  * @example
  * escapeODataLiteral("Let's Talk")  // → "Let''s Talk"
@@ -46,29 +58,133 @@ export function escapeODataLiteral(value) {
  *   1. OData literal escape (`'` → `''`)
  *   2. URL-encode the result so reserved characters don't break the request URL
  *
- * @example
- * // Building a topic filter:
- * const value = odataFilterValue("FM & FD");
- * client.api('/me/chats').filter(`contains(tolower(topic), '${value}')`).get();
- * // The SDK sends: ?$filter=contains(tolower(topic), 'fm%20%26%20fd')
+ * Prefer the `odataFilter` tag inside this package; reach for this directly
+ * only when you are assembling a value away from the string it lands in.
  *
  * @example
- * // Filtering by a name with an apostrophe:
- * const value = odataFilterValue("O'Brien");
- * client.api('/me/chats').filter(`contains(displayName, '${value}')`).get();
- * // → 'O%27%27Brien' (literal escape gives O''Brien, URL encode gives O%27%27Brien)
+ * odataFilterValue('invoice+statements@example.com');
+ * // → 'invoice%2Bstatements%40example.com'
+ * // Without the encoding, the SDK sends a raw `+`, which the server reads as
+ * // a space and the filter matches nobody.
  */
 export function odataFilterValue(value) {
     return encodeURIComponent(escapeODataLiteral(value));
 }
 /**
- * @deprecated Use `escapeODataLiteral` (same behavior) for the literal escape,
- * or `odataFilterValue` for the combined literal-escape + URL-encode that you
- * almost always want when going through the Graph SDK builders.
+ * Prepares a string for safe use as a `$search` value passed through the
+ * Microsoft Graph SDK's `.search()` builder.
+ *
+ * The SDK's `.search()` builder has the exact same non-encoding behavior as
+ * `.filter()` (see the module doc above) — it writes the value straight into
+ * `$search=...` on the request URL with no URL-encoding. `$search` values are
+ * plain quoted phrases, not OData string literals, so there's no literal
+ * layer to apply here (unlike `odataFilterValue`) — this is URL-encoding
+ * only.
+ *
+ * **It does not neutralize a literal `"` in the value.** The server percent-
+ * decodes `$search` before parsing it as KQL, so an embedded quote is restored
+ * and closes the phrase the caller wrapped around it. Verified against Graph:
+ * searching `Anthropic" OR from:someone@example.com` comes back as
+ * `Syntax error: character ':' is not valid at position 19 in
+ * '"Anthropic" OR from:someone@example.com"'` — the server quoting back the
+ * decoded string. That fails loud rather than mis-parsing silently, but a
+ * caller needing to search for a literal quote cannot express it here. What
+ * the encoding does buy is `+`, `&` and `#` surviving the URL.
+ *
+ * Prefer the `odataSearch` tag inside this package.
+ *
+ * @example
+ * odataSearchValue('from:invoice+statements@example.com');
+ * // → 'from%3Ainvoice%2Bstatements%40example.com'
+ */
+export function odataSearchValue(value) {
+    return encodeURIComponent(value);
+}
+/**
+ * An already-built OData fragment, interpolated into a tag verbatim.
+ *
+ * Produced only by {@link odataRaw}. Carrying a nominal type rather than a bare
+ * string is the point: the tags encode anything they are handed, and the only
+ * way past that is to say so explicitly at the call site.
+ */
+export class ODataRaw {
+    fragment;
+    constructor(fragment) {
+        this.fragment = fragment;
+    }
+}
+/**
+ * Marks an interpolation as OData *syntax* rather than a *value*, so the tags
+ * pass it through unencoded.
+ *
+ * This is the escape hatch, and it exists for one legitimate shape: composing
+ * clauses that the tags already built, where the parentheses, quotes and
+ * operators are structure and encoding them would destroy the expression.
+ *
+ * Never hand it something a caller supplied. If a value reaches `odataRaw`,
+ * the encoding is gone and nothing else will catch it.
+ *
+ * @example
+ * const clauses = addresses.map((a) => odataFilter`from/emailAddress/address eq '${a}'`);
+ * const anyOf = odataFilter`(${odataRaw(clauses.join(' or '))})`;
+ */
+export function odataRaw(fragment) {
+    return new ODataRaw(fragment);
+}
+function interpolate(strings, values, encode) {
+    let out = strings[0];
+    for (let i = 0; i < values.length; i++) {
+        const value = values[i];
+        out += value instanceof ODataRaw ? value.fragment : encode(String(value));
+        out += strings[i + 1];
+    }
+    return out;
+}
+/**
+ * Builds an OData `$filter` expression, escaping and URL-encoding every
+ * interpolated value (see {@link odataFilterValue}).
  *
- * Kept temporarily for backwards compatibility with the old name.
+ * Write the OData syntax — including the quotes around a string literal — in
+ * the template; interpolate only values. Numbers, booleans and unquoted
+ * datetime literals are safe to interpolate as-is: encoding leaves them intact
+ * apart from characters that genuinely have to be encoded, such as the `+` in a
+ * timezone offset.
+ *
+ * @example
+ * odataFilter`from/emailAddress/address eq '${'invoice+statements@example.com'}'`;
+ * // → "from/emailAddress/address eq 'invoice%2Bstatements%40example.com'"
+ */
+export function odataFilter(strings, ...values) {
+    return interpolate(strings, values, odataFilterValue);
+}
+/**
+ * Builds an OData `$search` expression, URL-encoding every interpolated value
+ * (see {@link odataSearchValue}).
+ *
+ * Write the phrase quotes and any KQL operators in the template; interpolate
+ * only values.
+ *
+ * @example
+ * odataSearch`"mail:${'a+b@example.com'}" OR "displayName:${'a+b@example.com'}"`;
+ * // → '"mail:a%2Bb%40example.com" OR "displayName:a%2Bb%40example.com"'
+ */
+export function odataSearch(strings, ...values) {
+    return interpolate(strings, values, odataSearchValue);
+}
+/**
+ * Joins already-built clauses into an any-of group, parenthesised only when
+ * there is more than one.
+ *
+ * The parentheses matter: an `or` group spliced into a filter that also has
+ * `and` clauses would otherwise bind wrongly and widen the query instead of
+ * narrowing it. This exists so that composing clauses — the one legitimate use
+ * of {@link odataRaw} — has a name, rather than each new any-of filter reaching
+ * for the escape hatch and copying the last call site that did.
+ *
+ * @example
+ * odataAnyOf(addresses.map((a) => odataFilter`from/emailAddress/address eq '${a}'`));
  */
-export function escapeODataString(value) {
-    return escapeODataLiteral(value);
+export function odataAnyOf(clauses) {
+    return clauses.length === 1 ? clauses[0] : odataFilter `(${odataRaw(clauses.join(' or '))})`;
 }
 //# sourceMappingURL=odata.js.map

package/dist/utils/odata.js.map

@@ -1 +1 @@
-{"version":3,"file":"odata.js","sourceRoot":"","sources":["../../src/utils/odata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,kBAAkB,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"odata.js","sourceRoot":"","sources":["../../src/utils/odata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,kBAAkB,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IACgB;IAAnC,YAAmC,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;CACxD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAKD,SAAS,WAAW,CAClB,OAA6B,EAC7B,MAA4B,EAC5B,MAAiC;IAEjC,IAAI,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,GAAG,IAAI,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1E,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,OAA6B,EAAE,GAAG,MAA4B;IACxF,OAAO,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,OAA6B,EAAE,GAAG,MAA4B;IACxF,OAAO,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,OAAiB;IAC1C,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAA,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;AAC9F,CAAC"}

package/dist/utils/retention.d.ts

@@ -0,0 +1,59 @@
+/** MAPI id of PR_POLICY_TAG — the retention tag GUID, stored as bytes. */
+export declare const RETENTION_TAG_PROPERTY = "Binary 0x3019";
+/** MAPI id of PR_RETENTION_PERIOD — days before the tag's action applies. */
+export declare const RETENTION_PERIOD_PROPERTY = "Integer 0x301A";
+/** MAPI id of PR_RETENTION_FLAGS — Exchange bookkeeping; read-only in practice. */
+export declare const RETENTION_FLAGS_PROPERTY = "Integer 0x301D";
+/** `$filter` selecting exactly the three retention properties in an `$expand`. */
+export declare const RETENTION_PROPERTY_FILTER: string;
+/** One entry of a `mailFolder`'s `singleValueExtendedProperties` collection, as Graph returns it. */
+export interface SingleValueExtendedProperty {
+    id?: string | null;
+    value?: string | null;
+}
+/** One entry as it is *sent* — a `null` value is the delete, so it is not optional. */
+export interface RetentionPropertyPayload {
+    id: string;
+    value: string | null;
+}
+/** A folder's retention policy, in the terms a person set it in. */
+export interface RetentionPolicy {
+    /** Retention tag GUID, in the form Exchange shows it. */
+    tag: string;
+    /** Days before the tag's action applies, when the folder carries one. */
+    periodDays: number | null;
+    /** Raw PR_RETENTION_FLAGS. Reported because it is there, not because it means anything. */
+    flags: number | null;
+}
+/**
+ * Decodes PR_POLICY_TAG's bytes into a GUID string.
+ *
+ * The bytes are in .NET `Guid` layout — the first three fields little-endian,
+ * the last two big-endian — not a flat big-endian read. Reading them flat
+ * produces a string that looks like a GUID and is not one: tags read off a real
+ * mailbox decode to a valid version-4 GUID under this layout, and to an
+ * impossible version nibble when the bytes are read straight through.
+ */
+export declare function decodeRetentionTag(base64Value: string): string | null;
+/** Encodes a GUID string back into PR_POLICY_TAG's bytes. Inverse of {@link decodeRetentionTag}. */
+export declare function encodeRetentionTag(guid: string): string;
+/**
+ * Reads a folder's retention policy out of its expanded extended properties.
+ *
+ * Returns `null` when the folder carries no tag. A folder whose policy has been
+ * cleared keeps a `PR_RETENTION_FLAGS` of 128, so presence of the properties is
+ * not the test — presence of a tag is.
+ */
+export declare function parseRetentionPolicy(properties: SingleValueExtendedProperty[] | null | undefined): RetentionPolicy | null;
+/**
+ * Builds the `singleValueExtendedProperties` payload for a PATCH.
+ *
+ * Pass a tag and period to assign a policy, or `null` for both to clear one.
+ * `PR_RETENTION_FLAGS` is only ever sent as `null`, on a clear: Exchange owns
+ * that value and rewrites whatever is sent.
+ */
+export declare function buildRetentionProperties(policy: {
+    tag: string | null;
+    periodDays: number | null;
+}): RetentionPropertyPayload[];
+//# sourceMappingURL=retention.d.ts.map