microsoft-graph 2.37.2 → 3.0.1

package/dist/esm/operations/driveItem/{listDriveItemChildren.d.ts → listDriveItems.d.ts}

@@ -1,6 +1,6 @@
 /**
  * Retrieve the metadata for items in a drive or folder.
- * @module listDriveItemChildren
+ * @module listDriveItems
  * @category Operations
  */
 import type { DriveItem } from "@microsoft/microsoft-graph-types";
@@ -11,6 +11,10 @@ export type ListDriveItemResponse = {
     value: (DriveItem & DriveItemRef)[];
     "@odata.nextLink": string | null;
 };
+export type DriveItemList = {
+    items: (DriveItem & DriveItemRef)[];
+    nextLink: URL | null;
+};
 /**
  * Retrieve the metadata for items in a drive or folder.
  * @param parentRef Reference to the parent drive or folder. Defaults to the root drive.
@@ -18,5 +22,5 @@ export type ListDriveItemResponse = {
  * @returns Array of drive items, each including its metadata and reference information.
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-list-children
  */
-export default function listDriveItemChildren(parentRef: DriveRef | DriveItemRef, take?: number): GraphOperation<ListDriveItemResponse>;
-//# sourceMappingURL=listDriveItemChildren.d.ts.map
+export default function listDriveItems(parentRef: DriveRef | DriveItemRef, take?: number): GraphOperation<DriveItemList>;
+//# sourceMappingURL=listDriveItems.d.ts.map

package/dist/esm/operations/driveItem/listDriveItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listDriveItems.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/listDriveItems.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE,MAAM,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC;IACpC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC;IACpC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,IAAI,SAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAyBrH"}

package/dist/esm/operations/driveItem/{listDriveItemChildren.js → listDriveItems.js}

@@ -1,6 +1,6 @@
 /**
  * Retrieve the metadata for items in a drive or folder.
- * @module listDriveItemChildren
+ * @module listDriveItems
  * @category Operations
  */
 import { createDriveItemRef } from "../../services/driveItem.js";
@@ -13,7 +13,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  * @returns Array of drive items, each including its metadata and reference information.
  * @see https://learn.microsoft.com/en-us/graph/api/driveitem-list-children
  */
