microsoft-graph 2.6.0 → 2.7.0

package/dist/cjs/services/driveItem.d.ts

@@ -0,0 +1,22 @@
+import type { DriveItemId } from "../models/DriveItemId.ts";
+import type { DriveItemPath } from "../models/DriveItemPath.ts";
+import type { DriveItemRef } from "../models/DriveItemRef.ts";
+import type { DriveRef } from "../models/DriveRef.ts";
+export declare const workbookFileExtension = "xlsx";
+export declare const rootDriveItemPath: DriveItemPath;
+/**
+ * Creates a drive item path from a given set of segments.
+ * @param segments - The segments of the path.
+ * @returns The constructed drive item path.
+ * @throws InvalidArgumentError if a segment is invalid or the path exceeds 400 characters.
+ */
+export declare function driveItemPath(...segments: string[]): DriveItemPath;
+/**
+ * Creates a reference to a drive item.
+ * @param driveRef - The reference to the drive.
+ * @param itemId - The ID of the drive item.
+ * @returns A reference to the drive item.
+ * @throws ProtocolError if the item ID is missing.
+ */
+export declare function createDriveItemRef(driveRef: DriveRef, itemId: DriveItemId | undefined): DriveItemRef;
+//# sourceMappingURL=driveItem.d.ts.map

package/dist/cjs/services/driveItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,eAAO,MAAM,iBAAiB,eAAqB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAkClE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAWpG"}

package/dist/cjs/services/driveItem.js

