microsoft-graph 2.22.2 → 2.23.0

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

@@ -1,6 +1,10 @@
+import type { ClientId } from "../models/ClientId.ts";
+import type { ClientSecret } from "../models/ClientSecret.ts";
 import type { DriveId } from "../models/DriveId.ts";
 import type { DriveRef } from "../models/DriveRef.ts";
+import type { SiteId } from "../models/SiteId.ts";
 import type { SiteRef } from "../models/SiteRef.ts";
+import type { TenantId } from "../models/TenantId.ts";
 /**
  * Creates a reference to a drive.
  * @param siteRef - The reference to the site.
@@ -9,10 +13,13 @@ import type { SiteRef } from "../models/SiteRef.ts";
  * @throws ProtocolError if the drive ID is missing.
  */
 export declare function createDriveRef(siteRef: SiteRef, driveId: DriveId | undefined): DriveRef;
+/** Creates a context with a reference to a drive. */
+export declare function createClientSecretContextWithDriveRef(tenantId: TenantId, clientId: ClientId, clientSecret: ClientSecret, siteId: SiteId, driveId: DriveId): DriveRef;
 /**
  * Retrieves the opinionated default drive reference. NOT RECOMMENDED FOR PRODUCTION USE.
  * @returns A reference to the default drive.
  * @remarks This method is opinionated and not recommended for production use.
+ * @obsolete Use `createClientSecretContextWithDriveRef()` instead.
  */
 export declare function getDefaultDriveRef(): DriveRef;
 //# sourceMappingURL=drive.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"drive.d.ts","sourceRoot":"","sources":["../../../src/services/drive.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAMpD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAUvF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAY7C"}