-export default function listDriveItemChildren(parentRef, take = 1000) {
+export default function listDriveItems(parentRef, take = 1000) {
     const pathSegment = parentRef.itemId ? "items/{item-id}" : "root";
     return operation({
         context: parentRef.context,
@@ -24,14 +24,14 @@ export default function listDriveItemChildren(parentRef, take = 1000) {
         responseTransform: (response) => {
             const result = response;
             return {
-                value: result.value.map((item) => {
+                items: result.value.map((item) => {
                     const itemRef = createDriveItemRef(parentRef, item.id);
                     return {
                         ...item,
                         ...itemRef,
                     };
                 }),
-                "@odata.nextLink": result["@odata.nextLink"] ?? null,
+                nextLink: result["@odata.nextLink"] ? new URL(result["@odata.nextLink"]) : null,
             };
         },
     });

package/dist/esm/operations/site/listSites.d.ts

@@ -7,11 +7,20 @@ import type { Site } from "@microsoft/microsoft-graph-types";
 import type { ContextRef } from "../../models/Context.ts";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { SiteRef } from "../../models/Site.ts";
+export type ListSitesResponse = {
+    value: (Site & SiteRef)[];
+    "@odata.nextLink": string | null;
+};
+export type SiteList = {
+    sites: (Site & SiteRef)[];
+    nextLink: URL | null;
+};
 /**
  * List sites in your company geography.
  * @param contextRef Reference to the context.
+ * @param take Maximum number of items to retrieve. Defaults to 1000.
  * @returns Array of sites, each including its metadata and reference information.
  * @see https://learn.microsoft.com/en-us/graph/api/site-list
  */
-export default function listSites(contextRef: ContextRef): GraphOperation<(Site & SiteRef)[]>;
+export default function listSites(contextRef: ContextRef, take?: number): GraphOperation<SiteList>;
 //# sourceMappingURL=listSites.d.ts.map

package/dist/esm/operations/site/listSites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listSites.d.ts","sourceRoot":"","sources":["../../../../src/operations/site/listSites.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAU,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAK5D;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAuB5F"}
+{"version":3,"file":"listSites.d.ts","sourceRoot":"","sources":["../../../../src/operations/site/listSites.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAU,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAK5D,MAAM,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,CAAC,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC;IAC1B,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,SAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAuB/F"}

package/dist/esm/operations/site/listSites.js

@@ -9,27 +9,29 @@ import { generatePath } from "../../services/templatedPaths.js";
 /**
  * List sites in your company geography.
  * @param contextRef Reference to the context.
+ * @param take Maximum number of items to retrieve. Defaults to 1000.
  * @returns Array of sites, each including its metadata and reference information.
  * @see https://learn.microsoft.com/en-us/graph/api/site-list
  */
-export default function listSites(contextRef) {
+export default function listSites(contextRef, take = 1000) {
     return operation({
         context: contextRef.context,
         method: "GET",
-        path: generatePath("/sites?search=*", {}), // TODO: Implement search parameter properly. Without this not all are shown.
+        path: generatePath(`/sites?search=*&$top=${take}`, {}), // TODO: Implement search parameter properly. Without this not all are shown.
         headers: {},
         body: null,
         responseTransform: (response) => {
-            const list = response;
-            const sites = list.value.map((site) => {
-                const siteId = site.id;
-                const siteRef = createSiteRef(contextRef, siteId);
-                return {
-                    ...site,
-                    ...siteRef,
-                };
-            });
-            return sites;
+            const result = response;
+            return {
+                sites: result.value.map((site) => {
+                    const siteRef = createSiteRef(contextRef, site.id);
+                    return {
+                        ...site,
+                        ...siteRef,
+                    };
+                }),
+                nextLink: result["@odata.nextLink"] ? new URL(result["@odata.nextLink"]) : null,
+            };
         },
     });
 }

package/dist/esm/operations/workbookPivotTable/refreshWorkbookPivotTable.d.ts

@@ -1,6 +1,6 @@
 /**
  * Refresh a specific pivot table in a worksheet.
- * @module refreshWorkbookWorksheetPivotTable
+ * @module refreshWorkbookPivotTable
  * @category Operations
  */
 import type { GraphOperation } from "../../models/GraphOperation.ts";

package/dist/esm/operations/workbookPivotTable/refreshWorkbookPivotTable.js

@@ -1,6 +1,6 @@
 /**
  * Refresh a specific pivot table in a worksheet.
- * @module refreshWorkbookWorksheetPivotTable
+ * @module refreshWorkbookPivotTable
  * @category Operations
  */
 import { operation } from "../../services/operationInvoker.js";

package/dist/{cjs/operations/workbookRange/getWorkbookRangeFormat.d.ts → esm/operations/workbookRange/getWorkbookRangeAlignment.d.ts}

@@ -1,6 +1,6 @@
 /**
  * Retrieve the format of a workbook range.
- * @module getWorkbookRangeFormat
+ * @module getWorkbookRangeAlignment
  * @category Operations
  */
 import type { WorkbookRangeFormat } from "@microsoft/microsoft-graph-types";
@@ -12,5 +12,5 @@ import type { WorkbookRangeRef } from "../../models/WorkbookRange.ts";
  * @returns Format of the specified range.
  * @see https://learn.microsoft.com/en-us/graph/api/rangeformat-get
  */
-export default function getWorkbookRangeFormat(rangeRef: WorkbookRangeRef): GraphOperation<WorkbookRangeFormat & WorkbookRangeRef>;
-//# sourceMappingURL=getWorkbookRangeFormat.d.ts.map
+export default function getWorkbookRangeAlignment(rangeRef: WorkbookRangeRef): GraphOperation<WorkbookRangeFormat & WorkbookRangeRef>;
+//# sourceMappingURL=getWorkbookRangeAlignment.d.ts.map

package/dist/esm/operations/workbookRange/getWorkbookRangeAlignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookRangeAlignment.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/getWorkbookRangeAlignment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAmBpI"}

package/dist/esm/operations/workbookRange/{getWorkbookRangeFormat.js → getWorkbookRangeAlignment.js}

@@ -1,7 +1,6 @@
-// TODO: Rename to getWorkbookRangeAlignment
 /**
  * Retrieve the format of a workbook range.
- * @module getWorkbookRangeFormat
+ * @module getWorkbookRangeAlignment
  * @category Operations
  */
 import { normalizeAddress } from "../../services/addressManipulation.js";
@@ -13,7 +12,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  * @returns Format of the specified range.
  * @see https://learn.microsoft.com/en-us/graph/api/rangeformat-get
  */
-export default function getWorkbookRangeFormat(rangeRef) {
+export default function getWorkbookRangeAlignment(rangeRef) {
     const address = normalizeAddress(rangeRef.address, true);
     return operation({
         context: rangeRef.context,

package/dist/esm/tasks/getWorkbookWorksheetByName.d.ts

@@ -2,6 +2,7 @@
  * Get a worksheet by its name.
  * @module getWorkbookWorksheetByName
  * @category Tasks
+ * @hidden
  */
 import type { WorkbookWorksheet } from "@microsoft/microsoft-graph-types";
 import type { WorkbookRef } from "../models/Workbook.ts";
@@ -13,6 +14,8 @@ import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheet.ts";
  * @param name The name of the worksheet to retrieve.
  * @throws {@link NotFoundError} If the worksheet with the specified name is not found.
  * @returns Worksheet
+ * @deprecated Use `getWorkbookWorksheetByName` operation instead
+ * @hidden
  */
 export default function getWorkbookWorksheetByName(workbookRef: WorkbookRef, name: string): Promise<WorkbookWorksheet & WorkbookWorksheetRef>;
 //# sourceMappingURL=getWorkbookWorksheetByName.d.ts.map

package/dist/esm/tasks/getWorkbookWorksheetByName.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookWorksheetByName.d.ts","sourceRoot":"","sources":["../../../src/tasks/getWorkbookWorksheetByName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG3E;;;;;;;GAOG;AACH,wBAA8B,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CAUlJ"}
+{"version":3,"file":"getWorkbookWorksheetByName.d.ts","sourceRoot":"","sources":["../../../src/tasks/getWorkbookWorksheetByName.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG3E;;;;;;;;;GASG;AACH,wBAA8B,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,oBAAoB,CAAC,CASlJ"}

package/dist/esm/tasks/getWorkbookWorksheetByName.js

@@ -2,6 +2,7 @@
  * Get a worksheet by its name.
  * @module getWorkbookWorksheetByName
  * @category Tasks
+ * @hidden
  */
 import NotFoundError from "../errors/NotFoundError.js";
 import listWorkbookWorksheets from "../operations/workbookWorksheet/listWorkbookWorksheets.js";
@@ -12,9 +13,10 @@ import listWorkbookWorksheets from "../operations/workbookWorksheet/listWorkbook
  * @param name The name of the worksheet to retrieve.
  * @throws {@link NotFoundError} If the worksheet with the specified name is not found.
  * @returns Worksheet
+ * @deprecated Use `getWorkbookWorksheetByName` operation instead
+ * @hidden
  */
 export default async function getWorkbookWorksheetByName(workbookRef, name) {
-    // TODO: More performant to get it by a direct call without listing all workbooks?
     const worksheets = await listWorkbookWorksheets(workbookRef);
     const worksheet = worksheets.find((worksheetRef) => worksheetRef.name === name);
     if (!worksheet) {

package/dist/esm/tasks/{listDriveItems.d.ts → iterateDriveItems.d.ts}

@@ -1,6 +1,6 @@
 /**
  * List drive items in a drive or a drive item.
- * @module listDriveItems
+ * @module iterateDriveItems
  * @category Tasks
  */
 import type { DriveItem } from "@microsoft/microsoft-graph-types";
@@ -13,5 +13,5 @@ import type { DriveItemRef } from "../models/DriveItem.ts";
  * @returns Async iterable of drive items.
  * @remarks `pageSize` should only be set for advanced performance tuning.
  */
-export default function listDriveItems(parentRef: DriveRef | DriveItemRef, maxPerChunk?: number): AsyncGenerator<DriveItem & DriveItemRef>;
-//# sourceMappingURL=listDriveItems.d.ts.map
+export default function iterateDriveItems(parentRef: DriveRef | DriveItemRef, maxPerChunk?: number): AsyncGenerator<DriveItem & DriveItemRef>;
+//# sourceMappingURL=iterateDriveItems.d.ts.map

package/dist/esm/tasks/iterateDriveItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterateDriveItems.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateDriveItems.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAKxE;;;;;;GAMG;AACH,wBAA+B,iBAAiB,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,WAAW,SAAO,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CA0BjJ"}

package/dist/esm/tasks/{listDriveItems.js → iterateDriveItems.js}

@@ -1,9 +1,9 @@
 /**
  * List drive items in a drive or a drive item.
- * @module listDriveItems
+ * @module iterateDriveItems
  * @category Tasks
  */
-import listDriveItemChildren from "../operations/driveItem/listDriveItemChildren.js";
+import listDriveItems from "../operations/driveItem/listDriveItems.js";
 import { createDriveItemRef } from "../services/driveItem.js";
 import { executeHttpRequest } from "../services/http.js";
 /**
@@ -13,31 +13,25 @@ import { executeHttpRequest } from "../services/http.js";
  * @returns Async iterable of drive items.
  * @remarks `pageSize` should only be set for advanced performance tuning.
  */
-export default async function* listDriveItems(parentRef, maxPerChunk = 1000) {
-    let result = await listDriveItemChildren(parentRef, maxPerChunk);
-    for (const item of result.value) {
-        const itemRef = createDriveItemRef(parentRef, item.id);
-        yield {
-            ...item,
-            ...itemRef,
-        };
+export default async function* iterateDriveItems(parentRef, maxPerChunk = 1000) {
+    let { items, nextLink } = await listDriveItems(parentRef, maxPerChunk);
+    for (const item of items) {
+        yield item;
     }
-    while (result["@odata.nextLink"]) {
+    while (nextLink) {
         const accessToken = await parentRef.context.generateAccessToken();
         const response = await executeHttpRequest({
-            url: result["@odata.nextLink"],
+            url: nextLink.toString(),
             method: "GET",
             headers: {
                 authorization: `Bearer ${accessToken}`,
             },
         });
-        result = response.data;
-        for (const item of result.value) {
-            const itemRef = createDriveItemRef(parentRef, item.id);
-            yield {
-                ...item,
-                ...itemRef,
-            };
+        const result = response.data;
+        const newItems = result.value.map((item) => (createDriveItemRef(parentRef, item.id) ? { ...item, ...createDriveItemRef(parentRef, item.id) } : item));
+        nextLink = result["@odata.nextLink"] ? new URL(result["@odata.nextLink"]) : null;
+        for (const item of newItems) {
+            yield item;
         }
     }
 }

package/dist/esm/tasks/iterateDrives.d.ts

@@ -0,0 +1,17 @@
+/**
+ * List drives in a site as an async iterable.
+ * @module iterateDrives
+ * @category Tasks
+ */
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { DriveRef } from "../models/Drive.ts";
+import type { SiteRef } from "../models/Site.ts";
+/**
+ * List drives in a site as an async iterable.
+ * @param siteRef Reference to the site.
+ * @param maxPerChunk Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING.
+ * @returns Async iterable of drives.
+ * @remarks `pageSize` should only be set for advanced performance tuning.
+ */
+export default function iterateDrives(siteRef: SiteRef, maxPerChunk?: number): AsyncGenerator<DriveItem & DriveRef>;
+//# sourceMappingURL=iterateDrives.d.ts.map

package/dist/esm/tasks/iterateDrives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterateDrives.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateDrives.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;;;GAMG;AACH,wBAA+B,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,SAAO,GAAG,cAAc,CAAC,SAAS,GAAG,QAAQ,CAAC,CAuBvH"}

package/dist/esm/tasks/iterateDrives.js

@@ -0,0 +1,33 @@
+/**
+ * List drives in a site as an async iterable.
+ * @module iterateDrives
+ * @category Tasks
+ */
+import listDrives from "../operations/drive/listDrives.js";
+/**
+ * List drives in a site as an async iterable.
+ * @param siteRef Reference to the site.
+ * @param maxPerChunk Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING.
+ * @returns Async iterable of drives.
+ * @remarks `pageSize` should only be set for advanced performance tuning.
+ */
+export default async function* iterateDrives(siteRef, maxPerChunk = 1000) {
+    let { drives, nextLink } = await listDrives(siteRef, maxPerChunk);
+    for (const drive of drives) {
+        yield drive;
+    }
+    while (nextLink) {
+        const accessToken = await siteRef.context.generateAccessToken();
+        const response = await fetch(nextLink, {
+            headers: {
+                authorization: `Bearer ${accessToken}`,
+            },
+        });
+        const result = (await response.json());
+        drives = result.value;
+        nextLink = result["@odata.nextLink"] ? new URL(result["@odata.nextLink"]) : null;
+        for (const drive of drives) {
+            yield drive;
+        }
+    }
+}

package/dist/esm/tasks/iterateSites.d.ts

@@ -0,0 +1,17 @@
+/**
+ * List sites in your company geography as an async iterable.
+ * @module iterateSites
+ * @category Tasks
+ */
+import type { Site } from "@microsoft/microsoft-graph-types";
+import type { ContextRef } from "../models/Context.ts";
+import type { SiteRef } from "../models/Site.ts";
+/**
+ * List sites in your company geography as an async iterable.
+ * @param contextRef Reference to the context.
+ * @param maxPerChunk Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING.
+ * @returns Async iterable of sites.
+ * @remarks `pageSize` should only be set for advanced performance tuning.
+ */
+export default function iterateSites(contextRef: ContextRef, maxPerChunk?: number): AsyncGenerator<Site & SiteRef>;
+//# sourceMappingURL=iterateSites.d.ts.map

package/dist/esm/tasks/iterateSites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterateSites.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateSites.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;;;GAMG;AACH,wBAA+B,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,SAAO,GAAG,cAAc,CAAC,IAAI,GAAG,OAAO,CAAC,CAuBtH"}

package/dist/esm/tasks/iterateSites.js

@@ -0,0 +1,33 @@
+/**
+ * List sites in your company geography as an async iterable.
+ * @module iterateSites
+ * @category Tasks
+ */
+import listSites from "../operations/site/listSites.js";
+/**
+ * List sites in your company geography as an async iterable.
+ * @param contextRef Reference to the context.
+ * @param maxPerChunk Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING.
+ * @returns Async iterable of sites.
+ * @remarks `pageSize` should only be set for advanced performance tuning.
+ */
+export default async function* iterateSites(contextRef, maxPerChunk = 1000) {
+    let { sites, nextLink } = await listSites(contextRef, maxPerChunk);
+    for (const site of sites) {
+        yield site;
+    }
+    while (nextLink) {
+        const accessToken = await contextRef.context.generateAccessToken();
+        const response = await fetch(nextLink, {
+            headers: {
+                authorization: `Bearer ${accessToken}`,
+            },
+        });
+        const result = (await response.json());
+        sites = result.value;
+        nextLink = result["@odata.nextLink"] ? new URL(result["@odata.nextLink"]) : null;
+        for (const site of sites) {
+            yield site;
+        }
+    }
+}

package/dist/esm/tasks/iterateWorkbookRangeRows.js

@@ -5,9 +5,9 @@
  * @experimental
  */
 import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import getWorkbookRangeAlignment from "../operations/workbookRange/getWorkbookRangeAlignment.js";
 import getWorkbookRangeFill from "../operations/workbookRange/getWorkbookRangeFill.js";
 import getWorkbookRangeFont from "../operations/workbookRange/getWorkbookRangeFont.js";
-import getWorkbookRangeFormat from "../operations/workbookRange/getWorkbookRangeFormat.js";
 import getWorkbookWorksheetRange from "../operations/workbookRange/getWorkbookWorksheetRange.js";
 import listWorkbookRangeBorders from "../operations/workbookRange/listWorkbookRangeBorders.js";
 import { countAddressColumns, countAddressRows, subRange } from "../services/addressManipulation.js";
@@ -124,7 +124,7 @@ async function getAlignment(rangeRef, scope) {
     if (!scope.alignment) {
         return {};
     }
-    const response = await getWorkbookRangeFormat(rangeRef);
+    const response = await getWorkbookRangeAlignment(rangeRef);
     return {
         vertical: response?.verticalAlignment,
         horizontal: response?.horizontalAlignment,

package/docs/api/README.md

@@ -98,9 +98,9 @@
 | [getSiteByName](getSiteByName.md) | Get a site by its name. |
 | [getWorkbookNamedRange](getWorkbookNamedRange.md) | Retrieve a named range. |
 | [getWorkbookPivotTable](getWorkbookPivotTable.md) | Retrieve a workbook pivot table. |
+| [getWorkbookRangeAlignment](getWorkbookRangeAlignment.md) | Retrieve the format of a workbook range. |
 | [getWorkbookRangeFill](getWorkbookRangeFill.md) | Retrieve the fill format of a workbook range. |
 | [getWorkbookRangeFont](getWorkbookRangeFont.md) | Retrieve the font format of a workbook range. |
-| [getWorkbookRangeFormat](getWorkbookRangeFormat.md) | Retrieve the format of a workbook range. |
 | [getWorkbookTable](getWorkbookTable.md) | Retrieve a workbook table. |
 | [getWorkbookTableBodyRange](getWorkbookTableBodyRange.md) | Retrieve the data body range of a workbook table. |
 | [getWorkbookTableBodyVisibleRange](getWorkbookTableBodyVisibleRange.md) | Retrieve the visible data body range of a table. |
@@ -113,7 +113,7 @@
 | [getWorkbookWorksheetUsedVisibleRange](getWorkbookWorksheetUsedVisibleRange.md) | Retrieve the visible (not hidden) range in a worksheet. |
 | [initiateCopyDriveItem](initiateCopyDriveItem.md) | Initiate an asynchronous copy of an item. |
 | [insertWorkbookCells](insertWorkbookCells.md) | Insert a new blank range at a specified address, shifting existing cells. |
-| [listDriveItemChildren](listDriveItemChildren.md) | Retrieve the metadata for items in a drive or folder. |
+| [listDriveItems](listDriveItems.md) | Retrieve the metadata for items in a drive or folder. |
 | [listDrives](listDrives.md) | Retrieve the list of accessible Drives in a Site. |
 | [listSites](listSites.md) | List sites in your company geography. |
 | [listSites](listSites-1.md) | List sites in all company geographies. |
@@ -125,8 +125,8 @@
 | [mergeWorkbookRange](mergeWorkbookRange.md) | Merge a range of cells in a worksheet. |
 | [moveDriveItem](moveDriveItem.md) | Moves a file to a new location in the same drive. |
 | [refreshAllWorkbookPivotTables](refreshAllWorkbookPivotTables.md) | Refresh all pivot tables in a worksheet. |
+| [refreshWorkbookPivotTable](refreshWorkbookPivotTable.md) | Refresh a specific pivot table in a worksheet. |
 | [refreshWorkbookSession](refreshWorkbookSession.md) | Refresh a workbook session. |
-| [refreshWorkbookWorksheetPivotTable](refreshWorkbookWorksheetPivotTable.md) | Refresh a specific pivot table in a worksheet. |
 | [searchSites](searchSites.md) | Find accessible sites that match the provided keywords. |
 | [setWorkbookRangeBorder](setWorkbookRangeBorder.md) | Update a specific border of a workbook range. |
 | [setWorkbookRangeFill](setWorkbookRangeFill.md) | Update the fill format of a workbook range. |
@@ -180,11 +180,12 @@
 | [copyDriveItem](copyDriveItem.md) | Copy a drive item. |
 | [createWorkbookAndStartSession](createWorkbookAndStartSession.md) | Create a new workbook and open a session for that workbook. |
 | [downloadDriveItemContent](downloadDriveItemContent.md) | Download a drive item and save it to the local disk. |
-| [getWorkbookWorksheetByName](getWorkbookWorksheetByName-1.md) | Get a worksheet by its name. |
 | [insertWorkbookRangeRow](insertWorkbookRangeRow.md) | Inserts a single row into a workbook range. |
 | [insertWorkbookRangeRows](insertWorkbookRangeRows.md) | Inserts rows into a workbook range. |
+| [iterateDriveItems](iterateDriveItems.md) | List drive items in a drive or a drive item. |
+| [iterateDrives](iterateDrives.md) | List drives in a site as an async iterable. |
+| [iterateSites](iterateSites.md) | List sites in your company geography as an async iterable. |
 | [iterateWorkbookRangeRows](iterateWorkbookRangeRows.md) | Iterate over the rows in a given worksheet range. |
-| [listDriveItems](listDriveItems.md) | List drive items in a drive or a drive item. |
 | [readWorkbookRangeFirstRow](readWorkbookRangeFirstRow.md) | Read the first row from a given workbook range. |
 | [readWorkbookRangeRows](readWorkbookRangeRows.md) | Read all rows from a given workbook range. |
 | [readWorkbookRows](readWorkbookRows.md) | Iterates over the rows in a given worksheet range. |

package/docs/api/{getWorkbookRangeFormat.md → getWorkbookRangeAlignment.md}

@@ -1,16 +1,16 @@
-[Microsoft Graph SDK](README.md) / getWorkbookRangeFormat
+[Microsoft Graph SDK](README.md) / getWorkbookRangeAlignment
 
-# getWorkbookRangeFormat
+# getWorkbookRangeAlignment
 
 Retrieve the format of a workbook range.
 
 ## Functions
 
-### getWorkbookRangeFormat()
+### getWorkbookRangeAlignment()
 
-> **getWorkbookRangeFormat**(`rangeRef`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`WorkbookRangeFormat` & [`SiteRef`](Site-1.md#siteref) & `object` & `object` & `object` & `object` & `object`\>
+> **getWorkbookRangeAlignment**(`rangeRef`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`WorkbookRangeFormat` & [`SiteRef`](Site-1.md#siteref) & `object` & `object` & `object` & `object` & `object`\>
 
-Defined in: [src/operations/workbookRange/getWorkbookRangeFormat.ts:21](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookRange/getWorkbookRangeFormat.ts#L21)
+Defined in: src/operations/workbookRange/getWorkbookRangeAlignment.ts:20
 
 Retrieve the format of a workbook range.
 

package/docs/api/iterateDriveItems.md

@@ -0,0 +1,32 @@
+[Microsoft Graph SDK](README.md) / iterateDriveItems
+
+# iterateDriveItems
+
+List drive items in a drive or a drive item.
+
+## Functions
+
+### iterateDriveItems()
+
+> **iterateDriveItems**(`parentRef`, `maxPerChunk`): [`AsyncGenerator`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
+
+Defined in: src/tasks/iterateDriveItems.ts:21
+
+List drive items in a drive or a drive item as an async iterable.
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `parentRef` | [`DriveRef`](Drive-1.md#driveref) \| [`DriveItemRef`](DriveItem-1.md#driveitemref) | `undefined` | Parent drive or folder reference. |
+| `maxPerChunk` | `number` | `1000` | Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING. |
+
+#### Returns
+
+[`AsyncGenerator`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
+
+Async iterable of drive items.
+
+#### Remarks
+
+`pageSize` should only be set for advanced performance tuning.

package/docs/api/iterateDrives.md

@@ -0,0 +1,32 @@
+[Microsoft Graph SDK](README.md) / iterateDrives
+
+# iterateDrives
+
+List drives in a site as an async iterable.
+
+## Functions
+
+### iterateDrives()
+
+> **iterateDrives**(`siteRef`, `maxPerChunk`): [`AsyncGenerator`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object`\>
+
+Defined in: src/tasks/iterateDrives.ts:19
+
+List drives in a site as an async iterable.
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `siteRef` | [`SiteRef`](Site-1.md#siteref) | `undefined` | Reference to the site. |
+| `maxPerChunk` | `number` | `1000` | Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING. |
+
+#### Returns
+
+[`AsyncGenerator`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object`\>
+
+Async iterable of drives.
+
+#### Remarks
+
+`pageSize` should only be set for advanced performance tuning.

package/docs/api/iterateSites.md

@@ -0,0 +1,32 @@
+[Microsoft Graph SDK](README.md) / iterateSites
+
+# iterateSites
+
+List sites in your company geography as an async iterable.
+
+## Functions
+
+### iterateSites()
+
+> **iterateSites**(`contextRef`, `maxPerChunk`): [`AsyncGenerator`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator)\<`Site` & [`SiteRef`](Site-1.md#siteref)\>
+
+Defined in: src/tasks/iterateSites.ts:19
+
+List sites in your company geography as an async iterable.
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `contextRef` | [`ContextRef`](Context-1.md#contextref) | `undefined` | Reference to the context. |
+| `maxPerChunk` | `number` | `1000` | Number of items to fetch per request. DO NOT SET EXCEPT FOR ADVANCED TUNING. |
+
+#### Returns
+
+[`AsyncGenerator`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator)\<`Site` & [`SiteRef`](Site-1.md#siteref)\>
+
+Async iterable of sites.
+
+#### Remarks
+
+`pageSize` should only be set for advanced performance tuning.