microsoft-graph 2.6.0 → 2.7.0

package/dist/esm/operations/driveItem/getDriveItem.js

@@ -0,0 +1,25 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Retrieve the metadata for an item in a drive.
+ *
+ * @param itemRef - A reference to the drive item.
+ * @returns The metadata of the specified drive item, including its reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get
+ */
+export default function getDriveItem(itemRef) {
+    return operation({
+        contextId: itemRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}", itemRef),
+        headers: {},
+        body: null,
+        responseTransform: (response) => {
+            const item = response;
+            return {
+                ...item,
+                ...itemRef,
+            };
+        },
+    });
+}

package/dist/esm/operations/driveItem/getDriveItem.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getDriveItem.test.d.ts.map

package/dist/esm/operations/driveItem/getDriveItem.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDriveItem.test.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItem.test.ts"],"names":[],"mappings":""}

package/dist/esm/operations/driveItem/getDriveItem.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import createFolder from "../drive/createFolder.js";
+import getDriveItem from "./getDriveItem.js";
+describe("getDriveItem", () => {
+    const defaultDriveRef = getDefaultDriveRef();
+    it("can retrieve an existing folder", async () => {
+        const folderName = generateTempFileName();
+        const folder = await createFolder(defaultDriveRef, folderName);
+        const retrievedFolder = await getDriveItem(folder);
+        expect(retrievedFolder.id).toBe(folder.id);
+        expect(retrievedFolder.name).toBe(folderName);
+        await tryDeleteDriveItem(folder);
+    });
+    it("throws an error when trying to retrieve a non-existent item", async () => {
+        const nonExistentItemRef = {
+            ...defaultDriveRef,
+            itemId: "non-existent-item-id",
+        };
+        await expect(getDriveItem(nonExistentItemRef)).rejects.toThrow();
+    });
+});

package/dist/esm/operations/driveItem/getDriveItemByPath.d.ts

@@ -0,0 +1,15 @@
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { DriveItemPath } from "../../models/DriveItemPath.ts";
+import type { DriveItemRef } from "../../models/DriveItemRef.ts";
+import type { DriveRef } from "../../models/DriveRef.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+/**
+ * Retrieve the metadata for an item in a drive by file path.
+ *
+ * @param driveRef - A reference to the drive containing the item.
+ * @param itemPath - The file path of the item within the drive.
+ * @returns The metadata of the specified drive item, including its reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get
+ */
+export default function getDriveItemByPath(driveRef: DriveRef, itemPath: DriveItemPath): GraphOperation<DriveItem & DriveItemRef>;
+//# sourceMappingURL=getDriveItemByPath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDriveItemByPath.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemByPath.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC,SAAS,GAAG,YAAY,CAAC,CAiBhI"}

package/dist/esm/operations/driveItem/getDriveItemByPath.js

@@ -0,0 +1,28 @@
+import { operation } from "../../graphApi.js";
+import { createDriveItemRef } from "../../services/driveItem.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Retrieve the metadata for an item in a drive by file path.
+ *
+ * @param driveRef - A reference to the drive containing the item.
+ * @param itemPath - The file path of the item within the drive.
+ * @returns The metadata of the specified drive item, including its reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get
+ */
+export default function getDriveItemByPath(driveRef, itemPath) {
+    return operation({
+        contextId: driveRef.contextId,
+        method: "GET",
+        path: generatePath(`/sites/{site-id}/drives/{drive-id}/root:${itemPath}`, driveRef),
+        headers: {},
+        body: null,
+        responseTransform: (response) => {
+            const item = response;
+            const itemRef = createDriveItemRef(driveRef, item.id);
+            return {
+                ...item,
+                ...itemRef,
+            };
+        },
+    });
+}

package/dist/esm/operations/driveItem/getDriveItemByPath.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getDriveItemByPath.test.d.ts.map

package/dist/esm/operations/driveItem/getDriveItemByPath.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDriveItemByPath.test.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemByPath.test.ts"],"names":[],"mappings":""}

package/dist/esm/operations/driveItem/getDriveItemByPath.test.js

