microsoft-graph 1.0.7 → 2.0.0

package/dist/services/accessToken.js

@@ -1,15 +1,15 @@
 import { ClientSecretCredential } from "@azure/identity";
-import { azureClientIdEnv, azureClientSecretEnv, azureTenantIdEnv } from "./configuration.js";
 const innerTokenCache = {};
-/** Get an access token for a given scope. If an unexpired one is cached it will be returned, otherwise requests a new one. */
-export async function getCurrentAccessToken(scope) {
-    let innerToken = innerTokenCache[scope];
+/** Get an access token for a given client and scope. If an unexpired one is cached it will be returned, otherwise requests a new one. */
+export async function getCurrentAccessToken(tenantId, clientId, clientSecret, scope) {
+    const cacheKey = createCacheKey(tenantId, clientId, scope);
+    let innerToken = innerTokenCache[cacheKey];
     if (!innerToken || innerToken.expiresOnTimestamp < Date.now()) {
-        const azureTenantId = azureTenantIdEnv();
-        const azureClientId = azureClientIdEnv();
-        const azureClientSecret = azureClientSecretEnv();
-        const credential = new ClientSecretCredential(azureTenantId, azureClientId, azureClientSecret);
-        innerTokenCache[scope] = innerToken = await credential.getToken(scope);
+        const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
+        innerTokenCache[cacheKey] = innerToken = await credential.getToken(scope);
     }
     return innerToken.token;
 }
+function createCacheKey(tenantId, clientId, scope) {
+    return `${tenantId}/${clientId}/${scope}`;
+}

package/dist/services/context.d.ts

@@ -0,0 +1,13 @@
+import type { ClientId } from "../models/ClientId.ts";
+import type { ClientSecret } from "../models/ClientSecret.ts";
+import type { Context } from "../models/Context.ts";
+import type { ContextId } from "../models/ContextId.ts";
+import type { ContextRef } from "../models/ContextRef.ts";
+import type { HttpProxy } from "../models/HttpProxy.ts";
+import type { TenantId } from "../models/TenantId.ts";
+/** Register a tenant/client so that it's secret can be used latter. */
+export declare function register(tenantId: TenantId, clientId: ClientId, clientSecret: ClientSecret, httpProxy?: HttpProxy | undefined): ContextRef;
+export declare function getContext(contextId: ContextId): Context;
+/** Opinionated method of getting default context reference. Not recommended for production use. */
+export declare function getDefaultContextRef(): ContextRef;
+//# sourceMappingURL=context.d.ts.map

package/dist/services/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/services/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAe1I;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAMxD;AAaD,mGAAmG;AACnG,wBAAgB,oBAAoB,IAAI,UAAU,CASjD"}

package/dist/services/context.js

@@ -0,0 +1,41 @@
+import ContextNotRegisteredError from "../errors/ContextNotRegisteredError.js";
+import { getEnvironmentVariable } from "./environmentVariable.js";
+import { generateRandomString } from "./random.js";
+const contexts = {};
+/** Register a tenant/client so that it's secret can be used latter. */
+export function register(tenantId, clientId, clientSecret, httpProxy) {
+    const contextId = generateContextId();
+    const context = {
+        tenantId,
+        clientId,
+        clientSecret,
+        httpProxy
+    };
+    contexts[contextId] = context;
+    const contextRef = createContextRef(contextId);
+    return contextRef;
+}
+export function getContext(contextId) {
+    const context = contexts[contextId];
+    if (!context) {
+        throw new ContextNotRegisteredError(`Context with ID ${contextId} is not registered`);
+    }
+    return context;
+}
+function generateContextId() {
+    return generateRandomString(16);
+}
+function createContextRef(contextId) {
+    return {
+        contextId
+    };
+}
+/** Opinionated method of getting default context reference. Not recommended for production use. */
+export function getDefaultContextRef() {
+    const tenantId = getEnvironmentVariable("AZURE_TENANT_ID");
+    const clientId = getEnvironmentVariable("AZURE_CLIENT_ID");
+    const clientSecret = getEnvironmentVariable("AZURE_CLIENT_SECRET");
+    const httpProxy = (getEnvironmentVariable("HTTP_PROXY", "") || undefined);
+    const contextRef = register(tenantId, clientId, clientSecret, httpProxy);
+    return contextRef;
+}

package/dist/services/drive.d.ts

@@ -1,6 +1,7 @@
 import type { DriveId } from "../models/DriveId.ts";
 import type { DriveRef } from "../models/DriveRef.ts";
 import type { SiteRef } from "../models/SiteRef.ts";
-export declare function driveRef(siteRef: SiteRef, driveId: DriveId | undefined): DriveRef;
+export declare function createDriveRef(siteRef: SiteRef, driveId: DriveId | undefined): DriveRef;
+/** Opinionated method of getting default drive reference. Not recommended for production use. */
 export declare function getDefaultDriveRef(): DriveRef;
 //# sourceMappingURL=drive.d.ts.map

package/dist/services/drive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drive.d.ts","sourceRoot":"","sources":["../../src/services/drive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CASjF;AAED,wBAAgB,kBAAkB,IAAI,QAAQ,CAK7C"}
+{"version":3,"file":"drive.d.ts","sourceRoot":"","sources":["../../src/services/drive.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAMpD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAUvF;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,IAAI,QAAQ,CAa7C"}

package/dist/services/drive.js

@@ -1,17 +1,27 @@
 import ProtocolError from "../errors/ProtocolError.js";
-import { defaultDriveIdEnv, defaultSiteIdEnv } from "./configuration.js";
-export function driveRef(siteRef, driveId) {
+import { register } from "./context.js";
+import { getEnvironmentVariable } from "./environmentVariable.js";
+import { createSiteRef } from "./site.js";
+export function createDriveRef(siteRef, driveId) {
     if (!driveId) {
         throw new ProtocolError("DriveID is missing");
     }
     return {
+        contextId: siteRef.contextId,
         siteId: siteRef.siteId,
         driveId,
     };
 }
+/** Opinionated method of getting default drive reference. Not recommended for production use. */
 export function getDefaultDriveRef() {
-    return {
-        siteId: defaultSiteIdEnv(),
-        driveId: defaultDriveIdEnv()
-    };
+    const tenantId = getEnvironmentVariable("AZURE_TENANT_ID");
+    const clientId = getEnvironmentVariable("AZURE_CLIENT_ID");
+    const clientSecret = getEnvironmentVariable("AZURE_CLIENT_SECRET");
+    const siteId = getEnvironmentVariable("SHAREPOINT_DEFAULT_SITE_ID");
+    const driveId = getEnvironmentVariable("SHAREPOINT_DEFAULT_DRIVE_ID");
+    const httpProxy = (getEnvironmentVariable("HTTP_PROXY", "") || undefined);
+    const contextRef = register(tenantId, clientId, clientSecret, httpProxy);
+    const siteRef = createSiteRef(contextRef, siteId);
+    const driveRef = createDriveRef(siteRef, driveId);
+    return driveRef;
 }

package/dist/services/driveItem.d.ts

@@ -6,5 +6,5 @@ export declare const workbookFileExtension = "xlsx";
 export declare const rootDriveItemPath: DriveItemPath;
 /** Create a drive item path from a given set of segments. Ie ["a","b"] => "/a/b" */
 export declare function driveItemPath(...segments: string[]): DriveItemPath;
-export declare function driveItemRef(driveRef: DriveRef, itemId: DriveItemId | undefined): DriveItemRef;
+export declare function createDriveItemRef(driveRef: DriveRef, itemId: DriveItemId | undefined): DriveItemRef;
 //# sourceMappingURL=driveItem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../src/services/driveItem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAUtD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,eAAO,MAAM,iBAAiB,eAAqB,CAAC;AAEpD,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAkClE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAU9F"}
+{"version":3,"file":"driveItem.d.ts","sourceRoot":"","sources":["../../src/services/driveItem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAUtD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,eAAO,MAAM,iBAAiB,eAAqB,CAAC;AAEpD,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAkClE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAWpG"}

package/dist/services/driveItem.js

@@ -36,11 +36,12 @@ export function driveItemPath(...segments) {
     }
     return path;
 }
-export function driveItemRef(driveRef, itemId) {
+export function createDriveItemRef(driveRef, itemId) {
     if (!itemId) {
         throw new ProtocolError("ItemID is missing");
     }
     return {
+        contextId: driveRef.contextId,
         siteId: driveRef.siteId,
         driveId: driveRef.driveId,
         itemId

package/dist/services/environmentVariable.d.ts

@@ -0,0 +1,3 @@
+export declare function getEnvironmentVariable(env: string, fallbackValue?: string | null): unknown;
+export declare function bindEnvironmentVariable(env: string, fallbackValue?: string | null): () => unknown;
+//# sourceMappingURL=environmentVariable.d.ts.map

package/dist/services/environmentVariable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environmentVariable.d.ts","sourceRoot":"","sources":["../../src/services/environmentVariable.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAWhG;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,OAAO,CAEvG"}

package/dist/services/environmentVariable.js

@@ -0,0 +1,14 @@
+import EnvironmentVariableMissingError from "../errors/EnvironmentVariableMissingError.js";
+export function getEnvironmentVariable(env, fallbackValue = null) {
+    const value = process.env[env]?.trim() ?? "";
+    if (value === "") {
+        if (fallbackValue === null) {
+            throw new EnvironmentVariableMissingError(env);
+        }
+        return fallbackValue ?? "";
+    }
+    return value;
+}
+export function bindEnvironmentVariable(env, fallbackValue = null) {
+    return () => getEnvironmentVariable(env, fallbackValue);
+}

package/dist/services/httpAgent.d.ts

@@ -1,3 +1,4 @@
-import { HttpProxyAgent } from "http-proxy-agent";
-export declare function getHttpAgent(): HttpProxyAgent<string> | undefined;
+import { HttpsProxyAgent } from "https-proxy-agent";
+import type { HttpProxy } from "../models/HttpProxy.ts";
+export declare function tryGetHttpAgent(httpProxy: HttpProxy | undefined): HttpsProxyAgent<string> | undefined;
 //# sourceMappingURL=httpAgent.d.ts.map

package/dist/services/httpAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"httpAgent.d.ts","sourceRoot":"","sources":["../../src/services/httpAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,YAAY,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,CAOjE"}
+{"version":3,"file":"httpAgent.d.ts","sourceRoot":"","sources":["../../src/services/httpAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,SAAS,CAKrG"}

package/dist/services/httpAgent.js

@@ -1,9 +1,7 @@
-import { HttpProxyAgent } from "http-proxy-agent";
-import { httpProxyEnv } from "./configuration.js";
-export function getHttpAgent() {
-    const httpProxy = httpProxyEnv();
+import { HttpsProxyAgent } from "https-proxy-agent";
+export function tryGetHttpAgent(httpProxy) {
     if (!httpProxy) {
         return undefined;
     }
-    return new HttpProxyAgent(httpProxy);
+    return new HttpsProxyAgent(httpProxy);
 }

package/dist/services/random.d.ts

@@ -0,0 +1,2 @@
+export declare function generateRandomString(length?: number): string;
+//# sourceMappingURL=random.d.ts.map

package/dist/services/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/services/random.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,MAAM,SAAK,GAAG,MAAM,CAOxD"}

package/dist/services/random.js

@@ -0,0 +1,9 @@
+const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+export function generateRandomString(length = 16) {
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        const randomIndex = Math.floor(Math.random() * characters.length);
+        result += characters[randomIndex];
+    }
+    return result;
+}

package/dist/services/site.d.ts

@@ -1,5 +1,7 @@
+import type { ContextRef } from "../models/ContextRef.ts";
 import type { SiteId } from "../models/SiteId.ts";
 import type { SiteRef } from "../models/SiteRef.ts";
-export declare function siteRef(siteId: SiteId | undefined): SiteRef;
+export declare function createSiteRef(contextRef: ContextRef, siteId: SiteId | undefined): SiteRef;
+/** Opinionated method of getting default site reference. Not recommended for production use. */
 export declare function getDefaultSiteRef(): SiteRef;
 //# sourceMappingURL=site.d.ts.map

package/dist/services/site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/services/site.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAQ3D;AAGD,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/services/site.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CASzF;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}

package/dist/services/site.js

@@ -1,15 +1,19 @@
 import ProtocolError from "../errors/ProtocolError.js";
-import { defaultSiteIdEnv } from "./configuration.js";
-export function siteRef(siteId) {
+import { getDefaultContextRef, } from "./context.js";
+import { getEnvironmentVariable } from "./environmentVariable.js";
+export function createSiteRef(contextRef, siteId) {
     if (!siteId) {
         throw new ProtocolError("SiteID is missing");
     }
     return {
+        contextId: contextRef.contextId,
         siteId
     };
 }
+/** Opinionated method of getting default site reference. Not recommended for production use. */
 export function getDefaultSiteRef() {
-    return {
-        siteId: defaultSiteIdEnv(),
-    };
+    const contextRef = getDefaultContextRef();
+    const siteId = getEnvironmentVariable("SHAREPOINT_DEFAULT_SITE_ID");
+    const siteRef = createSiteRef(contextRef, siteId);
+    return siteRef;
 }

package/dist/services/temporaryFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"temporaryFiles.d.ts","sourceRoot":"","sources":["../../src/services/temporaryFiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,MAAM,GAAG,IAAY,GAAG,aAAa,CAUpF"}
+{"version":3,"file":"temporaryFiles.d.ts","sourceRoot":"","sources":["../../src/services/temporaryFiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,MAAM,GAAG,IAAY,GAAG,aAAa,CAGpF"}

package/dist/services/temporaryFiles.js

@@ -1,11 +1,5 @@
+import { generateRandomString } from "./random.js";
 export function generateTempFileName(extension = "tmp") {
-    const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-    const charactersLength = characters.length;
-    const length = 16;
-    let result = '';
-    for (let i = 0; i < length; i++) {
-        const randomIndex = Math.floor(Math.random() * charactersLength);
-        result += characters[randomIndex];
-    }
-    return `~${result}.${extension}`;
+    const body = generateRandomString(16);
+    return `~${body}.${extension}`;
 }

package/dist/services/workbookRange.d.ts

@@ -1,5 +1,5 @@
 import type { WorkbookRangeAddressUnderlying } from "../models/WorkbookRangeAddress.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
-export declare function workbookRangeRef(worksheetRef: WorkbookWorksheetRef, address: WorkbookRangeAddressUnderlying): WorkbookRangeRef;
+export declare function createWorkbookRangeRef(worksheetRef: WorkbookWorksheetRef, address: WorkbookRangeAddressUnderlying): WorkbookRangeRef;
 //# sourceMappingURL=workbookRange.d.ts.map

package/dist/services/workbookRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbookRange.d.ts","sourceRoot":"","sources":["../../src/services/workbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAwB,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAC9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,8BAA8B,GAAG,gBAAgB,CAS9H"}
+{"version":3,"file":"workbookRange.d.ts","sourceRoot":"","sources":["../../src/services/workbookRange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAwB,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAC9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,8BAA8B,GAAG,gBAAgB,CAUpI"}

package/dist/services/workbookRange.js

@@ -1,5 +1,6 @@
-export function workbookRangeRef(worksheetRef, address) {
+export function createWorkbookRangeRef(worksheetRef, address) {
     return {
+        contextId: worksheetRef.contextId,
         siteId: worksheetRef.siteId,
         driveId: worksheetRef.driveId,
         itemId: worksheetRef.itemId,

package/dist/services/workbookRangeAddress.d.ts

@@ -1,3 +1,3 @@
 import type { WorkbookRangeAddress, WorkbookRangeAddressUnderlying } from "../models/WorkbookRangeAddress.ts";
-export declare function workbookRangeAddress(address: WorkbookRangeAddressUnderlying): WorkbookRangeAddress;
+export declare function createWorkbookRangeAddress(address: WorkbookRangeAddressUnderlying): WorkbookRangeAddress;
 //# sourceMappingURL=workbookRangeAddress.d.ts.map

package/dist/services/workbookRangeAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbookRangeAddress.d.ts","sourceRoot":"","sources":["../../src/services/workbookRangeAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAI9G,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,8BAA8B,GAAG,oBAAoB,CAMlG"}
+{"version":3,"file":"workbookRangeAddress.d.ts","sourceRoot":"","sources":["../../src/services/workbookRangeAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAI9G,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,8BAA8B,GAAG,oBAAoB,CAMxG"}

package/dist/services/workbookRangeAddress.js

@@ -1,6 +1,6 @@
 import InvalidArgumentError from "../errors/InvalidArgumentError.js";
 const addressPattern = /^[A-Z]+\d+(:[A-Z]+\d+)?$/;
-export function workbookRangeAddress(address) {
+export function createWorkbookRangeAddress(address) {
     if (!addressPattern.test(address)) {
         throw new InvalidArgumentError(`Invalid address format. It must match the pattern ${addressPattern}.`);
     }

package/dist/services/workbookTable.d.ts

@@ -1,5 +1,5 @@
 import type { WorkbookTableId } from "../models/WorkbookTableId.ts";
 import type { WorkbookTableRef } from "../models/WorkbookTableRef.ts";
 import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
-export declare function workbookTableRef(worksheetRef: WorkbookWorksheetRef, tableId: WorkbookTableId | undefined): WorkbookTableRef;
+export declare function createWorkbookTableRef(worksheetRef: WorkbookWorksheetRef, tableId: WorkbookTableId | undefined): WorkbookTableRef;
 //# sourceMappingURL=workbookTable.d.ts.map

package/dist/services/workbookTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbookTable.d.ts","sourceRoot":"","sources":["../../src/services/workbookTable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,gBAAgB,CAY3H"}
+{"version":3,"file":"workbookTable.d.ts","sourceRoot":"","sources":["../../src/services/workbookTable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,gBAAgB,CAajI"}

package/dist/services/workbookTable.js

@@ -1,8 +1,9 @@
-export function workbookTableRef(worksheetRef, tableId) {
+export function createWorkbookTableRef(worksheetRef, tableId) {
     if (!tableId) {
         throw new Error("TableId is missing");
     }
     return {
+        contextId: worksheetRef.contextId,
         siteId: worksheetRef.siteId,
         driveId: worksheetRef.driveId,
         itemId: worksheetRef.itemId,

package/dist/services/workbookWorksheet.d.ts

@@ -2,5 +2,5 @@ import type { WorkbookRef } from "../models/WorkbookRef.ts";
 import type { WorkbookWorksheetId } from "../models/WorkbookWorksheetId.ts";
 import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
 export declare const defaultWorkbookWorksheetId: WorkbookWorksheetId;
-export declare function workbookWorksheetRef(workbookRef: WorkbookRef, worksheetId: WorkbookWorksheetId | undefined): WorkbookWorksheetRef;
+export declare function createWorkbookWorksheetRef(workbookRef: WorkbookRef, worksheetId: WorkbookWorksheetId | undefined): WorkbookWorksheetRef;
 //# sourceMappingURL=workbookWorksheet.d.ts.map

package/dist/services/workbookWorksheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbookWorksheet.d.ts","sourceRoot":"","sources":["../../src/services/workbookWorksheet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,eAAO,MAAM,0BAA0B,EAA+C,mBAAmB,CAAC;AAE1G,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,oBAAoB,CAYjI"}
+{"version":3,"file":"workbookWorksheet.d.ts","sourceRoot":"","sources":["../../src/services/workbookWorksheet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,eAAO,MAAM,0BAA0B,EAA+C,mBAAmB,CAAC;AAE1G,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,oBAAoB,CAavI"}

package/dist/services/workbookWorksheet.js

@@ -1,9 +1,10 @@
 export const defaultWorkbookWorksheetId = "{00000000-0001-0000-0000-000000000000}"; // Program Manager in Microsoft Office Extensibility team says this ID is used for the first sheet of all workbooks by design, but not documented. https://github.com/OfficeDev/office-js/issues/552#issuecomment-800841930
-export function workbookWorksheetRef(workbookRef, worksheetId) {
+export function createWorkbookWorksheetRef(workbookRef, worksheetId) {
     if (!worksheetId) {
         throw new Error("WorksheetID is missing");
     }
     return {
+        contextId: workbookRef.contextId,
         siteId: workbookRef.siteId,
         driveId: workbookRef.driveId,
         itemId: workbookRef.itemId,

package/dist/tasks/getRangeLastUsedCell.test.js

@@ -6,8 +6,8 @@ import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange
 import { getDefaultDriveRef } from "../services/drive.js";
 import { driveItemPath } from "../services/driveItem.js";
 import { generateTempFileName } from "../services/temporaryFiles.js";
-import { workbookRangeRef } from "../services/workbookRange.js";
-import { defaultWorkbookWorksheetId, workbookWorksheetRef } from "../services/workbookWorksheet.js";
+import { createWorkbookRangeRef } from "../services/workbookRange.js";
+import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../services/workbookWorksheet.js";
 import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
 import getRangeLastUsedCell from "./getRangeLastUsedCell.js";
 describe("getRangeLastUsedCell", () => {
@@ -16,8 +16,8 @@ describe("getRangeLastUsedCell", () => {
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
-        const worksheetRef = workbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = workbookRangeRef(worksheetRef, "A1:B2");
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             await sequential(updateWorkbookRange(rangeRef, {
                 values: [
@@ -43,8 +43,8 @@ describe("getRangeLastUsedCell", () => {
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
-        const worksheetRef = workbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = workbookRangeRef(worksheetRef, "A1:B2");
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             await sequential(updateWorkbookRange(rangeRef, {
                 values: [
@@ -70,8 +70,8 @@ describe("getRangeLastUsedCell", () => {
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
-        const worksheetRef = workbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
-        const rangeRef = workbookRangeRef(worksheetRef, "A1:B2");
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:B2");
         try {
             await sequential(updateWorkbookRange(rangeRef, {
                 values: [

package/dist/tasks/getWorkbookTableVisibleBody.test.js

@@ -7,7 +7,7 @@ import createWorkbookWorksheet from "../operations/workbookWorksheet/createWorkb
 import { getDefaultDriveRef } from "../services/drive.js";
 import { driveItemPath } from "../services/driveItem.js";
 import { generateTempFileName } from "../services/temporaryFiles.js";
-import { workbookRangeRef } from "../services/workbookRange.js";
+import { createWorkbookRangeRef } from "../services/workbookRange.js";
 import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
 import { getWorkbookTableVisibleBody } from "./getWorkbookTableVisibleBody.js";
 describe("getWorkbookTableVisibleBody", () => {
@@ -18,7 +18,7 @@ describe("getWorkbookTableVisibleBody", () => {
         const workbook = await createWorkbook(driveRef, workbookPath);
         try {
             const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             await updateWorkbookRange(rangeRef, {
                 values: [
@@ -47,7 +47,7 @@ describe("getWorkbookTableVisibleBody", () => {
         const workbook = await createWorkbook(driveRef, workbookPath);
         try {
             const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             await updateWorkbookRange(rangeRef, {
                 values: [
@@ -57,7 +57,7 @@ describe("getWorkbookTableVisibleBody", () => {
                     ["Value9", "Value10", "Value11", "Value12"]
                 ]
             });
-            const hiddenRange = workbookRangeRef(worksheet, "2:2");
+            const hiddenRange = createWorkbookRangeRef(worksheet, "2:2");
             await updateWorkbookRange(hiddenRange, { rowHidden: true });
             await calculateWorkbook(workbook);
             const visibleBodyRange = await getWorkbookTableVisibleBody(table);
@@ -77,7 +77,7 @@ describe("getWorkbookTableVisibleBody", () => {
         const workbook = await createWorkbook(driveRef, workbookPath);
         try {
             const worksheet = await createWorkbookWorksheet(workbook);
-            const rangeRef = workbookRangeRef(worksheet, "A1:D4");
+            const rangeRef = createWorkbookRangeRef(worksheet, "A1:D4");
             const table = await createWorkbookTable(rangeRef, true);
             await updateWorkbookRange(rangeRef, {
                 values: [
@@ -87,7 +87,7 @@ describe("getWorkbookTableVisibleBody", () => {
                     ["Value9", "Value10", "Value11", "Value12"]
                 ]
             });
-            const hiddenRange = workbookRangeRef(worksheet, "B:B");
+            const hiddenRange = createWorkbookRangeRef(worksheet, "B:B");
             await updateWorkbookRange(hiddenRange, { columnHidden: true });
             await calculateWorkbook(workbook);
             const visibleBodyRange = await getWorkbookTableVisibleBody(table);

package/dist/tasks/setColumnHidden.test.js

@@ -6,8 +6,8 @@ import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange
 import { getDefaultDriveRef } from "../services/drive.js";
 import { driveItemPath, } from "../services/driveItem.js";
 import { generateTempFileName } from "../services/temporaryFiles.js";
-import { workbookRangeRef } from "../services/workbookRange.js";
-import { defaultWorkbookWorksheetId, workbookWorksheetRef } from "../services/workbookWorksheet.js";
+import { createWorkbookRangeRef } from "../services/workbookRange.js";
+import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../services/workbookWorksheet.js";
 import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
 import setColumnHidden from "./setColumnHidden.js";
 describe("setColumnHidden", () => {
@@ -16,9 +16,9 @@ describe("setColumnHidden", () => {
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
-        const worksheetRef = workbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
         try {
-            const rangeRef = workbookRangeRef(worksheetRef, "A1:C3");
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
             await updateWorkbookRange(rangeRef, {
                 values: [
                     [1, 2, 3],
@@ -26,7 +26,7 @@ describe("setColumnHidden", () => {
                     [7, 8, 9]
                 ]
             });
-            const hiddenRange = workbookRangeRef(worksheetRef, "B:B");
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "B:B");
             await setColumnHidden(hiddenRange, true);
             await calculateWorkbook(workbook);
             const visibleView = await getWorkbookVisibleRange(rangeRef);

package/dist/tasks/setRowHidden.test.js

@@ -6,8 +6,8 @@ import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange
 import { getDefaultDriveRef } from "../services/drive.js";
 import { driveItemPath, } from "../services/driveItem.js";
 import { generateTempFileName } from "../services/temporaryFiles.js";
-import { workbookRangeRef } from "../services/workbookRange.js";
-import { defaultWorkbookWorksheetId, workbookWorksheetRef } from "../services/workbookWorksheet.js";
+import { createWorkbookRangeRef } from "../services/workbookRange.js";
+import { createWorkbookWorksheetRef, defaultWorkbookWorksheetId } from "../services/workbookWorksheet.js";
 import deleteDriveItemWithRetry from "./deleteDriveItemWithRetry.js";
 import setRowHidden from "./setRowHidden.js";
 describe("setRowHidden", () => {
@@ -16,9 +16,9 @@ describe("setRowHidden", () => {
         const workbookPath = driveItemPath(workbookName);
         const driveRef = getDefaultDriveRef();
         const workbook = await createWorkbook(driveRef, workbookPath);
-        const worksheetRef = workbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
+        const worksheetRef = createWorkbookWorksheetRef(workbook, defaultWorkbookWorksheetId);
         try {
-            const rangeRef = workbookRangeRef(worksheetRef, "A1:C3");
+            const rangeRef = createWorkbookRangeRef(worksheetRef, "A1:C3");
             await updateWorkbookRange(rangeRef, {
                 values: [
                     [1, 2, 3],
@@ -26,7 +26,7 @@ describe("setRowHidden", () => {
                     [7, 8, 9]
                 ]
             });
-            const hiddenRange = workbookRangeRef(worksheetRef, "2:2");
+            const hiddenRange = createWorkbookRangeRef(worksheetRef, "2:2");
             await setRowHidden(hiddenRange, true);
             await calculateWorkbook(workbook);
             const visibleView = await getWorkbookVisibleRange(rangeRef);