microsoft-graph 2.26.0 → 2.28.0

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

@@ -0,0 +1,16 @@
+/**
+ * Defining a border that could be on a cell.
+ * @experimental
+ * @module Border
+ * @category Models
+ */
+import type { Color } from "./Color.ts";
+export type Border = {
+    color: Color;
+    style: BorderType;
+    weight: BorderWeight;
+};
+export type BorderSide = "EdgeTop" | "EdgeBottom" | "EdgeLeft" | "EdgeRight" | "InsideVertical" | "InsideHorizontal" | "DiagonalDown" | "DiagonalUp";
+export type BorderType = "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" | "Dot" | "Double" | "SlantDashDot";
+export type BorderWeight = "Hairline" | "Thin" | "Medium" | "Thick";
+//# sourceMappingURL=Border.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Border.d.ts","sourceRoot":"","sources":["../../../src/models/Border.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,cAAc,GAAG,YAAY,CAAC;AAErJ,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEvH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC"}

package/dist/cjs/models/Border.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -3,6 +3,9 @@
  * @module Cell
  * @category Models
  */
+import type { Border } from "./Border.ts";
+import type { Color } from "./Color.ts";
+import type { FontName } from "./FontName.ts";
 /**
  * Cell in a worksheet.
  * @remarks Contrary to common expectation, while a cell does contain a single value, it also contains a text representation of that value and a number format that often defines that representation.
@@ -21,19 +24,21 @@ export type Cell = {
      * Formatting that is applied to the value to derive the text representation.
      */
     format: CellFormat;
-};
-/**
- * Text content of a cell in a worksheet.
- * @remarks This is a string that represents the text displayed in the cell, which may differ from the actual value of the cell (e.g., due to formatting).
- */
-export type CellText = string & {
-    __brand: "CellText";
+    /**
+     * Style applied to the cell to affect its appearance, like color, borders, alignment, etc.
+     */
+    style: CellStyle;
 };
 /**
  * CellValue represents the value of a cell in a spreadsheet.
  * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.
  */
 export type CellValue = string | number | boolean;
+/**
+ * Text content of a cell in a worksheet.
+ * @remarks This is a string that represents the text displayed in the cell, which may differ from the actual value of the cell (e.g., due to formatting).
+ */
+export type CellText = string;
 /**
  * Format to be applied to a cell value to convert it to text to display to the user.
  * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.
@@ -41,4 +46,82 @@ export type CellValue = string | number | boolean;
 export type CellFormat = string & {
     __brand: "CellFormat";
 };
+/**
+ * Style applied to the cell to affect its appearance, like color, borders, alignment, etc.
+ */
+export type CellStyle = {
+    /**
+     * Number of cell merges (WRITE ONLY).
+     * @remarks Due to API limitations, this value is never populated when reading a cell, but it can be set when writing a cell.
+     * @experimental
+     */
+    merge: {
+        right?: number;
+        down?: number;
+    };
+    /**
+     * Alignment of cell contents.
+     * @experimental
+     */
+    alignment: {
+        horizontal?: CellHorizontalAlignment;
+        vertical?: CellVerticalAlignment;
+        wrapText?: boolean | undefined;
+    };
+    /**
+     * Borders around the cell.
+     * @experimental
+     */
+    borders: {
+        top?: Border | undefined;
+        bottom?: Border | undefined;
+        left?: Border | undefined;
+        right?: Border | undefined;
+        insideVertical?: Border | undefined;
+        insideHorizontal?: Border | undefined;
+        diagonalDown?: Border | undefined;
+        diagonalUp?: Border | undefined;
+    };
+    /**
+     * Fill color of the cell.
+     * @experimental
+     */
+    fill: {
+        color?: Color;
+    };
+    /**
+     * Font settings for the cell.
+     * @experimental
+     */
+    font: {
+        name?: FontName;
+        size?: number;
+        color?: Color;
+        bold?: boolean;
+        italic?: boolean;
+        underline?: CellUnderline;
+    };
+};
+/**
+ * The amount of detail that we're reading from a cell.
+ */
+export type CellScope = {
+    /** Raw underlying value. Cheap to read/write (1 op per ~10K cells for values, text & format) */
+    values: boolean;
+    /** Formatted value, as presented to the user. Cheap to read/write (1 op per ~10K cells for values, text & format) */
+    text: boolean;
+    /** Logic used to format values to text. Cheap to read/write (1 op per ~10K cells for values, text & format) */
+    format: boolean;
+    /** Content position with the cell. Expensive to read/write (1 op per cell) */
+    alignment: boolean;
+    /** Cell borders. Expensive to read/write (1 op per cell) */
+    borders: boolean;
+    /** Background fill style. Expensive to read/write (1 op per cell) */
+    fill: boolean;
+    /** Text style. Expensive to read/write (1 op per cell) */
+    font: boolean;
+};
+export type CellHorizontalAlignment = "General" | "Left" | "Center" | "Right" | "Fill" | "Justify" | "CenterAcrossSelection" | "Distributed";
+export type CellVerticalAlignment = "Top" | "Center" | "Bottom" | "Justify" | "Distributed";
+export type CellUnderline = "None" | "Single" | "Double" | "SingleAccountant" | "DoubleAccountant";
 //# sourceMappingURL=Cell.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG;IAClB;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+/**