@@ -0,0 +1,57 @@
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import ProtocolError from "../errors/ProtocolError.js";
+const segmentPattern = /^[^"*:<>?\\|#]{1,256}$/;
+const reservedNames = ["CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", "LPT9"];
+export const workbookFileExtension = "xlsx";
+export const rootDriveItemPath = driveItemPath("/");
+/**
+ * Creates a drive item path from a given set of segments.
+ * @param segments - The segments of the path.
+ * @returns The constructed drive item path.
+ * @throws InvalidArgumentError if a segment is invalid or the path exceeds 400 characters.
+ */
+export function driveItemPath(...segments) {
+    for (const segment of segments) {
+        if (segment === "") {
+            throw new InvalidArgumentError("Segment cannot be an empty string.");
+        }
+        if (!segmentPattern.test(segment)) {
+            throw new InvalidArgumentError(`Segment '${segment}' does not match required pattern '${segmentPattern}'.`);
+        }
+        if (reservedNames.includes(segment.toUpperCase())) {
+            throw new InvalidArgumentError(`Segment '${segment}' is a reserved name.`);
+        }
+        if (segment.endsWith(".")) {
+            throw new InvalidArgumentError(`Segment '${segment}' cannot end with a period.`);
+        }
+    }
+    let path = `${segments.join("/")}`;
+    if (!path.startsWith("/")) {
+        path = `/${path}`;
+    }
+    if (path.includes("//")) {
+        throw new InvalidArgumentError("Path cannot contain consecutive slashes.");
+    }
+    if (path.length > 400) {
+        throw new InvalidArgumentError("Path length exceeds 400 characters.");
+    }
+    return path;
+}
+/**
+ * Creates a reference to a drive item.
+ * @param driveRef - The reference to the drive.
+ * @param itemId - The ID of the drive item.
+ * @returns A reference to the drive item.
+ * @throws ProtocolError if the item ID is missing.
+ */
+export function createDriveItemRef(driveRef, itemId) {
+    if (!itemId) {
+        throw new ProtocolError("ItemID is missing");
+    }
+    return {
+        contextId: driveRef.contextId,
+        siteId: driveRef.siteId,
+        driveId: driveRef.driveId,
+        itemId,
+    };
+}

package/dist/cjs/services/driveItem.test.d.ts

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

package/dist/cjs/services/driveItem.test.d.ts.map

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

package/dist/cjs/services/driveItem.test.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vitest";
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import { driveItemPath } from "./driveItem.js";
+describe("driveItemPath", () => {
+    it("throws an error for empty segment", () => {
+        expect(() => driveItemPath("")).toThrow(InvalidArgumentError);
+    });
+    it.each([
+        [["a"], "/a"],
+        [["a", "b"], "/a/b"],
+        [["a", "b", "c.txt"], "/a/b/c.txt"],
+        [["/a"], "/a"],
+        [[], "/"],
+    ])("parses %s", (segments, expected) => {
+        expect(driveItemPath(...segments)).toEqual(expected);
+    });
+});

package/dist/cjs/services/environmentVariable.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Retrieves the value of an environment variable.
+ * @param env - The name of the environment variable.
+ * @param fallbackValue - The fallback value to use if the environment variable is not set. Defaults to null.
+ * @returns The value of the environment variable or the fallback value.
+ * @throws EnvironmentVariableMissingError if the environment variable is not set and no fallback value is provided.
+ */
+export declare function getEnvironmentVariable(env: string, fallbackValue?: string | null): unknown;
+/**
+ * Binds an environment variable to a function that retrieves its value.
+ * @param env - The name of the environment variable.
+ * @param fallbackValue - The fallback value to use if the environment variable is not set. Defaults to null.
+ * @returns A function that retrieves the value of the environment variable or the fallback value.
+ */
+export declare function bindEnvironmentVariable(env: string, fallbackValue?: string | null): () => unknown;
+//# sourceMappingURL=environmentVariable.d.ts.map

package/dist/cjs/services/environmentVariable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environmentVariable.d.ts","sourceRoot":"","sources":["../../../src/services/environmentVariable.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAWhG;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,OAAO,CAEvG"}

package/dist/cjs/services/environmentVariable.js

@@ -0,0 +1,27 @@
+import EnvironmentVariableMissingError from "../errors/EnvironmentVariableMissingError.js";
+/**
+ * Retrieves the value of an environment variable.
+ * @param env - The name of the environment variable.
+ * @param fallbackValue - The fallback value to use if the environment variable is not set. Defaults to null.
+ * @returns The value of the environment variable or the fallback value.
+ * @throws EnvironmentVariableMissingError if the environment variable is not set and no fallback value is provided.
+ */
+export function getEnvironmentVariable(env, fallbackValue = null) {
+    const value = process.env[env]?.trim() ?? "";
+    if (value === "") {
+        if (fallbackValue === null) {
+            throw new EnvironmentVariableMissingError(env);
+        }
+        return fallbackValue ?? "";
+    }
+    return value;
+}
+/**
+ * Binds an environment variable to a function that retrieves its value.
+ * @param env - The name of the environment variable.
+ * @param fallbackValue - The fallback value to use if the environment variable is not set. Defaults to null.
+ * @returns A function that retrieves the value of the environment variable or the fallback value.
+ */
+export function bindEnvironmentVariable(env, fallbackValue = null) {
+    return () => getEnvironmentVariable(env, fallbackValue);
+}

package/dist/cjs/services/httpAgent.d.ts

@@ -0,0 +1,9 @@
+import { HttpsProxyAgent } from "https-proxy-agent";
+import type { HttpProxy } from "../models/HttpProxy.ts";
+/**
+ * Attempts to create an HTTP agent for a given proxy configuration.
+ * @param httpProxy - The HTTP proxy configuration.
+ * @returns An instance of HttpsProxyAgent if the proxy is defined, otherwise undefined.
+ */
+export declare function tryGetHttpAgent(httpProxy: HttpProxy | undefined): HttpsProxyAgent<string> | undefined;
+//# sourceMappingURL=httpAgent.d.ts.map

package/dist/cjs/services/httpAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpAgent.d.ts","sourceRoot":"","sources":["../../../src/services/httpAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,SAAS,CAKrG"}

package/dist/cjs/services/httpAgent.js

@@ -0,0 +1,12 @@
+import { HttpsProxyAgent } from "https-proxy-agent";
+/**
+ * Attempts to create an HTTP agent for a given proxy configuration.
+ * @param httpProxy - The HTTP proxy configuration.
+ * @returns An instance of HttpsProxyAgent if the proxy is defined, otherwise undefined.
+ */
+export function tryGetHttpAgent(httpProxy) {
+    if (!httpProxy) {
+        return undefined;
+    }
+    return new HttpsProxyAgent(httpProxy);
+}

package/dist/cjs/services/httpStatus.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Checks if the HTTP status code indicates a successful response.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is in the range 200-299, otherwise false.
+ */
+export declare function isHttpOk(status: number): boolean;
+/**
+ * Checks if the HTTP status code indicates too many requests (rate limiting).
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 429, otherwise false.
+ */
+export declare function isHttpTooManyRequests(status: number): boolean;
+/**
+ * Checks if the HTTP status code indicates the service is unavailable.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 503, otherwise false.
+ */
+export declare function isServiceUnavailable(status: number): boolean;
+//# sourceMappingURL=httpStatus.d.ts.map

package/dist/cjs/services/httpStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpStatus.d.ts","sourceRoot":"","sources":["../../../src/services/httpStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/cjs/services/httpStatus.js

@@ -0,0 +1,24 @@
+/**
+ * Checks if the HTTP status code indicates a successful response.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is in the range 200-299, otherwise false.
+ */
+export function isHttpOk(status) {
+    return status >= 200 && status < 300;
+}
+/**
+ * Checks if the HTTP status code indicates too many requests (rate limiting).
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 429, otherwise false.
+ */
+export function isHttpTooManyRequests(status) {
+    return status === 429;
+}
+/**
+ * Checks if the HTTP status code indicates the service is unavailable.
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 503, otherwise false.
+ */
+export function isServiceUnavailable(status) {
+    return status === 503;
+}

package/dist/cjs/services/operationId.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Converts an operation index to an operation ID.
+ * @param index - The operation index.
+ * @returns The operation ID as a string.
+ */
+export declare function operationIndexToId(index: number): string;
+/**
+ * Converts an operation ID to an operation index.
+ * @param id - The operation ID as a string.
+ * @returns The operation index as a number.
+ */
+export declare function operationIdToIndex(id: string): number;
+//# sourceMappingURL=operationId.d.ts.map

package/dist/cjs/services/operationId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationId.d.ts","sourceRoot":"","sources":["../../../src/services/operationId.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/cjs/services/operationId.js

@@ -0,0 +1,16 @@
+/**
+ * Converts an operation index to an operation ID.
+ * @param index - The operation index.
+ * @returns The operation ID as a string.
+ */
+export function operationIndexToId(index) {
+    return index.toString();
+}
+/**
+ * Converts an operation ID to an operation index.
+ * @param id - The operation ID as a string.
+ * @returns The operation index as a number.
+ */
+export function operationIdToIndex(id) {
+    return Number.parseInt(id, 10);
+}

package/dist/cjs/services/random.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates a random alphanumeric string of the specified length.
+ * @param length - The length of the string to generate. Defaults to 16.
+ * @returns A random alphanumeric string.
+ */
+export declare function generateRandomString(length?: number): string;
+//# sourceMappingURL=random.d.ts.map

package/dist/cjs/services/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../../src/services/random.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,SAAK,GAAG,MAAM,CAQxD"}

package/dist/cjs/services/random.js

@@ -0,0 +1,14 @@
+import { randomInt } from "node:crypto";
+const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+/**
+ * Generates a random alphanumeric string of the specified length.
+ * @param length - The length of the string to generate. Defaults to 16.
+ * @returns A random alphanumeric string.
+ */
+export function generateRandomString(length = 16) {
+    let result = "";
+    for (let i = 0; i < length; i++) {
+        result += characters[randomInt(characters.length)];
+    }
+    return result;
+}

package/dist/cjs/services/sharepointUrl.d.ts

@@ -0,0 +1,15 @@
+import type { DriveItemId } from "../models/DriveItemId.ts";
+import type { HostName } from "../models/HostName.ts";
+import type { SiteName } from "../models/SiteName.ts";
+/**
+ * Parses a SharePoint document URL to extract the site name, host name, and item ID.
+ * @param url - The SharePoint document URL.
+ * @returns An object containing the host name, site name, and item ID.
+ * @throws InvalidArgumentError if the URL is invalid or required components are missing.
+ */
+export declare function parseSharepointUrl(url: URL): {
+    hostName: HostName;
+    siteName: SiteName;
+    itemId: DriveItemId;
+};
+//# sourceMappingURL=sharepointUrl.d.ts.map

package/dist/cjs/services/sharepointUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharepointUrl.d.ts","sourceRoot":"","sources":["../../../src/services/sharepointUrl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAyB5G"}

package/dist/cjs/services/sharepointUrl.js

@@ -0,0 +1,29 @@
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+/**
+ * Parses a SharePoint document URL to extract the site name, host name, and item ID.
+ * @param url - The SharePoint document URL.
+ * @returns An object containing the host name, site name, and item ID.
+ * @throws InvalidArgumentError if the URL is invalid or required components are missing.
+ */
+export function parseSharepointUrl(url) {
+    if (!url.hostname.endsWith(".sharepoint.com")) {
+        throw new InvalidArgumentError("Invalid SharePoint URL. Hostname must end with '.sharepoint.com'.");
+    }
+    const hostName = url.hostname;
+    const pathSegments = url.pathname.split("/");
+    const siteNameIndex = pathSegments.indexOf("sites") + 1;
+    if (siteNameIndex <= 0 || !pathSegments[siteNameIndex]) {
+        throw new InvalidArgumentError("Invalid SharePoint URL. Site name not found.");
+    }
+    const siteName = pathSegments[siteNameIndex];
+    const sourcedoc = url.searchParams.get("sourcedoc");
+    if (!sourcedoc) {
+        throw new InvalidArgumentError("Invalid SharePoint URL. Path not found in parameters.");
+    }
+    const itemId = sourcedoc.replace(/[{}]/g, "").toLocaleUpperCase();
+    return {
+        hostName,
+        siteName,
+        itemId,
+    };
+}

package/dist/cjs/services/sharepointUrl.test.d.ts

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

package/dist/cjs/services/sharepointUrl.test.d.ts.map

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

package/dist/cjs/services/sharepointUrl.test.js

@@ -0,0 +1,32 @@
+import { describe, expect, it } from "vitest";
+import { parseSharepointUrl } from "./sharepointUrl.js";
+describe("parseSharepointUrl", () => {
+    it.each([
+        [
+            "https://msftfuturesecureai.sharepoint.com/sites/FSAI-MQG/_layouts/15/doc.aspx?sourcedoc={500ff055-1e0f-4c2e-8b32-d167fba4778b}&action=edit",
+            {
+                hostName: "msftfuturesecureai.sharepoint.com",
+                siteName: "FSAI-MQG",
+                itemId: "500FF055-1E0F-4C2E-8B32-D167FBA4778B",
+            },
+        ],
+        [
+            "https://msftfuturesecureai.sharepoint.com/:x:/r/sites/FSAI-MQG/_layouts/15/Doc.aspx?sourcedoc=%7B500FF055-1E0F-4C2E-8B32-D167FBA4778B%7D&file=Book.xlsx&action=default&mobileredirect=true",
+            {
+                hostName: "msftfuturesecureai.sharepoint.com",
+                siteName: "FSAI-MQG",
+                itemId: "500FF055-1E0F-4C2E-8B32-D167FBA4778B",
+            },
+        ],
+        [
+            "https://msftfuturesecureai.sharepoint.com/:x:/r/sites/FSAI-MQG/_layouts/15/Doc.aspx?sourcedoc=%7B418801C2-AF81-44F9-AD17-324A973AA6AF%7D&file=a.xlsx&action=default&mobileredirect=true",
+            {
+                hostName: "msftfuturesecureai.sharepoint.com",
+                siteName: "FSAI-MQG",
+                itemId: "418801C2-AF81-44F9-AD17-324A973AA6AF",
+            },
+        ],
+    ])("parses %s", (url, expected) => {
+        expect(parseSharepointUrl(new URL(url))).toEqual(expected);
+    });
+});

package/dist/cjs/services/site.d.ts

@@ -0,0 +1,18 @@
+import type { ContextRef } from "../models/ContextRef.ts";
+import type { SiteId } from "../models/SiteId.ts";
+import type { SiteRef } from "../models/SiteRef.ts";
+/**
+ * Creates a reference to a site.
+ * @param contextRef - The reference to the context.
+ * @param siteId - The ID of the site.
+ * @returns A reference to the site.
+ * @throws ProtocolError if the site ID is missing.
+ */
+export declare function createSiteRef(contextRef: ContextRef, siteId: SiteId | undefined): SiteRef;
+/**
+ * Retrieves the opinionated default site reference. NOT RECOMMENDED FOR PRODUCTION USE
+ * @returns A reference to the default site.
+ * @remarks This method is opinionated and not recommended for production use.
+ */
+export declare function getDefaultSiteRef(): SiteRef;
+//# sourceMappingURL=site.d.ts.map

package/dist/cjs/services/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../../src/services/site.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CASzF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}

