microsoft-graph 2.7.7 → 2.7.8

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

@@ -1,5 +1,17 @@
 import type { Address } from "../models/Address.ts";
 import type { Cartesian } from "../models/Cartesian.ts";
+/**
+ * Converts a cell range address to Cartesian coordinates.
+ *
+ * @param {Address} address - The cell range address (e.g., "A1:C3").
+ * @returns {Cartesian} The Cartesian representation of the address, with start and end coordinates.
+ */
 export declare function addressToCartesian(address: Address): Cartesian;
+/**
+ * Converts Cartesian coordinates to a cell range address.
+ *
+ * @param {Cartesian} cartesian - The Cartesian coordinates, including start (ax, ay) and end (bx, by).
+ * @returns {Address} The cell range address (e.g., "A1:C3").
+ */
 export declare function cartesianToAddress(cartesian: Cartesian): Address;
 //# sourceMappingURL=cartesianAddress.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAchE"}
+{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAchE"}

package/dist/cjs/services/cartesianAddress.js

@@ -4,6 +4,12 @@ exports.addressToCartesian = addressToCartesian;
 exports.cartesianToAddress = cartesianToAddress;
 const addressManipulation_ts_1 = require("./addressManipulation.js");
 const addressOffset_ts_1 = require("./addressOffset.js");
+/**
+ * Converts a cell range address to Cartesian coordinates.
+ *
+ * @param {Address} address - The cell range address (e.g., "A1:C3").
+ * @returns {Cartesian} The Cartesian representation of the address, with start and end coordinates.
+ */
 function addressToCartesian(address) {
     const components = (0, addressManipulation_ts_1.decomposeAddress)(address);
     const ax = (0, addressOffset_ts_1.columnAddressToOffset)(components.startColumn);
@@ -12,6 +18,12 @@ function addressToCartesian(address) {
     const by = (0, addressOffset_ts_1.rowAddressToOffset)(components.endRow);
     return { ax, ay, bx, by };
 }
+/**
+ * Converts Cartesian coordinates to a cell range address.
+ *
+ * @param {Cartesian} cartesian - The Cartesian coordinates, including start (ax, ay) and end (bx, by).
+ * @returns {Address} The cell range address (e.g., "A1:C3").
+ */
 function cartesianToAddress(cartesian) {
     const startColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(cartesian.ax);
     const startRow = (0, addressOffset_ts_1.rowOffsetToAddress)(cartesian.ay);

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

@@ -0,0 +1,28 @@
+import type { Address } from "../models/Address.ts";
+import type { CellRangeValues } from "../models/CellRangeValues.ts";
+/**
+ * Converts a 2D array of cell values into range address in the upper left.
+ *
+ * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @returns {Address} The default cell range address (e.g., "A1:C3").
+ * @throws {InvalidArgumentError} If rows have inconsistent column counts.
+ */
+export declare function inferRangeAddress(values: CellRangeValues): Address;
+/**
+ * Converts a 2D array of cell values into an array of objects.
+ * Assumes the first row is a header and uses it as keys for the objects.
+ *
+ * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @returns {unknown[]} An array of objects where each object represents a row.
+ * @throws {InvalidArgumentError} If rows have inconsistent column counts or no header row is present.
+ */
+export declare function inferRangeObject(values: CellRangeValues): unknown[];
+/**
+ * Converts an array of objects into a 2D array of cell values.
+ * The first row of the 2D array contains the keys as headers.
+ *
+ * @param {unknown[]} objs - An array of objects to convert.
+ * @returns {CellRangeValues} A 2D array where the first row is the header and subsequent rows are the object values.
+ */
+export declare function inferObjectRange(objs: unknown[]): CellRangeValues;
+//# sourceMappingURL=rangeManipulation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rangeManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/rangeManipulation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CA4BlE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CAoBnE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CASjE"}

package/dist/cjs/services/rangeManipulation.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferRangeAddress = inferRangeAddress;
+exports.inferRangeObject = inferRangeObject;
+exports.inferObjectRange = inferObjectRange;
+const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
+const cartesianAddress_ts_1 = require("./cartesianAddress.js");
+/**
+ * Converts a 2D array of cell values into range address in the upper left.
+ *
+ * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @returns {Address} The default cell range address (e.g., "A1:C3").
+ * @throws {InvalidArgumentError} If rows have inconsistent column counts.
+ */
+function inferRangeAddress(values) {
+    const first = values[0];
+    if (!first) {
+        return "A1";
+    }
+    for (const row of values) {
+        if (row.length !== first.length) {
+            throw new InvalidArgumentError_ts_1.default("All rows must have the same number of columns");
+        }
+    }
+    const rowCount = values.length;
+    const columnCount = first.length;
+    const startRow = 0;
+    const startColumn = 0;
+    const endRow = (rowCount - 1);
+    const endColumn = (columnCount - 1);
+    return (0, cartesianAddress_ts_1.cartesianToAddress)({
+        ax: startColumn,
+        ay: startRow,
+        bx: endColumn,
+        by: endRow,
+    });
+}
+/**
+ * Converts a 2D array of cell values into an array of objects.
+ * Assumes the first row is a header and uses it as keys for the objects.
+ *
+ * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @returns {unknown[]} An array of objects where each object represents a row.
+ * @throws {InvalidArgumentError} If rows have inconsistent column counts or no header row is present.
+ */
+function inferRangeObject(values) {
+    const [header, ...rows] = values;
+    if (!header) {
+        throw new InvalidArgumentError_ts_1.default("Does not contain a header row");
+    }
+    return rows.map((row, index) => {
+        if (row.length !== header.length) {
+            throw new InvalidArgumentError_ts_1.default(`Row ${index} length must match header length`);
+        }
+        return header.reduce((obj, key, index) => {
+            obj[key.toString()] = row[index];
+            return obj;
+        }, {});
+    });
+}
+/**
+ * Converts an array of objects into a 2D array of cell values.
+ * The first row of the 2D array contains the keys as headers.
+ *
+ * @param {unknown[]} objs - An array of objects to convert.
+ * @returns {CellRangeValues} A 2D array where the first row is the header and subsequent rows are the object values.
+ */
+function inferObjectRange(objs) {
+    if (objs.length === 0) {
+        return [];
+    }
+    const header = Array.from(new Set(objs.flatMap((obj) => Object.keys(obj))));
+    const rows = objs.map((obj) => header.map((key) => obj[key]));
+    return [header, ...rows];
+}

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

@@ -1,5 +1,17 @@
 import type { Address } from "../models/Address.ts";
 import type { Cartesian } from "../models/Cartesian.ts";
+/**
+ * Converts a cell range address to Cartesian coordinates.
+ *
+ * @param {Address} address - The cell range address (e.g., "A1:C3").
+ * @returns {Cartesian} The Cartesian representation of the address, with start and end coordinates.
+ */
 export declare function addressToCartesian(address: Address): Cartesian;
+/**
+ * Converts Cartesian coordinates to a cell range address.
+ *
+ * @param {Cartesian} cartesian - The Cartesian coordinates, including start (ax, ay) and end (bx, by).
+ * @returns {Address} The cell range address (e.g., "A1:C3").
+ */
 export declare function cartesianToAddress(cartesian: Cartesian): Address;
 //# sourceMappingURL=cartesianAddress.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAchE"}
+{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAchE"}

package/dist/esm/services/cartesianAddress.js

@@ -1,5 +1,11 @@
 import { composeAddress, decomposeAddress } from "./addressManipulation.js";
 import { columnAddressToOffset, columnOffsetToAddress, rowAddressToOffset, rowOffsetToAddress } from "./addressOffset.js";
+/**
+ * Converts a cell range address to Cartesian coordinates.
+ *
+ * @param {Address} address - The cell range address (e.g., "A1:C3").
+ * @returns {Cartesian} The Cartesian representation of the address, with start and end coordinates.
+ */
 export function addressToCartesian(address) {
     const components = decomposeAddress(address);
     const ax = columnAddressToOffset(components.startColumn);
@@ -8,6 +14,12 @@ export function addressToCartesian(address) {
     const by = rowAddressToOffset(components.endRow);
     return { ax, ay, bx, by };
 }
+/**
+ * Converts Cartesian coordinates to a cell range address.
+ *
+ * @param {Cartesian} cartesian - The Cartesian coordinates, including start (ax, ay) and end (bx, by).
+ * @returns {Address} The cell range address (e.g., "A1:C3").
+ */
 export function cartesianToAddress(cartesian) {
     const startColumn = columnOffsetToAddress(cartesian.ax);
     const startRow = rowOffsetToAddress(cartesian.ay);

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

@@ -0,0 +1,28 @@
+import type { Address } from "../models/Address.ts";
+import type { CellRangeValues } from "../models/CellRangeValues.ts";
+/**
+ * Converts a 2D array of cell values into range address in the upper left.
+ *
+ * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @returns {Address} The default cell range address (e.g., "A1:C3").
+ * @throws {InvalidArgumentError} If rows have inconsistent column counts.
+ */
+export declare function inferRangeAddress(values: CellRangeValues): Address;
+/**
+ * Converts a 2D array of cell values into an array of objects.
+ * Assumes the first row is a header and uses it as keys for the objects.
+ *
+ * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @returns {unknown[]} An array of objects where each object represents a row.
+ * @throws {InvalidArgumentError} If rows have inconsistent column counts or no header row is present.
+ */
+export declare function inferRangeObject(values: CellRangeValues): unknown[];
+/**
+ * Converts an array of objects into a 2D array of cell values.
+ * The first row of the 2D array contains the keys as headers.
+ *
+ * @param {unknown[]} objs - An array of objects to convert.
+ * @returns {CellRangeValues} A 2D array where the first row is the header and subsequent rows are the object values.
+ */
+export declare function inferObjectRange(objs: unknown[]): CellRangeValues;
+//# sourceMappingURL=rangeManipulation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rangeManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/rangeManipulation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMpE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CA4BlE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE,CAoBnE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CASjE"}

package/dist/esm/services/rangeManipulation.js

@@ -0,0 +1,70 @@
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import { cartesianToAddress } from "./cartesianAddress.js";
+/**
+ * Converts a 2D array of cell values into range address in the upper left.
+ *
+ * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @returns {Address} The default cell range address (e.g., "A1:C3").
+ * @throws {InvalidArgumentError} If rows have inconsistent column counts.
+ */
+export function inferRangeAddress(values) {
+    const first = values[0];
+    if (!first) {
+        return "A1";
+    }
+    for (const row of values) {
+        if (row.length !== first.length) {
+            throw new InvalidArgumentError("All rows must have the same number of columns");
+        }
+    }
+    const rowCount = values.length;
+    const columnCount = first.length;
+    const startRow = 0;
+    const startColumn = 0;
+    const endRow = (rowCount - 1);
+    const endColumn = (columnCount - 1);
+    return cartesianToAddress({
+        ax: startColumn,
+        ay: startRow,
+        bx: endColumn,
+        by: endRow,
+    });
+}
+/**
+ * Converts a 2D array of cell values into an array of objects.
+ * Assumes the first row is a header and uses it as keys for the objects.
+ *
+ * @param {CellRangeValues} values - A 2D array representing cell values.
+ * @returns {unknown[]} An array of objects where each object represents a row.
+ * @throws {InvalidArgumentError} If rows have inconsistent column counts or no header row is present.
+ */
+export function inferRangeObject(values) {
+    const [header, ...rows] = values;
+    if (!header) {
+        throw new InvalidArgumentError("Does not contain a header row");
+    }
+    return rows.map((row, index) => {
+        if (row.length !== header.length) {
+            throw new InvalidArgumentError(`Row ${index} length must match header length`);
+        }
+        return header.reduce((obj, key, index) => {
+            obj[key.toString()] = row[index];
+            return obj;
+        }, {});
+    });
+}
+/**
+ * Converts an array of objects into a 2D array of cell values.
+ * The first row of the 2D array contains the keys as headers.
+ *
+ * @param {unknown[]} objs - An array of objects to convert.
+ * @returns {CellRangeValues} A 2D array where the first row is the header and subsequent rows are the object values.
+ */
+export function inferObjectRange(objs) {
+    if (objs.length === 0) {
+        return [];
+    }
+    const header = Array.from(new Set(objs.flatMap((obj) => Object.keys(obj))));
+    const rows = objs.map((obj) => header.map((key) => obj[key]));
+    return [header, ...rows];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microsoft-graph",
-  "version": "2.7.7",
+  "version": "2.7.8",
   "description": "Microsoft GraphAPI SDK for NodeJS",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -597,6 +597,11 @@
       "require": "./dist/cjs/services/random.js",
       "types": "./dist/esm/services/random.d.ts"
     },
+    "./services/rangeManipulation": {
+      "import": "./dist/esm/services/rangeManipulation.js",
+      "require": "./dist/cjs/services/rangeManipulation.js",
+      "types": "./dist/esm/services/rangeManipulation.d.ts"
+    },
     "./services/sharepointUrl": {
       "import": "./dist/esm/services/sharepointUrl.js",
       "require": "./dist/cjs/services/sharepointUrl.js",
@@ -1262,6 +1267,11 @@
       "import": "./dist/esm/services/random.js",
       "types": "./dist/esm/services/random.d.ts"
     },
+    "./dist/cjs/services/rangeManipulation.js": {
+      "require": "./dist/cjs/services/rangeManipulation.js",
+      "import": "./dist/esm/services/rangeManipulation.js",
+      "types": "./dist/esm/services/rangeManipulation.d.ts"
+    },
     "./dist/cjs/services/sharepointUrl.js": {
       "require": "./dist/cjs/services/sharepointUrl.js",
       "import": "./dist/esm/services/sharepointUrl.js",