+ * Color has a hexadecimal representation (ie #ffffff").
+ * @category Models
+ * @module Color
+ */
+export type Color = string & {
+    __brand: "Color";
+};
+//# sourceMappingURL=Color.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../src/models/Color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/dist/cjs/models/Color.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -3,6 +3,11 @@
  * @module Column
  * @category Models
  */
+import type { Cell } from "./Cell.ts";
+/**
+ * Vertical linear sequence of cells in a worksheet.
+ */
+export type Column = Cell[];
 /**
  * Zero-based index representing the position of a column in a range.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"Column.d.ts","sourceRoot":"","sources":["../../../src/models/Column.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IACnC,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}
+{"version":3,"file":"Column.d.ts","sourceRoot":"","sources":["../../../src/models/Column.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IACnC,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC"}

package/dist/cjs/models/Column.js

@@ -1,3 +1,7 @@
 "use strict";
-// biome-ignore lint/style/useFilenamingConvention: Appropriate in this context
+/**
+ * Column pointers.
+ * @module Column
+ * @category Models
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,49 @@
+/**
+ * Tooling for easily creating, updating, and deleting items in a worksheet or range.
+ * @module DataSource
+ * @category Models
+ * @experimental
+ */
+import type { Cell, CellValue } from "./Cell.ts";
+import type { ColumnName } from "./Column.ts";
+import type { RowNumber, RowOffset } from "./Row.ts";
+import type { WorkbookRangeRef } from "./WorkbookRange.ts";
+/**
+ * Defines a data source for a worksheet or range.
+ * @template T Type of the record, extending RecordBase.
+ */
+export type DataSource<T extends RecordBase> = {
+    bodyRef: WorkbookRangeRef;
+    bodyOffset: RowOffset;
+    head: ColumnName[];
+    coding: {
+        decode: RowDecoder<T>;
+        encode: RowEncoder<T> | null;
+    };
+} & AsyncIterable<Item<T>>;
+/**
+ * Method to decode row into a record.
+ */
+export type RowDecoder<T extends RecordBase> = (row: DataSourceRow) => T;
+/**
+ * Method to encode a record into a row.
+ */
+export type RowEncoder<T extends RecordBase> = (record: T) => DataSourceRow;
+/**
+ * Item's position within a data source.
+ */
+export type ItemIndex = number & {
+    __brand: "ItemIndex";
+};
+/**
+ * Item within a data source.
+ */
+export type Item<T extends RecordBase> = {
+    index: ItemIndex;
+    rowNumber: RowNumber;
+    record: T;
+};
+export type RecordBase = Record<string, CellValue>;
+export type DataSourceRow = Record<ColumnName, Partial<Cell>>;
+export type RangeOperationCallback = (rangeRef: WorkbookRangeRef) => Promise<void>;
+//# sourceMappingURL=DataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../../src/models/DataSource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI;IAC9C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,SAAS,CAAC;IACtB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE;QACP,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;KAC7B,CAAC;CACF,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,aAAa,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC;AAGF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACnD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cjs/models/DataSource.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Tooling for easily creating, updating, and deleting items in a worksheet or range.
+ * @module DataSource
+ * @category Models
+ * @experimental
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,9 @@
+/**
+ * Name of a font.
+ * @category Models
+ * @module FontName
+ */
+export type FontName = string & {
+    __brand: "FontName";
+};
+//# sourceMappingURL=FontName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FontName.d.ts","sourceRoot":"","sources":["../../../src/models/FontName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC/B,OAAO,EAAE,UAAU,CAAC;CACpB,CAAC"}

package/dist/cjs/models/FontName.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -4,6 +4,9 @@
  * @category Models
  */
 import type { Cell } from "./Cell.ts";
+/**
+ * Horizontal linear sequence of cells in a worksheet.
+ */
 export type Row = Cell[];
 /**
  * Row number as it appears in Excel.

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

@@ -1 +1 @@
-{"version":3,"file":"Row.d.ts","sourceRoot":"","sources":["../../../src/models/Row.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;AAEzB;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}
+{"version":3,"file":"Row.d.ts","sourceRoot":"","sources":["../../../src/models/Row.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;AAEzB;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}

package/dist/cjs/operations/workbookRange/getWorkbookWorksheetRange.d.ts

@@ -9,8 +9,13 @@ import type { WorkbookRangeRef } from "../../models/WorkbookRange.ts";
 /**
  * Fetch a range.
  * @param rangeRef Reference to the range to be fetched.
+ * @param select Optional parameters to select specific properties of the range.
  * @returns The fetched range, including values and formatting
  * @see https://learn.microsoft.com/en-us/graph/api/range-get
  */
-export default function getWorkbookWorksheetRange(rangeRef: WorkbookRangeRef): GraphOperation<WorkbookRange & WorkbookRangeRef>;
+export default function getWorkbookWorksheetRange(rangeRef: WorkbookRangeRef, select?: {
+    values?: boolean;
+    text?: boolean;
+    numberFormat?: boolean;
+}): GraphOperation<WorkbookRange & WorkbookRangeRef>;
 //# sourceMappingURL=getWorkbookWorksheetRange.d.ts.map

package/dist/cjs/operations/workbookRange/getWorkbookWorksheetRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookWorksheetRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/getWorkbookWorksheetRange.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAoB9H"}
+{"version":3,"file":"getWorkbookWorksheetRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/getWorkbookWorksheetRange.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CA2BrM"}

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

@@ -12,15 +12,22 @@ const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
 /**
  * Fetch a range.
  * @param rangeRef Reference to the range to be fetched.
+ * @param select Optional parameters to select specific properties of the range.
  * @returns The fetched range, including values and formatting
  * @see https://learn.microsoft.com/en-us/graph/api/range-get
  */
-function getWorkbookWorksheetRange(rangeRef) {
+function getWorkbookWorksheetRange(rangeRef, select) {
     const address = (0, addressManipulation_ts_1.normalizeAddress)(rangeRef.address, true);
+    const selectString = select
+        ? Object.entries(select)
+            .map(([k, v]) => (v ? k : undefined))
+            .filter((v) => !!v)
+            .join(",")
+        : null;
     return (0, operationInvoker_ts_1.operation)({
         context: rangeRef.context,
         method: "GET",
-        path: (0, templatedPaths_ts_1.generatePath)(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')`, rangeRef),
+        path: (0, templatedPaths_ts_1.generatePath)(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')?$select=${selectString}`, rangeRef),
         headers: {
             "workbook-session-id": rangeRef.sessionId,
         },

package/dist/cjs/operations/workbookRange/listWorkbookRangeBorders.d.ts

@@ -0,0 +1,16 @@
+/**
+ * List the borders of a range.
+ * @module listWorkbookRangeBorders
+ * @category Operations
+ */
+import type { WorkbookRangeBorder } from "@microsoft/microsoft-graph-types";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRange.ts";
+/**
+ * List the borders of a range.
+ * @param rangeRef Reference to the range whose borders will be listed.
+ * @returns Array of borders for the specified range.
+ * @see https://learn.microsoft.com/en-us/graph/api/rangeborder-list
+ */
+export default function listWorkbookRangeBorders(rangeRef: WorkbookRangeRef): GraphOperation<WorkbookRangeBorder[]>;
+//# sourceMappingURL=listWorkbookRangeBorders.d.ts.map

package/dist/cjs/operations/workbookRange/listWorkbookRangeBorders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listWorkbookRangeBorders.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/listWorkbookRangeBorders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,EAAE,CAAC,CAelH"}

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

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * List the borders of a range.
+ * @module listWorkbookRangeBorders
+ * @category Operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = listWorkbookRangeBorders;
+const addressManipulation_ts_1 = require("../../services/addressManipulation.js");
+const operationInvoker_ts_1 = require("../../services/operationInvoker.js");
+const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
+/**
+ * List the borders of a range.
+ * @param rangeRef Reference to the range whose borders will be listed.
+ * @returns Array of borders for the specified range.
+ * @see https://learn.microsoft.com/en-us/graph/api/rangeborder-list
+ */
+function listWorkbookRangeBorders(rangeRef) {
+    const address = (0, addressManipulation_ts_1.normalizeAddress)(rangeRef.address, true);
+    return (0, operationInvoker_ts_1.operation)({
+        context: rangeRef.context,
+        method: "GET",
+        path: (0, templatedPaths_ts_1.generatePath)(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')/format/borders`, rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const typed = response;
+            return typed.value;
+        },
+    });
+}

package/dist/cjs/operations/workbookRange/setWorkbookRangeBorder.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Update a specific border of a workbook range.
+ * @module setWorkbookRangeBorder
+ * @category Operations
+ */
+import type { WorkbookRangeBorder } from "@microsoft/microsoft-graph-types";
+import type { Border, BorderSide } from "../../models/Border.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookRangeRef } from "../../models/WorkbookRange.ts";
+/**
+ * Update a specific border of a workbook range.
+ * @param rangeRef Reference to the range whose border will be updated.
+ * @param side The border side to update (e.g., "EdgeTop", "EdgeBottom", "EdgeLeft", "EdgeRight", "InsideHorizontal", "InsideVertical").
+ * @param values Partial border object to update (color, style, weight, etc.).
+ * @returns The updated border for the specified range and side.
+ * @see https://learn.microsoft.com/en-us/graph/api/rangeborder-update
+ */
+export default function setWorkbookRangeBorder(rangeRef: WorkbookRangeRef, side: BorderSide, values: Partial<Border>): GraphOperation<WorkbookRangeBorder & WorkbookRangeRef>;
+//# sourceMappingURL=setWorkbookRangeBorder.d.ts.map

package/dist/cjs/operations/workbookRange/setWorkbookRangeBorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setWorkbookRangeBorder.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/setWorkbookRangeBorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAwB5K"}

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

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Update a specific border of a workbook range.
+ * @module setWorkbookRangeBorder
+ * @category Operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = setWorkbookRangeBorder;
+const addressManipulation_ts_1 = require("../../services/addressManipulation.js");
+const operationInvoker_ts_1 = require("../../services/operationInvoker.js");
+const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
+/**
+ * Update a specific border of a workbook range.
+ * @param rangeRef Reference to the range whose border will be updated.
+ * @param side The border side to update (e.g., "EdgeTop", "EdgeBottom", "EdgeLeft", "EdgeRight", "InsideHorizontal", "InsideVertical").
+ * @param values Partial border object to update (color, style, weight, etc.).
+ * @returns The updated border for the specified range and side.
+ * @see https://learn.microsoft.com/en-us/graph/api/rangeborder-update
+ */
+function setWorkbookRangeBorder(rangeRef, side, values) {
+    const address = (0, addressManipulation_ts_1.normalizeAddress)(rangeRef.address, true);
+    return (0, operationInvoker_ts_1.operation)({
+        context: rangeRef.context,
+        method: "PATCH",
+        path: (0, templatedPaths_ts_1.generatePath)(`/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='${address}')/format/borders/${side}`, rangeRef),
+        headers: {
+            "workbook-session-id": rangeRef.sessionId,
+            "content-type": "application/json",
+        },
+        body: {
+            sideIndex: side,
+            color: values.color,
+            style: values.style,
+            weight: values.weight,
+        },
+        responseTransform: (response) => {
+            const updated = response;
+            return {
+                ...updated,
+                ...rangeRef,
+            };
+        },
+    });
+}

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

@@ -374,7 +374,8 @@ function subAddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY,
     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) {
-        throw new InvalidArgumentError_ts_1.default(`Requested subaddress is out of bounds: rows [${startRow + 1},${endRow + 1}], cols [${startCol + 1},${endCol + 1}] in range.`);
+        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}.`);
     }
     return (0, cartesianAddress_ts_1.cartesianToAddress)({
         ay: startRow,

package/dist/cjs/services/cartesianAddress.js

@@ -39,10 +39,10 @@ function cartesianToAddress({ ax, ay, bx, by }) {
     const endColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(bx);
     const endRow = (0, addressOffset_ts_1.rowOffsetToAddress)(by);
     if (ax > bx) {
-        throw new InvalidArgumentError_ts_1.default("Invalid address. End column is before start column.");
+        throw new InvalidArgumentError_ts_1.default(`Invalid address. End column is before start column. ax=${ax} bx=${bx}.`);
     }
     if (ay > by) {
-        throw new InvalidArgumentError_ts_1.default("Invalid address. End row is before start row.");
+        throw new InvalidArgumentError_ts_1.default(`Invalid address. End row is before start row. ay=${ay} by=${by}.`);
     }
     const address = (0, addressManipulation_ts_1.composeAddress)({
         startRow,

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

@@ -0,0 +1,69 @@
+/**
+ * Tooling for easily creating, updating, and deleting items in a worksheet or range.
+ * @module dataSource
+ * @category Services
+ * @experimental
+ */
+import type { DataSource, Item, ItemIndex, RecordBase, RowDecoder, RowEncoder } from "../models/DataSource.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+/**
+ * Define a datasource from an entire worksheet.
+ * @template T Type of the record, extending RecordBase.
+ * @param worksheetRef Workbook range reference to define the data source on.
+ * @param decode Function to decode a row into a record.
+ * @param encode Function to encode a record into a row. Optional.
+ * @returns The initialized data source.
+ * @experimental
+ */
+export declare function dataSourceFromWorksheet<T extends RecordBase>(worksheetRef: WorkbookRangeRef, decode: RowDecoder<T>, encode?: RowEncoder<T> | null): Promise<DataSource<T>>;
+/**
+ * Defines a data source from a given range.
+ * @template T Type of the record, extending RecordBase.
+ * @param rangeRef Workbook range reference to define the data source on.
+ * @param decode Function to decode a row into a record.
+ * @param encode Function to encode a record into a row. Optional.
+ * @returns The initialized data source.
+ * @experimental
+ */
+export declare function dataSourceFromRange<T extends RecordBase>(rangeRef: WorkbookRangeRef, decode: RowDecoder<T>, encode?: RowEncoder<T> | null): Promise<DataSource<T>>;
+/**
+ * Reads all items from the data source.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to read from.
+ * @returns Array of all items in the data source.
+ * @deprecated Iterate on the source directly using `for await (const item of source)`.
+ */
+export declare function listItems<T extends RecordBase>(source: DataSource<T>): AsyncIterable<Item<T>>;
+/**
+ * Creates a new item in the data source.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to insert into. Must be initialized.
+ * @param record Record to insert.
+ * @param after Index after which to insert the new item. If null, inserts at the end. If -1 inserts at top.
+ * @returns Newly created item, including its index, row number, and record.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @throws {InvalidArgumentError} If the 'after' index is out of range.
+ * @experimental
+ */
+export declare function createItem<T extends RecordBase>(source: DataSource<T>, record: T, after?: ItemIndex | null): Promise<Item<T>>;
+/**
+ * Updates an item in the data source at the specified index.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to update. Must be initialized.
+ * @param index Index of the item to update.
+ * @param record New record to write at the specified index.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @throws {InvalidArgumentError} If the index is out of range.
+ * @experimental
+ */
+export declare function updateItem<T extends RecordBase>(source: DataSource<T>, index: ItemIndex, record: T): Promise<void>;
+/**
+ * Deletes an item from the data source at the specified index.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to delete from. Must be initialized.
+ * @param index Index of the item to delete.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @experimental
+ */
+export declare function deleteItem<T extends RecordBase>(source: DataSource<T>, index: ItemIndex): Promise<void>;
+//# sourceMappingURL=dataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataSource.d.ts","sourceRoot":"","sources":["../../../src/services/dataSource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAiB,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE9H,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAWnE;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,GAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAGtL;AACD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,GAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAqC9K;AAED;;;;;;GAMG;AACH,wBAAuB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAIpG;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,GAAE,SAAS,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAgBzI;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CASxH;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7G"}