@openfn/language-mssql 5.0.14 → 5.2.0

package/ast.json

@@ -74,6 +74,42 @@
             },
             "name": "filter"
           },
+          {
+            "title": "param",
+            "description": "The uuid column to determine a matching/existing record",
+            "type": {
+              "type": "NameExpression",
+              "name": "string"
+            },
+            "name": "filter.uuid"
+          },
+          {
+            "title": "param",
+            "description": "The table to lookup the value in",
+            "type": {
+              "type": "NameExpression",
+              "name": "string"
+            },
+            "name": "filter.relation"
+          },
+          {
+            "title": "param",
+            "description": "The condition to use for the lookup. Values are automatically escaped for security.",
+            "type": {
+              "type": "NameExpression",
+              "name": "object"
+            },
+            "name": "filter.where"
+          },
+          {
+            "title": "param",
+            "description": "The operator to use for the lookup",
+            "type": {
+              "type": "NameExpression",
+              "name": "object"
+            },
+            "name": "filter.operator"
+          },
           {
             "title": "returns",
             "description": null,
@@ -84,7 +120,7 @@
           }
         ]
       },
-      "valid": true
+      "valid": false
     },
     {
       "name": "insert",
@@ -1237,6 +1273,60 @@
         ]
       },
       "valid": false
+    },
+    {
+      "name": "as",
+      "params": [
+        "key",
+        "operation"
+      ],
+      "docs": {
+        "description": "Run an operation and save the result to a custom key in state instead of overwriting state.data.",
+        "tags": [
+          {
+            "title": "public",
+            "description": null,
+            "type": null
+          },
+          {
+            "title": "function",
+            "description": null,
+            "name": null
+          },
+          {
+            "title": "example",
+            "description": "as('cceData', collections.get('cce-data-dhis2', { key: `*:*:${$.syncedAt}*` }));",
+            "caption": "Fetch cce-data from collections and store them under state.cceData"
+          },
+          {
+            "title": "param",
+            "description": "The state key to assign the result of the operation to.",
+            "type": {
+              "type": "NameExpression",
+              "name": "string"
+            },
+            "name": "key"
+          },
+          {
+            "title": "param",
+            "description": " An operation that returns a new state object with a `data` property",
+            "type": {
+              "type": "NameExpression",
+              "name": "function"
+            },
+            "name": "operation"
+          },
+          {
+            "title": "returns",
+            "description": null,
+            "type": {
+              "type": "NameExpression",
+              "name": "Operation"
+            }
+          }
+        ]
+      },
+      "valid": true
     }
   ]
 }

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   alterState: () => import_language_common2.alterState,
+  as: () => import_language_common2.as,
   combine: () => import_language_common2.combine,
   cursor: () => import_language_common2.cursor,
   dataPath: () => import_language_common2.dataPath,
