microsoft-graph 3.3.0 → 3.4.1

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

@@ -155,12 +155,12 @@ export declare function cellToRangeAddress(cell: CellAddress, rows: number, cols
  * Supports negative values for `skipRows` and `skipCols` to count from the end.
  * Supports negative values for `takeRows` and `takeCols` to exclude from the end after skipping.
  *
- * @param address - The original range in A1 notation (e.g., "A1:D10").
- * @param skipRows - Number of rows to skip. If negative, skips that many rows from the end. Default is 0.
- * @param takeRows - Number of rows to take after skipping. If negative, excludes that many rows from the end of the remaining rows. Default is Infinity.
- * @param skipCols - Number of columns to skip. If negative, skips that many columns from the end. Default is 0.
- * @param takeCols - Number of columns to take after skipping. If negative, excludes that many columns from the end of the remaining columns. Default is Infinity.
- * @returns A new A1-style range representing the sliced subrange (e.g., "B2:C5").
+ * @param address Original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows Number of rows to skip. If negative, skips from the end. Default is 0.
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end of the remaining rows. Default is Infinity.
+ * @param skipCols Number of columns to skip. If negative, skips from the end. Default is 0.
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end of the remaining columns. Default is Infinity.
+ * @returns New A1-style range representing the sliced sub-range (e.g., "B2:C5").
  *
  * @example
  * subaddress("A1:D10", -1, 1); // Last row: "A10:D10"
@@ -168,22 +168,22 @@ export declare function cellToRangeAddress(cell: CellAddress, rows: number, cols
  * subaddress("A1:D10", 0, -1); // All but last row: "A1:D9"
  * subaddress("A1:D10", 0, Infinity, -2, 1); // Second last column: "C1:C10"
  */
-export declare function subAddress(address: Address, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): Address;
+export declare function subAddress(address: Address, skipRows?: number, takeRows?: number | undefined, skipCols?: number, takeCols?: number | undefined): Address;
 /**
  * Returns a super-address that extends the given address by skipping/taking rows/columns, possibly outside the original bounds.
  * Negative skip moves the start above/left of the original range (not from the end).
  *
- * @param address - The original range in A1 notation (e.g., "A1:D10").
- * @param skipRows - Number of rows to skip (can be negative to extend above).
- * @param takeRows - Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity.
- * @param skipCols - Number of columns to skip (can be negative to extend left).
- * @param takeCols - Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity.
- * @returns A new A1-style range representing the superrange (may extend outside original bounds).
+ * @param address Original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows Number of rows to skip (can be negative to extend above).
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity.
+ * @param skipCols Number of columns to skip (can be negative to extend left).
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity.
+ * @returns New A1-style range representing the super range (may extend outside original bounds).
  *
  * @example
  * superAddress("B2:C3", -1, 4, -1, 4) // "A1:D5"
  */
-export declare function superAddress(address: Address, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): Address;
+export declare function superAddress(address: Address, skipRows?: number, takeRows?: number | undefined, skipCols?: number, takeCols?: number | undefined): Address;
 /**
  * Extracts a sub-range from a WorkbookRangeRef using skip/take semantics.
  * @param rangeRef Range reference to extract the sub-range from.
@@ -194,7 +194,7 @@ export declare function superAddress(address: Address, skipRows?: number, takeRo
  * @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 | undefined, skipCols?: number, takeCols?: number | undefined): WorkbookRangeRef;
 /**
  * Returns a super-range from a WorkbookRangeRef using skip/take semantics, possibly extending outside the original bounds.
  * Negative skip moves the start above/left of the original range (not from the end).
@@ -206,5 +206,5 @@ export declare function subRange(rangeRef: WorkbookRangeRef, skipRows?: number,
  * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default Infinity.
  * @returns Extended super-range reference.
  */
-export declare function superRange(rangeRef: WorkbookRangeRef, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): WorkbookRangeRef;
+export declare function superRange(rangeRef: WorkbookRangeRef, skipRows?: number, takeRows?: number | undefined, skipCols?: number, takeCols?: number | undefined): WorkbookRangeRef;
 //# sourceMappingURL=addressManipulation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAuD,iBAAiB,EAA+B,MAAM,sBAAsB,CAAC;AAGtK,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAuBnE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,UAAQ,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,UAAQ,GAAG,OAAO,CAsBzF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAuCzF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,GAAG,OAAO,CAsC1J;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,GAAG,OAAO,CA2B5J;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,GAAG,gBAAgB,CAM3K;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,GAAG,gBAAgB,CAM7K"}
+{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"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"}

package/dist/cjs/services/addressManipulation.js

@@ -356,12 +356,12 @@ function cellToRangeAddress(cell, rows, cols) {
  * Supports negative values for `skipRows` and `skipCols` to count from the end.
  * Supports negative values for `takeRows` and `takeCols` to exclude from the end after skipping.
  *
- * @param address - The original range in A1 notation (e.g., "A1:D10").
- * @param skipRows - Number of rows to skip. If negative, skips that many rows from the end. Default is 0.
- * @param takeRows - Number of rows to take after skipping. If negative, excludes that many rows from the end of the remaining rows. Default is Infinity.
- * @param skipCols - Number of columns to skip. If negative, skips that many columns from the end. Default is 0.
- * @param takeCols - Number of columns to take after skipping. If negative, excludes that many columns from the end of the remaining columns. Default is Infinity.
- * @returns A new A1-style range representing the sliced subrange (e.g., "B2:C5").
+ * @param address Original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows Number of rows to skip. If negative, skips from the end. Default is 0.
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end of the remaining rows. Default is Infinity.
+ * @param skipCols Number of columns to skip. If negative, skips from the end. Default is 0.
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end of the remaining columns. Default is Infinity.
+ * @returns New A1-style range representing the sliced sub-range (e.g., "B2:C5").
  *
  * @example
  * subaddress("A1:D10", -1, 1); // Last row: "A10:D10"
@@ -369,11 +369,17 @@ function cellToRangeAddress(cell, rows, cols) {
  * subaddress("A1:D10", 0, -1); // All but last row: "A1:D9"
  * subaddress("A1:D10", 0, Infinity, -2, 1); // Second last column: "C1:C10"
  */
-function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+function subAddress(address, skipRows = 0, takeRows = undefined, skipCols = 0, takeCols = undefined) {
+    if (takeRows === undefined || takeRows === null) {
+        takeRows = Number.POSITIVE_INFINITY;
+    }
+    if (takeCols === undefined || takeCols === null) {
+        takeCols = Number.POSITIVE_INFINITY;
+    }
     const { ax, bx, ay, by } = (0, cartesianAddress_ts_1.addressToCartesian)(address);
     const [startRow, endRow] = slice(ay, by, skipRows, takeRows);
     const [startCol, endCol] = slice(ax, bx, skipCols, takeCols);
-    if (startRow < ay || endRow > by || startRow > endRow || startCol < ax || endCol > bx || startCol > endCol) {
+    if (startRow < ay || startRow > endRow || startCol < ax || startCol > endCol) {
         const requestedAddress = (0, cartesianAddress_ts_1.cartesianToAddress)({ ax: startCol, bx: endCol, ay: startRow, by: endRow });
         throw new InvalidArgumentError_ts_1.default(`Requested subaddress ${requestedAddress} is out of bounds of the base address ${address}.`);
     }
@@ -401,6 +407,9 @@ function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY,
         else if (take < 0) {
             e += take;
         }
+        // Clip e to not exceed the original end
+        if (e > end)
+            e = end;
         return [s, e];
     }
 }
@@ -408,17 +417,23 @@ function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY,
  * Returns a super-address that extends the given address by skipping/taking rows/columns, possibly outside the original bounds.
  * Negative skip moves the start above/left of the original range (not from the end).
  *
- * @param address - The original range in A1 notation (e.g., "A1:D10").
- * @param skipRows - Number of rows to skip (can be negative to extend above).
- * @param takeRows - Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity.
- * @param skipCols - Number of columns to skip (can be negative to extend left).
- * @param takeCols - Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity.
- * @returns A new A1-style range representing the superrange (may extend outside original bounds).
+ * @param address Original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows Number of rows to skip (can be negative to extend above).
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity.
+ * @param skipCols Number of columns to skip (can be negative to extend left).
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity.
+ * @returns New A1-style range representing the super range (may extend outside original bounds).
  *
  * @example
  * superAddress("B2:C3", -1, 4, -1, 4) // "A1:D5"
  */
-function superAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+function superAddress(address, skipRows = 0, takeRows = undefined, skipCols = 0, takeCols = undefined) {
+    if (takeRows === undefined || takeRows === null) {
+        takeRows = Number.POSITIVE_INFINITY;
+    }
+    if (takeCols === undefined || takeCols === null) {
+        takeCols = Number.POSITIVE_INFINITY;
+    }
     const { ax, bx, ay, by } = (0, cartesianAddress_ts_1.addressToCartesian)(address);
     const [startRow, endRow] = superSlice(ay, by, skipRows, takeRows);
     const [startCol, endCol] = superSlice(ax, bx, skipCols, takeCols);
@@ -453,7 +468,7 @@ function superAddress(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 = undefined, skipCols = 0, takeCols = undefined) {
     const address = subAddress(rangeRef.address, skipRows, takeRows, skipCols, takeCols);
     return {
         ...rangeRef,
@@ -471,7 +486,7 @@ function subRange(rangeRef, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, s
  * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default Infinity.
  * @returns Extended super-range reference.
  */
-function superRange(rangeRef, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+function superRange(rangeRef, skipRows = 0, takeRows = undefined, skipCols = 0, takeCols = undefined) {
     const address = superAddress(rangeRef.address, skipRows, takeRows, skipCols, takeCols);
     return {
         ...rangeRef,

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

@@ -3,6 +3,7 @@
  * @module driveItem
  * @category Services
  */
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
 import type { DriveRef } from "../models/Drive.ts";
 import type { DriveItemId, DriveItemPath, DriveItemRef } from "../models/DriveItem.ts";
 export declare const workbookFileExtension = "xlsx";
@@ -32,4 +33,10 @@ export declare function splitDriveItemPath(filePath: DriveItemPath): {
     folderPath: DriveItemPath;
     fileName: string;
 };
+/**
+ * Gets the file extension of a drive item.
+ * @param item Drive item.
+ * @returns File extension ie. "txt", "jpg"
+ */
+export declare function getDriveItemExtension(item: DriveItem): string;
 //# sourceMappingURL=driveItem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvF,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,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;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa3G"}
+{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvF,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,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;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa3G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAG7D"}

package/dist/cjs/services/driveItem.js

@@ -12,6 +12,8 @@ exports.rootDriveItemPath = exports.binaryWorkbookFileExtension = exports.workbo
 exports.driveItemPath = driveItemPath;
 exports.createDriveItemRef = createDriveItemRef;
 exports.splitDriveItemPath = splitDriveItemPath;
+exports.getDriveItemExtension = getDriveItemExtension;
+const node_path_1 = __importDefault(require("node:path"));
 const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
 const ProtocolError_ts_1 = __importDefault(require("../errors/ProtocolError.js"));
 const segmentPattern = /^[^"*:<>?\\|#]{1,256}$/;
@@ -87,3 +89,12 @@ function splitDriveItemPath(filePath) {
         fileName,
     };
 }
+/**
+ * Gets the file extension of a drive item.
+ * @param item Drive item.
+ * @returns File extension ie. "txt", "jpg"
+ */
+function getDriveItemExtension(item) {
+    const ext = node_path_1.default.extname(item.name ?? "").toLowerCase();
+    return ext.startsWith(".") ? ext.slice(1) : ext;
+}

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

@@ -155,12 +155,12 @@ export declare function cellToRangeAddress(cell: CellAddress, rows: number, cols
  * Supports negative values for `skipRows` and `skipCols` to count from the end.
  * Supports negative values for `takeRows` and `takeCols` to exclude from the end after skipping.
  *
- * @param address - The original range in A1 notation (e.g., "A1:D10").
- * @param skipRows - Number of rows to skip. If negative, skips that many rows from the end. Default is 0.
- * @param takeRows - Number of rows to take after skipping. If negative, excludes that many rows from the end of the remaining rows. Default is Infinity.
- * @param skipCols - Number of columns to skip. If negative, skips that many columns from the end. Default is 0.
- * @param takeCols - Number of columns to take after skipping. If negative, excludes that many columns from the end of the remaining columns. Default is Infinity.
- * @returns A new A1-style range representing the sliced subrange (e.g., "B2:C5").
+ * @param address Original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows Number of rows to skip. If negative, skips from the end. Default is 0.
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end of the remaining rows. Default is Infinity.
+ * @param skipCols Number of columns to skip. If negative, skips from the end. Default is 0.
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end of the remaining columns. Default is Infinity.
+ * @returns New A1-style range representing the sliced sub-range (e.g., "B2:C5").
  *
  * @example
  * subaddress("A1:D10", -1, 1); // Last row: "A10:D10"
@@ -168,22 +168,22 @@ export declare function cellToRangeAddress(cell: CellAddress, rows: number, cols
  * subaddress("A1:D10", 0, -1); // All but last row: "A1:D9"
  * subaddress("A1:D10", 0, Infinity, -2, 1); // Second last column: "C1:C10"
  */
-export declare function subAddress(address: Address, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): Address;
+export declare function subAddress(address: Address, skipRows?: number, takeRows?: number | undefined, skipCols?: number, takeCols?: number | undefined): Address;
 /**
  * Returns a super-address that extends the given address by skipping/taking rows/columns, possibly outside the original bounds.
  * Negative skip moves the start above/left of the original range (not from the end).
  *
- * @param address - The original range in A1 notation (e.g., "A1:D10").
- * @param skipRows - Number of rows to skip (can be negative to extend above).
- * @param takeRows - Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity.
- * @param skipCols - Number of columns to skip (can be negative to extend left).
- * @param takeCols - Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity.
- * @returns A new A1-style range representing the superrange (may extend outside original bounds).
+ * @param address Original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows Number of rows to skip (can be negative to extend above).
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity.
+ * @param skipCols Number of columns to skip (can be negative to extend left).
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity.
+ * @returns New A1-style range representing the super range (may extend outside original bounds).
  *
  * @example
  * superAddress("B2:C3", -1, 4, -1, 4) // "A1:D5"
  */
-export declare function superAddress(address: Address, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): Address;
+export declare function superAddress(address: Address, skipRows?: number, takeRows?: number | undefined, skipCols?: number, takeCols?: number | undefined): Address;
 /**
  * Extracts a sub-range from a WorkbookRangeRef using skip/take semantics.
  * @param rangeRef Range reference to extract the sub-range from.
@@ -194,7 +194,7 @@ export declare function superAddress(address: Address, skipRows?: number, takeRo
  * @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 | undefined, skipCols?: number, takeCols?: number | undefined): WorkbookRangeRef;
 /**
  * Returns a super-range from a WorkbookRangeRef using skip/take semantics, possibly extending outside the original bounds.
  * Negative skip moves the start above/left of the original range (not from the end).
@@ -206,5 +206,5 @@ export declare function subRange(rangeRef: WorkbookRangeRef, skipRows?: number,
  * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default Infinity.
  * @returns Extended super-range reference.
  */
-export declare function superRange(rangeRef: WorkbookRangeRef, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): WorkbookRangeRef;
+export declare function superRange(rangeRef: WorkbookRangeRef, skipRows?: number, takeRows?: number | undefined, skipCols?: number, takeCols?: number | undefined): WorkbookRangeRef;
 //# sourceMappingURL=addressManipulation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"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"}

package/dist/esm/services/addressManipulation.js

@@ -327,12 +327,12 @@ export function cellToRangeAddress(cell, rows, cols) {
  * Supports negative values for `skipRows` and `skipCols` to count from the end.
  * Supports negative values for `takeRows` and `takeCols` to exclude from the end after skipping.
  *
- * @param address - The original range in A1 notation (e.g., "A1:D10").
- * @param skipRows - Number of rows to skip. If negative, skips that many rows from the end. Default is 0.
- * @param takeRows - Number of rows to take after skipping. If negative, excludes that many rows from the end of the remaining rows. Default is Infinity.
- * @param skipCols - Number of columns to skip. If negative, skips that many columns from the end. Default is 0.
- * @param takeCols - Number of columns to take after skipping. If negative, excludes that many columns from the end of the remaining columns. Default is Infinity.
- * @returns A new A1-style range representing the sliced subrange (e.g., "B2:C5").
+ * @param address Original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows Number of rows to skip. If negative, skips from the end. Default is 0.
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end of the remaining rows. Default is Infinity.
+ * @param skipCols Number of columns to skip. If negative, skips from the end. Default is 0.
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end of the remaining columns. Default is Infinity.
+ * @returns New A1-style range representing the sliced sub-range (e.g., "B2:C5").
  *
  * @example
  * subaddress("A1:D10", -1, 1); // Last row: "A10:D10"
@@ -340,11 +340,17 @@ export function cellToRangeAddress(cell, rows, cols) {
  * subaddress("A1:D10", 0, -1); // All but last row: "A1:D9"
  * subaddress("A1:D10", 0, Infinity, -2, 1); // Second last column: "C1:C10"
  */
-export function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+export function subAddress(address, skipRows = 0, takeRows = undefined, skipCols = 0, takeCols = undefined) {
+    if (takeRows === undefined || takeRows === null) {
+        takeRows = Number.POSITIVE_INFINITY;
+    }
+    if (takeCols === undefined || takeCols === null) {
+        takeCols = Number.POSITIVE_INFINITY;
+    }
     const { ax, bx, ay, by } = addressToCartesian(address);
     const [startRow, endRow] = slice(ay, by, skipRows, takeRows);
     const [startCol, endCol] = slice(ax, bx, skipCols, takeCols);
-    if (startRow < ay || endRow > by || startRow > endRow || startCol < ax || endCol > bx || startCol > endCol) {
+    if (startRow < ay || startRow > endRow || startCol < ax || startCol > endCol) {
         const requestedAddress = cartesianToAddress({ ax: startCol, bx: endCol, ay: startRow, by: endRow });
         throw new InvalidArgumentError(`Requested subaddress ${requestedAddress} is out of bounds of the base address ${address}.`);
     }
@@ -372,6 +378,9 @@ export function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INF
         else if (take < 0) {
             e += take;
         }
+        // Clip e to not exceed the original end
+        if (e > end)
+            e = end;
         return [s, e];
     }
 }
@@ -379,17 +388,23 @@ export function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INF
  * Returns a super-address that extends the given address by skipping/taking rows/columns, possibly outside the original bounds.
  * Negative skip moves the start above/left of the original range (not from the end).
  *
- * @param address - The original range in A1 notation (e.g., "A1:D10").
- * @param skipRows - Number of rows to skip (can be negative to extend above).
- * @param takeRows - Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity.
- * @param skipCols - Number of columns to skip (can be negative to extend left).
- * @param takeCols - Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity.
- * @returns A new A1-style range representing the superrange (may extend outside original bounds).
+ * @param address Original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows Number of rows to skip (can be negative to extend above).
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity.
+ * @param skipCols Number of columns to skip (can be negative to extend left).
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity.
+ * @returns New A1-style range representing the super range (may extend outside original bounds).
  *
  * @example
  * superAddress("B2:C3", -1, 4, -1, 4) // "A1:D5"
  */
-export function superAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+export function superAddress(address, skipRows = 0, takeRows = undefined, skipCols = 0, takeCols = undefined) {
+    if (takeRows === undefined || takeRows === null) {
+        takeRows = Number.POSITIVE_INFINITY;
+    }
+    if (takeCols === undefined || takeCols === null) {
+        takeCols = Number.POSITIVE_INFINITY;
+    }
     const { ax, bx, ay, by } = addressToCartesian(address);
     const [startRow, endRow] = superSlice(ay, by, skipRows, takeRows);
     const [startCol, endCol] = superSlice(ax, bx, skipCols, takeCols);
@@ -424,7 +439,7 @@ export function superAddress(address, skipRows = 0, takeRows = Number.POSITIVE_I
  * @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 = undefined, skipCols = 0, takeCols = undefined) {
     const address = subAddress(rangeRef.address, skipRows, takeRows, skipCols, takeCols);
     return {
         ...rangeRef,
@@ -442,7 +457,7 @@ export function subRange(rangeRef, skipRows = 0, takeRows = Number.POSITIVE_INFI
  * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default Infinity.
  * @returns Extended super-range reference.
  */
-export function superRange(rangeRef, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+export function superRange(rangeRef, skipRows = 0, takeRows = undefined, skipCols = 0, takeCols = undefined) {
     const address = superAddress(rangeRef.address, skipRows, takeRows, skipCols, takeCols);
     return {
         ...rangeRef,

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

@@ -3,6 +3,7 @@
  * @module driveItem
  * @category Services
  */
+import type { DriveItem } from "@microsoft/microsoft-graph-types";
 import type { DriveRef } from "../models/Drive.ts";
 import type { DriveItemId, DriveItemPath, DriveItemRef } from "../models/DriveItem.ts";
 export declare const workbookFileExtension = "xlsx";
@@ -32,4 +33,10 @@ export declare function splitDriveItemPath(filePath: DriveItemPath): {
     folderPath: DriveItemPath;
     fileName: string;
 };
+/**
+ * Gets the file extension of a drive item.
+ * @param item Drive item.
+ * @returns File extension ie. "txt", "jpg"
+ */
+export declare function getDriveItemExtension(item: DriveItem): string;
 //# sourceMappingURL=driveItem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvF,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,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;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa3G"}
+{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../../src/services/driveItem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvF,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,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;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa3G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAG7D"}

package/dist/esm/services/driveItem.js

@@ -3,6 +3,7 @@
  * @module driveItem
  * @category Services
  */
+import path from "node:path";
 import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 import ProtocolError from "../errors/ProtocolError.js";
 const segmentPattern = /^[^"*:<>?\\|#]{1,256}$/;
@@ -78,3 +79,12 @@ export function splitDriveItemPath(filePath) {
         fileName,
     };
 }
+/**
+ * Gets the file extension of a drive item.
+ * @param item Drive item.
+ * @returns File extension ie. "txt", "jpg"
+ */
+export function getDriveItemExtension(item) {
+    const ext = path.extname(item.name ?? "").toLowerCase();
+    return ext.startsWith(".") ? ext.slice(1) : ext;
+}

package/docs/api/addressManipulation.md

@@ -499,17 +499,17 @@ Supports negative values for `takeRows` and `takeCols` to exclude from the end a
 
 | Parameter | Type | Default value | Description |
 | ------ | ------ | ------ | ------ |
-| `address` | [`Address`](Address.md#address) | `undefined` | The original range in A1 notation (e.g., "A1:D10"). |
-| `skipRows` | `number` | `0` | Number of rows to skip. If negative, skips that many rows from the end. Default is 0. |
-| `takeRows` | `number` | `Number.POSITIVE_INFINITY` | Number of rows to take after skipping. If negative, excludes that many rows from the end of the remaining rows. Default is Infinity. |
-| `skipCols` | `number` | `0` | Number of columns to skip. If negative, skips that many columns from the end. Default is 0. |
-| `takeCols` | `number` | `Number.POSITIVE_INFINITY` | Number of columns to take after skipping. If negative, excludes that many columns from the end of the remaining columns. Default is Infinity. |
+| `address` | [`Address`](Address.md#address) | `undefined` | Original range in A1 notation (e.g., "A1:D10"). |
+| `skipRows` | `number` | `0` | Number of rows to skip. If negative, skips from the end. Default is 0. |
+| `takeRows` | `undefined` \| `number` | `undefined` | Number of rows to take after skipping. If negative, excludes from the end of the remaining rows. Default is Infinity. |
+| `skipCols` | `number` | `0` | Number of columns to skip. If negative, skips from the end. Default is 0. |
+| `takeCols` | `undefined` \| `number` | `undefined` | Number of columns to take after skipping. If negative, excludes from the end of the remaining columns. Default is Infinity. |
 
 #### Returns
 
 [`Address`](Address.md#address)
 
-A new A1-style range representing the sliced subrange (e.g., "B2:C5").
+New A1-style range representing the sliced sub-range (e.g., "B2:C5").
 
 #### Example
 
@@ -526,7 +526,7 @@ subaddress("A1:D10", 0, Infinity, -2, 1); // Second last column: "C1:C10"
 
 > **subRange**(`rangeRef`, `skipRows`, `takeRows`, `skipCols`, `takeCols`): [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref)
 
-Defined in: [src/services/addressManipulation.ts:494](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressManipulation.ts#L494)
+Defined in: [src/services/addressManipulation.ts:511](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressManipulation.ts#L511)
 
 Extracts a sub-range from a WorkbookRangeRef using skip/take semantics.
 
@@ -536,9 +536,9 @@ Extracts a sub-range from a WorkbookRangeRef using skip/take semantics.
 | ------ | ------ | ------ | ------ |
 | `rangeRef` | [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref) | `undefined` | Range reference to extract the sub-range from. |
 | `skipRows` | `number` | `0` | Number of rows to skip. If negative, skips from the end. Default 0. |
-| `takeRows` | `number` | `Number.POSITIVE_INFINITY` | Number of rows to take after skipping. If negative, excludes from the end. Default Infinity. |
+| `takeRows` | `undefined` \| `number` | `undefined` | Number of rows to take after skipping. If negative, excludes from the end. Default Infinity. |
 | `skipCols` | `number` | `0` | Number of columns to skip. If negative, skips from the end. Default 0. |
-| `takeCols` | `number` | `Number.POSITIVE_INFINITY` | Number of columns to take after skipping. If negative, excludes from the end. Default Infinity. |
+| `takeCols` | `undefined` \| `number` | `undefined` | Number of columns to take after skipping. If negative, excludes from the end. Default Infinity. |
 
 #### Returns
 
@@ -556,7 +556,7 @@ InvalidArgumentError if the requested rows or columns exceed the available range
 
 > **superAddress**(`address`, `skipRows`, `takeRows`, `skipCols`, `takeCols`): [`Address`](Address.md#address)
 
-Defined in: [src/services/addressManipulation.ts:455](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressManipulation.ts#L455)
+Defined in: [src/services/addressManipulation.ts:465](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressManipulation.ts#L465)
 
 Returns a super-address that extends the given address by skipping/taking rows/columns, possibly outside the original bounds.
 Negative skip moves the start above/left of the original range (not from the end).
@@ -565,17 +565,17 @@ Negative skip moves the start above/left of the original range (not from the end
 
 | Parameter | Type | Default value | Description |
 | ------ | ------ | ------ | ------ |
-| `address` | [`Address`](Address.md#address) | `undefined` | The original range in A1 notation (e.g., "A1:D10"). |
+| `address` | [`Address`](Address.md#address) | `undefined` | Original range in A1 notation (e.g., "A1:D10"). |
 | `skipRows` | `number` | `0` | Number of rows to skip (can be negative to extend above). |
-| `takeRows` | `number` | `Number.POSITIVE_INFINITY` | Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity. |
+| `takeRows` | `undefined` \| `number` | `undefined` | Number of rows to take after skipping. If negative, excludes from the end. Default is Infinity. |
 | `skipCols` | `number` | `0` | Number of columns to skip (can be negative to extend left). |
-| `takeCols` | `number` | `Number.POSITIVE_INFINITY` | Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity. |
+| `takeCols` | `undefined` \| `number` | `undefined` | Number of columns to take after skipping. If negative, excludes from the end. Default is Infinity. |
 
 #### Returns
 
 [`Address`](Address.md#address)
 
-A new A1-style range representing the superrange (may extend outside original bounds).
+New A1-style range representing the super range (may extend outside original bounds).
 
 #### Example
 
@@ -589,7 +589,7 @@ superAddress("B2:C3", -1, 4, -1, 4) // "A1:D5"
 
 > **superRange**(`rangeRef`, `skipRows`, `takeRows`, `skipCols`, `takeCols`): [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref)
 
-Defined in: [src/services/addressManipulation.ts:513](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressManipulation.ts#L513)
+Defined in: [src/services/addressManipulation.ts:530](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressManipulation.ts#L530)
 
 Returns a super-range from a WorkbookRangeRef using skip/take semantics, possibly extending outside the original bounds.
 Negative skip moves the start above/left of the original range (not from the end).
@@ -600,9 +600,9 @@ Negative skip moves the start above/left of the original range (not from the end
 | ------ | ------ | ------ | ------ |
 | `rangeRef` | [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref) | `undefined` | Range reference to extend. |
 | `skipRows` | `number` | `0` | Number of rows to skip (can be negative to extend above). Default 0. |
-| `takeRows` | `number` | `Number.POSITIVE_INFINITY` | Number of rows to take after skipping. If negative, excludes from the end. Default Infinity. |
+| `takeRows` | `undefined` \| `number` | `undefined` | Number of rows to take after skipping. If negative, excludes from the end. Default Infinity. |
 | `skipCols` | `number` | `0` | Number of columns to skip (can be negative to extend left). Default 0. |
-| `takeCols` | `number` | `Number.POSITIVE_INFINITY` | Number of columns to take after skipping. If negative, excludes from the end. Default Infinity. |
+| `takeCols` | `undefined` \| `number` | `undefined` | Number of columns to take after skipping. If negative, excludes from the end. Default Infinity. |
 
 #### Returns
 

package/docs/api/driveItem.md

@@ -10,7 +10,7 @@ Utilities for working with Microsoft Graph Drive Items (files and folders).
 
 > `const` **binaryWorkbookFileExtension**: `"xlsb"` = `"xlsb"`
 
-Defined in: [src/services/driveItem.ts:17](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L17)
+Defined in: [src/services/driveItem.ts:19](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L19)
 
 ***
 
@@ -18,7 +18,7 @@ Defined in: [src/services/driveItem.ts:17](https://github.com/Future-Secure-AI/m
 
 > `const` **rootDriveItemPath**: [`DriveItemPath`](DriveItem-1.md#driveitempath)
 
-Defined in: [src/services/driveItem.ts:19](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L19)
+Defined in: [src/services/driveItem.ts:21](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L21)
 
 ***
 
@@ -26,7 +26,7 @@ Defined in: [src/services/driveItem.ts:19](https://github.com/Future-Secure-AI/m
 
 > `const` **workbookFileExtension**: `"xlsx"` = `"xlsx"`
 
-Defined in: [src/services/driveItem.ts:16](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L16)
+Defined in: [src/services/driveItem.ts:18](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L18)
 
 ## Functions
 
@@ -34,7 +34,7 @@ Defined in: [src/services/driveItem.ts:16](https://github.com/Future-Secure-AI/m
 
 > **createDriveItemRef**(`driveRef`, `itemId`): [`DriveItemRef`](DriveItem-1.md#driveitemref)
 
-Defined in: [src/services/driveItem.ts:70](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L70)
+Defined in: [src/services/driveItem.ts:72](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L72)
 
 Creates a reference to a drive item.
 
@@ -61,7 +61,7 @@ ProtocolError if the item ID is missing.
 
 > **driveItemPath**(...`segments`): [`DriveItemPath`](DriveItem-1.md#driveitempath)
 
-Defined in: [src/services/driveItem.ts:27](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L27)
+Defined in: [src/services/driveItem.ts:29](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L29)
 
 Creates a drive item path from a given set of segments.
 
@@ -83,11 +83,33 @@ InvalidArgumentError if a segment is invalid or the path exceeds 400 characters.
 
 ***
 
+### getDriveItemExtension()
+
+> **getDriveItemExtension**(`item`): `string`
+
+Defined in: [src/services/driveItem.ts:110](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L110)
+
+Gets the file extension of a drive item.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `item` | `DriveItem` | Drive item. |
+
+#### Returns
+
+`string`
+
+File extension ie. "txt", "jpg"
+
+***
+
 ### splitDriveItemPath()
 
 > **splitDriveItemPath**(`filePath`): `object`
 
-Defined in: [src/services/driveItem.ts:88](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L88)
+Defined in: [src/services/driveItem.ts:90](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/driveItem.ts#L90)
 
 Splits a drive item path into its folder path and file name.
 

package/package.json

@@ -1,14 +1,12 @@
 {
 	"name": "microsoft-graph",
-	"version": "3.3.0",
+	"version": "3.4.1",
 	"description": "Microsoft GraphAPI SDK for NodeJS",
 	"main": "./dist/cjs/index.js",
 	"module": "./dist/esm/index.js",
 	"types": "./dist/esm/index.d.ts",
 	"scripts": {
-		"check": "biome check",
-		"fix": "biome check --fix",
-		"build": "npm run check && rm -rf ./dist && echo 'Building for ESM...' && tsc -p tsconfig.esm.json && echo 'Building for CJS...' && tsc -p tsconfig.cjs.json && npx tsx update-exports.ts ",
+		"build": "biome check --fix && rm -rf ./dist && echo 'Building for ESM...' && tsc -p tsconfig.esm.json && echo 'Building for CJS...' && tsc -p tsconfig.cjs.json && npx tsx update-exports.ts ",
 		"release": "npm run build && npm run docs && npm publish --access public",
 		"test": "vitest --bail=3",
 		"update": "npm-check-updates -u && npm install",