+{"version":3,"file":"drive.d.ts","sourceRoot":"","sources":["../../../src/services/drive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAUvF;AAED,qDAAqD;AACrD,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,QAAQ,CAKpK;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAY7C"}

package/dist/esm/services/drive.js

@@ -1,5 +1,5 @@
 import ProtocolError from "../errors/ProtocolError.js";
-import { register } from "./context.js";
+import { createClientSecretContext, register } from "./context.js";
 import { getEnvironmentVariable } from "./environmentVariable.js";
 import { createSiteRef } from "./site.js";
 /**
@@ -11,18 +11,26 @@ import { createSiteRef } from "./site.js";
  */
 export function createDriveRef(siteRef, driveId) {
     if (!driveId) {
-        throw new ProtocolError("DriveID is missing");
+        throw new ProtocolError("DriveId is missing");
     }
     return {
-        contextId: siteRef.contextId,
+        context: siteRef.context,
         siteId: siteRef.siteId,
         driveId,
     };
 }
+/** Creates a context with a reference to a drive. */
+export function createClientSecretContextWithDriveRef(tenantId, clientId, clientSecret, siteId, driveId) {
+    const context = createClientSecretContext(tenantId, clientId, clientSecret);
+    const siteRef = createSiteRef(context, siteId);
+    const driveRef = createDriveRef(siteRef, driveId);
+    return driveRef;
+}
 /**
  * Retrieves the opinionated default drive reference. NOT RECOMMENDED FOR PRODUCTION USE.
  * @returns A reference to the default drive.
  * @remarks This method is opinionated and not recommended for production use.
+ * @obsolete Use `createClientSecretContextWithDriveRef()` instead.
  */
 export function getDefaultDriveRef() {
     const tenantId = getEnvironmentVariable("AZURE_TENANT_ID");

package/dist/esm/services/driveItem.js

@@ -49,7 +49,7 @@ export function createDriveItemRef(driveRef, itemId) {
         throw new ProtocolError("ItemID is missing");
     }
     return {
-        contextId: driveRef.contextId,
+        context: driveRef.context,
         siteId: driveRef.siteId,
         driveId: driveRef.driveId,
         itemId,

package/dist/esm/services/site.js

@@ -13,7 +13,7 @@ export function createSiteRef(contextRef, siteId) {
         throw new ProtocolError("SiteID is missing");
     }
     return {
-        contextId: contextRef.contextId,
+        context: contextRef.context,
         siteId,
     };
 }

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

@@ -6,5 +6,5 @@ import type { GraphPath } from "../models/GraphOperation.ts";
  * @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;
+export declare function generatePath(template: string, args: Record<string, unknown>): GraphPath;
 //# sourceMappingURL=templatedPaths.d.ts.map

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

@@ -1 +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"}
+{"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,OAAO,CAAC,GAAG,SAAS,CAmBvF"}

package/dist/esm/services/templatedPaths.js

@@ -18,9 +18,12 @@ export function generatePath(template, args) {
     return template.replace(argumentPattern, (_, match) => {
         const camelCaseKey = kebabToCamelCase(match);
         const value = args[camelCaseKey];
-        if (value === undefined) {
+        if (value === undefined || value === null) {
             throw new BadTemplateError(`Path template references argument '${camelCaseKey}' however no such argument provided.`);
         }
-        return encodeURIComponent(value);
+        if (typeof value !== "string" && typeof value !== "number") {
+            throw new BadTemplateError(`Path template references argument '${camelCaseKey}' which is of type ${typeof value}, but only strings and numbers are allowed.`);
+        }
+        return encodeURIComponent(value.toString());
     });
 }

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

@@ -7,5 +7,5 @@ import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
  * @param address - The address of the range.
  * @returns A reference to the workbook range.
  */
-export declare function createWorkbookRangeRef(worksheetRef: WorkbookWorksheetRef, address: Address): WorkbookRangeRef;
+export declare function createWorkbookRangeRef(worksheetRef: WorkbookWorksheetRef, address: Address | undefined): WorkbookRangeRef;
 //# sourceMappingURL=workbookRange.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workbookRange.d.ts","sourceRoot":"","sources":["../../../src/services/workbookRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAU7G"}
+{"version":3,"file":"workbookRange.d.ts","sourceRoot":"","sources":["../../../src/services/workbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAG9E;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,gBAAgB,CAgBzH"}

package/dist/esm/services/workbookRange.js

@@ -1,3 +1,5 @@
+import ProtocolError from "../errors/ProtocolError.js";
+import { normalizeAddress } from "./addressManipulation.js";
 /**
  * Creates a reference to a workbook range.
  * @param worksheetRef - The reference to the worksheet containing the range.
@@ -5,13 +7,17 @@
  * @returns A reference to the workbook range.
  */
 export function createWorkbookRangeRef(worksheetRef, address) {
+    if (!address) {
+        throw new ProtocolError("Address missing.");
+    }
+    const normalizedAddress = normalizeAddress(address);
     return {
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         siteId: worksheetRef.siteId,
         driveId: worksheetRef.driveId,
         itemId: worksheetRef.itemId,
         sessionId: worksheetRef.sessionId,
         worksheetId: worksheetRef.worksheetId,
-        address: address,
+        address: normalizedAddress,
     };
 }

package/dist/esm/services/workbookTable.js

@@ -10,7 +10,7 @@ export function createWorkbookTableRef(worksheetRef, tableId) {
         throw new Error("TableId is missing");
     }
     return {
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         siteId: worksheetRef.siteId,
         driveId: worksheetRef.driveId,
         itemId: worksheetRef.itemId,

package/dist/esm/services/workbookTableColumn.js

@@ -10,7 +10,7 @@ export function createWorkbookTableColumnRef(tableRef, column) {
         throw new Error("column is missing");
     }
     return {
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         siteId: tableRef.siteId,
         driveId: tableRef.driveId,
         itemId: tableRef.itemId,

package/dist/esm/services/workbookWorksheet.js

@@ -14,7 +14,7 @@ export function createWorkbookWorksheetRef(workbookRef, worksheetId) {
         throw new Error("WorksheetID is missing");
     }
     return {
-        contextId: workbookRef.contextId,
+        context: workbookRef.context,
         siteId: workbookRef.siteId,
         driveId: workbookRef.driveId,
         itemId: workbookRef.itemId,

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

@@ -1 +1 @@
-{"version":3,"file":"listDriveItems.d.ts","sourceRoot":"","sources":["../../../src/tasks/listDriveItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOtD,wBAA8B,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAiCvI"}
+{"version":3,"file":"listDriveItems.d.ts","sourceRoot":"","sources":["../../../src/tasks/listDriveItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtD,wBAA8B,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAgCvI"}

package/dist/esm/tasks/listDriveItems.js

@@ -1,7 +1,4 @@
-import { authenticationScope } from "../graphApi.js";
 import listDriveItemChildren from "../operations/driveItem/listDriveItemChildren.js";
-import { getCurrentAccessToken } from "../services/accessToken.js";
-import { getContext } from "../services/context.js";
 import { createDriveItemRef } from "../services/driveItem.js";
 import { executeHttpRequest } from "../services/http.js";
 export default async function listDriveItems(parentRef, pageSize = 1000) {
@@ -9,8 +6,7 @@ export default async function listDriveItems(parentRef, pageSize = 1000) {
     let result = await listDriveItemChildren(parentRef, pageSize);
     output.push(...result.value);
     while (result["@odata.nextLink"]) {
-        const context = getContext(parentRef.contextId);
-        const accessToken = await getCurrentAccessToken(context.tenantId, context.clientId, context.clientSecret, authenticationScope);
+        const accessToken = await parentRef.context.generateAccessToken();
         const response = await executeHttpRequest({
             url: result["@odata.nextLink"],
             method: "GET",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microsoft-graph",
-  "version": "2.22.2",
+  "version": "2.23.0",
   "description": "Microsoft GraphAPI SDK for NodeJS",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -419,6 +419,31 @@
       "require": "./dist/cjs/models/AccessToken.js",
       "types": "./dist/esm/models/AccessToken.d.ts"
     },
+    "./AccessTokenGenerator": {
+      "import": "./dist/esm/models/AccessTokenGenerator.js",
+      "require": "./dist/cjs/models/AccessTokenGenerator.js",
+      "types": "./dist/esm/models/AccessTokenGenerator.d.ts"
+    },
+    "./dist/cjs/models/AccessTokenGenerator.js": {
+      "import": "./dist/esm/models/AccessTokenGenerator.js",
+      "require": "./dist/cjs/models/AccessTokenGenerator.js",
+      "types": "./dist/esm/models/AccessTokenGenerator.d.ts"
+    },
+    "./dist/cjs/models/AccessTokenGenerator": {
+      "import": "./dist/esm/models/AccessTokenGenerator.js",
+      "require": "./dist/cjs/models/AccessTokenGenerator.js",
+      "types": "./dist/esm/models/AccessTokenGenerator.d.ts"
+    },
+    "./models/AccessTokenGenerator": {
+      "import": "./dist/esm/models/AccessTokenGenerator.js",
+      "require": "./dist/cjs/models/AccessTokenGenerator.js",
+      "types": "./dist/esm/models/AccessTokenGenerator.d.ts"
+    },
+    "./models/AccessTokenGenerator.js": {
+      "import": "./dist/esm/models/AccessTokenGenerator.js",
+      "require": "./dist/cjs/models/AccessTokenGenerator.js",
+      "types": "./dist/esm/models/AccessTokenGenerator.d.ts"
+    },
     "./Address": {
       "import": "./dist/esm/models/Address.js",
       "require": "./dist/cjs/models/Address.js",
@@ -669,31 +694,6 @@
       "require": "./dist/cjs/models/Context.js",
       "types": "./dist/esm/models/Context.d.ts"
     },
-    "./ContextId": {
-      "import": "./dist/esm/models/ContextId.js",
-      "require": "./dist/cjs/models/ContextId.js",
-      "types": "./dist/esm/models/ContextId.d.ts"
-    },
-    "./dist/cjs/models/ContextId.js": {
-      "import": "./dist/esm/models/ContextId.js",
-      "require": "./dist/cjs/models/ContextId.js",
-      "types": "./dist/esm/models/ContextId.d.ts"
-    },
-    "./dist/cjs/models/ContextId": {
-      "import": "./dist/esm/models/ContextId.js",
-      "require": "./dist/cjs/models/ContextId.js",
-      "types": "./dist/esm/models/ContextId.d.ts"
-    },
-    "./models/ContextId": {
-      "import": "./dist/esm/models/ContextId.js",
-      "require": "./dist/cjs/models/ContextId.js",
-      "types": "./dist/esm/models/ContextId.d.ts"
-    },
-    "./models/ContextId.js": {
-      "import": "./dist/esm/models/ContextId.js",
-      "require": "./dist/cjs/models/ContextId.js",
-      "types": "./dist/esm/models/ContextId.d.ts"
-    },
     "./ContextRef": {
       "import": "./dist/esm/models/ContextRef.js",
       "require": "./dist/cjs/models/ContextRef.js",

package/dist/cjs/models/ContextId.d.ts

@@ -1,4 +0,0 @@
-export type ContextId = string & {
-    __brand: "ContextId";
-};
-//# sourceMappingURL=ContextId.d.ts.map

package/dist/cjs/models/ContextId.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContextId.d.ts","sourceRoot":"","sources":["../../../src/models/ContextId.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}

package/dist/esm/models/ContextId.d.ts

@@ -1,4 +0,0 @@
-export type ContextId = string & {
-    __brand: "ContextId";
-};
-//# sourceMappingURL=ContextId.d.ts.map

package/dist/esm/models/ContextId.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContextId.d.ts","sourceRoot":"","sources":["../../../src/models/ContextId.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}