OpenFn · josephjclark · Oct 18, 2024 · Oct 18, 2024 · Oct 18, 2024 · Oct 18, 2024
diff --git a/packages/asana/CHANGELOG.md b/packages/asana/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-asana
 
+## 4.0.4
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 4.0.3
 
 ### Patch Changes

diff --git a/packages/asana/package.json b/packages/asana/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-asana",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "description": "An adaptor to access objects in Asana",
   "homepage": "https://docs.openfn.org",
   "repository": {

diff --git a/packages/azure-storage/CHANGELOG.md b/packages/azure-storage/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-azure-storage
 
+## 2.0.4
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 2.0.3
 
 ### Patch Changes

diff --git a/packages/azure-storage/package.json b/packages/azure-storage/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-azure-storage",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "OpenFn adaptor for Azure Storage",
   "type": "module",
   "exports": {

diff --git a/packages/beyonic/CHANGELOG.md b/packages/beyonic/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-beyonic
 
+## 0.3.6
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 0.3.5
 
 ### Patch Changes

diff --git a/packages/beyonic/package.json b/packages/beyonic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-beyonic",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "beyonic Language Pack for OpenFn",
   "homepage": "https://docs.openfn.org",
   "repository": {

diff --git a/packages/bigquery/CHANGELOG.md b/packages/bigquery/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-bigquery
 
+## 3.0.5
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 3.0.4
 
 ### Patch Changes

diff --git a/packages/bigquery/package.json b/packages/bigquery/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-bigquery",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "A Google BigQuery language package for use with Open Function",
   "main": "dist/index.cjs",
   "scripts": {

diff --git a/packages/cartodb/CHANGELOG.md b/packages/cartodb/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-cartodb
 
+## 0.4.6
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 0.4.5
 
 ### Patch Changes

diff --git a/packages/cartodb/package.json b/packages/cartodb/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-cartodb",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "cartodb Language Pack for OpenFn",
   "main": "dist/index.cjs",
   "scripts": {

diff --git a/packages/cht/CHANGELOG.md b/packages/cht/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-cht
 
+## 1.0.4
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 1.0.3
 
 ### Patch Changes

diff --git a/packages/cht/package.json b/packages/cht/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-cht",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "OpenFn CHT adaptor",
   "type": "module",
   "exports": {

diff --git a/packages/commcare/CHANGELOG.md b/packages/commcare/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-commcare
 
+## 3.2.3
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 3.2.2
 
 ### Patch Changes

diff --git a/packages/commcare/package.json b/packages/commcare/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-commcare",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "description": "Commcare Language Pack for OpenFn",
   "homepage": "https://docs.openfn.org",
   "repository": {

diff --git a/packages/common/CHANGELOG.md b/packages/common/CHANGELOG.md
@@ -1,5 +1,11 @@
 ## 2.0.0
 
+## 2.1.0
+
+### Minor Changes
+
+- 03a1a74: Add `encode`, `decode` and `uuid` helpers
+
 ## 2.0.3
 
 ### Patch Changes

diff --git a/packages/common/package.json b/packages/common/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-common",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "Common Expressions for OpenFn",
   "homepage": "https://docs.openfn.org",
   "repository": {

diff --git a/packages/common/src/util/helpers.js b/packages/common/src/util/helpers.js
@@ -0,0 +1,37 @@
+import { randomUUID } from 'node:crypto';
+
+/**
+ * Encodes a given string into Base64 format.
+ * @function
+ * @public
+ * @param {string} data - The string to be encoded.
+ * @returns {string} - The Base64 encoded string.
+ * @example <caption>Encode a string</caption>
+ * const encoded = encode('Hello World');
+ * console.log(encoded); // Output: SGVsbG8gV29ybGQ=
+ */
+export const encode = data => Buffer.from(data, 'utf-8').toString('base64');
+
+/**
+ * Decodes a Base64 encoded string back to its original format.
+ * @function
+ * @public
+ * @param {string} base64Data - The Base64 encoded string.
+ * @returns {string} - The decoded string.
+ * @example <caption>Decode a Base64 string</caption>
+ * const decoded = decode('SGVsbG8gV29ybGQ=');
+ * console.log(decoded); // Output: Hello World
+ */
+export const decode = base64Data =>
+  Buffer.from(base64Data, 'base64').toString('utf-8');
+
+/**
+ * Generates a UUID (Universally Unique Identifier).
+ * @function
+ * @public
+ * @returns {string} - A newly generated UUID.
+ * @example <caption>Generate a UUID</caption>
+ * const id = uuid();
+ * console.log(id); // Output:'3f4e254e-8f6f-4f8b-9651-1c1c262cc83f'
+ */
+export const uuid = () => randomUUID();
diff --git a/packages/common/src/util/index.js b/packages/common/src/util/index.js
@@ -1,4 +1,5 @@
 export * from './http';
+export * from './helpers';
 export * from './references';
 import parseDate from './parse-date';
 

diff --git a/packages/common/test/util/helpers.test.js b/packages/common/test/util/helpers.test.js
@@ -0,0 +1,59 @@
+import { expect } from 'chai';
+import { encode, decode, uuid } from '../../src/util/helpers.js';
+
+describe('uuid', () => {
+  it('should generate a uuid', () => {
+    const uuidPattern =
+      /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+
+    expect(uuid()).to.match(uuidPattern);
+  });
+  it('should generate unique UUIDs', () => {
+    const id1 = uuid();
+    const id2 = uuid();
+
+    expect(id1).not.eql(id2);
+  });
+});
+const errorMsg =
+  'The first argument must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object';
+
+describe('encode', () => {
+  it('should encode a string to Base64', () => {
+    expect(encode('Hello World')).to.eql('SGVsbG8gV29ybGQ=');
+  });
+
+  it('should encode an empty string to Base64', () => {
+    expect(encode('')).to.eql('');
+  });
+  it('should encode emoji to Base64', () => {
+    expect(encode('😀')).to.eql('8J+YgA==');
+  });
+  it('should throw an error if the string is not a string', () => {
+    expect(() => encode(123)).to.throw(errorMsg);
+    expect(() => encode(true)).to.throw(errorMsg);
+    expect(() => encode(null)).to.throw(errorMsg);
+    expect(() => encode({})).to.throw(errorMsg);
+    expect(() => encode(() => {})).to.throw(errorMsg);
+  });
+});
+
+describe('decode', () => {
+  it('should throw an error if the string is not a string', () => {
+    expect(() => decode(123)).to.throw(errorMsg);
+    expect(() => decode(true)).to.throw(errorMsg);
+    expect(() => decode(null)).to.throw(errorMsg);
+    expect(() => decode({})).to.throw(errorMsg);
+    expect(() => decode(() => {})).to.throw(errorMsg);
+  });
+  it('should decode a Base64 string for emoji', () => {
+    expect(decode('8J+YgA==')).to.eql('😀');
+  });
+  it('should decode a Base64 string back to its original string', () => {
+    expect(decode('SGVsbG8gV29ybGQ=')).to.eql('Hello World');
+  });
+
+  it('should decode an empty Base64 string', () => {
+    expect(decode('')).to.eql('');
+  });
+});
diff --git a/packages/dhis2/CHANGELOG.md b/packages/dhis2/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-dhis2
 
+## 5.0.5
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 5.0.4
 
 ### Patch Changes

diff --git a/packages/dhis2/package.json b/packages/dhis2/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-dhis2",
-  "version": "5.0.4",
+  "version": "5.0.5",
   "description": "DHIS2 Language Pack for OpenFn",
   "homepage": "https://docs.openfn.org",
   "repository": {

diff --git a/packages/dynamics/CHANGELOG.md b/packages/dynamics/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-dynamics
 
+## 0.5.8
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 0.5.7
 
 ### Patch Changes

diff --git a/packages/dynamics/package.json b/packages/dynamics/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-dynamics",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "A Microsoft Dynamics Language Pack for OpenFn",
   "main": "dist/index.cjs",
   "scripts": {
@@ -20,7 +20,7 @@
     "configuration-schema.json"
   ],
   "dependencies": {
-    "@openfn/language-common": "2.0.3",
+    "@openfn/language-common": "2.1.0",
     "request": "^2.72.0"
   },
   "devDependencies": {

diff --git a/packages/facebook/CHANGELOG.md b/packages/facebook/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-facebook
 
+## 0.4.6
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 0.4.5
 
 ### Patch Changes

diff --git a/packages/facebook/package.json b/packages/facebook/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-facebook",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "An Language Package for Facebook Messenger API",
   "main": "dist/index.cjs",
   "scripts": {

diff --git a/packages/fhir-ndr-et/CHANGELOG.md b/packages/fhir-ndr-et/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-fhir-ndr-et
 
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 0.1.2
 
 ### Patch Changes

diff --git a/packages/fhir-ndr-et/package.json b/packages/fhir-ndr-et/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-fhir-ndr-et",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "OpenFn fhir adaptor for NDR HIV in Ehtiopia",
   "type": "module",
   "exports": {

diff --git a/packages/googlesheets/CHANGELOG.md b/packages/googlesheets/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-googlesheets
 
+## 3.0.4
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 3.0.3
 
 ### Patch Changes

diff --git a/packages/googlesheets/package.json b/packages/googlesheets/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@openfn/language-googlesheets",
-  "version": "3.0.3",
+  "version": "3.0.4",
   "description": "A Google Sheets Language Pack for OpenFn",
   "homepage": "https://docs.openfn.org",
   "repository": {

diff --git a/packages/hive/CHANGELOG.md b/packages/hive/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @openfn/language-hive
 
+## 0.3.6
+
+### Patch Changes
+
+- Updated dependencies [03a1a74]
+  - @openfn/language-common@2.1.0
+
 ## 0.3.5
 
 ### Patch Changes