@openfn/language-asana 2.1.6 → 3.1.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

@@ -3,7 +3,7 @@
     {
       "name": "getTask",
       "params": [
-        "task_gid",
+        "taskGid",
         "params",
         "callback"
       ],
@@ -17,7 +17,7 @@
           },
           {
             "title": "example",
-            "description": "getTask(\"task_gid\",\n {\n   opt_fields: \"name,notes,assignee\"\n })"
+            "description": "getTask(\"1206933955023739\", {\n  opt_fields: \"name,notes,assignee\",\n});"
           },
           {
             "title": "function",
@@ -31,7 +31,7 @@
               "type": "NameExpression",
               "name": "string"
             },
-            "name": "task_gid"
+            "name": "taskGid"
           },
           {
             "title": "param",
@@ -66,7 +66,7 @@
     {
       "name": "getTasks",
       "params": [
-        "project_gid",
+        "projectGid",
         "params",
         "callback"
       ],
@@ -80,7 +80,7 @@
           },
           {
             "title": "example",
-            "description": "getTasks(\"project_gid\",\n {\n   opt_fields: \"name,notes,assignee\"\n })"
+            "description": "getTasks(\"1206933955023739\", {\n  opt_fields: \"name,notes,assignee\",\n});"
           },
           {
             "title": "function",
@@ -94,7 +94,7 @@
               "type": "NameExpression",
               "name": "string"
             },
-            "name": "project_gid"
+            "name": "projectGid"
           },
           {
             "title": "param",
@@ -129,7 +129,7 @@
     {
       "name": "updateTask",
       "params": [
-        "task_gid",
+        "taskGid",
         "params",
         "callback"
       ],
@@ -143,7 +143,7 @@
           },
           {
             "title": "example",
-            "description": "updateTask(\"task_gid\",\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",
@@ -157,7 +157,7 @@
               "type": "NameExpression",
               "name": "string"
             },
-            "name": "task_gid"
+            "name": "taskGid"
           },
           {
             "title": "param",
@@ -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",
@@ -245,7 +245,7 @@
     {
       "name": "upsertTask",
       "params": [
-        "project_gid",
+        "projectGid",
         "params",
         "callback"
       ],
@@ -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",
@@ -273,7 +273,7 @@
               "type": "NameExpression",
               "name": "string"
             },
-            "name": "project_gid"
+            "name": "projectGid"
           },
           {
             "title": "param",

package/dist/index.cjs

@@ -19,23 +19,25 @@ 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,
+  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,164 +46,197 @@ 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,
+  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
     });
   };
 }