package/dist/cjs/services/site.js

@@ -0,0 +1,30 @@
+import ProtocolError from "../errors/ProtocolError.js";
+import { getDefaultContextRef } from "./context.js";
+import { getEnvironmentVariable } from "./environmentVariable.js";
+/**
+ * Creates a reference to a site.
+ * @param contextRef - The reference to the context.
+ * @param siteId - The ID of the site.
+ * @returns A reference to the site.
+ * @throws ProtocolError if the site ID is missing.
+ */
+export function createSiteRef(contextRef, siteId) {
+    if (!siteId) {
+        throw new ProtocolError("SiteID is missing");
+    }
+    return {
+        contextId: contextRef.contextId,
+        siteId,
+    };
+}
+/**
+ * Retrieves the opinionated default site reference. NOT RECOMMENDED FOR PRODUCTION USE
+ * @returns A reference to the default site.
+ * @remarks This method is opinionated and not recommended for production use.
+ */
+export function getDefaultSiteRef() {
+    const contextRef = getDefaultContextRef();
+    const siteId = getEnvironmentVariable("SHAREPOINT_DEFAULT_SITE_ID");
+    const siteRef = createSiteRef(contextRef, siteId);
+    return siteRef;
+}

package/dist/cjs/services/sleep.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Pauses execution for the specified number of milliseconds.
+ * @param ms - The number of milliseconds to sleep.
+ * @returns A promise that resolves after the specified time.
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/cjs/services/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/services/sleep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/cjs/services/sleep.js

