8base utils

This is a package for functions that are use full in common cases of working with the 8base.com platform.

Index

Function	Description
normalize8BaseReference	Updates an object to change a property with a 8base connect operation.
normalize8baseDocumentCreate	Updates an object to change a property with a 8base create operation for a file object.
normalize8baseDocumentsCreate	Updates an object to change a property with a 8base create operation for a list of files objects.
normalize8baseDocumentDeleteAndUpdate	Updates an object to change a property with a 8base create and/or disconnect operation for a list of files objects.
normalize8BaseDocumentsDeleteAndUpdate	Updates an object to change a property with a 8base create and/or disconnect operation for a list of files objects.

normalize8BaseReference(data, key)

• Updates an object to change a property with a 8base connect operation.
• If the value of the key is undefined or null, the property gets deleted from the object.
• This function mutates the data object to reflect the change.
• This function assumes that all 8base IDs are of type string.

Example:

const issue = {name :"Issues Name", project: "<Project ID>"   };

normalize8BaseReference(issue, "project");

console.log(issue);
// {name :"Issues Name", project: {connect:{id: "<Project ID>"}}};

normalize8baseDocumentCreate(data, key)

• Updates an object to change a property with a 8base create operation.
• If the value of the key is undefined or null, the property gets deleted from the object.
• This function mutates the data object to reflect the change.

Example:

const issue = {name :"Issues Name", document: {fileId: "<FILE-ID>"}  };

normalize8baseDocumentCreate(issue, "document");

console.log(issue);
// {name :"Issues Name", document: {create:{fileId: "<FILE-ID>"}}};

normalize8baseDocumentsCreate(data, key)

• Updates an object to change a property with a 8base create operation.
• If the value of the key is undefined, null, or an empty array, the property gets deleted from the object.
• This function mutates the data object to reflect the change.

Example:

const issue = {name :"Issues Name", document: [{fileId: "<FILE-ID1>"},{fileId: "<FILE-ID2>"}]  };

normalize8BaseReference(issue, "document");

console.log(issue);
// {name :"Issues Name", document: {create:[{fileId: "<FILE-ID1>"},{fileId: "<FILE-ID2>"}]}};

normalize8baseDocumentDeleteAndUpdate(data, key, oldData)

• Helper to update or delete one document key from an Object.
• Updates an object to change a property with a 8base create and/or disconnect operation.
• If the value of the key is undefined, null, or an empty array, the property gets deleted from the object.
• This function mutates the data object to reflect the change.

Example:

const new12 = { a: { fileId: "FILE-ID1" } };
const old12 = {};
normalize8baseDocumentDeleteAndUpdate(new12, "a", old12);
expect(new12).toEqual({ a: { create: { fileId: "FILE-ID1" } } });

normalize8BaseDocumentsDeleteAndUpdate(data, key, oldData)

• Helper to change non null keys to 8base 'delete & create' reference for Documents Lists
• Updates an object to change a property with a 8base create and/or disconnect operation.
• If the value of the key is undefined, null, or an empty array, the property gets deleted from the object.
• This function mutates the data object to reflect the change.

Example:

const new15 = { a: [{ fileId: "FILE-ID1" }, { id: "ID2", fileId: "FILE-ID2" }] };
const old15 = { a: [{ id: "FILE-ID2" }, { id: "ID2" }] };
normalize8BaseDocumentsDeleteAndUpdate(new15, "a", old15);
expect(new15).toEqual({ a: { create: [{ fileId: "FILE-ID1" }], disconnect: [{ id: "FILE-ID2" }] } });