@openfn/language-asana 3.0.1 → 3.2.0

package/README.md

@@ -16,6 +16,7 @@ definition.
 Using Asana's API requires having an API token. To generate that token, head to
 the [Asana developer console](https://app.asana.com/0/developer-console) and
 enter the **Personal access tokens** section.
+[For API Reference docs](https://developers.asana.com/docs/api-explorer)
 
 There you can click on **+New access token**. A prompt will be opened allowing
 you to give the token a name and then create it.

package/ast.json

@@ -17,7 +17,7 @@
           },
           {
             "title": "example",
-            "description": "getTask(\"taskGid\",\n {\n   opt_fields: \"name,notes,assignee\"\n })"
+            "description": "getTask(\"1206933955023739\", {\n  opt_fields: \"name,notes,assignee\",\n});"
           },
           {
             "title": "function",
@@ -80,7 +80,7 @@
           },
           {
             "title": "example",
-            "description": "getTasks(\"projectGid\",\n {\n   opt_fields: \"name,notes,assignee\"\n })"
+            "description": "getTasks(\"1206933955023739\", {\n  opt_fields: \"name,notes,assignee\",\n});"
           },
           {
             "title": "function",
@@ -143,7 +143,7 @@
           },
           {
             "title": "example",
-            "description": "updateTask(\"taskGid\",\n {\n   name: 'test', \"approval_status\": \"pending\", \"assignee\": \"12345\"\n }\n)"
+            "description": "updateTask(\"1206933955023739\", {\n  name: \"test\",\n  approval_status: \"pending\",\n  assignee: \"12345\",\n});"
           },
           {
             "title": "function",
@@ -205,7 +205,7 @@
           },
           {
             "title": "example",
-            "description": "createTask(\n {\n   name: 'test', \"approval_status\": \"pending\", \"assignee\": \"12345\"\n }\n)"
+            "description": "createTask({\n  name: \"test\",\n  approval_status: \"pending\",\n  assignee: \"12345\",\n  projects: [\"1206933955023739\"],\n});"
           },
           {
             "title": "function",
@@ -259,7 +259,7 @@
           },
           {
             "title": "example",
-            "description": "upsertTask(\n \"1201382240880\",\n {\n   \"externalId\": \"name\",\n   \"data\": {\n     name: 'test', \"approval_status\": \"pending\", \"assignee\": \"12345\"\n   }\n\n }\n)"
+            "description": "upsertTask(\"1201382240880\", {\n  externalId: \"name\",\n  data: {\n    name: \"test\",\n    approval_status: \"pending\",\n    projects: [\"1201382240880\"],\n    assignee: \"12345\",\n  },\n});"
           },
           {
             "title": "function",
@@ -724,6 +724,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

@@ -19,23 +19,26 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.js
 var src_exports = {};
 __export(src_exports, {
-  alterState: () => import_language_common2.alterState,
+  alterState: () => import_language_common3.alterState,
   createTask: () => createTask,
-  dataPath: () => import_language_common2.dataPath,
-  dataValue: () => import_language_common2.dataValue,
-  dateFns: () => import_language_common2.dateFns,
+  createTaskStory: () => createTaskStory,
+  cursor: () => import_language_common3.cursor,
+  dataPath: () => import_language_common3.dataPath,
+  dataValue: () => import_language_common3.dataValue,
+  dateFns: () => import_language_common3.dateFns,
   default: () => src_default,
-  each: () => import_language_common2.each,
+  each: () => import_language_common3.each,
   execute: () => execute,
-  field: () => import_language_common2.field,
-  fields: () => import_language_common2.fields,
-  fn: () => import_language_common2.fn,
+  field: () => import_language_common3.field,
+  fields: () => import_language_common3.fields,
+  fn: () => import_language_common3.fn,
   getTask: () => getTask,
   getTasks: () => getTasks,
-  http: () => import_language_common2.http,
-  lastReferenceValue: () => import_language_common2.lastReferenceValue,
-  merge: () => import_language_common2.merge,
-  sourceValue: () => import_language_common2.sourceValue,
+  http: () => import_language_common3.http,
+  lastReferenceValue: () => import_language_common3.lastReferenceValue,
+  merge: () => import_language_common3.merge,
+  request: () => request2,
+  sourceValue: () => import_language_common3.sourceValue,
   updateTask: () => updateTask,
   upsertTask: () => upsertTask
 });
@@ -44,34 +47,74 @@ module.exports = __toCommonJS(src_exports);
 // src/Adaptor.js
 var Adaptor_exports = {};
 __export(Adaptor_exports, {
-  alterState: () => import_language_common2.alterState,
+  alterState: () => import_language_common3.alterState,
   createTask: () => createTask,
-  dataPath: () => import_language_common2.dataPath,
-  dataValue: () => import_language_common2.dataValue,
-  dateFns: () => import_language_common2.dateFns,
-  each: () => import_language_common2.each,
+  createTaskStory: () => createTaskStory,
+  cursor: () => import_language_common3.cursor,
+  dataPath: () => import_language_common3.dataPath,
+  dataValue: () => import_language_common3.dataValue,
+  dateFns: () => import_language_common3.dateFns,
+  each: () => import_language_common3.each,
   execute: () => execute,
-  field: () => import_language_common2.field,
-  fields: () => import_language_common2.fields,
-  fn: () => import_language_common2.fn,
+  field: () => import_language_common3.field,
+  fields: () => import_language_common3.fields,
+  fn: () => import_language_common3.fn,
   getTask: () => getTask,
   getTasks: () => getTasks,
-  http: () => import_language_common2.http,
-  lastReferenceValue: () => import_language_common2.lastReferenceValue,
-  merge: () => import_language_common2.merge,
-  sourceValue: () => import_language_common2.sourceValue,
+  http: () => import_language_common3.http,
+  lastReferenceValue: () => import_language_common3.lastReferenceValue,
+  merge: () => import_language_common3.merge,
+  request: () => request2,
+  sourceValue: () => import_language_common3.sourceValue,
   updateTask: () => updateTask,
   upsertTask: () => upsertTask
 });
-var import_language_common = require("@openfn/language-common");
 var import_language_common2 = require("@openfn/language-common");
+var import_util2 = require("@openfn/language-common/util");
+
+// src/Utils.js
+var import_language_common = require("@openfn/language-common");
+var import_util = require("@openfn/language-common/util");
+function addAuth(headers, configuration = {}) {
+  const { token } = configuration;
+  if (token) {
+    Object.assign(headers, { Authorization: `Bearer ${token}` });
+  }
+}
+function request(state, path, params, callback = (s) => s) {
+  var _a;
+  let { body, headers = {}, method = "GET", ...rest } = params;
+  const baseUrl = `https://app.asana.com/api/${(_a = state.configuration) == null ? void 0 : _a.apiVersion}`;
+  addAuth(headers, state.configuration);
+  const options = {
+    ...rest,
+    headers,
+    baseUrl,
+    body
+  };
+  return (0, import_util.request)(method, path, options).then((response) => {
+    (0, import_util.logResponse)(response);
+    const { body: body2, ...responseWithoutBody } = response;
+    return {
+      ...(0, import_language_common.composeNextState)(state, body2 == null ? void 0 : body2.data),
+      response: responseWithoutBody
+    };
+  }).then(callback).catch((err) => {
+    console.log("Asana says:");
+    (0, import_util.logResponse)(err);
+    throw err;
+  });
+}
+
+// src/Adaptor.js
+var import_language_common3 = require("@openfn/language-common");
 function execute(...operations) {
   const initialState = {
     references: [],
     data: null
   };
   return (state) => {
-    return (0, import_language_common.execute)(...operations)({
+    return (0, import_language_common2.execute)(...operations)({
       ...initialState,
       ...state
     });
@@ -79,129 +122,123 @@ function execute(...operations) {
 }
 function getTask(taskGid, params, callback) {
   return (state) => {
-    const resolvedTaskGid = (0, import_language_common.expandReferences)(taskGid)(state);
-    const { opt_fields } = (0, import_language_common.expandReferences)(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/${resolvedTaskGid}`;
-    const config = {
-      url,
-      headers: { Authorization: `Bearer ${token}` },
-      params: {
-        opt_fields
-      }
-    };
-    return import_language_common.http.get(config)(state).then((response) => {
-      const nextState = {
-        ...(0, import_language_common.composeNextState)(state, response.data),
-        response
-      };
-      if (callback)
-        return callback(nextState);
-      return nextState;
-    });
+    const [resolvedTaskGid, resolvedParams] = (0, import_util2.expandReferences)(
+      state,
+      taskGid,
+      params
+    );
+    return request(
+      state,
+      `tasks/${resolvedTaskGid}`,
+      { query: resolvedParams },
+      callback
+    );
   };
 }
 function getTasks(projectGid, params, callback) {
   return (state) => {
-    const resolvedProjectGid = (0, import_language_common.expandReferences)(projectGid)(state);
-    const { opt_fields } = (0, import_language_common.expandReferences)(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/projects/${resolvedProjectGid}/tasks`;
-    const config = {
-      url,
-      headers: { Authorization: `Bearer ${token}` },
-      params: {
-        opt_fields
-      }
-    };
-    return import_language_common.http.get(config)(state).then((response) => {
-      const nextState = {
-        ...(0, import_language_common.composeNextState)(state, response.data),
-        response
-      };
-      if (callback)
-        return callback(nextState);
-      return nextState;
-    });
+    const [resolvedProjectGid, resolvedParams] = (0, import_util2.expandReferences)(
+      state,
+      projectGid,
+      params
+    );
+    return request(
+      state,
+      `projects/${resolvedProjectGid}/tasks`,
+      { query: resolvedParams },
+      callback
+    );
   };
 }
 function updateTask(taskGid, params, callback) {
   return (state) => {
-    const resolvedTaskGid = (0, import_language_common.expandReferences)(taskGid)(state);
-    const resolvedParams = (0, import_language_common.expandReferences)(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/${resolvedTaskGid}/`;
-    const config = {
-      url,
-      data: { data: resolvedParams },
-      headers: { Authorization: `Bearer ${token}` }
-    };
-    return import_language_common.http.put(config)(state).then((response) => {
-      const nextState = {
-        ...(0, import_language_common.composeNextState)(state, response.data),
-        response
-      };
-      if (callback)
-        return callback(nextState);
-      return nextState;
-    }).catch((e) => {
-      console.log("Asana says:", e.response.data);
-      throw e;
-    });
+    const [resolvedTaskGid, resolvedParams] = (0, import_util2.expandReferences)(
+      state,
+      taskGid,
+      params
+    );
+    return request(
+      state,
+      `tasks/${resolvedTaskGid}`,
+      { body: { data: resolvedParams }, method: "PUT" },
+      callback
+    );
   };
 }
 function createTask(params, callback) {
   return (state) => {
-    const resolvedParams = (0, import_language_common.expandReferences)(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/`;
-    const config = {
-      url,
-      data: { data: resolvedParams },
-      headers: { Authorization: `Bearer ${token}` }
-    };
-    return import_language_common.http.post(config)(state).then((response) => {
-      const nextState = {
-        ...(0, import_language_common.composeNextState)(state, response.data),
-        response
-      };
-      if (callback)
-        return callback(nextState);
-      return nextState;
-    }).catch((e) => {
-      console.log("Asana says:", e.response.data);
-      throw e;
-    });
+    const [resolvedParams] = (0, import_util2.expandReferences)(state, params);
+    return request(
+      state,
+      "tasks",
+      { body: { data: resolvedParams }, method: "POST" },
+      callback
+    );
   };
 }
 function upsertTask(projectGid, params, callback) {
   return (state) => {
-    const resolvedProjectGid = (0, import_language_common.expandReferences)(projectGid)(state);
-    const { externalId, data } = (0, import_language_common.expandReferences)(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/projects/${resolvedProjectGid}/tasks`;
-    const config = {
-      url,
-      headers: { Authorization: `Bearer ${token}` },
-      params: {
-        opt_fields: `${externalId}`
+    const [resolvedProjectGid, { externalId, data }] = (0, import_util2.expandReferences)(
+      state,
+      projectGid,
+      params
+    );
+    return request(
+      state,
+      `projects/${resolvedProjectGid}/tasks`,
+      { query: { opt_fields: `${externalId}` } },
+      (next) => {
+        const matchingTask = next.data.find(
+          (task) => task[externalId] === data[externalId]
+        );
+        if (matchingTask) {
+          console.log("Matching task found. Performing update.");
+          console.log("Data to update", data);
+          const { projects, workspace, ...remainingData } = data;
+          return updateTask(matchingTask.gid, remainingData, callback)(state);
+        } else {
+          console.log("No matching task found. Performing create.");
+          return createTask(data, callback)(state);
+        }
       }
-    };
-    return import_language_common.http.get(config)(state).then((response) => {
-      const matchingTask = response.data.data.find(
-        (task) => task[externalId] === data[externalId]
-      );
-      if (matchingTask) {
-        console.log("Matching task found. Performing update.");
-        console.log("Data to update", data);
-        delete data.projects;
-        delete data.workspace;
-        return updateTask(matchingTask.gid, data, callback)(state);
-      } else {
-        console.log("No matching task found. Performing create.");
-        return createTask(data, callback)(state);
+    );
+  };
+}
+function createTaskStory(taskGid, params, callback) {
+  return (state) => {
+    const [
+      resolvedTaskGid,
+      {
+        text,
+        html_text,
+        sticker_name,
+        is_pinned = false,
+        opt_pretty = false,
+        opt_fields = []
       }
-    });
+    ] = (0, import_util2.expandReferences)(state, taskGid, params);
+    const story = { text, html_text, is_pinned, sticker_name };
+    return request(
+      state,
+      `tasks/${resolvedTaskGid}/stories`,
+      {
+        body: { data: story },
+        query: { opt_fields, opt_pretty },
+        method: "POST"
+      },
+      callback
+    );
+  };
+}
+function request2(path, params, callback) {
+  return (state) => {
+    const [resolvedPath, { body = {}, query = {}, method = "GET" }] = (0, import_util2.expandReferences)(state, path, params);
+    return request(
+      state,
+      resolvedPath,
+      { method, body, query },
+      callback
+    );
   };
 }
 
@@ -211,6 +248,8 @@ var src_default = Adaptor_exports;
 0 && (module.exports = {
   alterState,
   createTask,
+  createTaskStory,
+  cursor,
   dataPath,
   dataValue,
   dateFns,
@@ -224,6 +263,7 @@ var src_default = Adaptor_exports;
   http,
   lastReferenceValue,
   merge,
+  request,
   sourceValue,
   updateTask,
   upsertTask

package/dist/index.js

@@ -9,6 +9,8 @@ var Adaptor_exports = {};
 __export(Adaptor_exports, {
   alterState: () => alterState,
   createTask: () => createTask,
+  createTaskStory: () => createTaskStory,
+  cursor: () => cursor,
   dataPath: () => dataPath,
   dataValue: () => dataValue,
   dateFns: () => dateFns,
@@ -19,21 +21,58 @@ __export(Adaptor_exports, {
   fn: () => fn,
   getTask: () => getTask,
   getTasks: () => getTasks,
-  http: () => http2,
+  http: () => http,
   lastReferenceValue: () => lastReferenceValue,
   merge: () => merge,
+  request: () => request2,
   sourceValue: () => sourceValue,
   updateTask: () => updateTask,
   upsertTask: () => upsertTask
 });
+import { execute as commonExecute } from "@openfn/language-common";
+import { expandReferences } from "@openfn/language-common/util";
+
+// src/Utils.js
+import { composeNextState } from "@openfn/language-common";
 import {
-  execute as commonExecute,
-  composeNextState,
-  expandReferences,
-  http
-} from "@openfn/language-common";
+  request as commonRequest,
+  logResponse
+} from "@openfn/language-common/util";
+function addAuth(headers, configuration = {}) {
+  const { token } = configuration;
+  if (token) {
+    Object.assign(headers, { Authorization: `Bearer ${token}` });
+  }
+}
+function request(state, path, params, callback = (s) => s) {
+  var _a;
+  let { body, headers = {}, method = "GET", ...rest } = params;
+  const baseUrl = `https://app.asana.com/api/${(_a = state.configuration) == null ? void 0 : _a.apiVersion}`;
+  addAuth(headers, state.configuration);
+  const options = {
+    ...rest,
+    headers,
+    baseUrl,
+    body
+  };
+  return commonRequest(method, path, options).then((response) => {
+    logResponse(response);
+    const { body: body2, ...responseWithoutBody } = response;
+    return {
+      ...composeNextState(state, body2 == null ? void 0 : body2.data),
+      response: responseWithoutBody
+    };
+  }).then(callback).catch((err) => {
+    console.log("Asana says:");
+    logResponse(err);
+    throw err;
+  });
+}
+
+// src/Adaptor.js
 import {
   alterState,
+  cursor,
   dataPath,
   dataValue,
   dateFns,
@@ -41,7 +80,7 @@ import {
   field,
   fields,
   fn,
-  http as http2,
+  http,
   lastReferenceValue,
   merge,
   sourceValue
@@ -60,129 +99,123 @@ function execute(...operations) {
 }
 function getTask(taskGid, params, callback) {
   return (state) => {
-    const resolvedTaskGid = expandReferences(taskGid)(state);
-    const { opt_fields } = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/${resolvedTaskGid}`;
-    const config = {
-      url,
-      headers: { Authorization: `Bearer ${token}` },
-      params: {
-        opt_fields
-      }
-    };
-    return http.get(config)(state).then((response) => {
-      const nextState = {
-        ...composeNextState(state, response.data),
-        response
-      };
-      if (callback)
-        return callback(nextState);
-      return nextState;
-    });
+    const [resolvedTaskGid, resolvedParams] = expandReferences(
+      state,
+      taskGid,
+      params
+    );
+    return request(
+      state,
+      `tasks/${resolvedTaskGid}`,
+      { query: resolvedParams },
+      callback
+    );
   };
 }
 function getTasks(projectGid, params, callback) {
   return (state) => {
-    const resolvedProjectGid = expandReferences(projectGid)(state);
-    const { opt_fields } = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/projects/${resolvedProjectGid}/tasks`;
-    const config = {
-      url,
-      headers: { Authorization: `Bearer ${token}` },
-      params: {
-        opt_fields
-      }
-    };
-    return http.get(config)(state).then((response) => {
-      const nextState = {
-        ...composeNextState(state, response.data),
-        response
-      };
-      if (callback)
-        return callback(nextState);
-      return nextState;
-    });
+    const [resolvedProjectGid, resolvedParams] = expandReferences(
+      state,
+      projectGid,
+      params
+    );
+    return request(
+      state,
+      `projects/${resolvedProjectGid}/tasks`,
+      { query: resolvedParams },
+      callback
+    );
   };
 }
 function updateTask(taskGid, params, callback) {
   return (state) => {
-    const resolvedTaskGid = expandReferences(taskGid)(state);
-    const resolvedParams = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/${resolvedTaskGid}/`;
-    const config = {
-      url,
-      data: { data: resolvedParams },
-      headers: { Authorization: `Bearer ${token}` }
-    };
-    return http.put(config)(state).then((response) => {
-      const nextState = {
-        ...composeNextState(state, response.data),
-        response
-      };
-      if (callback)
-        return callback(nextState);
-      return nextState;
-    }).catch((e) => {
-      console.log("Asana says:", e.response.data);
-      throw e;
-    });
+    const [resolvedTaskGid, resolvedParams] = expandReferences(
+      state,
+      taskGid,
+      params
+    );
+    return request(
+      state,
+      `tasks/${resolvedTaskGid}`,
+      { body: { data: resolvedParams }, method: "PUT" },
+      callback
+    );
   };
 }
 function createTask(params, callback) {
   return (state) => {
-    const resolvedParams = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/`;
-    const config = {
-      url,
-      data: { data: resolvedParams },
-      headers: { Authorization: `Bearer ${token}` }
-    };
-    return http.post(config)(state).then((response) => {
-      const nextState = {
-        ...composeNextState(state, response.data),
-        response
-      };
-      if (callback)
-        return callback(nextState);
-      return nextState;
-    }).catch((e) => {
-      console.log("Asana says:", e.response.data);
-      throw e;
-    });
+    const [resolvedParams] = expandReferences(state, params);
+    return request(
+      state,
+      "tasks",
+      { body: { data: resolvedParams }, method: "POST" },
+      callback
+    );
   };
 }
 function upsertTask(projectGid, params, callback) {
   return (state) => {
-    const resolvedProjectGid = expandReferences(projectGid)(state);
-    const { externalId, data } = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/projects/${resolvedProjectGid}/tasks`;
-    const config = {
-      url,
-      headers: { Authorization: `Bearer ${token}` },
-      params: {
-        opt_fields: `${externalId}`
+    const [resolvedProjectGid, { externalId, data }] = expandReferences(
+      state,
+      projectGid,
+      params
+    );
+    return request(
+      state,
+      `projects/${resolvedProjectGid}/tasks`,
+      { query: { opt_fields: `${externalId}` } },
+      (next) => {
+        const matchingTask = next.data.find(
+          (task) => task[externalId] === data[externalId]
+        );
+        if (matchingTask) {
+          console.log("Matching task found. Performing update.");
+          console.log("Data to update", data);
+          const { projects, workspace, ...remainingData } = data;
+          return updateTask(matchingTask.gid, remainingData, callback)(state);
+        } else {
+          console.log("No matching task found. Performing create.");
+          return createTask(data, callback)(state);
+        }
       }
-    };
-    return http.get(config)(state).then((response) => {
-      const matchingTask = response.data.data.find(
-        (task) => task[externalId] === data[externalId]
-      );
-      if (matchingTask) {
-        console.log("Matching task found. Performing update.");
-        console.log("Data to update", data);
-        delete data.projects;
-        delete data.workspace;
-        return updateTask(matchingTask.gid, data, callback)(state);
-      } else {
-        console.log("No matching task found. Performing create.");
-        return createTask(data, callback)(state);
+    );
+  };
+}
+function createTaskStory(taskGid, params, callback) {
+  return (state) => {
+    const [
+      resolvedTaskGid,
+      {
+        text,
+        html_text,
+        sticker_name,
+        is_pinned = false,
+        opt_pretty = false,
+        opt_fields = []
       }
-    });
+    ] = expandReferences(state, taskGid, params);
+    const story = { text, html_text, is_pinned, sticker_name };
+    return request(
+      state,
+      `tasks/${resolvedTaskGid}/stories`,
+      {
+        body: { data: story },
+        query: { opt_fields, opt_pretty },
+        method: "POST"
+      },
+      callback
+    );
+  };
+}
+function request2(path, params, callback) {
+  return (state) => {
+    const [resolvedPath, { body = {}, query = {}, method = "GET" }] = expandReferences(state, path, params);
+    return request(
+      state,
+      resolvedPath,
+      { method, body, query },
+      callback
+    );
   };
 }
 
@@ -191,6 +224,8 @@ var src_default = Adaptor_exports;
 export {
   alterState,
   createTask,
+  createTaskStory,
+  cursor,
   dataPath,
   dataValue,
   dateFns,
@@ -202,9 +237,10 @@ export {
   fn,
   getTask,
   getTasks,
-  http2 as http,
+  http,
   lastReferenceValue,
   merge,
+  request2 as request,
   sourceValue,
   updateTask,
   upsertTask

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-asana",
-  "version": "3.0.1",
+  "version": "3.2.0",
   "description": "An adaptor to access objects in Asana",
   "homepage": "https://docs.openfn.org",
   "repository": {
@@ -23,10 +23,9 @@
     "configuration-schema.json"
   ],
   "dependencies": {
-    "@openfn/language-common": "^1.8.1"
+    "@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

@@ -15,10 +15,9 @@ export function execute(...operations: Operations): Operation;
  * Get a single task of a given project.
  * @public
  * @example
- * getTask("taskGid",
- *  {
- *    opt_fields: "name,notes,assignee"
- *  })
+ * getTask("1206933955023739", {
+ *   opt_fields: "name,notes,assignee",
+ * });
  * @function
  * @param {string} taskGid - Globally unique identifier for the task
  * @param {object} params - Query params to include.
@@ -30,10 +29,9 @@ export function getTask(taskGid: string, params: object, callback: Function): Op
  * Get the list of tasks for a given project.
  * @public
  * @example
- * getTasks("projectGid",
- *  {
- *    opt_fields: "name,notes,assignee"
- *  })
+ * getTasks("1206933955023739", {
+ *   opt_fields: "name,notes,assignee",
+ * });
  * @function
  * @param {string} projectGid - Globally unique identifier for the project
  * @param {object} params - Query params to include.
@@ -45,11 +43,11 @@ export function getTasks(projectGid: string, params: object, callback: Function)
  * Update a specific task.
  * @public
  * @example
- * updateTask("taskGid",
- *  {
- *    name: 'test', "approval_status": "pending", "assignee": "12345"
- *  }
- * )
+ * updateTask("1206933955023739", {
+ *   name: "test",
+ *   approval_status: "pending",
+ *   assignee: "12345",
+ * });
  * @function
  * @param {string} taskGid - Globally unique identifier for the task
  * @param {object} params - Body parameters
@@ -61,11 +59,12 @@ export function updateTask(taskGid: string, params: object, callback: Function):
  * Create a task.
  * @public
  * @example
- * createTask(
- *  {
- *    name: 'test', "approval_status": "pending", "assignee": "12345"
- *  }
- * )
+ * createTask({
+ *   name: "test",
+ *   approval_status: "pending",
+ *   assignee: "12345",
+ *   projects: ["1206933955023739"],
+ * });
  * @function
  * @param {object} params - Body parameters
  * @param {function} callback - (Optional) callback function
@@ -76,16 +75,15 @@ export function createTask(params: object, callback: Function): Operation;
  * Update or create a task.
  * @public
  * @example
- * upsertTask(
- *  "1201382240880",
- *  {
- *    "externalId": "name",
- *    "data": {
- *      name: 'test', "approval_status": "pending", "assignee": "12345"
- *    }
- *
- *  }
- * )
+ * upsertTask("1201382240880", {
+ *   externalId: "name",
+ *   data: {
+ *     name: "test",
+ *     approval_status: "pending",
+ *     projects: ["1201382240880"],
+ *     assignee: "12345",
+ *   },
+ * });
  * @function
  * @param {string} projectGid - Globally unique identifier for the project
  * @param {object} params - an object with an externalId and some task data.
@@ -93,4 +91,100 @@ export function createTask(params: object, callback: Function): Operation;
  * @returns {Operation}
  */
 export function upsertTask(projectGid: string, params: object, callback: Function): Operation;
-export { alterState, dataPath, dataValue, dateFns, each, field, fields, fn, http, lastReferenceValue, merge, sourceValue } from "@openfn/language-common";
+/**
+ * Options provided to the createTaskStory request
+ * @typedef {Object} StoryOptions
+ * @property {string} text - The plain text of the comment to add. Cannot be used with html_text.
+ * @property {string} html_text - Opt In. HTML formatted text for a comment. This will not include the name of the creator.
+ * @property {boolean} is_pinned - Default to `false`. Whether the story should be pinned on the resource.
+ * @property {string} sticker_name - The name of the sticker in this story. `null` if there is no sticker.
+ * @property {array} opt_fields - Opt In. This endpoint returns a compact resource, which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
+ * @property {boolean} opt_pretty - Defaults to `false`. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
+ */
+/**
+ * Create a story to a specific task.
+ * @public
+ * @example <caption>Create a plain text comment</caption>
+ * createTaskStory("1206933955023739", {
+ *   text: "This is a comment",
+ * });
+ * @example <caption>Create a HTML formatted text comment</caption>
+ * createTaskStory("1206933955023739", {
+ *   html_text: "<body>This is a comment</body>",
+ * });
+ * @function
+ * @param {string} taskGid - Globally unique identifier for the task
+ * @param {StoryOptions} params - Story parameters
+ * @param {function} callback - (Optional) callback function
+ * @returns {Operation}
+ */
+export function createTaskStory(taskGid: string, params: StoryOptions, callback: Function): Operation;
+/**
+ * Options provided to the Asana API request
+ * @typedef {Object} RequestOptions
+ * @property {object} body - Body data to append to the request.
+ * @property {object} query - An object of query parameters to be encoded into the URL.
+ * @property {string} method - The HTTP method to use. Defaults to `GET`
+ */
+/**
+ * Make a request in Asana API
+ * @public
+ * @example
+ * request("/asanaEndpoint", {
+ *   method: "POST",
+ *   query: { foo: "bar", a: 1 },
+ * });
+ * @function
+ * @param {string} path - Path to resource
+ * @param {RequestOptions} params - Query, body and method parameters
+ * @param {function} callback - (Optional) Callback function
+ * @returns {Operation}
+ */
+export function request(path: string, params: RequestOptions, callback: Function): Operation;
+/**
+ * Options provided to the createTaskStory request
+ */
+export type StoryOptions = {
+    /**
+     * - The plain text of the comment to add. Cannot be used with html_text.
+     */
+    text: string;
+    /**
+     * - Opt In. HTML formatted text for a comment. This will not include the name of the creator.
+     */
+    html_text: string;
+    /**
+     * - Default to `false`. Whether the story should be pinned on the resource.
+     */
+    is_pinned: boolean;
+    /**
+     * - The name of the sticker in this story. `null` if there is no sticker.
+     */
+    sticker_name: string;
+    /**
+     * - Opt In. This endpoint returns a compact resource, which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
+     */
+    opt_fields: any[];
+    /**
+     * - Defaults to `false`. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
+     */
+    opt_pretty: boolean;
+};
+/**
+ * Options provided to the Asana API request
+ */
+export type RequestOptions = {
+    /**
+     * - Body data to append to the request.
+     */
+    body: object;
+    /**
+     * - An object of query parameters to be encoded into the URL.
+     */
+    query: object;
+    /**
+     * - The HTTP method to use. Defaults to `GET`
+     */
+    method: string;
+};
+export { alterState, cursor, dataPath, dataValue, dateFns, each, field, fields, fn, http, lastReferenceValue, merge, sourceValue } from "@openfn/language-common";

package/types/Utils.d.ts

@@ -0,0 +1,2 @@
+export function addAuth(headers: any, configuration?: {}): void;
+export function request(state: any, path: any, params: any, callback?: (s: any) => any): any;