@@ -0,0 +1,8 @@
+/**
+ * Pauses execution for the specified number of milliseconds.
+ * @param ms - The number of milliseconds to sleep.
+ * @returns A promise that resolves after the specified time.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/cjs/services/stringCaseConversion.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Converts a kebab-case string to camelCase.
+ * @param str - The kebab-case string.
+ * @returns The camelCase string.
+ */
+export declare function kebabToCamelCase(str: string): string;
+//# sourceMappingURL=stringCaseConversion.d.ts.map

package/dist/cjs/services/stringCaseConversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringCaseConversion.d.ts","sourceRoot":"","sources":["../../../src/services/stringCaseConversion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/dist/cjs/services/stringCaseConversion.js

@@ -0,0 +1,10 @@
+/**
+ * Converts a kebab-case string to camelCase.
+ * @param str - The kebab-case string.
+ * @returns The camelCase string.
+ */
+export function kebabToCamelCase(str) {
+    return str
+        .replace(/^-+|-+$/g, "") // Remove leading and trailing dashes
+        .replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}

package/dist/cjs/services/stringCaseConversion.test.d.ts

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

package/dist/cjs/services/stringCaseConversion.test.d.ts.map

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

package/dist/cjs/services/stringCaseConversion.test.js

@@ -0,0 +1,16 @@
+import { describe, expect, it } from "vitest";
+import { kebabToCamelCase } from "./stringCaseConversion.js";
+describe("kebabToCamelCase", () => {
+    it("should handle single word strings", () => {
+        expect(kebabToCamelCase("single")).toBe("single");
+    });
+    it("should handle empty strings", () => {
+        expect(kebabToCamelCase("")).toBe("");
+    });
+    it("should handle strings with multiple dashes", () => {
+        expect(kebabToCamelCase("multiple-dashes-in-string")).toBe("multipleDashesInString");
+    });
+    it("should handle strings with leading and trailing dashes", () => {
+        expect(kebabToCamelCase("-leading-and-trailing-")).toBe("leadingAndTrailing");
+    });
+});

