microsoft-graph 2.22.2 → 2.23.0

package/dist/esm/operations/workbookRange/getWorkbookRangeFormat.js

@@ -11,7 +11,7 @@ import { generatePath } from "../../services/templatedPaths.js";
 export default function getWorkbookRangeFormat(rangeRef) {
     const address = normalizeAddress(rangeRef.address, true);
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "GET",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')/format`, rangeRef),
         headers: {

package/dist/esm/operations/workbookRange/getWorkbookUsedRange.js

@@ -7,7 +7,7 @@ import { createWorkbookRangeRef } from "../../services/workbookRange.js";
  */
 export default function getWorkbookUsedRange(worksheetRef) {
     return operation({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange", worksheetRef),
         headers: {

package/dist/esm/operations/workbookRange/getWorkbookVisibleRange.js

@@ -12,7 +12,7 @@ export default function getWorkbookVisibleRange(rangeRef) {
     const address = normalizeAddress(rangeRef.address, true);
     // TODO: Should be a visible ref type?
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "GET",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')/visibleView`, rangeRef),
         headers: {

package/dist/esm/operations/workbookRange/getWorkbookWorksheetRange.js

@@ -11,7 +11,7 @@ import { generatePath } from "../../services/templatedPaths.js";
 export default function getWorkbookWorksheetRange(rangeRef) {
     const address = normalizeAddress(rangeRef.address, true);
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "GET",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')`, rangeRef),
         headers: {

package/dist/esm/operations/workbookRange/insertWorkbookCells.js

@@ -14,7 +14,7 @@ import { createWorkbookRangeRef } from "../../services/workbookRange.js";
  */
 export default function insertWorkbookCells(worksheetRef, address, shift) {
     return operation({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "POST",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${normalizeAddress(address)}')/insert`, worksheetRef),
         headers: {

package/dist/esm/operations/workbookRange/mergeWorkbookRange.js

@@ -11,7 +11,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function mergeWorkbookRange(rangeRef, across = false) {
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "POST",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${normalizeAddress(rangeRef.address)}')/merge`, rangeRef),
         headers: {

package/dist/esm/operations/workbookRange/setWorkbookRangeFill.js

@@ -11,7 +11,7 @@ import { generatePath } from "../../services/templatedPaths.js";
 export default function setWorkbookRangeFill(rangeRef, format) {
     const address = normalizeAddress(rangeRef.address, true);
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "PATCH",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')/format/fill`, rangeRef),
         headers: {

package/dist/esm/operations/workbookRange/setWorkbookRangeFont.js

@@ -11,7 +11,7 @@ import { generatePath } from "../../services/templatedPaths.js";
 export default function setWorkbookRangeFont(rangeRef, format) {
     const address = normalizeAddress(rangeRef.address, true);
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "PATCH",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')/format/font`, rangeRef),
         headers: {

package/dist/esm/operations/workbookRange/setWorkbookRangeFormat.js

@@ -13,7 +13,7 @@ import { generatePath } from "../../services/templatedPaths.js";
 export default function setWorkbookRangeFormat(rangeRef, format) {
     const address = normalizeAddress(rangeRef.address, true);
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "PATCH",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')/format`, rangeRef),
         headers: {

package/dist/esm/operations/workbookRange/unmergeWorkbookRange.js

@@ -10,7 +10,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function unmergeWorkbookRange(rangeRef) {
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "POST",
         path: generatePath(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${normalizeAddress(rangeRef.address)}')/unmerge`, rangeRef),
         headers: {

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

@@ -10,7 +10,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function updateWorkbookNamedRange(rangeRef, value) {
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "PATCH",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/names/{range-name}/range", rangeRef),
         headers: {

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

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

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

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

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

@@ -11,7 +11,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function createWorkbookSession(itemRef, persistChanges = true) {
     return operation({
-        contextId: itemRef.contextId,
+        context: itemRef.context,
         method: "POST",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/createSession", itemRef),
         headers: {

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

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

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

@@ -10,7 +10,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function applyWorkbookTableColumnFilter(columnRef, criteria) {
     return operation({
-        contextId: columnRef.contextId,
+        context: columnRef.context,
         method: "POST",
         path: 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/esm/operations/workbookTable/clearWorkbookTableFilters.js

@@ -8,7 +8,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function clearWorkbookTableColumnFilters(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "POST",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/clearFilters", tableRef),
         headers: {

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

@@ -11,7 +11,7 @@ import { createWorkbookTableRef } from "../../services/workbookTable.js";
  */
 export default function createWorkbookTable(rangeRef, hasHeaders) {
     return operation({
-        contextId: rangeRef.contextId,
+        context: rangeRef.context,
         method: "POST",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/add", rangeRef),
         headers: {

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

@@ -10,7 +10,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function deleteWorkbookTable(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "DELETE",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}", tableRef),
         headers: {

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

@@ -8,7 +8,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function deleteWorkbookTablePreservingValues(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "POST",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/convertToRange", tableRef),
         headers: {

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

@@ -9,7 +9,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function getWorkbookTable(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}", tableRef),
         headers: {

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

@@ -11,7 +11,7 @@ import { createWorkbookRangeRef } from "../../services/workbookRange.js";
  */
 export default function getWorkbookTableBodyRange(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/dataBodyRange", tableRef),
         headers: {

package/dist/esm/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/esm/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/esm/operations/workbookTable/getWorkbookTableBodyVisibleRange.js

@@ -1,6 +1,5 @@
 import { operation } from "../../graphApi.js";
 import { generatePath } from "../../services/templatedPaths.js";
-import { createWorkbookRangeRef } from "../../services/workbookRange.js";
 /**
  * Retrieve the visible data body range of a table.
  *
@@ -10,7 +9,7 @@ import { createWorkbookRangeRef } from "../../services/workbookRange.js";
  */
 export default function getWorkbookTableBodyVisibleRange(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/dataBodyRange/visibleView", tableRef),
         headers: {
@@ -19,11 +18,9 @@ export default function getWorkbookTableBodyVisibleRange(tableRef) {
         body: null,
         responseTransform: (response) => {
             const range = response;
-            const rangeRef = 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/esm/operations/workbookTable/getWorkbookTableHeaderRange.js

@@ -11,7 +11,7 @@ import { createWorkbookRangeRef } from "../../services/workbookRange.js";
  */
 export default function getWorkbookTableHeaderRange(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables/{table-id}/headerRowRange", tableRef),
         headers: {

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

@@ -9,7 +9,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function listWorkbookTableColumns(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/columns", tableRef),
         headers: {

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

@@ -9,7 +9,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function listWorkbookTableRows(tableRef) {
     return operation({
-        contextId: tableRef.contextId,
+        context: tableRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/rows", tableRef),
         headers: {

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

@@ -10,7 +10,7 @@ import { createWorkbookTableRef } from "../../services/workbookTable.js";
  */
 export default function listWorkbookTables(worksheetRef) {
     return operation({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/tables", worksheetRef),
         headers: {

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

@@ -11,7 +11,7 @@ import { createWorkbookWorksheetRef } from "../../services/workbookWorksheet.js"
  */
 export default function createWorkbookWorksheet(workbookRef, name) {
     return operation({
-        contextId: workbookRef.contextId,
+        context: workbookRef.context,
         method: "POST",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/add", workbookRef),
         headers: {

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

@@ -9,7 +9,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function deleteWorkbookWorksheet(worksheetRef) {
     return operation({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "DELETE",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}", worksheetRef),
         headers: {

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

@@ -11,7 +11,7 @@ import { createWorkbookRangeRef } from "../../services/workbookRange.js";
  */
 export default function getWorkbookWorksheetUsedRange(worksheetRef) {
     return operation({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange", worksheetRef),
         headers: {

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

@@ -11,7 +11,7 @@ import { createWorkbookRangeRef } from "../../services/workbookRange.js";
  */
 export default function getWorkbookWorksheetUsedRangeRef(worksheetRef) {
     return operation({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange?$select=address", worksheetRef),
         headers: {

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

@@ -10,7 +10,7 @@ import { createWorkbookRangeRef } from "../../services/workbookRange.js";
  */
 export default function getWorkbookWorksheetUsedVisibleRange(worksheetRef) {
     return operation({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange/visibleView", worksheetRef),
         headers: {

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

@@ -11,7 +11,7 @@ import { createWorkbookWorksheetRef } from "../../services/workbookWorksheet.js"
  */
 export default function listWorkbookWorksheets(workbookRef) {
     return operation({
-        contextId: workbookRef.contextId,
+        context: workbookRef.context,
         method: "GET",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets", workbookRef),
         headers: {

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

@@ -13,7 +13,7 @@ import { generatePath } from "../../services/templatedPaths.js";
  */
 export default function updateWorkbookWorksheet(worksheetRef, updates) {
     return operation({
-        contextId: worksheetRef.contextId,
+        context: worksheetRef.context,
         method: "PATCH",
         path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}", worksheetRef),
         headers: {

package/dist/esm/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/esm/services/addressManipulation.js

@@ -316,7 +316,7 @@ export 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.
@@ -370,7 +370,7 @@ export function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INF
     }
 }
 /**
- * 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.
@@ -379,7 +379,7 @@ export function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INF
  * @returns Extracted sub-range reference.
  * @throws InvalidArgumentError if the requested rows or columns exceed the available range.
  */
-export function subrange(rangeRef, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+export 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/esm/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/esm/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/esm/services/context.js

@@ -1,55 +1,48 @@
-import ContextNotRegisteredError from "../errors/ContextNotRegisteredError.js";
+import { getCurrentAccessToken } from "./accessToken.js";
 import { getEnvironmentVariable } from "./environmentVariable.js";
-import { generateRandomString } from "./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.
- */
-export 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. */
+export function createClientSecretContext(tenantId, clientId, clientSecret, scope = defaultScope) {
+    const generateAccessToken = async () => {
+        return await 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.
  */
-export function getContext(contextId) {
-    const context = contexts[contextId];
-    if (!context) {
-        throw new ContextNotRegisteredError(`Context with ID ${contextId} is not registered`);
-    }
-    return context;
-}
-function generateContextId() {
-    return generateRandomString(16);
+export 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. */
+export 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.
- */
-export function getDefaultContextRef() {
+/** Create a context using the client secret credential using environment variables AZURE_TENANT_ID, AZURE_CLIENT_ID and AZURE_CLIENT_SECRET. */
+export function createDefaultClientSecretContext() {
     const tenantId = getEnvironmentVariable("AZURE_TENANT_ID");
     const clientId = getEnvironmentVariable("AZURE_CLIENT_ID");
     const clientSecret = getEnvironmentVariable("AZURE_CLIENT_SECRET");
-    const contextRef = register(tenantId, clientId, clientSecret);
-    return contextRef;
+    return createClientSecretContext(tenantId, clientId, clientSecret);
+}
+/**
+ @obsolete Use `createDefaultClientSecretContext()` instead.
+ */
+export function getDefaultContextRef() {
+    return createDefaultClientSecretContext();
+}
+/**
+ * @obsolete Use `createClientSecretContext()` instead.
+ */
+export function register(tenantId, clientId, clientSecret) {
+    return createClientSecretContext(tenantId, clientId, clientSecret);
 }