@@ -0,0 +1,22 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { driveItemPath } from "../../services/driveItem.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import createFolder from "../drive/createFolder.js";
+import getDriveItemByPath from "./getDriveItemByPath.js";
+describe("getDriveItemByPath", () => {
+    it("can retrieve an existing folder by path", async () => {
+        const folderName = generateTempFileName();
+        const folder = await createFolder(getDefaultDriveRef(), folderName);
+        const folderPath = driveItemPath(folderName);
+        const retrievedFolder = await getDriveItemByPath(getDefaultDriveRef(), folderPath);
+        expect(retrievedFolder.id).toBe(folder.id);
+        expect(retrievedFolder.name).toBe(folderName);
+        await tryDeleteDriveItem(folder);
+    });
+    it("throws an error when trying to retrieve a non-existent item by path", async () => {
+        const nonExistentItemPath = driveItemPath("non-existent-item-path");
+        await expect(getDriveItemByPath(getDefaultDriveRef(), nonExistentItemPath)).rejects.toThrow();
+    });
+});

package/dist/esm/operations/driveItem/getDriveItemContent.d.ts

@@ -0,0 +1,11 @@
+import type { DriveItemRef } from "../../models/DriveItemRef.ts";
+/**
+ * Download the content of a drive item.
+ *
+ * @param itemRef - A reference to the drive item to be downloaded.
+ * @returns The content of the drive item as an ArrayBuffer.
+ * @throws Error if the download fails.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get-content
+ */
+export default function getDriveItemContent(itemRef: DriveItemRef): Promise<ArrayBuffer>;
+//# sourceMappingURL=getDriveItemContent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDriveItemContent.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemContent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAMjE;;;;;;;GAOG;AACH,wBAA8B,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAmB7F"}

package/dist/esm/operations/driveItem/getDriveItemContent.js