package/dist/cjs/services/templatedPaths.d.ts

@@ -0,0 +1,10 @@
+import type { GraphPath } from "../models/GraphOperation.ts";
+/**
+ * Generates a HTTP path based on a template and arguments. Arguments are automatically escaped.
+ * @param template - The path template, which must start with a slash.
+ * @param args - A record of arguments to replace placeholders in the template.
+ * @returns The generated Graph API path.
+ * @throws BadTemplateError if the template is invalid or required arguments are missing.
+ */
+export declare function generatePath(template: string, args: Record<string, string | undefined>): GraphPath;
+//# sourceMappingURL=templatedPaths.d.ts.map

package/dist/cjs/services/templatedPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templatedPaths.d.ts","sourceRoot":"","sources":["../../../src/services/templatedPaths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAK7D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAgBlG"}

package/dist/cjs/services/templatedPaths.js

@@ -0,0 +1,26 @@
+import BadTemplateError from "../errors/BadTemplateError.js";
+import { kebabToCamelCase } from "./stringCaseConversion.js";
+const argumentPattern = /\{([a-z-]+)\}/g;
+/**
+ * Generates a HTTP path based on a template and arguments. Arguments are automatically escaped.
+ * @param template - The path template, which must start with a slash.
+ * @param args - A record of arguments to replace placeholders in the template.
+ * @returns The generated Graph API path.
+ * @throws BadTemplateError if the template is invalid or required arguments are missing.
+ */
+export function generatePath(template, args) {
+    if (!template.startsWith("/")) {
+        throw new BadTemplateError(`Path template '${template}' must start with a slash.`);
+    }
+    if (template.includes("\n")) {
+        throw new BadTemplateError("Path template must not contain newlines.");
+    }
+    return template.replace(argumentPattern, (_, match) => {
+        const camelCaseKey = kebabToCamelCase(match);
+        const value = args[camelCaseKey];
+        if (value === undefined) {
+            throw new BadTemplateError(`Path template references argument '${camelCaseKey}' however no such argument provided.`);
+        }
+        return encodeURIComponent(value);
+    });
+}

