microsoft-graph 2.37.0 → 3.0.0

package/dist/esm/operations/drive/listDrives.d.ts

@@ -3,15 +3,24 @@
  * @module listDrives
  * @category Operations
  */
-import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { Drive, DriveItem } from "@microsoft/microsoft-graph-types";
 import type { DriveRef } from "../../models/Drive.ts";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
 import type { SiteRef } from "../../models/Site.ts";
+export type ListDrivesResponse = {
+    value: (DriveItem & DriveRef)[];
+    "@odata.nextLink": string | null;
+};
+export type DriveList = {
+    drives: (Drive & DriveRef)[];
+    nextLink: URL | null;
+};
 /**
  * Retrieve the list of accessible Drives in a Site.
  * @param siteRef Reference to the site.
+ * @param take Maximum number of items to retrieve. Defaults to 1000.
  * @returns Array of drives available for the specified site, each including its metadata and reference information.
  * @see https://learn.microsoft.com/en-us/graph/api/drive-list
  */
-export default function listDrives(siteRef: SiteRef): GraphOperation<(DriveItem & DriveRef)[]>;
+export default function listDrives(siteRef: SiteRef, take?: number): GraphOperation<DriveList>;
 //# sourceMappingURL=listDrives.d.ts.map

package/dist/esm/operations/drive/listDrives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listDrives.d.ts","sourceRoot":"","sources":["../../../../src/operations/drive/listDrives.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAKpD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC,CAkB7F"}
+{"version":3,"file":"listDrives.d.ts","sourceRoot":"","sources":["../../../../src/operations/drive/listDrives.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAKpD,MAAM,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC7B,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,SAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAwB3F"}

package/dist/esm/operations/drive/listDrives.js

@@ -9,25 +9,29 @@ import { generatePath } from "../../services/templatedPaths.js";
 /**
  * Retrieve the list of accessible Drives in a Site.
  * @param siteRef Reference to the site.
+ * @param take Maximum number of items to retrieve. Defaults to 1000.
  * @returns Array of drives available for the specified site, each including its metadata and reference information.
  * @see https://learn.microsoft.com/en-us/graph/api/drive-list
  */
-export default function listDrives(siteRef) {
+export default function listDrives(siteRef, take = 1000) {
     return operation({
         context: siteRef.context,
         method: "GET",
-        path: generatePath("/sites/{site-id}/drives", siteRef),
+        path: generatePath(`/sites/{site-id}/drives?$top=${take}`, siteRef),
         headers: {},
         body: null,
         responseTransform: (response) => {
-            const list = response;
-            return list.value.map((drive) => {
-                const ref = createDriveRef(siteRef, drive.id);
-                return {
-                    ...drive,
-                    ...ref,
-                };
-            });
+            const result = response;
+            return {
+                drives: result.value.map((drive) => {
+                    const driveRef = createDriveRef(siteRef, drive.id);
+                    return {
+                        ...drive,
+                        ...driveRef,
+                    };
+                }),
+                nextLink: result["@odata.nextLink"] ? new URL(result["@odata.nextLink"]) : null,
+            };
         },
     });
 }

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", {}),
+        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/refreshAllWorkbookPivotTables.d.ts

@@ -1,6 +1,6 @@
 /**
  * Refresh all pivot tables in a worksheet.
- * @module refreshAllWorkbookWorksheetPivotTables
+ * @module refreshAllWorkbookPivotTables
  * @category Operations
  */
 import type { GraphOperation } from "../../models/GraphOperation.ts";
@@ -10,6 +10,21 @@ import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheet.ts";
  * @param worksheetRef Reference to the worksheet.
  * @returns void (no response body)
  * @see https://learn.microsoft.com/en-us/graph/api/workbookpivottable-refreshall
+ * @example
+ * const tenantId = getEnvironmentVariable("AZURE_TENANT_ID") as AzureTenantId;
+ * const clientId = getEnvironmentVariable("AZURE_CLIENT_ID") as AzureClientId;
+ * const clientSecret = getEnvironmentVariable("AZURE_CLIENT_SECRET") as AzureClientSecret;
+ * const siteId = getEnvironmentVariable("SHAREPOINT_SITE_ID") as SiteId;
+ * const driveId = getEnvironmentVariable("SHAREPOINT_DRIVE_ID") as DriveId;
+ * const driveItemPath = "/path/to/your/workbook.xlsx" as DriveItemPath;
+ * const worksheetName = "Sheet1" as WorkbookWorksheetName;
+ *
+ * const contextRef = createClientSecretContext(tenantId, clientId, clientSecret);
+ * const siteRef = createSiteRef(contextRef, siteId);
+ * const driveRef = createDriveRef(siteRef, driveId);
+ * const driveItemRef = await getDriveItemByPath(driveRef, driveItemPath);
+ * const worksheetRef = await getWorkbookWorksheetByName(driveItemRef, worksheetName);
+ * await refreshAllWorkbookPivotTables(worksheetRef);
  */
-export default function refreshAllWorkbookWorksheetPivotTables(worksheetRef: WorkbookWorksheetRef): GraphOperation<void>;
+export default function refreshAllWorkbookPivotTables(worksheetRef: WorkbookWorksheetRef): GraphOperation<void>;
 //# sourceMappingURL=refreshAllWorkbookPivotTables.d.ts.map

package/dist/esm/operations/workbookPivotTable/refreshAllWorkbookPivotTables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refreshAllWorkbookPivotTables.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookPivotTable/refreshAllWorkbookPivotTables.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAI9E;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,sCAAsC,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,IAAI,CAAC,CAWvH"}
+{"version":3,"file":"refreshAllWorkbookPivotTables.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookPivotTable/refreshAllWorkbookPivotTables.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAI9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,UAAU,6BAA6B,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,IAAI,CAAC,CAW9G"}

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

@@ -1,6 +1,6 @@
 /**
  * Refresh all pivot tables in a worksheet.
- * @module refreshAllWorkbookWorksheetPivotTables
+ * @module refreshAllWorkbookPivotTables
  * @category Operations
  */
 import { operation } from "../../services/operationInvoker.js";
@@ -10,8 +10,23 @@ import { generatePath } from "../../services/templatedPaths.js";
  * @param worksheetRef Reference to the worksheet.
  * @returns void (no response body)
  * @see https://learn.microsoft.com/en-us/graph/api/workbookpivottable-refreshall
+ * @example
+ * const tenantId = getEnvironmentVariable("AZURE_TENANT_ID") as AzureTenantId;
+ * const clientId = getEnvironmentVariable("AZURE_CLIENT_ID") as AzureClientId;
+ * const clientSecret = getEnvironmentVariable("AZURE_CLIENT_SECRET") as AzureClientSecret;
+ * const siteId = getEnvironmentVariable("SHAREPOINT_SITE_ID") as SiteId;
+ * const driveId = getEnvironmentVariable("SHAREPOINT_DRIVE_ID") as DriveId;
+ * const driveItemPath = "/path/to/your/workbook.xlsx" as DriveItemPath;
+ * const worksheetName = "Sheet1" as WorkbookWorksheetName;
+ *
+ * const contextRef = createClientSecretContext(tenantId, clientId, clientSecret);
+ * const siteRef = createSiteRef(contextRef, siteId);
+ * const driveRef = createDriveRef(siteRef, driveId);
+ * const driveItemRef = await getDriveItemByPath(driveRef, driveItemPath);
+ * const worksheetRef = await getWorkbookWorksheetByName(driveItemRef, worksheetName);
+ * await refreshAllWorkbookPivotTables(worksheetRef);
  */
-export default function refreshAllWorkbookWorksheetPivotTables(worksheetRef) {
+export default function refreshAllWorkbookPivotTables(worksheetRef) {
     return operation({
         context: worksheetRef.context,
         method: "POST",

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";
@@ -10,6 +10,23 @@ import type { WorkbookPivotTableRef } from "../../models/WorkbookPivotTable.ts";
  * @param pivotTableRef Reference to the pivot table.
  * @returns void (no response body)
  * @see https://learn.microsoft.com/en-us/graph/api/workbookpivottable-refresh
+ * @example
+ * const tenantId = getEnvironmentVariable("AZURE_TENANT_ID") as AzureTenantId;
+ * const clientId = getEnvironmentVariable("AZURE_CLIENT_ID") as AzureClientId;
+ * const clientSecret = getEnvironmentVariable("AZURE_CLIENT_SECRET") as AzureClientSecret;
+ * const siteId = getEnvironmentVariable("SHAREPOINT_SITE_ID") as SiteId;
+ * const driveId = getEnvironmentVariable("SHAREPOINT_DRIVE_ID") as DriveId;
+ * const driveItemPath = "/path/to/your/workbook.xlsx" as DriveItemPath;
+ * const worksheetName = "Sheet1" as WorkbookWorksheetName;
+ * const pivotTableId = "PivotTable1" as WorkbookPivotTableId;
+ *
+ * const contextRef = createClientSecretContext(tenantId, clientId, clientSecret);
+ * const siteRef = createSiteRef(contextRef, siteId);
+ * const driveRef = createDriveRef(siteRef, driveId);
+ * const driveItemRef = await getDriveItemByPath(driveRef, driveItemPath);
+ * const worksheetRef = await getWorkbookWorksheetByName(driveItemRef, worksheetName);
+ * const pivotTableRef = createWorkbookPivotTableRef(worksheetRef, pivotTableId);
+ * await refreshWorkbookPivotTable(pivotTableRef);
  */
-export default function refreshWorkbookWorksheetPivotTable(pivotTableRef: WorkbookPivotTableRef): GraphOperation<void>;
+export default function refreshWorkbookPivotTable(pivotTableRef: WorkbookPivotTableRef): GraphOperation<void>;
 //# sourceMappingURL=refreshWorkbookPivotTable.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"refreshWorkbookPivotTable.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookPivotTable/refreshWorkbookPivotTable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAIhF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,kCAAkC,CAAC,aAAa,EAAE,qBAAqB,GAAG,cAAc,CAAC,IAAI,CAAC,CAWrH"}
+{"version":3,"file":"refreshWorkbookPivotTable.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookPivotTable/refreshWorkbookPivotTable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAIhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,aAAa,EAAE,qBAAqB,GAAG,cAAc,CAAC,IAAI,CAAC,CAW5G"}

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";
@@ -10,8 +10,25 @@ import { generatePath } from "../../services/templatedPaths.js";
  * @param pivotTableRef Reference to the pivot table.
  * @returns void (no response body)
  * @see https://learn.microsoft.com/en-us/graph/api/workbookpivottable-refresh
+ * @example
+ * const tenantId = getEnvironmentVariable("AZURE_TENANT_ID") as AzureTenantId;
+ * const clientId = getEnvironmentVariable("AZURE_CLIENT_ID") as AzureClientId;
+ * const clientSecret = getEnvironmentVariable("AZURE_CLIENT_SECRET") as AzureClientSecret;
+ * const siteId = getEnvironmentVariable("SHAREPOINT_SITE_ID") as SiteId;
+ * const driveId = getEnvironmentVariable("SHAREPOINT_DRIVE_ID") as DriveId;
+ * const driveItemPath = "/path/to/your/workbook.xlsx" as DriveItemPath;
+ * const worksheetName = "Sheet1" as WorkbookWorksheetName;
+ * const pivotTableId = "PivotTable1" as WorkbookPivotTableId;
+ *
+ * const contextRef = createClientSecretContext(tenantId, clientId, clientSecret);
+ * const siteRef = createSiteRef(contextRef, siteId);
+ * const driveRef = createDriveRef(siteRef, driveId);
+ * const driveItemRef = await getDriveItemByPath(driveRef, driveItemPath);
+ * const worksheetRef = await getWorkbookWorksheetByName(driveItemRef, worksheetName);
+ * const pivotTableRef = createWorkbookPivotTableRef(worksheetRef, pivotTableId);
+ * await refreshWorkbookPivotTable(pivotTableRef);
  */
-export default function refreshWorkbookWorksheetPivotTable(pivotTableRef) {
+export default function refreshWorkbookPivotTable(pivotTableRef) {
     return operation({
         context: pivotTableRef.context,
         method: "POST",

package/dist/esm/services/workbookPivotTable.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Utilities for working with workbook pivot tables and their references.
+ * @module workbookPivotTable
+ * @category Services
+ */
+import type { WorkbookPivotTableId, WorkbookPivotTableRef } from "../models/WorkbookPivotTable.ts";
+import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheet.ts";
+/**
+ * Creates a reference to a workbook pivot table.
+ * @param worksheetRef Reference to the worksheet containing the pivot table.
+ * @param pivotTableId ID of the pivot table.
+ * @returns Reference to the workbook pivot table.
+ * @throws Error if the pivot table ID is missing.
+ */
+export declare function createWorkbookPivotTableRef(worksheetRef: WorkbookWorksheetRef, pivotTableId: WorkbookPivotTableId | undefined): WorkbookPivotTableRef;
+//# sourceMappingURL=workbookPivotTable.d.ts.map

package/dist/esm/services/workbookPivotTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbookPivotTable.d.ts","sourceRoot":"","sources":["../../../src/services/workbookPivotTable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,oBAAoB,GAAG,SAAS,GAAG,qBAAqB,CAcrJ"}

package/dist/esm/services/workbookPivotTable.js

@@ -0,0 +1,26 @@
+/**
+ * Utilities for working with workbook pivot tables and their references.
+ * @module workbookPivotTable
+ * @category Services
+ */
+/**
+ * Creates a reference to a workbook pivot table.
+ * @param worksheetRef Reference to the worksheet containing the pivot table.
+ * @param pivotTableId ID of the pivot table.
+ * @returns Reference to the workbook pivot table.
+ * @throws Error if the pivot table ID is missing.
+ */
+export function createWorkbookPivotTableRef(worksheetRef, pivotTableId) {
+    if (!pivotTableId) {
+        throw new Error("TableId is missing");
+    }
+    return {
+        context: worksheetRef.context,
+        siteId: worksheetRef.siteId,
+        driveId: worksheetRef.driveId,
+        itemId: worksheetRef.itemId,
+        worksheetId: worksheetRef.worksheetId,
+        sessionId: worksheetRef.sessionId,
+        pivotTableId: pivotTableId,
+    };
+}

package/dist/{cjs/tasks/listDriveItems.d.ts → esm/tasks/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;
+        }
+    }
+}