Getting Started

• DateHelpers
  • DateHelpers.getReadableDateTime(datetime)
  • DateHelpers.getReadableDate(datetime)
  • DateHelpers.getDateString(date)
  • DateHelpers.parseDate(date)
  • DateHelpers.getShortOrdinalDate(date)
• MapHelpers
  • MapHelpers.getDistanceBetweenPoints(point1, point2)
  • MapHelpers.compareLocations(location1, location2, precision)
  • MapHelpers.getBearingToCoordinate({startCoordinate, endCoordinate})
• TextHelpers
  • TextHelpers.uuidv4()
  • TextHelpers.formatPosition(position)
  • TextHelpers.truncateText(text, characterLimit)
  • TextHelpers.fileNameFromPath(path)
  • TextHelpers.replaceSpacesWithUnderscore(s)
  • TextHelpers.replaceUnderscoreWithSpaces(s)
  • TextHelpers.pluralizeOnCondition(word, condition)
  • TextHelpers.convertSnakeToCamelCase(data)
  • TextHelpers.convertCamelToSnakeCase(data)
  • TextHelpers.convertCamelToKebabCase(data)
  • TextHelpers.convertKebabToCamelCase(data)
  • TextHelpers.generateAcronym(term)
  • TextHelpers.isAcronym(data)
  • TextHelpers.acronymToKebabCase(data)
  • TextHelpers.handleNullDisplay(value, defaultValue="N/A")
  • TextHelpers.enforceCharacterLimit({text, characterLimit, onCharacterLimit})
  • TextHelpers.isValidEmail(email)
  • TextHelpers.generateIdFromWord(word)
  • TextHelpers.generateWordFromId(word)
  • TextHelpers.generateSlugFromWords(id, ...words)
  • TextHelpers.extractIDfromSlug(slug)
  • TextHelpers.abbreviateNumber(number)
• ObjectHelpers
  • ObjectHelpers.isPureObject(any)
  • ObjectHelpers.parseCookie(str)
  • ObjectHelpers.filterObjectsByProperty ( array, propertyName, propertyValue)
  • ObjectHelpers.containsSubObject(mainObject, subObject)
  • ObjectHelpers.findObjectBySubObject(array, subObject)
  • ObjectHelpers.filterObjectsBySubObject(array, subObject)
  • ObjectHelpers.objectPropHasValue({object, key, value)}
  • ObjectHelpers.findEntry(array, predicate)
• GenericHelpers
  • GenericHelpers.delay(ms)
  • GenericHelpers.getPreferredUriScheme(host)
• FileHelpers
  • FileHelpers.checkFileExtension(filePath, validExtensions)
  • Contributing to this package
  • License

DateHelpers

Import the DateHelpers utility.

import { DateHelpers } from "@akadenia/helpers

DateHelpers.getReadableDateTime(datetime)

Returns the date in yyyy-mm-dd hh:mm:ss format.

Arguments |Name|Type|Required|Description| |--|--|--|--| |datetime|Date|false|The date to convert to readable date time. Default is current datetime. i.e. new Date()|

DateHelpers.getReadableDate(datetime)

Returns the date in yyyy-mm-dd format.

Arguments |Name|Type|Required|Description| |--|--|--|--| |datetime|Date|false|The date to convert to readable date time. Default is current datetime. i.e. new Date()|

DateHelpers.getDateString(date)

Returns a string representing the date in the user's local timezone.

Arguments |Name|Type|Required|Description| |--|--|--|--| |date|string or Date|true|The date string to convert to the string in the user's local timezone|

DateHelpers.parseDate(date)

Returns a date representing the new date object.

Arguments |Name|Type|Required|Description| |--|--|--|--| |date|string|true|The date string that needs to be returned as a date object|

DateHelpers.getShortOrdinalDate(date)

Returns a string representing the date in short ordinal format.

Arguments |Name|Type|Required|Description| |--|--|--|--| |date|string|true|The date string that needs to be formatted|

MapHelpers

Import the MapHelpers utility.

import { MapHelpers } from "@akadenia/helpers

MapHelpers.getDistanceBetweenPoints(point1, point2)

Returns the distance between two points in meters. Returns null if either point is invalid.

Arguments |Name|Type|Required|Description| |--|--|--|--| |point1|Array<number>|false| The coordinates of the first point. i.e. [lat, lng] | |point2|Array<number>|false|The coordinates of the second point. i.e. [lat, lng]|

MapHelpers.compareLocations(location1, location2, precision)

Returns a boolean value that indicates whether or not the two locations are the same based on precision provided.

Arguments |Name|Type|Required|Description| |--|--|--|--| |location1|Array<number>|false| The coordinates of the first location. i.e. [lat, lng] | |location2|Array<number>|false|The coordinates of the second location. i.e. [lat, lng]| |precision|number|false|The precision to compare the locations to. Default is 6|

MapHelpers.getBearingToCoordinate({startCoordinate, endCoordinate})

Returns the bearing to the end coordinate from the start coordinate in degrees.

Arguments |Name|Type|Required|Description| |--|--|--|--| |coordinates|object|true|An object containing the start and end coordinates. i.e. {startCoordinate: [lat, lng], endCoordinate: [lat, lng]}|

