import { logger, field } from "@coder/logger" export interface Options { base: string csStaticBase: string logLevel: number } /** * Split a string up to the delimiter. If the delimiter doesn't exist the first * item will have all the text and the second item will be an empty string. */ export const split = (str: string, delimiter: string): [string, string] => { const index = str.indexOf(delimiter) return index !== -1 ? [str.substring(0, index).trim(), str.substring(index + 1)] : [str, ""] } /** * Appends an 's' to the provided string if count is greater than one; * otherwise the string is returned */ export const plural = (count: number, str: string): string => (count === 1 ? str : `${str}s`) export const generateUuid = (length = 24): string => { const possible = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" return Array(length) .fill(1) .map(() => possible[Math.floor(Math.random() * possible.length)]) .join("") } /** * Remove extra slashes in a URL. */ export const normalize = (url: string, keepTrailing = false): string => { return url.replace(/\/\/+/g, "/").replace(/\/+$/, keepTrailing ? "/" : "") } /** * Remove leading and trailing slashes. */ export const trimSlashes = (url: string): string => { return url.replace(/^\/+|\/+$/g, "") } /** * Resolve a relative base against the window location. This is used for * anything that doesn't work with a relative path. */ export const resolveBase = (base?: string): string => { // After resolving the base will either start with / or be an empty string. if (!base || base.startsWith("/")) { return base ?? "" } const parts = location.pathname.split("/") parts[parts.length - 1] = base const url = new URL(location.origin + "/" + parts.join("/")) return normalize(url.pathname) } /** * Get options embedded in the HTML or query params. */ export const getOptions = (): T => { let options: T try { options = JSON.parse(document.getElementById("coder-options")!.getAttribute("data-settings")!) } catch (error) { options = {} as T } const params = new URLSearchParams(location.search) const queryOpts = params.get("options") if (queryOpts) { options = { ...options, ...JSON.parse(queryOpts), } } logger.level = options.logLevel options.base = resolveBase(options.base) options.csStaticBase = resolveBase(options.csStaticBase) logger.debug("got options", field("options", options)) return options } /** * Wrap the value in an array if it's not already an array. If the value is * undefined return an empty array. */ export const arrayify = (value?: T | T[]): T[] => { if (Array.isArray(value)) { return value } if (typeof value === "undefined") { return [] } return [value] } /** * Get the first string. If there's no string return undefined. */ export const getFirstString = (value: string | string[] | object | undefined): string | undefined => { if (Array.isArray(value)) { return value[0] } return typeof value === "string" ? value : undefined }