@openfn/language-msgraph 0.3.5 → 0.5.0

package/ast.json

@@ -326,6 +326,135 @@
         ]
       },
       "valid": true
+    },
+    {
+      "name": "uploadFile",
+      "params": [
+        "resource",
+        "data",
+        "callback"
+      ],
+      "docs": {
+        "description": "Upload a file to a drive",
+        "tags": [
+          {
+            "title": "public",
+            "description": null,
+            "type": null
+          },
+          {
+            "title": "example",
+            "description": "uploadFile(\n  state => ({\n    driveId: state.driveId,\n    folderId: state.folderId,\n    fileName: `Tracker.xlsx`,\n  }),\n  state => state.buffer\n);",
+            "caption": "Upload Excel file to a drive using `driveId` and `parantItemId`"
+          },
+          {
+            "title": "example",
+            "description": "uploadFile(\n  state => ({\n    siteId: state.siteId,\n    folderId: state.folderId,\n    fileName: `Report.xlsx`,\n  }),\n  state => state.buffer\n);",
+            "caption": "Upload Excel file to a SharePoint drive using `siteId` and `parantItemId`"
+          },
+          {
+            "title": "function",
+            "description": null,
+            "name": null
+          },
+          {
+            "title": "param",
+            "description": "Resource Object",
+            "type": {
+              "type": "NameExpression",
+              "name": "Object"
+            },
+            "name": "resource"
+          },
+          {
+            "title": "param",
+            "description": "Drive Id",
+            "type": {
+              "type": "OptionalType",
+              "expression": {
+                "type": "NameExpression",
+                "name": "String"
+              }
+            },
+            "name": "resource.driveId"
+          },
+          {
+            "title": "param",
+            "description": "Site Id",
+            "type": {
+              "type": "OptionalType",
+              "expression": {
+                "type": "NameExpression",
+                "name": "String"
+              }
+            },
+            "name": "resource.driveId"
+          },
+          {
+            "title": "param",
+            "description": "Parent folder id",
+            "type": {
+              "type": "OptionalType",
+              "expression": {
+                "type": "NameExpression",
+                "name": "String"
+              }
+            },
+            "name": "resource.folderId"
+          },
+          {
+            "title": "param",
+            "description": "Resource content-type",
+            "type": {
+              "type": "OptionalType",
+              "expression": {
+                "type": "NameExpression",
+                "name": "String"
+              }
+            },
+            "name": "resource.contentType"
+          },
+          {
+            "title": "param",
+            "description": "Specify conflict behavior if file with the same name exists. Can be \"rename | fail | replace\"",
+            "type": {
+              "type": "OptionalType",
+              "expression": {
+                "type": "NameExpression",
+                "name": "String"
+              }
+            },
+            "name": "resource.onConflict"
+          },
+          {
+            "title": "param",
+            "description": "A buffer containing the file.",
+            "type": {
+              "type": "NameExpression",
+              "name": "Object"
+            },
+            "name": "data"
+          },
+          {
+            "title": "param",
+            "description": "Optional callback function",
+            "type": {
+              "type": "NameExpression",
+              "name": "Function"
+            },
+            "name": "callback"
+          },
+          {
+            "title": "returns",
+            "description": null,
+            "type": {
+              "type": "NameExpression",
+              "name": "Operation"
+            }
+          }
+        ]
+      },
+      "valid": false
     }
   ],
   "exports": [],
@@ -820,6 +949,83 @@
         ]
       },
       "valid": true
+    },
+    {
+      "name": "cursor",
+      "params": [
+        "value",
+        "options"
+      ],
+      "docs": {
+        "description": "Sets a cursor property on state.\nSupports natural language dates like `now`, `today`, `yesterday`, `n hours ago`, `n days ago`, and `start`,\nwhich will be converted relative to the environment (ie, the Lightning or CLI locale). Custom timezones \nare not yet supported.\nSee the usage guide at @{link https://docs.openfn.org/documentation/jobs/job-writing-guide#using-cursors}",
+        "tags": [
+          {
+            "title": "public",
+            "description": null,
+            "type": null
+          },
+          {
+            "title": "example",
+            "description": "cursor($.cursor, { defaultValue: 'today' })",
+            "caption": "Use a cursor from state if present, or else use the default value"
+          },
+          {
+            "title": "example",
+            "description": "cursor(22)",
+            "caption": "Use a pagination cursor"
+          },
+          {
+            "title": "function",
+            "description": null,
+            "name": null
+          },
+          {
+            "title": "param",
+            "description": "the cursor value. Usually an ISO date, natural language date, or page number",
+            "type": {
+              "type": "NameExpression",
+              "name": "any"
+            },
+            "name": "value"
+          },
+          {
+            "title": "param",
+            "description": "options to control the cursor.",
+            "type": {
+              "type": "NameExpression",
+              "name": "object"
+            },
+            "name": "options"
+          },
+          {
+            "title": "param",
+            "description": "set the cursor key. Will persist through the whole run.",
+            "type": {
+              "type": "NameExpression",
+              "name": "string"
+            },
+            "name": "options.key"
+          },
+          {
+            "title": "param",
+            "description": "the value to use if value is falsy",
+            "type": {
+              "type": "NameExpression",
+              "name": "any"
+            },
+            "name": "options.defaultValue"
+          },
+          {
+            "title": "returns",
+            "description": null,
+            "type": {
+              "type": "NameExpression",
+              "name": "Operation"
+            }
+          }
+        ]
+      },
+      "valid": false
     }
   ]
 }