-function getTask(task_gid, params, callback) {
+function getTask(taskGid, params, callback) {
   return (state) => {
-    task_gid = (0, import_language_common.expandReferences)(task_gid)(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/${task_gid}`;
-    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(project_gid, params, callback) {
+function getTasks(projectGid, params, callback) {
   return (state) => {
-    project_gid = (0, import_language_common.expandReferences)(project_gid)(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/${project_gid}/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(task_gid, params, callback) {
+function updateTask(taskGid, params, callback) {
   return (state) => {
-    task_gid = (0, import_language_common.expandReferences)(task_gid)(state);
-    params = (0, import_language_common.expandReferences)(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/${task_gid}/`;
-    const config = {
-      url,
-      data: { data: params },
-      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) => {
-    params = (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: params },
-      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(project_gid, params, callback) {
+function upsertTask(projectGid, params, callback) {
   return (state) => {
-    project_gid = (0, import_language_common.expandReferences)(project_gid)(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/${project_gid}/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 +246,7 @@ var src_default = Adaptor_exports;
 0 && (module.exports = {
   alterState,
   createTask,
+  createTaskStory,
   dataPath,
   dataValue,
   dateFns,
@@ -224,6 +260,7 @@ var src_default = Adaptor_exports;
   http,
   lastReferenceValue,
   merge,
+  request,
   sourceValue,
   updateTask,
   upsertTask

package/dist/index.js

@@ -9,6 +9,7 @@ var Adaptor_exports = {};
 __export(Adaptor_exports, {
   alterState: () => alterState,
   createTask: () => createTask,
+  createTaskStory: () => createTaskStory,
   dataPath: () => dataPath,
   dataValue: () => dataValue,
   dateFns: () => dateFns,
@@ -19,19 +20,55 @@ __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,
   dataPath,
@@ -41,7 +78,7 @@ import {
   field,
   fields,
   fn,
-  http as http2,
+  http,
   lastReferenceValue,
   merge,
   sourceValue
@@ -58,131 +95,125 @@ function execute(...operations) {
     });
   };
 }
-function getTask(task_gid, params, callback) {
+function getTask(taskGid, params, callback) {
   return (state) => {
-    task_gid = expandReferences(task_gid)(state);
-    const { opt_fields } = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/${task_gid}`;
-    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(project_gid, params, callback) {
+function getTasks(projectGid, params, callback) {
   return (state) => {
-    project_gid = expandReferences(project_gid)(state);
-    const { opt_fields } = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/projects/${project_gid}/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(task_gid, params, callback) {
+function updateTask(taskGid, params, callback) {
   return (state) => {
-    task_gid = expandReferences(task_gid)(state);
-    params = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/${task_gid}/`;
-    const config = {
-      url,
-      data: { data: params },
-      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) => {
-    params = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/tasks/`;
-    const config = {
-      url,
-      data: { data: params },
-      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(project_gid, params, callback) {
+function upsertTask(projectGid, params, callback) {
   return (state) => {
-    project_gid = expandReferences(project_gid)(state);
-    const { externalId, data } = expandReferences(params)(state);
-    const { apiVersion, token } = state.configuration;
-    const url = `https://app.asana.com/api/${apiVersion}/projects/${project_gid}/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 +222,7 @@ var src_default = Adaptor_exports;
 export {
   alterState,
   createTask,
+  createTaskStory,
   dataPath,
   dataValue,
   dateFns,
@@ -202,9 +234,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": "2.1.6",
+  "version": "3.1.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.7.6"
+    "@openfn/language-common": "^1.12.0"
   },
   "devDependencies": {
-    "@openfn/buildtools": "^1.0.2",
     "@openfn/simple-ast": "0.4.1",
     "assertion-error": "2.0.0",
     "chai": "4.3.6",
@@ -44,6 +43,7 @@
     "test": "mocha --experimental-specifier-resolution=node --no-warnings",
     "test:watch": "mocha -w --experimental-specifier-resolution=node --no-warnings",
     "clean": "rimraf dist types docs",
-    "pack": "pnpm pack --pack-destination ../../dist"
+    "pack": "pnpm pack --pack-destination ../../dist",
+    "lint": "eslint src"
   }
 }

package/types/Adaptor.d.ts

@@ -15,57 +15,56 @@ export function execute(...operations: Operations): Operation;
  * Get a single task of a given project.
  * @public
  * @example
- * getTask("task_gid",
- *  {
- *    opt_fields: "name,notes,assignee"
- *  })
+ * getTask("1206933955023739", {
+ *   opt_fields: "name,notes,assignee",
+ * });
  * @function
- * @param {string} task_gid - Globally unique identifier for the task
+ * @param {string} taskGid - Globally unique identifier for the task
  * @param {object} params - Query params to include.
  * @param {function} callback - (Optional) callback function
  * @returns {Operation}
  */
-export function getTask(task_gid: string, params: object, callback: Function): Operation;
+export function getTask(taskGid: string, params: object, callback: Function): Operation;
 /**
  * Get the list of tasks for a given project.
  * @public
  * @example
- * getTasks("project_gid",
- *  {
- *    opt_fields: "name,notes,assignee"
- *  })
+ * getTasks("1206933955023739", {
+ *   opt_fields: "name,notes,assignee",
+ * });
  * @function
- * @param {string} project_gid - Globally unique identifier for the project
+ * @param {string} projectGid - Globally unique identifier for the project
  * @param {object} params - Query params to include.
  * @param {function} callback - (Optional) callback function
  * @returns {Operation}
  */
-export function getTasks(project_gid: string, params: object, callback: Function): Operation;
+export function getTasks(projectGid: string, params: object, callback: Function): Operation;
 /**
  * Update a specific task.
  * @public
  * @example
- * updateTask("task_gid",
- *  {
- *    name: 'test', "approval_status": "pending", "assignee": "12345"
- *  }
- * )
+ * updateTask("1206933955023739", {
+ *   name: "test",
+ *   approval_status: "pending",
+ *   assignee: "12345",
+ * });
  * @function
- * @param {string} task_gid - Globally unique identifier for the task
+ * @param {string} taskGid - Globally unique identifier for the task
  * @param {object} params - Body parameters
  * @param {function} callback - (Optional) callback function
  * @returns {Operation}
  */
-export function updateTask(task_gid: string, params: object, callback: Function): Operation;
+export function updateTask(taskGid: string, params: object, callback: Function): Operation;
 /**
  * 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,21 +75,116 @@ 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} project_gid - Globally unique identifier for the project
+ * @param {string} projectGid - Globally unique identifier for the project
  * @param {object} params - an object with an externalId and some task data.
  * @param {function} callback - (Optional) callback function
  * @returns {Operation}
  */
-export function upsertTask(project_gid: string, params: object, callback: Function): Operation;
+export function upsertTask(projectGid: string, params: object, callback: Function): Operation;
+/**
+ * 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, 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;