github-pages-deploy-action/src/util.ts
2020-09-12 18:07:27 -04:00

83 lines
2.7 KiB
TypeScript

import {isDebug} from '@actions/core'
import {ActionInterface} from './constants'
const replaceAll = (input: string, find: string, replace: string): string =>
input.split(find).join(replace)
/* Utility function that checks to see if a value is undefined or not. */
export const isNullOrUndefined = (value: any): boolean =>
typeof value === 'undefined' || value === null || value === ''
/* Generates a token type used for the action. */
export const generateTokenType = (action: ActionInterface): string =>
action.ssh
? 'SSH Deploy Key'
: action.accessToken
? 'Access Token'
: action.gitHubToken
? 'GitHub Token'
: '…'
/* Generates a the repository path used to make the commits. */
export const generateRepositoryPath = (action: ActionInterface): string =>
action.ssh
? `git@github.com:${action.repositoryName}`
: `https://${action.accessToken ||
`x-access-token:${action.gitHubToken}`}@github.com/${
action.repositoryName
}.git`
/* Checks for the required tokens and formatting. Throws an error if any case is matched. */
export const hasRequiredParameters = (action: ActionInterface): void => {
if (
(isNullOrUndefined(action.accessToken) &&
isNullOrUndefined(action.gitHubToken) &&
isNullOrUndefined(action.ssh)) ||
isNullOrUndefined(action.repositoryPath) ||
(action.accessToken && action.accessToken === '')
) {
throw new Error(
'No deployment token/method was provided. You must provide the action with either a Personal Access Token or the GitHub Token secret in order to deploy. If you wish to use an ssh deploy token then you must set SSH to true.'
)
}
if (isNullOrUndefined(action.branch)) {
throw new Error('Branch is required.')
}
if (!action.folder || isNullOrUndefined(action.folder)) {
throw new Error('You must provide the action with a folder to deploy.')
}
if (action.folder.startsWith('/') || action.folder.startsWith('./')) {
throw new Error(
"Incorrectly formatted build folder. The deployment folder cannot be prefixed with '/' or './'. Instead reference the folder name directly."
)
}
}
/* Suppresses sensitive information from being exposed in error messages. */
export const suppressSensitiveInformation = (
str: string,
action: ActionInterface
): string => {
let value = str
if (isDebug()) {
// Data is unmasked in debug mode.
return value
}
const orderedByLength = ([
action.accessToken,
action.gitHubToken,
action.repositoryPath
].filter(Boolean) as string[]).sort((a, b) => b.length - a.length)
for (const find of orderedByLength) {
value = replaceAll(value, find, '***')
}
return value
}