package/dist/cjs/services/templatedPaths.test.d.ts

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

package/dist/cjs/services/templatedPaths.test.d.ts.map

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

package/dist/cjs/services/templatedPaths.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from "vitest";
+import BadTemplateError from "../errors/BadTemplateError.js";
+import { generatePath } from "./templatedPaths.js";
+describe("generatePath", () => {
+    it("should generate a valid path with correct arguments", () => {
+        const template = "/me/drive/items/{item-id}/children";
+        const args = { itemId: "123" };
+        const result = generatePath(template, args);
+        expect(result).toBe("/me/drive/items/123/children");
+    });
+    it("should throw BadTemplateError if template does not start with a slash", () => {
+        const template = "me/drive/items/{item-id}/children";
+        const args = { itemId: "123" };
+        expect(() => generatePath(template, args)).toThrow(BadTemplateError);
+    });
+    it("should throw BadTemplateError if template contains newlines", () => {
+        const template = "/me/drive/items/{item-id}/children\n";
+        const args = { itemId: "123" };
+        expect(() => generatePath(template, args)).toThrow(BadTemplateError);
+    });
+    it("should throw BadTemplateError if argument is missing", () => {
+        const template = "/me/drive/items/{item-id}/children";
+        const args = {};
+        expect(() => generatePath(template, args)).toThrow(BadTemplateError);
+    });
+    it("should encode URI components", () => {
+        const template = "/me/drive/items/{item-id}/children";
+        const args = { itemId: "item name with spaces" };
+        const result = generatePath(template, args);
+        expect(result).toBe("/me/drive/items/item%20name%20with%20spaces/children");
+    });
+    it("should generate a valid path when the same argument is used twice", () => {
+        const template = "/me/drive/items/{item-id}/children/{item-id}";
+        const args = { itemId: "123" };
+        const result = generatePath(template, args);
+        expect(result).toBe("/me/drive/items/123/children/123");
+    });
+    it("should throw BadTemplateError if template has an argument that is not matched", () => {
+        const template = "/me/drive/items/{item-id}/children/{child-id}";
+        const args = { itemId: "123" };
+        expect(() => generatePath(template, args)).toThrow(BadTemplateError);
+    });
+    it("should generate a valid path with multiple arguments", () => {
+        const template = "/users/{user-id}/messages/{message-id}/attachments/{attachment-id}";
+        const args = { userId: "user123", messageId: "msg456", attachmentId: "att789" };
+        const result = generatePath(template, args);
+        expect(result).toBe("/users/user123/messages/msg456/attachments/att789");
+    });
+});

package/dist/cjs/services/temporaryFiles.d.ts

@@ -0,0 +1,8 @@
+import type { DriveItemPath } from "../models/DriveItemPath.ts";
+/**
+ * Generates a temporary file name with the specified extension.
+ * @param extension - The file extension. Defaults to "tmp".
+ * @returns A temporary file name.
+ */
+export declare function generateTempFileName(extension?: string | null): DriveItemPath;
+//# sourceMappingURL=temporaryFiles.d.ts.map