microsoft-graph 2.22.2 → 2.23.0

package/dist/cjs/operations/workbookRange/updateWorkbookNamedRange.js

@@ -13,7 +13,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function updateWorkbookNamedRange(rangeRef, value) {
     return (0, graphApi_ts_1.operation)({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "PATCH",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/names/{range-name}/range", rangeRef),
         headers: {

package/dist/cjs/operations/workbookRange/updateWorkbookRange.js

@@ -15,7 +15,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
 function updateWorkbookRange(rangeRef, update) {
     const address = (0, addressManipulation_ts_1.normalizeAddress)(rangeRef.address, true);
     return (0, graphApi_ts_1.operation)({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "PATCH",
         path: (0, templatedPaths_ts_1.generatePath)(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')`, rangeRef),
         headers: {

package/dist/cjs/operations/workbookSession/closeWorkbookSession.js

@@ -20,7 +20,7 @@ function closeWorkbookSession(workbookRef) {
         throw new InvalidArgumentError_ts_1.default("Workbook session ID is required to close a session.");
     }
     return (0, graphApi_ts_1.operation)({
-        contextId: workbookRef.contextId,
+        context: workbookRef.context,
         method: "POST",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/closeSession", workbookRef),
         headers: {

package/dist/cjs/operations/workbookSession/createWorkbookSession.js

@@ -14,7 +14,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function createWorkbookSession(itemRef, persistChanges = true) {
     return (0, graphApi_ts_1.operation)({
-        contextId: itemRef.contextId,
+        context: itemRef.context,
         method: "POST",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/createSession", itemRef),
         headers: {

package/dist/cjs/operations/workbookSession/refreshWorkbookSession.js

@@ -20,7 +20,7 @@ function refreshWorkbookSession(workbookRef) {
         throw new InvalidArgumentError_ts_1.default("Workbook session ID is required to refresh a session.");
     }
     return (0, graphApi_ts_1.operation)({
-        contextId: workbookRef.contextId,
+        context: workbookRef.context,
         method: "POST",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/refreshSession", workbookRef),
         headers: {

package/dist/cjs/operations/workbookTable/applyWorkbookTableColumnFilter.js

@@ -13,7 +13,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function applyWorkbookTableColumnFilter(columnRef, criteria) {
     return (0, graphApi_ts_1.operation)({
-        contextId: columnRef.contextId,
+        context: columnRef.context,
         method: "POST",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/columns/{column}/filter/apply", columnRef),
         headers: {

package/dist/cjs/operations/workbookTable/clearWorkbookTableFilters.js

@@ -11,7 +11,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function clearWorkbookTableColumnFilters(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "POST",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/clearFilters", tableRef),
         headers: {

package/dist/cjs/operations/workbookTable/createWorkbookTable.js

@@ -14,7 +14,7 @@ const workbookTable_ts_1 = require("../../services/workbookTable.js");
  */
 function createWorkbookTable(rangeRef, hasHeaders) {
     return (0, graphApi_ts_1.operation)({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "POST",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/add", rangeRef),
         headers: {

package/dist/cjs/operations/workbookTable/deleteWorkbookTable.js

@@ -13,7 +13,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function deleteWorkbookTable(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "DELETE",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}", tableRef),
         headers: {

package/dist/cjs/operations/workbookTable/deleteWorkbookTablePreservingValues.js

@@ -11,7 +11,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function deleteWorkbookTablePreservingValues(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "POST",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/convertToRange", tableRef),
         headers: {

package/dist/cjs/operations/workbookTable/getWorkbookTable.js

@@ -12,7 +12,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function getWorkbookTable(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}", tableRef),
         headers: {

package/dist/cjs/operations/workbookTable/getWorkbookTableBodyRange.js

@@ -17,7 +17,7 @@ const workbookRange_ts_1 = require("../../services/workbookRange.js");
  */
 function getWorkbookTableBodyRange(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/dataBodyRange", tableRef),
         headers: {

package/dist/cjs/operations/workbookTable/getWorkbookTableBodyVisibleRange.d.ts

@@ -1,6 +1,5 @@
 import type { WorkbookRange } from "@microsoft/microsoft-graph-types";
 import type { GraphOperation } from "../../models/GraphOperation.ts";
-import type { WorkbookRangeRef } from "../../models/WorkbookRangeRef.ts";
 import type { WorkbookTableRef } from "../../models/WorkbookTableRef.ts";
 /**
  * Retrieve the visible data body range of a table.
@@ -9,5 +8,5 @@ import type { WorkbookTableRef } from "../../models/WorkbookTableRef.ts";
  * @returns The data body range of the specified table, including its metadata and reference information.
  * @see https://learn.microsoft.com/en-us/graph/api/table-databodyrange
  */
-export default function getWorkbookTableBodyVisibleRange(tableRef: WorkbookTableRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+export default function getWorkbookTableBodyVisibleRange(tableRef: WorkbookTableRef): GraphOperation<WorkbookRange>;
 //# sourceMappingURL=getWorkbookTableBodyVisibleRange.d.ts.map

package/dist/cjs/operations/workbookTable/getWorkbookTableBodyVisibleRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookTableBodyVisibleRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookTable/getWorkbookTableBodyVisibleRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAmBrI"}
+{"version":3,"file":"getWorkbookTableBodyVisibleRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookTable/getWorkbookTableBodyVisibleRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,gCAAgC,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,CAAC,CAiBlH"}

package/dist/cjs/operations/workbookTable/getWorkbookTableBodyVisibleRange.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = getWorkbookTableBodyVisibleRange;
 const graphApi_ts_1 = require("../../graphApi.js");
 const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
-const workbookRange_ts_1 = require("../../services/workbookRange.js");
 /**
  * Retrieve the visible data body range of a table.
  *
@@ -13,7 +12,7 @@ const workbookRange_ts_1 = require("../../services/workbookRange.js");
  */
 function getWorkbookTableBodyVisibleRange(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/dataBodyRange/visibleView", tableRef),
         headers: {
@@ -22,11 +21,9 @@ function getWorkbookTableBodyVisibleRange(tableRef) {
         body: null,
         responseTransform: (response) => {
             const range = response;
-            const rangeRef = (0, workbookRange_ts_1.createWorkbookRangeRef)(tableRef, range.address);
-            return {
-                ...range,
-                ...rangeRef,
-            };
+            // This API does not appear to return the range address. It is undefined.
+            // const rangeRef = createWorkbookRangeRef(tableRef, range.address as CellRangeAddress);
+            return range;
         },
     });
 }

package/dist/cjs/operations/workbookTable/getWorkbookTableHeaderRange.js

@@ -17,7 +17,7 @@ const workbookRange_ts_1 = require("../../services/workbookRange.js");
  */
 function getWorkbookTableHeaderRange(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/headerRowRange", tableRef),
         headers: {

package/dist/cjs/operations/workbookTable/listWorkbookTableColumns.js

@@ -12,7 +12,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function listWorkbookTableColumns(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/columns", tableRef),
         headers: {

package/dist/cjs/operations/workbookTable/listWorkbookTableRows.js

@@ -12,7 +12,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function listWorkbookTableRows(tableRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/rows", tableRef),
         headers: {

package/dist/cjs/operations/workbookTable/listWorkbookTables.js

@@ -13,7 +13,7 @@ const workbookTable_ts_1 = require("../../services/workbookTable.js");
  */
 function listWorkbookTables(worksheetRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables", worksheetRef),
         headers: {

package/dist/cjs/operations/workbookWorksheet/createWorkbookWorksheet.js

@@ -14,7 +14,7 @@ const workbookWorksheet_ts_1 = require("../../services/workbookWorksheet.js");
  */
 function createWorkbookWorksheet(workbookRef, name) {
     return (0, graphApi_ts_1.operation)({
-        contextId: workbookRef.contextId,
+        context: workbookRef.context,
         method: "POST",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/add", workbookRef),
         headers: {

package/dist/cjs/operations/workbookWorksheet/deleteWorkbookWorksheet.js

@@ -12,7 +12,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function deleteWorkbookWorksheet(worksheetRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "DELETE",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}", worksheetRef),
         headers: {

package/dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRange.js

@@ -17,7 +17,7 @@ const workbookRange_ts_1 = require("../../services/workbookRange.js");
  */
 function getWorkbookWorksheetUsedRange(worksheetRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange", worksheetRef),
         headers: {

package/dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeRef.js

@@ -17,7 +17,7 @@ const workbookRange_ts_1 = require("../../services/workbookRange.js");
  */
 function getWorkbookWorksheetUsedRangeRef(worksheetRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange?$select=address", worksheetRef),
         headers: {

package/dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedVisibleRange.js

@@ -13,7 +13,7 @@ const workbookRange_ts_1 = require("../../services/workbookRange.js");
  */
 function getWorkbookWorksheetUsedVisibleRange(worksheetRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange/visibleView", worksheetRef),
         headers: {

package/dist/cjs/operations/workbookWorksheet/listWorkbookWorksheets.js

@@ -17,7 +17,7 @@ const workbookWorksheet_ts_1 = require("../../services/workbookWorksheet.js");
  */
 function listWorkbookWorksheets(workbookRef) {
     return (0, graphApi_ts_1.operation)({
-        contextId: workbookRef.contextId,
+        context: workbookRef.context,
         method: "GET",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets", workbookRef),
         headers: {

package/dist/cjs/operations/workbookWorksheet/updateWorkbookWorksheet.js

@@ -16,7 +16,7 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
  */
 function updateWorkbookWorksheet(worksheetRef, updates) {
     return (0, graphApi_ts_1.operation)({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "PATCH",
         path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}", worksheetRef),
         headers: {

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

@@ -150,7 +150,7 @@ export declare function countAddressColumns(address: Address): number;
  */
 export declare function cellToRangeAddress(cell: CellAddress, rows: number, cols: number): Address;
 /**
- * Extracts a subrange from a spreadsheet-style A1 range (e.g., "A1:D10"),
+ * Extracts a sub-address from a spreadsheet-style A1 range (e.g., "A1:D10"),
  * allowing skip and take semantics on both rows and columns.
  *
  * Supports negative values for `skipRows` and `skipCols` to count from the end.
@@ -171,7 +171,7 @@ export declare function cellToRangeAddress(cell: CellAddress, rows: number, cols
  */
 export declare function subAddress(address: Address, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): Address;
 /**
- * Extracts a subrange from a WorkbookRangeRef using skip/take semantics.
+ * Extracts a sub-range from a WorkbookRangeRef using skip/take semantics.
  * @param rangeRef Range reference to extract the sub-range from.
  * @param skipRows Number of rows to skip. If negative, skips from the end. Default 0.
  * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default Infinity.
@@ -180,5 +180,5 @@ export declare function subAddress(address: Address, skipRows?: number, takeRows
  * @returns Extracted sub-range reference.
  * @throws InvalidArgumentError if the requested rows or columns exceed the available range.
  */
-export declare function subrange(rangeRef: WorkbookRangeRef, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): WorkbookRangeRef;
+export declare function subRange(rangeRef: WorkbookRangeRef, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): WorkbookRangeRef;
 //# sourceMappingURL=addressManipulation.d.ts.map

package/dist/cjs/services/addressManipulation.js

@@ -24,7 +24,7 @@ exports.countAddressRows = countAddressRows;
 exports.countAddressColumns = countAddressColumns;
 exports.cellToRangeAddress = cellToRangeAddress;
 exports.subAddress = subAddress;
-exports.subrange = subrange;
+exports.subRange = subRange;
 const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
 const UnsupportedAddressTypeError_ts_1 = __importDefault(require("../errors/UnsupportedAddressTypeError.js"));
 const addressOffset_ts_1 = require("./addressOffset.js");
@@ -343,7 +343,7 @@ function cellToRangeAddress(cell, rows, cols) {
     });
 }
 /**
- * Extracts a subrange from a spreadsheet-style A1 range (e.g., "A1:D10"),
+ * Extracts a sub-address from a spreadsheet-style A1 range (e.g., "A1:D10"),
  * allowing skip and take semantics on both rows and columns.
  *
  * Supports negative values for `skipRows` and `skipCols` to count from the end.
@@ -397,7 +397,7 @@ function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY,
     }
 }
 /**
- * Extracts a subrange from a WorkbookRangeRef using skip/take semantics.
+ * Extracts a sub-range from a WorkbookRangeRef using skip/take semantics.
  * @param rangeRef Range reference to extract the sub-range from.
  * @param skipRows Number of rows to skip. If negative, skips from the end. Default 0.
  * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default Infinity.
@@ -406,7 +406,7 @@ function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY,
  * @returns Extracted sub-range reference.
  * @throws InvalidArgumentError if the requested rows or columns exceed the available range.
  */
-function subrange(rangeRef, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+function subRange(rangeRef, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
     const address = subAddress(rangeRef.address, skipRows, takeRows, skipCols, takeCols);
     return {
         ...rangeRef,

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

@@ -1,28 +1,27 @@
+import type { AccessToken } from "../models/AccessToken.ts";
+import type { AccessTokenGenerator } from "../models/AccessTokenGenerator.ts";
 import type { ClientId } from "../models/ClientId.ts";
 import type { ClientSecret } from "../models/ClientSecret.ts";
-import type { Context } from "../models/Context.ts";
-import type { ContextId } from "../models/ContextId.ts";
 import type { ContextRef } from "../models/ContextRef.ts";
+import type { Scope } from "../models/Scope.ts";
 import type { TenantId } from "../models/TenantId.ts";
+/** Create a context using the client secret credential. */
+export declare function createClientSecretContext(tenantId: TenantId, clientId: ClientId, clientSecret: ClientSecret, scope?: Scope): ContextRef;
 /**
- * Registers a tenant+client so that its secret can be used later.
- * @param tenantId - The tenant ID.
- * @param clientId - The client ID.
- * @param clientSecret - The client secret.
- * @returns A reference to the registered context.
+ * Create a context using a static access token.
+ * @remarks You must manually handle renewal of the access token with this approach.
  */
-export declare function register(tenantId: TenantId, clientId: ClientId, clientSecret: ClientSecret): ContextRef;
+export declare function createAccessTokenContext(accessToken: AccessToken): ContextRef;
+/** Create a context using a given access token generator. */
+export declare function createContext(accessTokenGenerator: AccessTokenGenerator): ContextRef;
+/** Create a context using the client secret credential using environment variables AZURE_TENANT_ID, AZURE_CLIENT_ID and AZURE_CLIENT_SECRET. */
+export declare function createDefaultClientSecretContext(): ContextRef;
 /**
- * Retrieves the context for a given context ID.
- * @param contextId - The ID of the context.
- * @returns The context associated with the given ID.
- * @throws ContextNotRegisteredError if the context ID is not registered.
+ @obsolete Use `createDefaultClientSecretContext()` instead.
  */
-export declare function getContext(contextId: ContextId): Context;
+export declare function getDefaultContextRef(): ContextRef;
 /**
- * Retrieves the opinionated default context reference. NOT RECOMMENDED FOR PRODUCTION USE.
- * @returns A reference to the default context.
- * @remarks This method is opinionated and not recommended for production use.
+ * @obsolete Use `createClientSecretContext()` instead.
  */
-export declare function getDefaultContextRef(): ContextRef;
+export declare function register(tenantId: TenantId, clientId: ClientId, clientSecret: ClientSecret): ContextRef;
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/services/context.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,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,GAAG,UAAU,CAcvG;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAMxD;AAYD;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAQjD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/services/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,GAAE,KAAoB,GAAG,UAAU,CAMrJ;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAK7E;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,oBAAoB,EAAE,oBAAoB,GAAG,UAAU,CAQpF;AAED,gJAAgJ;AAChJ,wBAAgB,gCAAgC,IAAI,UAAU,CAM7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAEjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,GAAG,UAAU,CAEvG"}

package/dist/cjs/services/context.js

@@ -1,63 +1,56 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.register = register;
-exports.getContext = getContext;
+exports.createClientSecretContext = createClientSecretContext;
+exports.createAccessTokenContext = createAccessTokenContext;
+exports.createContext = createContext;
+exports.createDefaultClientSecretContext = createDefaultClientSecretContext;
 exports.getDefaultContextRef = getDefaultContextRef;
-const ContextNotRegisteredError_ts_1 = __importDefault(require("../errors/ContextNotRegisteredError.js"));
+exports.register = register;
+const accessToken_ts_1 = require("./accessToken.js");
 const environmentVariable_ts_1 = require("./environmentVariable.js");
-const random_ts_1 = require("./random.js");
-const contexts = {};
-/**
- * Registers a tenant+client so that its secret can be used later.
- * @param tenantId - The tenant ID.
- * @param clientId - The client ID.
- * @param clientSecret - The client secret.
- * @returns A reference to the registered context.
- */
-function register(tenantId, clientId, clientSecret) {
-    const contextId = generateContextId();
-    const context = {
-        tenantId,
-        clientId,
-        clientSecret,
+const defaultScope = "https://graph.microsoft.com/.default";
+/** Create a context using the client secret credential. */
+function createClientSecretContext(tenantId, clientId, clientSecret, scope = defaultScope) {
+    const generateAccessToken = async () => {
+        return await (0, accessToken_ts_1.getCurrentAccessToken)(tenantId, clientId, clientSecret, scope);
     };
-    contexts[contextId] = context;
-    const contextRef = createContextRef(contextId);
-    return contextRef;
+    return createContext(generateAccessToken);
 }
 /**
- * Retrieves the context for a given context ID.
- * @param contextId - The ID of the context.
- * @returns The context associated with the given ID.
- * @throws ContextNotRegisteredError if the context ID is not registered.
+ * Create a context using a static access token.
+ * @remarks You must manually handle renewal of the access token with this approach.
  */
-function getContext(contextId) {
-    const context = contexts[contextId];
-    if (!context) {
-        throw new ContextNotRegisteredError_ts_1.default(`Context with ID ${contextId} is not registered`);
-    }
-    return context;
-}
-function generateContextId() {
-    return (0, random_ts_1.generateRandomString)(16);
+function createAccessTokenContext(accessToken) {
+    // biome-ignore lint/suspicious/useAwait: Not applicable here, as we are creating a context that returns a static access token.
+    return createContext(async () => {
+        return accessToken;
+    });
 }
-function createContextRef(contextId) {
+/** Create a context using a given access token generator. */
+function createContext(accessTokenGenerator) {
+    const context = {
+        generateAccessToken: accessTokenGenerator,
+    };
     return {
-        contextId,
+        context,
     };
 }
-/**
- * Retrieves the opinionated default context reference. NOT RECOMMENDED FOR PRODUCTION USE.
- * @returns A reference to the default context.
- * @remarks This method is opinionated and not recommended for production use.
- */
-function getDefaultContextRef() {
+/** Create a context using the client secret credential using environment variables AZURE_TENANT_ID, AZURE_CLIENT_ID and AZURE_CLIENT_SECRET. */
+function createDefaultClientSecretContext() {
     const tenantId = (0, environmentVariable_ts_1.getEnvironmentVariable)("AZURE_TENANT_ID");
     const clientId = (0, environmentVariable_ts_1.getEnvironmentVariable)("AZURE_CLIENT_ID");
     const clientSecret = (0, environmentVariable_ts_1.getEnvironmentVariable)("AZURE_CLIENT_SECRET");
-    const contextRef = register(tenantId, clientId, clientSecret);
-    return contextRef;
+    return createClientSecretContext(tenantId, clientId, clientSecret);
+}
+/**
+ @obsolete Use `createDefaultClientSecretContext()` instead.
+ */
+function getDefaultContextRef() {
+    return createDefaultClientSecretContext();
+}
+/**
+ * @obsolete Use `createClientSecretContext()` instead.
+ */
+function register(tenantId, clientId, clientSecret) {
+    return createClientSecretContext(tenantId, clientId, clientSecret);
 }

package/dist/cjs/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/cjs/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/cjs/services/drive.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDriveRef = createDriveRef;
+exports.createClientSecretContextWithDriveRef = createClientSecretContextWithDriveRef;
 exports.getDefaultDriveRef = getDefaultDriveRef;
 const ProtocolError_ts_1 = __importDefault(require("../errors/ProtocolError.js"));
 const context_ts_1 = require("./context.js");
@@ -18,18 +19,26 @@ const site_ts_1 = require("./site.js");
  */
 function createDriveRef(siteRef, driveId) {
     if (!driveId) {
-        throw new ProtocolError_ts_1.default("DriveID is missing");
+        throw new ProtocolError_ts_1.default("DriveId is missing");
     }
     return {
-        contextId: siteRef.contextId,
+        context: siteRef.context,
         siteId: siteRef.siteId,
         driveId,
     };
 }
+/** Creates a context with a reference to a drive. */
+function createClientSecretContextWithDriveRef(tenantId, clientId, clientSecret, siteId, driveId) {
+    const context = (0, context_ts_1.createClientSecretContext)(tenantId, clientId, clientSecret);
+    const siteRef = (0, site_ts_1.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.
  */
 function getDefaultDriveRef() {
     const tenantId = (0, environmentVariable_ts_1.getEnvironmentVariable)("AZURE_TENANT_ID");

package/dist/cjs/services/driveItem.js

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

package/dist/cjs/services/site.js

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

package/dist/cjs/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/cjs/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"}