package/dist/index.cjs

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -14,12 +16,17 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.js
 var src_exports = {};
 __export(src_exports, {
   create: () => create,
+  cursor: () => import_language_common3.cursor,
   dataPath: () => import_language_common3.dataPath,
   dataValue: () => import_language_common3.dataValue,
   dateFns: () => import_language_common3.dateFns,
@@ -37,7 +44,9 @@ __export(src_exports, {
   merge: () => import_language_common3.merge,
   parseCsv: () => import_language_common3.parseCsv,
   request: () => request,
-  sourceValue: () => import_language_common3.sourceValue
+  sheetToBuffer: () => sheetToBuffer,
+  sourceValue: () => import_language_common3.sourceValue,
+  uploadFile: () => uploadFile
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -45,6 +54,7 @@ module.exports = __toCommonJS(src_exports);
 var Adaptor_exports = {};
 __export(Adaptor_exports, {
   create: () => create,
+  cursor: () => import_language_common3.cursor,
   dataPath: () => import_language_common3.dataPath,
   dataValue: () => import_language_common3.dataValue,
   dateFns: () => import_language_common3.dateFns,
@@ -61,15 +71,19 @@ __export(Adaptor_exports, {
   merge: () => import_language_common3.merge,
   parseCsv: () => import_language_common3.parseCsv,
   request: () => request,
-  sourceValue: () => import_language_common3.sourceValue
+  sheetToBuffer: () => sheetToBuffer,
+  sourceValue: () => import_language_common3.sourceValue,
+  uploadFile: () => uploadFile
 });
 var import_language_common2 = require("@openfn/language-common");
-var import_util = require("@openfn/language-common/util");
+var import_util2 = require("@openfn/language-common/util");
 
 // src/Utils.js
+var import_xlsx = __toESM(require("xlsx"), 1);
 var import_undici = require("undici");
 var import_node_stream = require("stream");
 var import_language_common = require("@openfn/language-common");
+var import_util = require("@openfn/language-common/util");
 function assertDrive(state, driveName) {
   if (!state.drives[driveName]) {
     const errorString = [
@@ -80,7 +94,7 @@ function assertDrive(state, driveName) {
     throw new Error(errorString);
   }
 }
-function getUrl(resource, apiVersion) {
+function setUrl(resource, apiVersion) {
   if (isValidHttpUrl(resource))
     return resource;
   const pathSuffix = apiVersion ? `${apiVersion}/${resource}` : `v1.0/${resource}`;
@@ -95,9 +109,6 @@ function isValidHttpUrl(string) {
   }
   return url.protocol === "http:" || url.protocol === "https:";
 }
-function getAuth(token) {
-  return token ? { headers: { Authorization: `Bearer ${token}` } } : null;
-}
 var isStream = (value) => {
   if (value && typeof value == "object") {
     if (value instanceof import_node_stream.Readable || value instanceof import_node_stream.Writable) {
@@ -138,21 +149,22 @@ function handleResponseError(response, data, method) {
     throw new Error(errorString);
   }
 }
-var request = async (urlString, params = {}, method = "GET") => {
-  let url = urlString;
-  const defaultHeaders = { "Content-Type": "application/json" };
-  const { headers, parseAs } = params;
-  const setHeaders = { ...headers, ...defaultHeaders };
-  delete params.parseAs;
-  delete params.headers;
-  let options = {
-    method,
-    headers: setHeaders
-  };
-  if ("GET" === method) {
-    url = `${urlString}?${new URLSearchParams(params).toString()}`;
-  } else {
-    options.body = JSON.stringify(params);
+var defaultOptions = {
+  method: "GET",
+  headers: {
+    "Content-Type": "application/json"
+  },
+  accessToken: ""
+};
+var request = async (path, params) => {
+  let url = path;
+  const options = { ...defaultOptions, ...params };
+  const { parseAs, query, method, accessToken } = options;
+  delete options.parseAs;
+  delete options.accessToken;
+  options.headers["Authorization"] = makeAuthHeader(accessToken);
+  if (method === "GET" && query) {
+    url = `${path}?${new URLSearchParams(query).toString()}`;
   }
   const response = await (0, import_undici.fetch)(url, options);
   const contentType = response.headers.get("Content-Type");
@@ -168,6 +180,41 @@ var request = async (urlString, params = {}, method = "GET") => {
   handleResponseError(response, data, method);
   return data;
 };
+function makeAuthHeader(accessToken) {
+  return accessToken ? `Bearer ${accessToken}` : null;
+}
+var defaultSheetOptions = {
+  bookType: "xlsx",
+  wsName: "Sheet"
+};
+function sheetToBuffer(rows, options, callback) {
+  return (state) => {
+    const resolvedRows = (0, import_language_common.asData)(rows, state);
+    const [resolvedOptions] = (0, import_util.expandReferences)(state, options);
+    const { wsName, bookType } = {
+      ...defaultSheetOptions,
+      ...resolvedOptions
+    };
+    const workbook = import_xlsx.default.utils.book_new();
+    const worksheet = import_xlsx.default.utils.json_to_sheet(resolvedRows);
+    import_xlsx.default.utils.book_append_sheet(workbook, worksheet, wsName);
+    const buffer = import_xlsx.default.write(workbook, { type: "buffer", bookType });
+    console.log(`Creating sheet buffer with bookType '${bookType}'`);
+    const nextState = { ...state, buffer };
+    if (callback)
+      return callback(nextState);
+    return nextState;
+  };
+}
+function assertResources(resources) {
+  const { driveId, siteId, folderId } = resources;
+  if (driveId && siteId)
+    throw new Error('Use either "driveId" or "siteId" not both');
+  if (!driveId && !siteId)
+    throw new Error('"siteId" or "driveId" is required');
+  if (!folderId)
+    throw new Error("Parent Item Id is required");
+}
 
 // src/Adaptor.js
 var import_language_common3 = require("@openfn/language-common");
@@ -178,8 +225,13 @@ function execute(...operations) {
     drives: {}
   };
   const cleanup = (finalState) => {
-    const { drives, ...rest } = finalState;
-    return rest;
+    if (finalState == null ? void 0 : finalState.buffer) {
+      delete finalState.buffer;
+    }
+    if (finalState == null ? void 0 : finalState.drives) {
+      delete finalState.drives;
+    }
+    return finalState;
   };
   return (state) => {
     return (0, import_language_common2.execute)(...operations)({
@@ -193,19 +245,19 @@ function execute(...operations) {
 }
 function create(resource, data, callback) {
   return (state) => {
-    const [resolvedResource, resolvedData] = (0, import_util.expandReferences)(
+    const [resolvedResource, resolvedData] = (0, import_util2.expandReferences)(
       state,
       resource,
       data
     );
     const { accessToken, apiVersion } = state.configuration;
-    const url = getUrl({ apiVersion, resolvedResource });
-    const auth = getAuth(accessToken);
+    const url = setUrl({ apiVersion, resolvedResource });
     const options = {
-      auth,
-      ...resolvedData
+      accessToken,
+      body: JSON.stringify(resolvedData),
+      method: "POST"
     };
-    return request(url, options, "POST").then(
+    return request(url, options).then(
       (response) => handleResponse(response, state, callback)
     );
   };
@@ -213,10 +265,9 @@ function create(resource, data, callback) {
 function get(path, query, callback = false) {
   return (state) => {
     const { accessToken, apiVersion } = state.configuration;
-    const [resolvedPath, resolvedQuery] = (0, import_util.expandReferences)(state, path, query);
-    const url = getUrl(resolvedPath, apiVersion);
-    const auth = getAuth(accessToken);
-    return request(url, { ...resolvedQuery, ...auth }).then(
+    const [resolvedPath, resolvedQuery] = (0, import_util2.expandReferences)(state, path, query);
+    const url = setUrl(resolvedPath, apiVersion);
+    return request(url, { query: resolvedQuery, accessToken }).then(
       (response) => handleResponse(response, state, callback)
     );
   };
@@ -224,7 +275,7 @@ function get(path, query, callback = false) {
 function getDrive(specifier, name = "default", callback = (s) => s) {
   return (state) => {
     const { accessToken, apiVersion } = state.configuration;
-    const [resolvedSpecifier, resolvedName] = (0, import_util.expandReferences)(
+    const [resolvedSpecifier, resolvedName] = (0, import_util2.expandReferences)(
       state,
       specifier,
       name
@@ -236,9 +287,8 @@ function getDrive(specifier, name = "default", callback = (s) => s) {
     } else {
       resource = `${owner}/${id}/drive`;
     }
-    const url = getUrl(resource, apiVersion);
-    const auth = getAuth(accessToken);
-    return request(url, { ...auth }).then((response) => {
+    const url = setUrl(resource, apiVersion);
+    return request(url, { accessToken }).then((response) => {
       state.drives[resolvedName] = response;
       return callback(state);
     });
@@ -246,17 +296,17 @@ function getDrive(specifier, name = "default", callback = (s) => s) {
 }
 function getFolder(pathOrId, options, callback = (s) => s) {
   return async (state) => {
-    const defaultOptions = {
+    const defaultOptions2 = {
       driveName: "default",
       metadata: false
     };
     const { accessToken, apiVersion } = state.configuration;
-    const [resolvedPathOrId, resolvedOptions] = (0, import_util.expandReferences)(
+    const [resolvedPathOrId, resolvedOptions] = (0, import_util2.expandReferences)(
       state,
       pathOrId,
       options
     );
-    const { driveName, metadata } = { ...defaultOptions, ...resolvedOptions };
+    const { driveName, metadata } = { ...defaultOptions2, ...resolvedOptions };
     assertDrive(state, driveName);
     const { id: driveId } = state.drives[driveName];
     let resource;
@@ -270,27 +320,26 @@ function getFolder(pathOrId, options, callback = (s) => s) {
     if (!metadata) {
       resource += resolvedPathOrId.startsWith("/") ? ":/children" : "/children";
     }
-    const url = getUrl(resource, apiVersion);
-    const auth = getAuth(accessToken);
-    return request(url, { ...auth }).then(
+    const url = setUrl(resource, apiVersion);
+    return request(url, { accessToken }).then(
       (response) => handleResponse(response, state, callback)
     );
   };
 }
 function getFile(pathOrId, options, callback = (s) => s) {
-  const defaultOptions = {
+  const defaultOptions2 = {
     driveName: "default",
     metadata: false
   };
   return async (state) => {
     const { accessToken, apiVersion } = state.configuration;
-    const [resolvedPathOrId, resolvedOptions] = (0, import_util.expandReferences)(
+    const [resolvedPathOrId, resolvedOptions] = (0, import_util2.expandReferences)(
       state,
       pathOrId,
       options
     );
     const { driveName, metadata } = {
-      ...defaultOptions,
+      ...defaultOptions2,
       ...resolvedOptions
     };
     assertDrive(state, driveName);
@@ -306,21 +355,67 @@ function getFile(pathOrId, options, callback = (s) => s) {
     if (!metadata) {
       resource += resolvedPathOrId.startsWith("/") ? ":/content" : "/content";
     }
-    const url = getUrl(resource, apiVersion);
-    const auth = getAuth(accessToken);
+    const url = setUrl(resource, apiVersion);
     const response = await request(url, {
-      ...auth,
+      accessToken,
       parseAs: metadata ? "json" : "text"
     });
     return handleResponse(response, state, callback);
   };
 }
+var defaultResource = {
+  contentType: "application/octet-stream",
+  driveId: "",
+  folderId: "",
+  fileName: "sheet.xls",
+  onConflict: "replace"
+};
+function uploadFile(resource, data, callback) {
+  return async (state) => {
+    const { accessToken, apiVersion } = state.configuration;
+    const [resolvedResource, resolvedData] = (0, import_util2.expandReferences)(
+      state,
+      resource,
+      data
+    );
+    const { contentType, driveId, siteId, folderId, onConflict, fileName } = {
+      ...defaultResource,
+      ...resolvedResource
+    };
+    assertResources({ driveId, siteId, folderId });
+    const path = driveId && `drives/${driveId}/items/${folderId}:/${fileName}:/createUploadSession` || siteId && `sites/${siteId}/drive/items/${folderId}:/${fileName}:/createUploadSession`;
+    const uploadSession = await request(setUrl(path, apiVersion), {
+      method: "POST",
+      accessToken,
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        "@microsoft.graph.conflictBehavior": onConflict,
+        name: fileName
+      })
+    });
+    const uploadUrl = uploadSession.uploadUrl;
+    console.log(`Uploading file...`);
+    return request(uploadUrl, {
+      method: "PUT",
+      accessToken,
+      headers: {
+        "Content-Type": contentType,
+        "Content-Length": `${resolvedData.length}`,
+        "Content-Range": `bytes 0-${resolvedData.length - 1}/${resolvedData.length}`
+      },
+      body: resolvedData
+    }).then((response) => handleResponse(response, state, callback));
+  };
+}
 
 // src/index.js
 var src_default = Adaptor_exports;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   create,
+  cursor,
   dataPath,
   dataValue,
   dateFns,
@@ -337,5 +432,7 @@ var src_default = Adaptor_exports;
   merge,
   parseCsv,
   request,
-  sourceValue
+  sheetToBuffer,
+  sourceValue,
+  uploadFile
 });

package/dist/index.js

@@ -8,6 +8,7 @@ var __export = (target, all) => {
 var Adaptor_exports = {};
 __export(Adaptor_exports, {
   create: () => create,
+  cursor: () => cursor,
   dataPath: () => dataPath,
   dataValue: () => dataValue,
   dateFns: () => dateFns,
@@ -24,15 +25,19 @@ __export(Adaptor_exports, {
   merge: () => merge,
   parseCsv: () => parseCsv,
   request: () => request,
-  sourceValue: () => sourceValue
+  sheetToBuffer: () => sheetToBuffer,
+  sourceValue: () => sourceValue,
+  uploadFile: () => uploadFile
 });
 import { execute as commonExecute } from "@openfn/language-common";
-import { expandReferences } from "@openfn/language-common/util";
+import { expandReferences as expandReferences2 } from "@openfn/language-common/util";
 
 // src/Utils.js
+import xlsx from "xlsx";
 import { fetch } from "undici";
 import { Readable, Writable } from "stream";
-import { composeNextState } from "@openfn/language-common";
+import { composeNextState, asData } from "@openfn/language-common";
+import { expandReferences } from "@openfn/language-common/util";
 function assertDrive(state, driveName) {
   if (!state.drives[driveName]) {
     const errorString = [
@@ -43,7 +48,7 @@ function assertDrive(state, driveName) {
     throw new Error(errorString);
   }
 }
-function getUrl(resource, apiVersion) {
+function setUrl(resource, apiVersion) {
   if (isValidHttpUrl(resource))
     return resource;
   const pathSuffix = apiVersion ? `${apiVersion}/${resource}` : `v1.0/${resource}`;
@@ -58,9 +63,6 @@ function isValidHttpUrl(string) {
   }
   return url.protocol === "http:" || url.protocol === "https:";
 }
-function getAuth(token) {
-  return token ? { headers: { Authorization: `Bearer ${token}` } } : null;
-}
 var isStream = (value) => {
   if (value && typeof value == "object") {
     if (value instanceof Readable || value instanceof Writable) {
@@ -101,21 +103,22 @@ function handleResponseError(response, data, method) {
     throw new Error(errorString);
   }
 }
-var request = async (urlString, params = {}, method = "GET") => {
-  let url = urlString;
-  const defaultHeaders = { "Content-Type": "application/json" };
-  const { headers, parseAs } = params;
-  const setHeaders = { ...headers, ...defaultHeaders };
-  delete params.parseAs;
-  delete params.headers;
-  let options = {
-    method,
-    headers: setHeaders
-  };
-  if ("GET" === method) {
-    url = `${urlString}?${new URLSearchParams(params).toString()}`;
-  } else {
-    options.body = JSON.stringify(params);
+var defaultOptions = {
+  method: "GET",
+  headers: {
+    "Content-Type": "application/json"
+  },
+  accessToken: ""
+};
+var request = async (path, params) => {
+  let url = path;
+  const options = { ...defaultOptions, ...params };
+  const { parseAs, query, method, accessToken } = options;
+  delete options.parseAs;
+  delete options.accessToken;
+  options.headers["Authorization"] = makeAuthHeader(accessToken);
+  if (method === "GET" && query) {
+    url = `${path}?${new URLSearchParams(query).toString()}`;
   }
   const response = await fetch(url, options);
   const contentType = response.headers.get("Content-Type");
@@ -131,9 +134,45 @@ var request = async (urlString, params = {}, method = "GET") => {
   handleResponseError(response, data, method);
   return data;
 };
+function makeAuthHeader(accessToken) {
+  return accessToken ? `Bearer ${accessToken}` : null;
+}
+var defaultSheetOptions = {
+  bookType: "xlsx",
+  wsName: "Sheet"
+};
+function sheetToBuffer(rows, options, callback) {
+  return (state) => {
+    const resolvedRows = asData(rows, state);
+    const [resolvedOptions] = expandReferences(state, options);
+    const { wsName, bookType } = {
+      ...defaultSheetOptions,
+      ...resolvedOptions
+    };
+    const workbook = xlsx.utils.book_new();
+    const worksheet = xlsx.utils.json_to_sheet(resolvedRows);
+    xlsx.utils.book_append_sheet(workbook, worksheet, wsName);
+    const buffer = xlsx.write(workbook, { type: "buffer", bookType });
+    console.log(`Creating sheet buffer with bookType '${bookType}'`);
+    const nextState = { ...state, buffer };
+    if (callback)
+      return callback(nextState);
+    return nextState;
+  };
+}
+function assertResources(resources) {
+  const { driveId, siteId, folderId } = resources;
+  if (driveId && siteId)
+    throw new Error('Use either "driveId" or "siteId" not both');
+  if (!driveId && !siteId)
+    throw new Error('"siteId" or "driveId" is required');
+  if (!folderId)
+    throw new Error("Parent Item Id is required");
+}
 
 // src/Adaptor.js
 import {
+  cursor,
   dataPath,
   dataValue,
   dateFns,
@@ -153,8 +192,13 @@ function execute(...operations) {
     drives: {}
   };
   const cleanup = (finalState) => {
-    const { drives, ...rest } = finalState;
-    return rest;
+    if (finalState == null ? void 0 : finalState.buffer) {
+      delete finalState.buffer;
+    }
+    if (finalState == null ? void 0 : finalState.drives) {
+      delete finalState.drives;
+    }
+    return finalState;
   };
   return (state) => {
     return commonExecute(...operations)({
@@ -168,19 +212,19 @@ function execute(...operations) {
 }
 function create(resource, data, callback) {
   return (state) => {
-    const [resolvedResource, resolvedData] = expandReferences(
+    const [resolvedResource, resolvedData] = expandReferences2(
       state,
       resource,
       data
     );
     const { accessToken, apiVersion } = state.configuration;
-    const url = getUrl({ apiVersion, resolvedResource });
-    const auth = getAuth(accessToken);
+    const url = setUrl({ apiVersion, resolvedResource });
     const options = {
-      auth,
-      ...resolvedData
+      accessToken,
+      body: JSON.stringify(resolvedData),
+      method: "POST"
     };
-    return request(url, options, "POST").then(
+    return request(url, options).then(
       (response) => handleResponse(response, state, callback)
     );
   };
@@ -188,10 +232,9 @@ function create(resource, data, callback) {
 function get(path, query, callback = false) {
   return (state) => {
     const { accessToken, apiVersion } = state.configuration;
-    const [resolvedPath, resolvedQuery] = expandReferences(state, path, query);
-    const url = getUrl(resolvedPath, apiVersion);
-    const auth = getAuth(accessToken);
-    return request(url, { ...resolvedQuery, ...auth }).then(
+    const [resolvedPath, resolvedQuery] = expandReferences2(state, path, query);
+    const url = setUrl(resolvedPath, apiVersion);
+    return request(url, { query: resolvedQuery, accessToken }).then(
       (response) => handleResponse(response, state, callback)
     );
   };
@@ -199,7 +242,7 @@ function get(path, query, callback = false) {
 function getDrive(specifier, name = "default", callback = (s) => s) {
   return (state) => {
     const { accessToken, apiVersion } = state.configuration;
-    const [resolvedSpecifier, resolvedName] = expandReferences(
+    const [resolvedSpecifier, resolvedName] = expandReferences2(
       state,
       specifier,
       name
@@ -211,9 +254,8 @@ function getDrive(specifier, name = "default", callback = (s) => s) {
     } else {
       resource = `${owner}/${id}/drive`;
     }
-    const url = getUrl(resource, apiVersion);
-    const auth = getAuth(accessToken);
-    return request(url, { ...auth }).then((response) => {
+    const url = setUrl(resource, apiVersion);
+    return request(url, { accessToken }).then((response) => {
       state.drives[resolvedName] = response;
       return callback(state);
     });
@@ -221,17 +263,17 @@ function getDrive(specifier, name = "default", callback = (s) => s) {
 }
 function getFolder(pathOrId, options, callback = (s) => s) {
   return async (state) => {
-    const defaultOptions = {
+    const defaultOptions2 = {
       driveName: "default",
       metadata: false
     };
     const { accessToken, apiVersion } = state.configuration;
-    const [resolvedPathOrId, resolvedOptions] = expandReferences(
+    const [resolvedPathOrId, resolvedOptions] = expandReferences2(
       state,
       pathOrId,
       options
     );
-    const { driveName, metadata } = { ...defaultOptions, ...resolvedOptions };
+    const { driveName, metadata } = { ...defaultOptions2, ...resolvedOptions };
     assertDrive(state, driveName);
     const { id: driveId } = state.drives[driveName];
     let resource;
@@ -245,27 +287,26 @@ function getFolder(pathOrId, options, callback = (s) => s) {
     if (!metadata) {
       resource += resolvedPathOrId.startsWith("/") ? ":/children" : "/children";
     }
-    const url = getUrl(resource, apiVersion);
-    const auth = getAuth(accessToken);
-    return request(url, { ...auth }).then(
+    const url = setUrl(resource, apiVersion);
+    return request(url, { accessToken }).then(
       (response) => handleResponse(response, state, callback)
     );
   };
 }
 function getFile(pathOrId, options, callback = (s) => s) {
-  const defaultOptions = {
+  const defaultOptions2 = {
     driveName: "default",
     metadata: false
   };
   return async (state) => {
     const { accessToken, apiVersion } = state.configuration;
-    const [resolvedPathOrId, resolvedOptions] = expandReferences(
+    const [resolvedPathOrId, resolvedOptions] = expandReferences2(
       state,
       pathOrId,
       options
     );
     const { driveName, metadata } = {
-      ...defaultOptions,
+      ...defaultOptions2,
       ...resolvedOptions
     };
     assertDrive(state, driveName);
@@ -281,20 +322,66 @@ function getFile(pathOrId, options, callback = (s) => s) {
     if (!metadata) {
       resource += resolvedPathOrId.startsWith("/") ? ":/content" : "/content";
     }
-    const url = getUrl(resource, apiVersion);
-    const auth = getAuth(accessToken);
+    const url = setUrl(resource, apiVersion);
     const response = await request(url, {
-      ...auth,
+      accessToken,
       parseAs: metadata ? "json" : "text"
     });
     return handleResponse(response, state, callback);
   };
 }
+var defaultResource = {
+  contentType: "application/octet-stream",
+  driveId: "",
+  folderId: "",
+  fileName: "sheet.xls",
+  onConflict: "replace"
+};
+function uploadFile(resource, data, callback) {
+  return async (state) => {
+    const { accessToken, apiVersion } = state.configuration;
+    const [resolvedResource, resolvedData] = expandReferences2(
+      state,
+      resource,
+      data
+    );
+    const { contentType, driveId, siteId, folderId, onConflict, fileName } = {
+      ...defaultResource,
+      ...resolvedResource
+    };
+    assertResources({ driveId, siteId, folderId });
+    const path = driveId && `drives/${driveId}/items/${folderId}:/${fileName}:/createUploadSession` || siteId && `sites/${siteId}/drive/items/${folderId}:/${fileName}:/createUploadSession`;
+    const uploadSession = await request(setUrl(path, apiVersion), {
+      method: "POST",
+      accessToken,
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        "@microsoft.graph.conflictBehavior": onConflict,
+        name: fileName
+      })
+    });
+    const uploadUrl = uploadSession.uploadUrl;
+    console.log(`Uploading file...`);
+    return request(uploadUrl, {
+      method: "PUT",
+      accessToken,
+      headers: {
+        "Content-Type": contentType,
+        "Content-Length": `${resolvedData.length}`,
+        "Content-Range": `bytes 0-${resolvedData.length - 1}/${resolvedData.length}`
+      },
+      body: resolvedData
+    }).then((response) => handleResponse(response, state, callback));
+  };
+}
 
 // src/index.js
 var src_default = Adaptor_exports;
 export {
   create,
+  cursor,
   dataPath,
   dataValue,
   dateFns,
@@ -312,5 +399,7 @@ export {
   merge,
   parseCsv,
   request,
-  sourceValue
+  sheetToBuffer,
+  sourceValue,
+  uploadFile
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-msgraph",
-  "version": "0.3.5",
+  "version": "0.5.0",
   "description": "Microsoft Graph Language Pack for OpenFn",
   "type": "module",
   "exports": {
@@ -20,10 +20,10 @@
   ],
   "dependencies": {
     "undici": "^5.22.1",
-    "@openfn/language-common": "1.11.0"
+    "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.0/xlsx-0.20.0.tgz",
+    "@openfn/language-common": "1.13.0"
   },
   "devDependencies": {
-    "@openfn/buildtools": "^1.0.2",
     "@openfn/simple-ast": "0.4.1",
     "assertion-error": "2.0.0",
     "chai": "4.3.6",

package/types/Adaptor.d.ts

@@ -79,5 +79,46 @@ export function getFolder(pathOrId: string, options: object, callback?: Function
  * @return {Operation}
  */
 export function getFile(pathOrId: string, options: object, callback?: Function): Operation;
-export { request } from "./Utils";
-export { dataPath, dataValue, dateFns, each, field, fields, fn, lastReferenceValue, merge, sourceValue, parseCsv } from "@openfn/language-common";
+/**
+ * Upload a file to a drive
+ * @public
+ * @example
+ * <caption>Upload Excel file to a drive using `driveId` and `parantItemId`</caption>
+ * uploadFile(
+ *   state => ({
+ *     driveId: state.driveId,
+ *     folderId: state.folderId,
+ *     fileName: `Tracker.xlsx`,
+ *   }),
+ *   state => state.buffer
+ * );
+ * @example
+ * <caption>Upload Excel file to a SharePoint drive using `siteId` and `parantItemId`</caption>
+ * uploadFile(
+ *   state => ({
+ *     siteId: state.siteId,
+ *     folderId: state.folderId,
+ *     fileName: `Report.xlsx`,
+ *   }),
+ *   state => state.buffer
+ * );
+ * @function
+ * @param {Object} resource - Resource Object
+ * @param {String} [resource.driveId] - Drive Id
+ * @param {String} [resource.driveId] - Site Id
+ * @param {String} [resource.folderId] - Parent folder id
+ * @param {String} [resource.contentType] - Resource content-type
+ * @param {String} [resource.onConflict] - Specify conflict behavior if file with the same name exists. Can be "rename | fail | replace"
+ * @param {Object} data - A buffer containing the file.
+ * @param {Function} callback - Optional callback function
+ * @returns {Operation}
+ */
+export function uploadFile(resource: {
+    driveId?: string;
+    driveId?: string;
+    folderId?: string;
+    contentType?: string;
+    onConflict?: string;
+}, data: any, callback: Function): Operation;
+export { request, sheetToBuffer } from "./Utils";
+export { cursor, dataPath, dataValue, dateFns, each, field, fields, fn, lastReferenceValue, merge, sourceValue, parseCsv } from "@openfn/language-common";

package/types/Utils.d.ts

@@ -1,10 +1,27 @@
 export function assertDrive(state: any, driveName: any): void;
-export function getUrl(resource: any, apiVersion: any): any;
-export function getAuth(token: any): {
-    headers: {
-        Authorization: string;
-    };
-};
+export function setUrl(resource: any, apiVersion: any): any;
 export function handleResponse(response: any, state: any, callback: any): any;
 export function handleResponseError(response: any, data: any, method: any): void;
-export function request(urlString: any, params?: object, method?: string): Promise<unknown>;
+/**
+ * The function `sheetToBuffer` takes in rows, options and optional callback, It creates a workbook
+ * and worksheet using the rows, appends the worksheet to the workbook, and returns the workbook as a
+ * buffer.
+ * @public
+ * @example
+ * <caption>Create a buffer containing excel file with `xlsx` output format  </caption>
+ * sheetToBuffer('$.data[*]', {
+ *  wsName: 'Invalid Grant Codes',
+ *  bookType: 'xlsx',
+ * });
+ * @param rows - The `rows` parameter is an array of objects representing the data to be written to the
+ * Excel sheet. Each object in the array represents a row in the sheet, and the keys of the object
+ * represent the column headers. The values of the object represent the data in each cell of the row.
+ * @param options - The `options` parameter is an object that contains additional configuration options
+ * @param {String} [options.wsName] - Worksheet name i.e 32 Characters
+ * @param {String} [options.bookType] - File format of the exported file, Default is 'xlsx'. See {@link https://docs.sheetjs.com/docs/api/write-options/#supported-output-formats here}
+ * for the function. It can have the following properties:
+ * @returns a buffer containing the Excel file in `state.buffer`.
+ */
+export function sheetToBuffer(rows: any, options: any, callback: any): (state: any) => any;
+export function assertResources(resources: any): void;
+export function request(path: any, params: any): Promise<unknown>;