TextHelpers

Import the TextHelpers utility.

import { TextHelpers } from "@akadenia/helpers

TextHelpers.uuidv4()

Returns a randomly generated string.

Arguments |Name|Type|Required|Description| |--|--|--|--|

TextHelpers.formatPosition(position)

Returns a string position for a provided number. eg. "2nd", "3rd" etc.

Arguments |Name|Type|Required|Description| |--|--|--|--| |position|number|true|A position number to add the appropriate suffix to|

TextHelpers.truncateText(text, characterLimit)

Returns a string ending in an ellipsis ... or returns the input string if maximum character limit isn't met.

Arguments |Name|Type|Required|Description| |--|--|--|--| |text|string|true|The text to truncate| |characterLimit|number|true|The target number of characters to truncate text to|

TextHelpers.fileNameFromPath(path)

Returns a file name.

Arguments |Name|Type|Required|Description| |--|--|--|--| |path|string|true|The path to extract the file name from|

TextHelpers.replaceSpacesWithUnderscore(s)

Returns a string where the spaces have been replaced with underscores.

Arguments |Name|Type|Required|Description| |--|--|--|--| |s|string|false|The text to replace spaces with underscores in|

TextHelpers.replaceUnderscoreWithSpaces(s)

Returns a string where the underscores have been replaced with spaces.

Arguments |Name|Type|Required|Description| |--|--|--|--| |s|string|false|The text to replace underscores with spaces in|

TextHelpers.pluralizeOnCondition(word, condition)

Returns a pluralised version of the input string or returns the same string.

Arguments |Name|Type|Required|Description| |--|--|--|--| |word|string|true|The word to pluralise| |condition|boolean|true|The condition that determines whether to plurize the input word|

TextHelpers.convertSnakeToCamelCase(data)

Returns the input object or array with all object keys recursively transformed to camelCase. Returns input object if type is invalid.

Arguments |Name|Type|Required|Description| |--|--|--|--| |data|Object or Array<Object>|true|The object whose keys to transform|

TextHelpers.convertCamelToSnakeCase(data)

Returns the input object or array with all object keys recursively transformed to snake_case. Returns input object if type is invalid.

Arguments |Name|Type|Required|Description| |--|--|--|--| |data|Object or Array<Object>|true|The object whose keys to transform|

TextHelpers.convertCamelToKebabCase(data)

Convert camel case to kebab case The word returned as kebab case

Arguments |Name|Type|Required|Description| |--|--|--|--| |data|string|The word needed to be converted to kebab case from camel case|

TextHelpers.convertKebabToCamelCase(data)

Convert kebab case to camel case The word returned as camel case

Arguments |Name|Type|Required|Description| |--|--|--|--| |data|string|The word needed to be converted from kebab case to camel case|

TextHelpers.generateAcronym(term)

Generate an acronym from a term an acronym generated from the term

Arguments |Name|Type|Required|Description| |--|--|--|--| |term|string|The term to be converted to an acronym|

TextHelpers.isAcronym(data)

Validate if a word is acronym The boolean value when the condition is met

Arguments |Name|Type|Required|Description| |--|--|--|--| |data|string|The word that is being validated as acronym|

TextHelpers.acronymToKebabCase(data)

Convert acronym to kebab case The word returned as camel case

Arguments |Name|Type|Required|Description| |--|--|--|--| |data|string|The acronym to be converted to kebab case|

TextHelpers.handleNullDisplay(value, defaultValue="N/A")

Returns the input string or the default string if the input value is null or undefined. Arguments |Name|Type|Required|Description| |--|--|--|--| |value|string|true|The string to display in the ui| |defaultValue|string|false|The default string to display if the input value is null or undefined defaults to N/A|

TextHelpers.enforceCharacterLimit({text, characterLimit, onCharacterLimit})

Returns the input string if the character limit is not exceeded or returns the truncated string when the character limit is exceeded. Calls the onCharacterLimit callback when the character limit is exceeded. Arguments |Name|Type|Required|Description| |--|--|--|--| |text|string|true|The string to truncate| |characterLimit|number|true|The target number of characters to truncate text to| |onCharacterLimit|function|true|The callback to call when the character limit is exceeded|

TextHelpers.isValidEmail(email)

Returns true when the email is a proper email and returns false when the email is not a proper email Arguments |Name|Type|Required|Description| |--|--|--|--| |email|string|true|The email to be validated|

TextHelpers.generateIdFromWord(word)

Generate ID from word Returns the generated ID from the word

Arguments |Name|Type|Required|Description| |--|--|--|--| |word|string|true|The word needed to generate ID from|

TextHelpers.generateWordFromId(word)

Get the word from the generated ID Returns the word that is got from the id

Arguments |Name|Type|Required|Description| |--|--|--|--| |words|string|true|The id that is needed to get the word from| |customList|Record<string, string>|false|The custom lists that has the id with the custom list of words|

TextHelpers.generateSlugFromWords(id, ...words)

Get the slug from words Returns the slug from the words and it will be url path safe