@@ -0,0 +1,31 @@
+import fetch from "node-fetch";
+import { authenticationScope, endpoint } from "../../graphApi.js";
+import { getCurrentAccessToken } from "../../services/accessToken.js";
+import { getContext } from "../../services/context.js";
+import { tryGetHttpAgent } from "../../services/httpAgent.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Download the content of a drive item.
+ *
+ * @param itemRef - A reference to the drive item to be downloaded.
+ * @returns The content of the drive item as an ArrayBuffer.
+ * @throws Error if the download fails.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-get-content
+ */
+export default async function getDriveItemContent(itemRef) {
+    // Note this method doesn't match the standard pattern since the batching library doesn't support non-JSON return types, and there appears to be no value in adding support.
+    const url = `${endpoint}${generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/content", itemRef)}`;
+    const context = getContext(itemRef.contextId);
+    const accessToken = await getCurrentAccessToken(context.tenantId, context.clientId, context.clientSecret, authenticationScope);
+    const agent = tryGetHttpAgent(context.httpProxy);
+    const response = await fetch(url, {
+        headers: {
+            authorization: `Bearer ${accessToken}`,
+        },
+        agent,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to download file: ${response.status} ${response.statusText}`);
+    }
+    return await response.arrayBuffer();
+}

package/dist/esm/operations/driveItem/getDriveItemContent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getDriveItemContent.test.d.ts.map

package/dist/esm/operations/driveItem/getDriveItemContent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDriveItemContent.test.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/getDriveItemContent.test.ts"],"names":[],"mappings":""}

package/dist/esm/operations/driveItem/getDriveItemContent.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { createDriveItemRef, driveItemPath } from "../../services/driveItem.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import { createWorkbookRangeRef } from "../../services/workbookRange.js";
+import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../../services/workbookWorksheet.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import calculateWorkbook from "../workbook/calculateWorkbook.js";
+import createWorkbook from "../workbook/createWorkbook.js";
+import updateWorkbookRange from "../workbookRange/updateWorkbookRange.js";
+import getDriveItemContent from "./getDriveItemContent.js";
+describe("getDriveItemContent", () => {
+    it("can download the content of an existing workbook", { timeout: 20000 }, async () => {
+        const workbookPath = driveItemPath(generateTempFileName("xlsx"));
+        const workbook = await createWorkbook(getDefaultDriveRef(), workbookPath);
+        try {
+            const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B1");
+            await updateWorkbookRange(rangeRef, {
+                values: [["Hello", "World"]],
+            });
+            await calculateWorkbook(workbook);
+            const content = await getDriveItemContent(workbook);
+            expect(content).toBeInstanceOf(ArrayBuffer);
+            expect(content.byteLength).toBeGreaterThan(0);
+        }
+        finally {
+            await tryDeleteDriveItem(workbook);
+        }
+    });
+    it("throws an error when trying to download a non-existent item", async () => {
+        const nonExistentItemRef = createDriveItemRef(getDefaultDriveRef(), "non-existent-item-id");
+        await expect(getDriveItemContent(nonExistentItemRef)).rejects.toThrow();
+    });
+});

package/dist/esm/operations/driveItem/initiateCopyDriveItem.d.ts

@@ -0,0 +1,13 @@
+import type { DriveItemRef } from "../../models/DriveItemRef.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+/**
+ * Initiate an asynchronous copy of an item. NOTE: The copied file may not be immediately available and polling is required.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFolderRef - A reference to the destination folder.
+ * @param dstFileName - The name of the copied file.
+ * @returns Nothing. The copied file may not be immediately available, and polling is required.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-copy
+ */
+export default function initiateCopyDriveItem(srcFileRef: DriveItemRef, dstFolderRef: DriveItemRef, dstFileName: string): GraphOperation<void>;
+//# sourceMappingURL=initiateCopyDriveItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initiateCopyDriveItem.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/initiateCopyDriveItem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAkB7I"}

package/dist/esm/operations/driveItem/initiateCopyDriveItem.js

@@ -0,0 +1,30 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Initiate an asynchronous copy of an item. NOTE: The copied file may not be immediately available and polling is required.
+ *
+ * @param srcFileRef - A reference to the source file to be copied.
+ * @param dstFolderRef - A reference to the destination folder.
+ * @param dstFileName - The name of the copied file.
+ * @returns Nothing. The copied file may not be immediately available, and polling is required.
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-copy
+ */
+export default function initiateCopyDriveItem(srcFileRef, dstFolderRef, dstFileName) {
+    return operation({
+        contextId: srcFileRef.contextId,
+        method: "POST",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/copy", srcFileRef),
+        headers: {
+            "content-type": "application/json",
+        },
+        body: {
+            name: dstFileName,
+            parentReference: {
+                siteId: dstFolderRef.siteId,
+                driveId: dstFolderRef.driveId,
+                id: dstFolderRef.itemId,
+            },
+        },
+        responseTransform: () => undefined,
+    });
+}

package/dist/esm/operations/driveItem/initiateCopyDriveItem.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=initiateCopyDriveItem.test.d.ts.map

package/dist/esm/operations/driveItem/initiateCopyDriveItem.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiateCopyDriveItem.test.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/initiateCopyDriveItem.test.ts"],"names":[],"mappings":""}

package/dist/esm/operations/driveItem/initiateCopyDriveItem.test.js

@@ -0,0 +1,28 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { driveItemPath } from "../../services/driveItem.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import createFolder from "../drive/createFolder.js";
+import getDriveItemByPath from "./getDriveItemByPath.js";
+import initiateCopyDriveItem from "./initiateCopyDriveItem.js";
+describe("initiateCopyDriveItem", () => {
+    it("can copy an item to a new folder", async () => {
+        const driveRef = getDefaultDriveRef();
+        const srcFolderName = generateTempFileName();
+        const srcFolder = await createFolder(driveRef, srcFolderName);
+        const dstFolderName = generateTempFileName();
+        const dstFolder = await createFolder(driveRef, dstFolderName);
+        try {
+            const copiedItemName = `${srcFolderName}-copy`;
+            await initiateCopyDriveItem(srcFolder, dstFolder, copiedItemName);
+            const copyPath = driveItemPath(dstFolderName, copiedItemName);
+            const copyFolder = await getDriveItemByPath(driveRef, copyPath);
+            expect(copyFolder.webUrl?.endsWith(copyPath)).toBeTruthy();
+        }
+        finally {
+            await tryDeleteDriveItem(srcFolder);
+            await tryDeleteDriveItem(dstFolder);
+        }
+    });
+});

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

@@ -0,0 +1,18 @@
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
+import type { DriveItemRef } from "../../models/DriveItemRef.ts";
+import type { DriveRef } from "../../models/DriveRef.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+export type ListDriveItemResponse = {
+    "@odata.context": string;
+    value: DriveItem[];
+    "@odata.nextLink"?: string;
+};
+/**
+ * Retrieve the metadata for items in a drive or folder.
+ *
+ * @param parentRef - A reference to the parent drive or folder. Defaults to the root drive.
+ * @returns An 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 listDriveItems(parentRef: DriveRef | DriveItemRef): GraphOperation<(DriveItem & DriveItemRef)[]>;
+//# 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,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,MAAM,MAAM,qBAAqB,GAAG;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,GAAG,cAAc,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAwBvH"}

package/dist/esm/operations/driveItem/listDriveItems.js

@@ -0,0 +1,31 @@
+import { operation } from "../../graphApi.js";
+import { createDriveItemRef } from "../../services/driveItem.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Retrieve the metadata for items in a drive or folder.
+ *
+ * @param parentRef - A reference to the parent drive or folder. Defaults to the root drive.
+ * @returns An 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 listDriveItems(parentRef) {
+    const pathSegment = parentRef.itemId ? "items/{item-id}" : "root";
+    return operation({
+        contextId: parentRef.contextId,
+        method: "GET",
+        path: generatePath(`/sites/{site-id}/drives/{drive-id}/${pathSegment}/children`, parentRef),
+        headers: {},
+        body: null,
+        responseTransform: (response) => {
+            const list = response;
+            const items = list.value.map((item) => {
+                const itemRef = createDriveItemRef(parentRef, item.id);
+                return {
+                    ...item,
+                    ...itemRef,
+                };
+            });
+            return items;
+        },
+    });
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=listDriveItems.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listDriveItems.test.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/listDriveItems.test.ts"],"names":[],"mappings":""}

package/dist/esm/operations/driveItem/listDriveItems.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultDriveRef } from "../../services/drive.js";
+import { generateTempFileName } from "../../services/temporaryFiles.js";
+import tryDeleteDriveItem from "../../tasks/tryDeleteDriveItem.js";
+import createFolder from "../drive/createFolder.js";
+import listDriveItems from "./listDriveItems.js";
+describe("listDriveItems", () => {
+    it("can list items in the root folder", async () => {
+        const driveRef = getDefaultDriveRef();
+        const items = await listDriveItems(driveRef);
+        expect(items).toBeInstanceOf(Array);
+    });
+    it("can list items in a folder", async () => {
+        const driveRef = getDefaultDriveRef();
+        const folder = await createFolder(driveRef, generateTempFileName());
+        try {
+            const items = await listDriveItems(folder);
+            expect(items).toBeInstanceOf(Array);
+        }
+        finally {
+            await tryDeleteDriveItem(folder);
+        }
+    });
+});

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

@@ -0,0 +1,12 @@
+import type { Site } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { SiteRef } from "../../models/SiteRef.ts";
+/**
+ * Retrieve properties for a site resource.
+ *
+ * @param siteRef - A reference to the site.
+ * @returns The specified site, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/site-get
+ */
+export default function getSite(siteRef: SiteRef): GraphOperation<Site & SiteRef>;
+//# sourceMappingURL=getSite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getSite.d.ts","sourceRoot":"","sources":["../../../../src/operations/site/getSite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,IAAI,GAAG,OAAO,CAAC,CAehF"}

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

@@ -0,0 +1,25 @@
+import { operation } from "../../graphApi.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Retrieve properties for a site resource.
+ *
+ * @param siteRef - A reference to the site.
+ * @returns The specified site, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/site-get
+ */
+export default function getSite(siteRef) {
+    return operation({
+        contextId: siteRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{site-id}", siteRef),
+        headers: {},
+        body: null,
+        responseTransform: (response) => {
+            const site = response;
+            return {
+                ...site,
+                ...siteRef,
+            };
+        },
+    });
+}

package/dist/esm/operations/site/getSite.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getSite.test.d.ts.map

package/dist/esm/operations/site/getSite.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSite.test.d.ts","sourceRoot":"","sources":["../../../../src/operations/site/getSite.test.ts"],"names":[],"mappings":""}

package/dist/esm/operations/site/getSite.test.js

@@ -0,0 +1,11 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultSiteRef } from "../../services/site.js";
+import getSite from "./getSite.js";
+describe("getSite", () => {
+    it("can retrieve an existing site", async () => {
+        const defaultSiteRef = getDefaultSiteRef();
+        const site = await getSite(defaultSiteRef);
+        expect(site.id).toBeDefined();
+        expect(site.name).toBeDefined();
+    });
+});

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

@@ -0,0 +1,17 @@
+import type { Site } from "@microsoft/microsoft-graph-types";
+import type { ContextRef } from "../../models/ContextRef.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { HostName } from "../../models/HostName.ts";
+import type { SiteName } from "../../models/SiteName.ts";
+import type { SiteRef } from "../../models/SiteRef.ts";
+/**
+ * Get a site by its name.
+ *
+ * @param contextRef - A reference to the context.
+ * @param hostName - The host name of the site.
+ * @param siteName - The name of the site.
+ * @returns The specified site, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/site-getbypath
+ */
+export default function getSiteByName(contextRef: ContextRef, hostName: HostName, siteName: SiteName): GraphOperation<Site & SiteRef>;
+//# sourceMappingURL=getSiteByName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getSiteByName.d.ts","sourceRoot":"","sources":["../../../../src/operations/site/getSiteByName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIvD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,IAAI,GAAG,OAAO,CAAC,CAiBpI"}

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

@@ -0,0 +1,30 @@
+import { operation } from "../../graphApi.js";
+import { createSiteRef } from "../../services/site.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Get a site by its name.
+ *
+ * @param contextRef - A reference to the context.
+ * @param hostName - The host name of the site.
+ * @param siteName - The name of the site.
+ * @returns The specified site, including its metadata and reference information.
+ * @see https://learn.microsoft.com/en-us/graph/api/site-getbypath
+ */
+export default function getSiteByName(contextRef, hostName, siteName) {
+    return operation({
+        contextId: contextRef.contextId,
+        method: "GET",
+        path: generatePath("/sites/{host-name}:/sites/{site-name}", { hostName, siteName }),
+        headers: {},
+        body: null,
+        responseTransform: (response) => {
+            const site = response;
+            const siteId = site.id;
+            const siteRef = createSiteRef(contextRef, siteId);
+            return {
+                ...site,
+                ...siteRef,
+            };
+        },
+    });
+}

package/dist/esm/operations/site/getSiteByName.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getSiteByName.test.d.ts.map

package/dist/esm/operations/site/getSiteByName.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSiteByName.test.d.ts","sourceRoot":"","sources":["../../../../src/operations/site/getSiteByName.test.ts"],"names":[],"mappings":""}

package/dist/esm/operations/site/getSiteByName.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vitest";
+import { getDefaultSiteRef } from "../../services/site.js";
+import getSite from "./getSite.js";
+import getSiteByName from "./getSiteByName.js";
+describe("getSiteByName", () => {
+    it("can retrieve an existing site by name", async () => {
+        const defaultSiteRef = getDefaultSiteRef();
+        const defaultSite = await getSite(defaultSiteRef);
+        const hostName = new URL(defaultSite.webUrl ?? "").hostname; // Yeah, a little hacky, but in the context of this test it's fine
+        const siteName = defaultSite.name;
+        const site = await getSiteByName(defaultSiteRef, hostName, siteName);
+        expect(site.id).toBe(defaultSite.id);
+        expect(site.name).toBe(siteName);
+    });
+});

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

@@ -0,0 +1,13 @@
+import type { Site } from "@microsoft/microsoft-graph-types";
+import type { ContextRef } from "../../models/ContextRef.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { SiteRef } from "../../models/SiteRef.ts";
+/**
+ * List accessible sites.
+ *
+ * @param contextRef - A reference to the context.
+ * @returns An 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)[]>;
+//# sourceMappingURL=listSites.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listSites.d.ts","sourceRoot":"","sources":["../../../../src/operations/site/listSites.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIvD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAuB5F"}

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

@@ -0,0 +1,31 @@
+import { operation } from "../../graphApi.js";
+import { createSiteRef } from "../../services/site.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * List accessible sites.
+ *
+ * @param contextRef - A reference to the context.
+ * @returns An 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) {
+    return operation({
+        contextId: contextRef.contextId,
+        method: "GET",
+        path: generatePath("/sites", {}),
+        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;
+        },
+    });
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=listSites.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listSites.test.d.ts","sourceRoot":"","sources":["../../../../src/operations/site/listSites.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,12 @@
+import { describe, expect, it } from "vitest";
+import listSites from "./listSites.js";
+import { getDefaultContextRef } from "../../services/context.js";
+describe("listSites", () => {
+    it("can list all sites", async () => {
+        const contextRef = getDefaultContextRef();
+        const sites = await listSites(contextRef);
+        console.debug("Sites:", sites.map((site) => [site.id, site.name]));
+        expect(sites).toBeInstanceOf(Array);
+        expect(sites.length).toBeGreaterThan(0);
+    });
+});