microsoft-graph 2.15.2 → 2.17.0

package/dist/cjs/errors/InvalidOperationError.d.ts

@@ -0,0 +1,4 @@
+export default class InvalidOperationError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=InvalidOperationError.d.ts.map

package/dist/cjs/errors/InvalidOperationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidOperationError.d.ts","sourceRoot":"","sources":["../../../src/errors/InvalidOperationError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,KAAK;gBACpC,OAAO,CAAC,EAAE,MAAM;CAInC"}

package/dist/cjs/errors/InvalidOperationError.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class InvalidOperationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidOperationError";
+    }
+}
+exports.default = InvalidOperationError;

package/dist/cjs/graphApi.js

@@ -45,7 +45,7 @@ async function sequential(...operations) {
     return (await executeBatch(...definitions));
 }
 const maxBatchOperations = 20; // https://learn.microsoft.com/en-us/graph/json-batching?tabs=http#batch-size-limitations
-const maxRetries = 3;
+const maxRetries = 5;
 const defaultRetryDelayMilliseconds = 1000;
 const consecutiveRetryDelayMultiplier = 2;
 async function executeSingle(definition) {
@@ -139,7 +139,7 @@ async function innerFetch(args) {
         catch (error) {
             if (axios_1.default.isAxiosError(error) && error.response) {
                 response = error.response;
-                if (!((0, httpStatus_ts_1.isHttpTooManyRequests)(response.status) || (0, httpStatus_ts_1.isServiceUnavailable)(response.status) || (0, httpStatus_ts_1.isGatewayTimeout)(response.status))) {
+                if (!((0, httpStatus_ts_1.isHttpTooManyRequests)(response.status) || (0, httpStatus_ts_1.isServiceUnavailable)(response.status) || (0, httpStatus_ts_1.isGatewayTimeout)(response.status) || (0, httpStatus_ts_1.isLocked)(response.status))) {
                     throw error;
                 }
                 const requestedRetryAfterSeconds = Number.parseInt(response.headers["retry-after"] ?? "0", 10);

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

@@ -0,0 +1,8 @@
+import type { CellValue } from "../models/CellValue.ts";
+import type { NumberFormat } from "./NumberFormat.ts";
+export type Cell = {
+    text: string;
+    value: CellValue;
+    numberFormat: NumberFormat;
+};
+//# sourceMappingURL=Cell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;CAC3B,CAAC"}

package/dist/cjs/models/Cell.js

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

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

@@ -0,0 +1,9 @@
+import type { RowOffset } from "../models/RowOffset.ts";
+import type { RecordBase } from "./RecordBase.ts";
+import type { RowNumber } from "./RowNumber.ts";
+export type Item<T extends RecordBase> = {
+    rowOffset: RowOffset;
+    rowNumber: RowNumber;
+    record: T;
+};
+//# sourceMappingURL=Item.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Item.d.ts","sourceRoot":"","sources":["../../../src/models/Item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC"}

package/dist/cjs/models/Item.js

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

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

@@ -0,0 +1,4 @@
+export type NumberFormat = string & {
+    __brand: "NumberFormat";
+};
+//# sourceMappingURL=NumberFormat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NumberFormat.d.ts","sourceRoot":"","sources":["../../../src/models/NumberFormat.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IACnC,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC"}

package/dist/cjs/models/NumberFormat.js

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

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

@@ -0,0 +1,3 @@
+import type { CellValue } from "./CellValue.ts";
+export type RecordBase = Record<string, CellValue>;
+//# sourceMappingURL=RecordBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecordBase.d.ts","sourceRoot":"","sources":["../../../src/models/RecordBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/cjs/models/RecordBase.js

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

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

@@ -0,0 +1,4 @@
+export type RowNumber = number & {
+    __brand: "RowNumber";
+};
+//# sourceMappingURL=RowNumber.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RowNumber.d.ts","sourceRoot":"","sources":["../../../src/models/RowNumber.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAChC,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC"}

package/dist/cjs/models/RowNumber.js

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

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

@@ -0,0 +1,15 @@
+import type { ColumnName } from "./ColumnName.ts";
+import type { Item } from "./Item.ts";
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceDecoder } from "./SourceDecoder.ts";
+import type { SourceEncoder } from "./SourceEncoder.ts";
+import type { WorkbookRangeRef } from "./WorkbookRangeRef.ts";
+export type Source<T extends RecordBase> = {
+    rangeRef: WorkbookRangeRef;
+    head: ColumnName[];
+    coding: {
+        decode: SourceDecoder<T>;
+        encode: SourceEncoder<T>;
+    };
+} & AsyncIterable<Item<T>>;
+//# sourceMappingURL=Source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Source.d.ts","sourceRoot":"","sources":["../../../src/models/Source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,UAAU,IAAI;IAC1C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE;QACP,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;KACzB,CAAC;CACF,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/cjs/models/Source.js

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

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

@@ -0,0 +1,4 @@
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceRow } from "./SourceRow.ts";
+export type SourceDecoder<T extends RecordBase> = (row: SourceRow) => T;
+//# sourceMappingURL=SourceDecoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceDecoder.d.ts","sourceRoot":"","sources":["../../../src/models/SourceDecoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,GAAG,EAAE,SAAS,KAAK,CAAC,CAAC"}

package/dist/cjs/models/SourceDecoder.js

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

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

@@ -0,0 +1,4 @@
+import type { RecordBase } from "./RecordBase.ts";
+import type { SourceRow } from "./SourceRow.ts";
+export type SourceEncoder<T extends RecordBase> = (record: T) => SourceRow;
+//# sourceMappingURL=SourceEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceEncoder.d.ts","sourceRoot":"","sources":["../../../src/models/SourceEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAC"}

package/dist/cjs/models/SourceEncoder.js

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

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

@@ -0,0 +1,4 @@
+import type { Cell } from "../models/Cell.ts";
+import type { ColumnName } from "../models/ColumnName.ts";
+export type SourceRow = Record<ColumnName, Cell>;
+//# sourceMappingURL=SourceRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceRow.d.ts","sourceRoot":"","sources":["../../../src/models/SourceRow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC"}

package/dist/cjs/models/SourceRow.js

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

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

@@ -0,0 +1,4 @@
+import type { CellValue } from "./CellValue.ts";
+import type { ColumnName } from "./ColumnName.ts";
+export type SourceRowValue = Record<ColumnName, CellValue>;
+//# sourceMappingURL=SourceRowValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SourceRowValue.d.ts","sourceRoot":"","sources":["../../../src/models/SourceRowValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC"}

package/dist/cjs/models/SourceRowValue.js

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

package/dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts

@@ -0,0 +1,12 @@
+import type { Address } from "../../models/Address.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+import type { WorkbookWorksheetRef } from "../../models/WorkbookWorksheetRef.ts";
+/**
+ * Retrieve the address of the used range in a worksheet, ignoring trailing rows and columns that are blank.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns Address of the used range of the worksheet.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+export default function getWorkbookWorksheetUsedRangeAddress(worksheetRef: WorkbookWorksheetRef): GraphOperation<Address>;
+//# sourceMappingURL=getWorkbookWorksheetUsedRangeAddress.d.ts.map

package/dist/cjs/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWorkbookWorksheetUsedRangeAddress.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,oCAAoC,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,OAAO,CAAC,CAmBxH"}

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

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getWorkbookWorksheetUsedRangeAddress;
+const ProtocolError_ts_1 = __importDefault(require("../../errors/ProtocolError.js"));
+const graphApi_ts_1 = require("../../graphApi.js");
+const addressManipulation_ts_1 = require("../../services/addressManipulation.js");
+const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
+/**
+ * Retrieve the address of the used range in a worksheet, ignoring trailing rows and columns that are blank.
+ *
+ * @param worksheetRef - A reference to the worksheet, optionally including session information.
+ * @returns Address of the used range of the worksheet.
+ * @see https://learn.microsoft.com/en-us/graph/api/range-usedrange
+ */
+function getWorkbookWorksheetUsedRangeAddress(worksheetRef) {
+    return (0, graphApi_ts_1.operation)({
+        contextId: worksheetRef.contextId,
+        method: "GET",
+        path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range/usedRange?$select=address", worksheetRef),
+        headers: {
+            "workbook-session-id": worksheetRef.sessionId,
+        },
+        body: null,
+        responseTransform: (response) => {
+            const range = response;
+            if (!range.address) {
+                throw new ProtocolError_ts_1.default("Invalid response: address is missing");
+            }
+            const address = (0, addressManipulation_ts_1.composeAddress)((0, addressManipulation_ts_1.decomposeAddress)(range.address)); // Strip any prefixed sheet name
+            return address;
+        },
+    });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAmBnJ,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CA6BrE;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"}
+{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAmBnJ,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAsBrE;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"}

package/dist/cjs/services/addressManipulation.js

@@ -70,12 +70,6 @@ function composeAddress(components) {
     if (isSingleColumn(components) && isSingleRow(components)) {
         return composeCellAddress(components.startColumn, components.startRow);
     }
-    if (components.startColumn > components.endColumn) {
-        throw new InvalidArgumentError_ts_1.default("Invalid address. End column is before start column.");
-    }
-    if (components.startRow > components.endRow) {
-        throw new InvalidArgumentError_ts_1.default("Invalid address. End row is before start row.");
-    }
     return composeCellRangeAddress(components.startColumn, components.startRow, components.endColumn, components.endRow);
 }
 /**

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

@@ -13,7 +13,7 @@ export declare function columnAddressToOffset(column: ColumnAddress): ColumnOffs
  * @returns The column address.
  */
 export declare function columnOffsetToAddress(offset: ColumnOffset): ColumnAddress;
-/** @deprecated Use columnAddressToOffset instead. */
+/** @deprecated Use columnOffsetToAddress instead. */
 export declare function offsetToColumnAddress(offset: ColumnOffset): ColumnAddress;
 /**
  * Converts a row address (e.g., "1") to a zero-based row offset.

package/dist/cjs/services/addressOffset.js

@@ -33,7 +33,7 @@ function columnOffsetToAddress(offset) {
     }
     return result;
 }
-/** @deprecated Use columnAddressToOffset instead. */
+/** @deprecated Use columnOffsetToAddress instead. */
 function offsetToColumnAddress(offset) {
     return columnOffsetToAddress(offset);
 }

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

@@ -13,5 +13,5 @@ export declare function addressToCartesian(address: Address): Cartesian;
  * @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;
+export declare function cartesianToAddress({ ax, ay, bx, by }: 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;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAchE"}
+{"version":3,"file":"cartesianAddress.d.ts","sourceRoot":"","sources":["../../../src/services/cartesianAddress.ts"],"names":[],"mappings":"AACA,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,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAqBzE"}

package/dist/cjs/services/cartesianAddress.js

@@ -1,7 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addressToCartesian = addressToCartesian;
 exports.cartesianToAddress = cartesianToAddress;
+const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
 const addressManipulation_ts_1 = require("./addressManipulation.js");
 const addressOffset_ts_1 = require("./addressOffset.js");
 /**
@@ -24,11 +28,17 @@ function addressToCartesian(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);
-    const endColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(cartesian.bx);
-    const endRow = (0, addressOffset_ts_1.rowOffsetToAddress)(cartesian.by);
+function cartesianToAddress({ ax, ay, bx, by }) {
+    const startColumn = (0, addressOffset_ts_1.columnOffsetToAddress)(ax);
+    const startRow = (0, addressOffset_ts_1.rowOffsetToAddress)(ay);
+    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.");
+    }
+    if (ay > by) {
+        throw new InvalidArgumentError_ts_1.default("Invalid address. End row is before start row.");
+    }
     const address = (0, addressManipulation_ts_1.composeAddress)({
         startRow,
         startColumn,

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

@@ -34,4 +34,10 @@ export declare function isServiceUnavailable(status: number): boolean;
  * @returns True if the status code is 504, otherwise false.
  */
 export declare function isGatewayTimeout(status: number): boolean;
+/**
+ * Checks if the HTTP status code indicates the resource is locked
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 423, otherwise false.
+ */
+export declare function isLocked(status: number): boolean;
 //# sourceMappingURL=httpStatus.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"httpStatus.d.ts","sourceRoot":"","sources":["../../../src/services/httpStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"httpStatus.d.ts","sourceRoot":"","sources":["../../../src/services/httpStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/dist/cjs/services/httpStatus.js

@@ -6,6 +6,7 @@ exports.isHttpNotFound = isHttpNotFound;
 exports.isHttpTooManyRequests = isHttpTooManyRequests;
 exports.isServiceUnavailable = isServiceUnavailable;
 exports.isGatewayTimeout = isGatewayTimeout;
+exports.isLocked = isLocked;
 /**
  * Checks if the HTTP status code indicates a successful response.
  * @param status - The HTTP status code.
@@ -54,3 +55,11 @@ function isServiceUnavailable(status) {
 function isGatewayTimeout(status) {
     return status === 504;
 }
+/**
+ * Checks if the HTTP status code indicates the resource is locked
+ * @param status - The HTTP status code.
+ * @returns True if the status code is 423, otherwise false.
+ */
+function isLocked(status) {
+    return status === 423;
+}

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

@@ -0,0 +1,3 @@
+import type { NumberFormat } from "../models/NumberFormat.ts";
+export declare const generalNumberFormat: NumberFormat;
+//# sourceMappingURL=numberFormat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numberFormat.d.ts","sourceRoot":"","sources":["../../../src/services/numberFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,eAAO,MAAM,mBAAmB,EAAgB,YAAY,CAAC"}

package/dist/cjs/services/numberFormat.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generalNumberFormat = void 0;
+exports.generalNumberFormat = "General";

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

@@ -0,0 +1 @@
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/services/source.ts"],"names":[],"mappings":""}

package/dist/cjs/services/source.js

@@ -0,0 +1,178 @@
+"use strict";
+// import InvalidOperationError from "../errors/InvalidOperationError.ts";
+// import NeverError from "../errors/NeverError.ts";
+// import type { Cell } from "../models/Cell.ts";
+// import type { ColumnName } from "../models/ColumnName.ts";
+// import type { ColumnOffset } from "../models/ColumnOffset.ts";
+// import type { Item } from "../models/Item.ts";
+// import type { RecordBase } from "../models/RecordBase.ts";
+// import type { RowNumber } from "../models/RowNumber.ts";
+// import type { RowOffset } from "../models/RowOffset.ts";
+// import type { Source } from "../models/source.ts";
+// import type { SourceDecoder } from "../models/SourceDecoder.ts";
+// import type { SourceEncoder } from "../models/SourceEncoder.ts";
+// import type { SourceRow } from "../models/SourceRow.ts";
+// import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
+// import deleteWorkbookRange from "../operations/workbookRange/deleteWorkbookRange.ts";
+// import insertWorkbookCells from "../operations/workbookRange/insertWorkbookCells.ts";
+// import setWorkbookRangeFont from "../operations/workbookRange/setWorkbookRangeFont.ts";
+// import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.ts";
+// import getWorkbookWorksheetUsedRangeAddress from "../operations/workbookWorksheet/getWorkbookWorksheetUsedRangeAddress.ts";
+// import iterateWorkbookRange from "../tasks/iterateWorkbookRange.ts";
+// import { countAddressColumns, countAddressRows } from "./addressManipulation.ts";
+// import { rowOffsetToAddress } from "./addressOffset.ts";
+// import { addressToCartesian, cartesianToAddress } from "./cartesianAddress.ts";
+// import { createWorkbookRangeRef } from "./workbookRange.ts";
+// export async function defineSource<T extends RecordBase>(worksheetRef: WorkbookWorksheetRef, decode: SourceDecoder<T>, encode: SourceEncoder<T>): Promise<Source<T>> {
+// 	const usedRange = await getWorkbookWorksheetUsedRangeAddress(worksheetRef);
+// 	const rangeRef = createWorkbookRangeRef(worksheetRef, usedRange);
+// 	const b = addressToCartesian(usedRange);
+// 	// TODO: Header
+// 	const a = await getWorkbookWorksheetRange();
+// 	const source: Source<T> = {
+// 		rangeRef,
+// 		coding: {
+// 			decode,
+// 			encode,
+// 		},
+// 		head: [],
+// 		async *[Symbol.asyncIterator](): AsyncGenerator<Item<T>> {
+// 			let hasHead = false;
+// 			for await (const { rowOffset, row } of iterateWorkbookRange(rangeRef)) {
+// 				if (!hasHead) {
+// 					source.head = row.map((cell) => cell.text) as ColumnName[];
+// 					hasHead = true;
+// 					continue;
+// 				}
+// 				const record = rowToRecord<T>(row, source);
+// 				const rowNumber = rowOffsetToNumber(rowOffset);
+// 				yield {
+// 					rowOffset,
+// 					rowNumber,
+// 					record,
+// 				};
+// 			}
+// 		},
+// 	};
+// 	return source;
+// }
+// export async function initializeSource<T extends RecordBase>(source: Source<T>, empty: T): Promise<void> {
+// 	if (!isEmpty(source)) {
+// 		throw new InvalidOperationError("Cannot initialize source with non-empty worksheet.");
+// 	}
+// 	source.head = Object.keys(empty) as ColumnName[];
+// 	const address = cartesianToAddress({
+// 		ax: 0 as ColumnOffset,
+// 		bx: (source.head.length - 1) as ColumnOffset,
+// 		ay: 0 as RowOffset,
+// 		by: 0 as RowOffset,
+// 	});
+// 	source.rangeRef = createWorkbookRangeRef(source.rangeRef, address);
+// 	await updateWorkbookRange(source.rangeRef, {
+// 		values: [source.head],
+// 	});
+// 	await setWorkbookRangeFont(source.rangeRef, {
+// 		bold: true,
+// 	});
+// }
+// export async function readAllItems<T extends RecordBase>(source: Source<T>): Promise<Item<T>[]> {
+// 	const result: Item<T>[] = [];
+// 	for await (const item of source) {
+// 		result.push(item);
+// 	}
+// 	return result;
+// }
+// export async function createItem<T extends RecordBase>(source: Source<T>, record: T, after: RowOffset = 0 as RowOffset): Promise<Item<T>> {
+// 	if (!isInitialized(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	await insertWorkbookCells(source.rangeRef, rowOffsetToAddress(after), "Down");
+// 	const row = recordToRow(record, source);
+// 	const address = cartesianToAddress({
+// 		ax: 0 as ColumnOffset,
+// 		bx: (row.length - 1) as ColumnOffset,
+// 		ay: after,
+// 		by: after,
+// 	});
+// 	const rangeRef = createWorkbookRangeRef(source.rangeRef, address);
+// 	await updateWorkbookRange(rangeRef, {
+// 		values: [row],
+// 		// TODO: Format
+// 	});
+// 	const { ax, bx, ay, by } = addressToCartesian(source.rangeRef.address);
+// 	source.rangeRef.address = cartesianToAddress({
+// 		ax,
+// 		bx,
+// 		ay,
+// 		by: (by + 1) as RowOffset,
+// 	});
+// 	return {
+// 		rowOffset: after,
+// 		rowNumber: rowOffsetToNumber(after),
+// 		record,
+// 	};
+// }
+// export async function updateItem<T extends RecordBase>(source: Source<T>, offset: RowOffset, record: T): Promise<void> {
+// 	if (!isInitialized(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	const row = recordToRow(record, source);
+// 	const address = cartesianToAddress({
+// 		ax: 0 as ColumnOffset,
+// 		bx: (row.length - 1) as ColumnOffset,
+// 		ay: offset,
+// 		by: offset,
+// 	});
+// 	const rangeRef = createWorkbookRangeRef(source.rangeRef, address);
+// 	await updateWorkbookRange(rangeRef, {
+// 		values: [row],
+// 		// TODO: format
+// 	});
+// }
+// export async function deleteItem<T extends RecordBase>(source: Source<T>, offset: RowOffset): Promise<void> {
+// 	if (!isInitialized(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	const rangeRef = createWorkbookRangeRef(source.rangeRef, rowOffsetToAddress(offset));
+// 	await deleteWorkbookRange(rangeRef, "Up");
+// 	const { ax, bx, ay, by } = addressToCartesian(source.rangeRef.address);
+// 	source.rangeRef.address = cartesianToAddress({
+// 		ax,
+// 		bx,
+// 		ay,
+// 		by: (by - 1) as RowOffset,
+// 	});
+// }
+// function rowToRecord<T extends RecordBase>(row: Cell[], source: Source<T>): T {
+// 	const sourceRow = source.head.reduce((acc, heading, columnIndex) => {
+// 		const cell = row[columnIndex];
+// 		if (!cell) {
+// 			throw new NeverError(`Cell at index ${columnIndex} is undefined`);
+// 		}
+// 		acc[heading] = cell;
+// 		return acc;
+// 	}, {} as SourceRow);
+// 	const record = source.coding.decode(sourceRow);
+// 	return record;
+// }
+// function recordToRow<T extends RecordBase>(record: T, source: Source<T>): Cell[] {
+// 	const sourceRow = source.coding.encode(record);
+// 	const row = source.head.map((heading) => {
+// 		const cell = sourceRow[heading];
+// 		if (cell === undefined) {
+// 			throw new NeverError(`Cell at index ${heading} is undefined`);
+// 		}
+// 		return cell;
+// 	});
+// 	return row;
+// }
+// function rowOffsetToNumber(offset: RowOffset): RowNumber {
+// 	return (offset + 1) as RowNumber;
+// }
+// function isEmpty<T extends RecordBase>(source: Source<T>) {
+// 	return countAddressRows(source.rangeRef.address) <= 1 && countAddressColumns(source.rangeRef.address) <= 1;
+// }
+// function isInitialized<T extends RecordBase>(source: Source<T>) {
+// 	return source.head.length > 0;
+// }
+// // TODO: Tidy Cell/CellValue types

package/dist/cjs/tasks/iterateWorkbookRange.d.ts

@@ -0,0 +1,15 @@
+import type { Cell } from "../models/Cell.ts";
+import type { RowOffset } from "../models/RowOffset.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+/**
+ * Iterates over the values of a workbook range in chunks, fetching data in manageable sizes.
+ *
+ * @param rangeRef - A reference to the workbook range to iterate over.
+ * @param overwriteRowsPerRequest - Optional. The number of rows to fetch per request. If omitted, it is automatically calculated.
+ * @returns An async iterable that yields rows of range values.
+ */
+export default function iterateWorkbookRange(rangeRef: WorkbookRangeRef, overwriteRowsPerRequest?: number | null): AsyncIterable<{
+    rowOffset: RowOffset;
+    row: Cell[];
+}>;
+//# sourceMappingURL=iterateWorkbookRange.d.ts.map

package/dist/cjs/tasks/iterateWorkbookRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AActE;;;;;;GAMG;AACH,wBAA+B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC,CAsDnL"}