@@ -45,7 +46,8 @@ __export(src_exports, {
   sql: () => sql,
   upsert: () => upsert,
   upsertIf: () => upsertIf,
-  upsertMany: () => upsertMany
+  upsertMany: () => upsertMany,
+  util: () => util_exports
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -53,6 +55,7 @@ module.exports = __toCommonJS(src_exports);
 var Adaptor_exports = {};
 __export(Adaptor_exports, {
   alterState: () => import_language_common2.alterState,
+  as: () => import_language_common2.as,
   combine: () => import_language_common2.combine,
   cursor: () => import_language_common2.cursor,
   dataPath: () => import_language_common2.dataPath,
@@ -80,6 +83,23 @@ __export(Adaptor_exports, {
   upsertMany: () => upsertMany
 });
 var import_language_common = require("@openfn/language-common");
+var import_util = require("@openfn/language-common/util");
+
+// src/util.js
+var util_exports = {};
+__export(util_exports, {
+  escape: () => escape
+});
+function escape(stringExp) {
+  if (typeof stringExp === "object" && stringExp !== null) {
+    return Object.values(stringExp).map((x) => escape(x));
+  } else if (typeof stringExp !== "string") {
+    return stringExp;
+  }
+  return stringExp.replace(/\'/g, "''");
+}
+
+// src/Adaptor.js
 var import_tedious = require("tedious");
 var import_language_common2 = require("@openfn/language-common");
 function createConnection(state) {
@@ -138,10 +158,9 @@ function execute(...operations) {
   };
 }
 function cleanupState(state) {
-  if (state.connection) {
-    state.connection.close();
-  }
-  delete state.connection;
+  var _a;
+  (_a = state == null ? void 0 : state.connection) == null ? void 0 : _a.close();
+  state == null ? true : delete state.connection;
   return state;
 }
 function addRowsToRefs(state, rows) {
@@ -198,7 +217,8 @@ function sql(params) {
   return (state) => {
     const { connection } = state;
     try {
-      const { query, options } = (0, import_language_common.expandReferences)(params)(state);
+      const [resolvedParams] = (0, import_util.expandReferences)(state, params);
+      const { query, options } = resolvedParams;
       console.log(`Preparing to execute sql statement: ${query}`);
       return queryHandler(state, query, composeNextState, options);
     } catch (e) {
@@ -232,25 +252,19 @@ function handleOptions(options) {
   }
   return options && options.setNull || "'undefined'";
 }
-function escapeQuote(stringExp) {
-  if (typeof stringExp === "object" && stringExp !== null) {
-    return Object.values(stringExp).map((x) => escapeQuote(x));
-  } else if (typeof stringExp !== "string") {
-    return stringExp;
-  }
-  return stringExp.replace(/\'/g, "''");
-}
 function findValue(filter) {
   return (state) => {
     const { connection } = state;
     const { uuid, relation, where, operator } = filter;
-    const whereData = (0, import_language_common.expandReferences)(where)(state);
-    const operatorData = (0, import_language_common.expandReferences)(operator)(state);
+    const [whereData] = (0, import_util.expandReferences)(state, where);
+    const [operatorData] = (0, import_util.expandReferences)(state, operator);
     let conditionsArray = [];
-    for (let key in whereData)
+    for (let key in whereData) {
+      const escapedValue = escape(whereData[key]);
       conditionsArray.push(
-        `${key} ${operatorData ? operatorData[key] : "="} '${whereData[key]}'`
+        `${key} ${operatorData ? operatorData[key] : "="} '${escapedValue}'`
       );
+    }
     const condition = conditionsArray.length > 0 ? `where ${conditionsArray.join(" and ")}` : "";
     try {
       const body = `select ${uuid} from ${relation} ${condition}`;
@@ -261,13 +275,15 @@ function findValue(filter) {
         const request = new import_tedious.Request(body, (err, rowCount, rows) => {
           if (err) {
             console.error(err.message);
-            throw err;
+            reject(err);
           } else {
             if (rows.length > 0) {
               returnValue = rows[0][0].value;
             }
-            if (returnValue === null)
+            if (returnValue === null) {
+              console.log("No value found");
               resolve(void 0);
+            }
             resolve(returnValue);
           }
         });
@@ -283,9 +299,9 @@ function insert(table, record, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = (0, import_language_common.expandReferences)(record)(state);
+      const [recordData] = (0, import_util.expandReferences)(state, record);
       const columns = Object.keys(recordData).sort();
-      const values = columns.map((key) => escapeQuote(recordData[key])).join("', '");
+      const values = columns.map((key) => escape(recordData[key])).join("', '");
       const query = handleValues(
         `INSERT INTO ${table} (${columns.join(", ")}) VALUES ('${values}');`,
         handleOptions(options)
@@ -308,10 +324,10 @@ function insertMany(table, records, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = (0, import_language_common.expandReferences)(records)(state);
+      const [recordData] = (0, import_util.expandReferences)(state, records);
       const columns = Object.keys(recordData[0]);
       const valueSets = recordData.map(
-        (x) => `('${escapeQuote(Object.values(x)).join("', '")}')`
+        (x) => `('${escape(Object.values(x)).join("', '")}')`
       );
       const query = handleValues(
         `INSERT INTO ${table} (${columns.join(", ")}) VALUES ${valueSets.join(
@@ -337,10 +353,10 @@ function upsert(table, uuid, record, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = (0, import_language_common.expandReferences)(record)(state);
+      const [recordData] = (0, import_util.expandReferences)(state, record);
       const columns = Object.keys(recordData).sort();
-      const selectValues = columns.map((key) => `'${escapeQuote(recordData[key])}' AS ${key}`).join(", ");
-      const updateValues = columns.map((key) => `[Target].${key}='${escapeQuote(recordData[key])}'`).join(", ");
+      const selectValues = columns.map((key) => `'${escape(recordData[key])}' AS ${key}`).join(", ");
+      const updateValues = columns.map((key) => `[Target].${key}='${escape(recordData[key])}'`).join(", ");
       const insertColumns = columns.join(", ");
       const insertValues = columns.map((key) => `[Source].${key}`).join(", ");
       const constraint = [];
@@ -383,17 +399,17 @@ function upsertIf(logical, table, uuid, record, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = (0, import_language_common.expandReferences)(record)(state);
+      const [recordData] = (0, import_util.expandReferences)(state, record);
       const columns = Object.keys(recordData).sort();
-      const logicalData = (0, import_language_common.expandReferences)(logical)(state);
+      const [logicalData] = (0, import_util.expandReferences)(state, logical);
       return new Promise((resolve, reject) => {
         if (!logicalData) {
           console.log(`Skipping upsert for ${uuid}.`);
           resolve(state);
           return state;
         }
-        const selectValues = columns.map((key) => `'${escapeQuote(recordData[key])}' AS ${key}`).join(", ");
-        const updateValues = columns.map((key) => `[Target].${key}='${escapeQuote(recordData[key])}'`).join(", ");
+        const selectValues = columns.map((key) => `'${escape(recordData[key])}' AS ${key}`).join(", ");
+        const updateValues = columns.map((key) => `[Target].${key}='${escape(recordData[key])}'`).join(", ");
         const insertColumns = columns.join(", ");
         const insertValues = columns.map((key) => `[Source].${key}`).join(", ");
         const constraint = [];
@@ -435,7 +451,7 @@ function upsertMany(table, uuid, records, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = (0, import_language_common.expandReferences)(records)(state);
+      const [recordData] = (0, import_util.expandReferences)(state, records);
       return new Promise((resolve, reject) => {
         if (!recordData || recordData.length === 0) {
           console.log("No records provided; skipping upsert.");
@@ -443,7 +459,7 @@ function upsertMany(table, uuid, records, options) {
         }
         const columns = Object.keys(recordData[0]);
         const valueSets = recordData.map(
-          (x) => `('${escapeQuote(Object.values(x)).join("', '")}')`
+          (x) => `('${escape(Object.values(x)).join("', '")}')`
         );
         const insertColumns = columns.join(", ");
         const insertValues = columns.map((key) => `[Source].${key}`).join(", ");
@@ -486,7 +502,7 @@ function upsertMany(table, uuid, records, options) {
 function describeTable(tableName, options) {
   return (state) => {
     const { connection } = state;
-    const name = (0, import_language_common.expandReferences)(tableName)(state);
+    const [name] = (0, import_util.expandReferences)(state, tableName);
     try {
       const query = `SELECT column_name
           FROM information_schema.columns 
@@ -504,7 +520,7 @@ function insertTable(tableName, columns, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const data = (0, import_language_common.expandReferences)(columns)(state);
+      const [data] = (0, import_util.expandReferences)(state, columns);
       return new Promise((resolve, reject) => {
         if (!data || data.length === 0) {
           console.log("No columns provided; skipping table creation.");
@@ -530,7 +546,7 @@ function modifyTable(tableName, columns, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const data = (0, import_language_common.expandReferences)(columns)(state);
+      const [data] = (0, import_util.expandReferences)(state, columns);
       return new Promise((resolve, reject) => {
         if (!data || data.length === 0) {
           console.log("No columns provided; skipping table modification.");
@@ -556,6 +572,7 @@ var src_default = Adaptor_exports;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   alterState,
+  as,
   combine,
   cursor,
   dataPath,
@@ -580,5 +597,6 @@ var src_default = Adaptor_exports;
   sql,
   upsert,
   upsertIf,
-  upsertMany
+  upsertMany,
+  util
 });

package/dist/index.js

@@ -8,6 +8,7 @@ var __export = (target, all) => {
 var Adaptor_exports = {};
 __export(Adaptor_exports, {
   alterState: () => alterState,
+  as: () => as,
   combine: () => combine,
   cursor: () => cursor,
   dataPath: () => dataPath,
@@ -34,10 +35,24 @@ __export(Adaptor_exports, {
   upsertIf: () => upsertIf,
   upsertMany: () => upsertMany
 });
-import {
-  execute as commonExecute,
-  expandReferences
-} from "@openfn/language-common";
+import { execute as commonExecute } from "@openfn/language-common";
+import { expandReferences } from "@openfn/language-common/util";
+
+// src/util.js
+var util_exports = {};
+__export(util_exports, {
+  escape: () => escape
+});
+function escape(stringExp) {
+  if (typeof stringExp === "object" && stringExp !== null) {
+    return Object.values(stringExp).map((x) => escape(x));
+  } else if (typeof stringExp !== "string") {
+    return stringExp;
+  }
+  return stringExp.replace(/\'/g, "''");
+}
+
+// src/Adaptor.js
 import { Connection, Request } from "tedious";
 import {
   alterState,
@@ -54,7 +69,8 @@ import {
   lastReferenceValue,
   cursor,
   merge,
-  sourceValue
+  sourceValue,
+  as
 } from "@openfn/language-common";
 function createConnection(state) {
   const {
@@ -112,10 +128,9 @@ function execute(...operations) {
   };
 }
 function cleanupState(state) {
-  if (state.connection) {
-    state.connection.close();
-  }
-  delete state.connection;
+  var _a;
+  (_a = state == null ? void 0 : state.connection) == null ? void 0 : _a.close();
+  state == null ? true : delete state.connection;
   return state;
 }
 function addRowsToRefs(state, rows) {
@@ -172,7 +187,8 @@ function sql(params) {
   return (state) => {
     const { connection } = state;
     try {
-      const { query, options } = expandReferences(params)(state);
+      const [resolvedParams] = expandReferences(state, params);
+      const { query, options } = resolvedParams;
       console.log(`Preparing to execute sql statement: ${query}`);
       return queryHandler(state, query, composeNextState, options);
     } catch (e) {
@@ -206,25 +222,19 @@ function handleOptions(options) {
   }
   return options && options.setNull || "'undefined'";
 }
-function escapeQuote(stringExp) {
-  if (typeof stringExp === "object" && stringExp !== null) {
-    return Object.values(stringExp).map((x) => escapeQuote(x));
-  } else if (typeof stringExp !== "string") {
-    return stringExp;
-  }
-  return stringExp.replace(/\'/g, "''");
-}
 function findValue(filter) {
   return (state) => {
     const { connection } = state;
     const { uuid, relation, where, operator } = filter;
-    const whereData = expandReferences(where)(state);
-    const operatorData = expandReferences(operator)(state);
+    const [whereData] = expandReferences(state, where);
+    const [operatorData] = expandReferences(state, operator);
     let conditionsArray = [];
-    for (let key in whereData)
+    for (let key in whereData) {
+      const escapedValue = escape(whereData[key]);
       conditionsArray.push(
-        `${key} ${operatorData ? operatorData[key] : "="} '${whereData[key]}'`
+        `${key} ${operatorData ? operatorData[key] : "="} '${escapedValue}'`
       );
+    }
     const condition = conditionsArray.length > 0 ? `where ${conditionsArray.join(" and ")}` : "";
     try {
       const body = `select ${uuid} from ${relation} ${condition}`;
@@ -235,13 +245,15 @@ function findValue(filter) {
         const request = new Request(body, (err, rowCount, rows) => {
           if (err) {
             console.error(err.message);
-            throw err;
+            reject(err);
           } else {
             if (rows.length > 0) {
               returnValue = rows[0][0].value;
             }
-            if (returnValue === null)
+            if (returnValue === null) {
+              console.log("No value found");
               resolve(void 0);
+            }
             resolve(returnValue);
           }
         });
@@ -257,9 +269,9 @@ function insert(table, record, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = expandReferences(record)(state);
+      const [recordData] = expandReferences(state, record);
       const columns = Object.keys(recordData).sort();
-      const values = columns.map((key) => escapeQuote(recordData[key])).join("', '");
+      const values = columns.map((key) => escape(recordData[key])).join("', '");
       const query = handleValues(
         `INSERT INTO ${table} (${columns.join(", ")}) VALUES ('${values}');`,
         handleOptions(options)
@@ -282,10 +294,10 @@ function insertMany(table, records, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = expandReferences(records)(state);
+      const [recordData] = expandReferences(state, records);
       const columns = Object.keys(recordData[0]);
       const valueSets = recordData.map(
-        (x) => `('${escapeQuote(Object.values(x)).join("', '")}')`
+        (x) => `('${escape(Object.values(x)).join("', '")}')`
       );
       const query = handleValues(
         `INSERT INTO ${table} (${columns.join(", ")}) VALUES ${valueSets.join(
@@ -311,10 +323,10 @@ function upsert(table, uuid, record, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = expandReferences(record)(state);
+      const [recordData] = expandReferences(state, record);
       const columns = Object.keys(recordData).sort();
-      const selectValues = columns.map((key) => `'${escapeQuote(recordData[key])}' AS ${key}`).join(", ");
-      const updateValues = columns.map((key) => `[Target].${key}='${escapeQuote(recordData[key])}'`).join(", ");
+      const selectValues = columns.map((key) => `'${escape(recordData[key])}' AS ${key}`).join(", ");
+      const updateValues = columns.map((key) => `[Target].${key}='${escape(recordData[key])}'`).join(", ");
       const insertColumns = columns.join(", ");
       const insertValues = columns.map((key) => `[Source].${key}`).join(", ");
       const constraint = [];
@@ -357,17 +369,17 @@ function upsertIf(logical, table, uuid, record, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = expandReferences(record)(state);
+      const [recordData] = expandReferences(state, record);
       const columns = Object.keys(recordData).sort();
-      const logicalData = expandReferences(logical)(state);
+      const [logicalData] = expandReferences(state, logical);
       return new Promise((resolve, reject) => {
         if (!logicalData) {
           console.log(`Skipping upsert for ${uuid}.`);
           resolve(state);
           return state;
         }
-        const selectValues = columns.map((key) => `'${escapeQuote(recordData[key])}' AS ${key}`).join(", ");
-        const updateValues = columns.map((key) => `[Target].${key}='${escapeQuote(recordData[key])}'`).join(", ");
+        const selectValues = columns.map((key) => `'${escape(recordData[key])}' AS ${key}`).join(", ");
+        const updateValues = columns.map((key) => `[Target].${key}='${escape(recordData[key])}'`).join(", ");
         const insertColumns = columns.join(", ");
         const insertValues = columns.map((key) => `[Source].${key}`).join(", ");
         const constraint = [];
@@ -409,7 +421,7 @@ function upsertMany(table, uuid, records, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const recordData = expandReferences(records)(state);
+      const [recordData] = expandReferences(state, records);
       return new Promise((resolve, reject) => {
         if (!recordData || recordData.length === 0) {
           console.log("No records provided; skipping upsert.");
@@ -417,7 +429,7 @@ function upsertMany(table, uuid, records, options) {
         }
         const columns = Object.keys(recordData[0]);
         const valueSets = recordData.map(
-          (x) => `('${escapeQuote(Object.values(x)).join("', '")}')`
+          (x) => `('${escape(Object.values(x)).join("', '")}')`
         );
         const insertColumns = columns.join(", ");
         const insertValues = columns.map((key) => `[Source].${key}`).join(", ");
@@ -460,7 +472,7 @@ function upsertMany(table, uuid, records, options) {
 function describeTable(tableName, options) {
   return (state) => {
     const { connection } = state;
-    const name = expandReferences(tableName)(state);
+    const [name] = expandReferences(state, tableName);
     try {
       const query = `SELECT column_name
           FROM information_schema.columns 
@@ -478,7 +490,7 @@ function insertTable(tableName, columns, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const data = expandReferences(columns)(state);
+      const [data] = expandReferences(state, columns);
       return new Promise((resolve, reject) => {
         if (!data || data.length === 0) {
           console.log("No columns provided; skipping table creation.");
@@ -504,7 +516,7 @@ function modifyTable(tableName, columns, options) {
   return (state) => {
     const { connection } = state;
     try {
-      const data = expandReferences(columns)(state);
+      const [data] = expandReferences(state, columns);
       return new Promise((resolve, reject) => {
         if (!data || data.length === 0) {
           console.log("No columns provided; skipping table modification.");
@@ -529,6 +541,7 @@ function modifyTable(tableName, columns, options) {
 var src_default = Adaptor_exports;
 export {
   alterState,
+  as,
   combine,
   cursor,
   dataPath,
@@ -554,5 +567,6 @@ export {
   sql,
   upsert,
   upsertIf,
-  upsertMany
+  upsertMany,
+  util_exports as util
 };

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@openfn/language-mssql",
-  "version": "5.0.14",
+  "label": "MSSQL",
+  "version": "5.2.0",
   "description": "A Microsoft SQL language pack for OpenFn",
   "exports": {
     ".": {
@@ -25,13 +26,12 @@
   ],
   "dependencies": {
     "tedious": "18.6.1",
-    "@openfn/language-common": "2.4.0"
+    "@openfn/language-common": "3.0.0"
   },
   "devDependencies": {
     "assertion-error": "2.0.0",
-    "chai": "4.3.6",
+    "chai": "^5.2.0",
     "deep-eql": "4.1.1",
-    "esno": "^0.16.3",
     "rimraf": "3.0.2"
   },
   "type": "module",
@@ -39,8 +39,9 @@
   "main": "dist/index.cjs",
   "scripts": {
     "build": "pnpm clean && build-adaptor mssql",
-    "test": "mocha --experimental-specifier-resolution=node --no-warnings",
-    "test:watch": "mocha -w --experimental-specifier-resolution=node --no-warnings",
+    "test": "mocha --experimental-specifier-resolution=node --no-warnings --exclude test/integration.js --recursive",
+    "test:watch": "mocha -w --experimental-specifier-resolution=node --no-warnings --exclude test/integration.js --recursive",
+    "test:integration": "mocha --experimental-specifier-resolution=node --no-warnings test/integration.js",
     "clean": "rimraf dist types docs",
     "pack": "pnpm pack --pack-destination ../../dist",
     "lint": "eslint src"

package/types/Adaptor.d.ts

@@ -33,9 +33,18 @@ export function sql(params: object): Operation;
  *  })
  * @function
  * @param {object} filter - A filter object with the lookup table, a uuid and the condition
+ * @param {string} filter.uuid - The uuid column to determine a matching/existing record
+ * @param {string} filter.relation - The table to lookup the value in
+ * @param {object} filter.where - The condition to use for the lookup. Values are automatically escaped for security.
+ * @param {object} filter.operator - The operator to use for the lookup
  * @returns {Operation}
  */
-export function findValue(filter: object): Operation;
+export function findValue(filter: {
+    uuid: string;
+    relation: string;
+    where: object;
+    operator: object;
+}): Operation;
 /**
  * Insert a record
  * @public
@@ -161,4 +170,4 @@ export function insertTable(tableName: string, columns: any[], options: object):
  * @returns {Operation}
  */
 export function modifyTable(tableName: string, columns: any[], options: object): Operation;
-export { alterState, combine, dataPath, dataValue, dateFns, each, field, fields, fn, fnIf, http, lastReferenceValue, cursor, merge, sourceValue } from "@openfn/language-common";
+export { alterState, combine, dataPath, dataValue, dateFns, each, field, fields, fn, fnIf, http, lastReferenceValue, cursor, merge, sourceValue, as } from "@openfn/language-common";

package/types/index.d.ts

@@ -1,3 +1,4 @@
 export default Adaptor;
 export * from "./Adaptor";
+export * as util from "./util";
 import * as Adaptor from "./Adaptor";

package/types/util.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Escapes a string for use in an SQL query.
+ * @example <caption>Examples</caption>
+ * util.escape('test string') // 'test string'
+ * util.escape("O'Connor") // "O''Connor"
+ * util.escape('string with "quotes"') // 'string with "quotes"'
+ * util.escape('') // ''
+ * util.escape(null) // null
+ * util.escape("'; DROP TABLE users; --") // "''; DROP TABLE users; --"
+ * @param {string} stringExp - The string to escape.
+ * @returns {string} The escaped string.
+ */
+export function escape(stringExp: string): string;