Arguments |Name|Type|Required|Description| |--|--|--|--| |id|string|true|The id that is needed to be concatenated with the slug| |words|string[]|true|The words that will be in the slug|

TextHelpers.extractIDfromSlug(slug)

Extracts the id from the slug Returns the id from the slug Throws error if the string is empty, null or undefined

Arguments |Name|Type|Required|Description| |--|--|--|--| |slug|string|true|The slug associated with the id|

TextHelpers.abbreviateNumber(number)

Returns the string representation of the abbreviated number, rounded to two decimal places.

Arguments |Name|Type|Required|Description| |--|--|--|--| |number|number|true|The number to be abbreviated|

Examples

• Numbers below 1,000 are displayed without abbreviation
• Numbers between 1,000 and 1,000,000 are displayed in thousands (e.g. 1.23K)
• Numbers between 1,000,000 and 1,000,000,000 are displayed in millions (e.g. 1.23M)
• Numbers above 1,000,000,000 are displayed in billions (e.g. 1.23B)

Note: If the input number is null or undefined, the function returns null.

ObjectHelpers

Import the ObjectHelpers utility.

import { ObjectHelpers } from "@akadenia/helpers

ObjectHelpers.isPureObject(any)

Returns a boolean indicating whether or not the input is a pure object.

Arguments |Name|Type|Required|Description| |--|--|--|--| |object|any|true|The object to test for pureness|

ObjectHelpers.parseCookie(str)

Returns an object containing the key-value pairs of the parsed cookies.

Arguments |Name|Type|Required|Description| |--|--|--|--| |str|string|true|The string of cookies to parse|

ObjectHelpers.filterObjectsByProperty ( array, propertyName, propertyValue)

Filter an array of objects based on a specific property and its corresponding value. Returns an array containing all objects that have the specified property with the given value.

Template T extends Record<string, any>

Arguments |Name|Type|Required|Description| |--|--|--|--| |array|T[]|true|An array of objects to be searched| |propertyName|keyof T|true|The name of the property to match against| |propertyValue|T[keyof T]|true|The value that the property should have to be considered|

ObjectHelpers.containsSubObject(mainObject, subObject)

It compares the key-value pairs of the sub-object with the corresponding key-value pairs in the main object. Returns true If all key-value pairs in the sub-object are found in the main object; otherwise, it returns false.

Template T extends Record<string, any>

Arguments |Name|Type|Required|Description| |--|--|--|--| |mainObject|T|true|The main object to be checked| |subObject|Partial<T>|true|The sub-object to be searched for|

ObjectHelpers.findObjectBySubObject(array, subObject)

Searches an array of objects for an object that contains a specific sub-object. Returns the first object found in the array that contains the sub-object or null if no match is found.

Template T extends Record<string, any>

Arguments |Name|Type|Required|Description| |--|--|--|--| |array|T[]|true|An array of objects to be searched| |array|Partial<T>|true|The sub-object to be searched for in the array|

ObjectHelpers.filterObjectsBySubObject(array, subObject)

Filters an array of objects based on the presence of a specific sub-object within each object. Returns an array containing all objects from the input array that contain the specified sub-object.

Template T extends Record<string, any>

Arguments |Name|Type|Required|Description| |--|--|--|--| |array|T[]|true|An array of objects to be filtered| |array|Partial<T>|true|The sub-object to be searched for in the array|

ObjectHelpers.objectPropHasValue({object, key, value)}

Checks if the object has the key with the value.

Arguments |Name|Type|Required|Description| |--|--|--|--| |object|Object|true|The object to check| |key|string|true|The key to check| |value|any|true|The value to check|

ObjectHelpers.findEntry(array, predicate)

Finds the first entry in the array that satisfies the predicate.

Arguments |Name|Type|Required|Description| |--|--|--|--| |array|Array<any>|true|The array of entries to search| |predicate|(item: any) => boolean|true|The predicate function to use to search the array|

GenericHelpers

Import the GenericHelpers utility.

import { GenericHelpers } from "@akadenia/helpers

GenericHelpers.delay(ms)

A "modern" sleep statement.

Arguments |Name|Type|Required|Description| |--|--|--|--| |ms|number|true|The number of milliseconds to wait|

GenericHelpers.getPreferredUriScheme(host)

Get the preferred scheme for a host

Arguments |Name|Type|Required|Description| |--|--|--|--| |host|string|true|An IP address or a domain name|

FileHelpers

FileHelpers.checkFileExtension(filePath, validExtensions)

Check if a file path has a valid extension

Arguments |Name|Type|Required|Description| |--|--|--|--| |filePath|string|true|The file path to check| |validExtensions|string[]|true|The valid extensions|

Contributing to this package

This package follows the commitlint and conventional commits standards. As such the commit messages should follow the following format:

<type>(optional scope): <description> eg: feat: add new feature OR fix(map-loading): fix rendering on ipad devices

Common types according to commitlint-config-conventional (based on the Angular convention) can be:

• build
• chore
• ci
• docs
• feat
• fix
• perf
• refactor
• revert
• style
• test
• BREAKING CHANGE

License

MIT