import { DebugLogger, deepAssign, InvalidConfigurationError, log, safeStringifyJson, statOrNull } from "builder-util"
import { Nullish } from "builder-util-runtime"
import { readJson } from "fs-extra"
import { Lazy } from "lazy-val"
import * as path from "path"
import { Configuration } from "../../configuration"
import { FileSet } from "../../options/PlatformSpecificBuildOptions"
import { reactCra } from "../../presets/rectCra"
import { PACKAGE_VERSION } from "../../version"
import { getConfig as _getConfig, loadParentConfig, orNullIfFileNotExist, ReadConfigRequest } from "./load"
const validateSchema = require("@develar/schema-utils")
function mergePublish(config: Configuration, configFromOptions: Configuration) {
const publish = Array.isArray(config.publish) ? configFromOptions.publish : null
if (publish != null) {
delete (configFromOptions as any).publish
}
deepAssign(config, configFromOptions)
if (publish == null) {
return
}
const listOnDisk = config.publish as Array<any>
if (listOnDisk.length === 0) {
config.publish = publish
} else {
Object.assign(listOnDisk[0], publish)
}
}
export async function getConfig(
projectDir: string,
configPath: string | null,
configFromOptions: Configuration | Nullish,
packageMetadata: Lazy<Record<string, any> | null> = new Lazy(() => orNullIfFileNotExist(readJson(path.join(projectDir, "package.json"))))
): Promise<Configuration> {
const configRequest: ReadConfigRequest = { packageKey: "build", configFilename: "electron-builder", projectDir, packageMetadata }
const configAndEffectiveFile = await _getConfig<Configuration>(configRequest, configPath)
const config = configAndEffectiveFile == null ? {} : configAndEffectiveFile.result
if (configFromOptions != null) {
mergePublish(config, configFromOptions)
}
if (configAndEffectiveFile != null) {
log.info({ file: configAndEffectiveFile.configFile == null ? 'package.json ("build" field)' : configAndEffectiveFile.configFile }, "loaded configuration")
}
if (config.extends == null && config.extends !== null) {
const metadata = (await packageMetadata.value) || {}
const devDependencies = metadata.devDependencies
const dependencies = metadata.dependencies
if ((dependencies != null && "react-scripts" in dependencies) || (devDependencies != null && "react-scripts" in devDependencies)) {
config.extends = "react-cra"
} else if (devDependencies != null && "electron-webpack" in devDependencies) {
let file = "electron-webpack/out/electron-builder.js"
try {
file = require.resolve(file)
} catch (_ignore) {
file = require.resolve("electron-webpack/electron-builder.yml")
}
config.extends = `file:${file}`
}
}
const parentConfigs = await loadParentConfigsRecursively(config.extends, async configExtend => {
if (configExtend === "react-cra") {
const result = await reactCra(projectDir)
log.info({ preset: configExtend }, "loaded parent configuration")
return result
} else {
const { configFile, result } = await loadParentConfig<Configuration>(configRequest, configExtend)
log.info({ file: configFile }, "loaded parent configuration")
return result
}
})
return doMergeConfigs([...parentConfigs, config])
}
function asArray(value: string[] | string | Nullish): string[] {
return Array.isArray(value) ? value : typeof value === "string" ? [value] : []
}
async function loadParentConfigsRecursively(configExtends: Configuration["extends"], loader: (configExtend: string) => Promise<Configuration>): Promise<Configuration[]> {
const configs = []
for (const configExtend of asArray(configExtends)) {
const result = await loader(configExtend)
const parentConfigs = await loadParentConfigsRecursively(result.extends, loader)
configs.push(...parentConfigs, result)
}
return configs
}
function normalizeFiles(configuration: Configuration, name: "files" | "extraFiles" | "extraResources") {
let value = configuration[name]
if (value == null) {
return
}
if (!Array.isArray(value)) {
value = [value]
}
itemLoop: for (let i = 0; i < value.length; i++) {
let item = value[i]
if (typeof item === "string") {
if (i !== 0) {
let prevItemIndex = i - 1
let prevItem: FileSet
do {
prevItem = value[prevItemIndex--] as FileSet
} while (prevItem == null)
if (prevItem.from == null && prevItem.to == null) {
if (prevItem.filter == null) {
prevItem.filter = [item]
} else {
;(prevItem.filter as Array<string>).push(item)
}
value[i] = null as any
continue itemLoop
}
}
item = {
filter: [item],
}
value[i] = item
} else if (Array.isArray(item)) {
throw new Error(`${name} configuration is invalid, nested array not expected for index ${i}: ${item}`)
}
if (item.from === ".") {
item.from = undefined
}
if (item.to === ".") {
item.to = undefined
}
if (item.filter != null && typeof item.filter === "string") {
item.filter = [item.filter]
}
}
configuration[name] = value.filter(it => it != null)
}
function isSimilarFileSet(value: FileSet, other: FileSet): boolean {
return value.from === other.from && value.to === other.to
}
type Filter = FileSet["filter"]
function mergeFilters(value: Filter, other: Filter): string[] {
return asArray(value).concat(asArray(other))
}
function mergeFileSets(lists: FileSet[][]): FileSet[] {
const result: FileSet[] = []
for (const list of lists) {
for (const item of list) {
const existingItem = result.find(i => isSimilarFileSet(i, item))
if (existingItem) {
existingItem.filter = mergeFilters(item.filter, existingItem.filter)
} else {
result.push(item)
}
}
}
return result
}
* `doMergeConfigs` takes configs in the order you would pass them to
* Object.assign as sources.
*/
export function doMergeConfigs(configs: Configuration[]): Configuration {
for (const config of configs) {
normalizeFiles(config, "files")
normalizeFiles(config, "extraFiles")
normalizeFiles(config, "extraResources")
}
const result = deepAssign(getDefaultConfig(), ...configs)
configs = configs.slice().reverse()
result.files = mergeFileSets(configs.map(config => (config.files ?? []) as FileSet[]))
return result
}
function getDefaultConfig(): Configuration {
return {
directories: {
output: "dist",
buildResources: "build",
},
}
}
const schemeDataPromise = new Lazy(() => readJson(path.join(__dirname, "..", "..", "..", "scheme.json")))
export async function validateConfiguration(config: Configuration, debugLogger: DebugLogger) {
const extraMetadata = config.extraMetadata
if (extraMetadata != null) {
if (extraMetadata.build != null) {
throw new InvalidConfigurationError(`--em.build is deprecated, please specify as -c"`)
}
if (extraMetadata.directories != null) {
throw new InvalidConfigurationError(`--em.directories is deprecated, please specify as -c.directories"`)
}
}
const oldConfig: any = config
if (oldConfig.npmSkipBuildFromSource === false) {
throw new InvalidConfigurationError(`npmSkipBuildFromSource is deprecated, please use buildDependenciesFromSource"`)
}
if (oldConfig.appImage != null && oldConfig.appImage.systemIntegration != null) {
throw new InvalidConfigurationError(`appImage.systemIntegration is deprecated, https://github.com/TheAssassin/AppImageLauncher is used for desktop integration"`)
}
validateSchema(await schemeDataPromise.value, config, {
name: `electron-builder ${PACKAGE_VERSION}`,
postFormatter: (formattedError: string, error: any): string => {
if (debugLogger.isEnabled) {
debugLogger.add("invalidConfig", safeStringifyJson(error))
}
const site = "https://www.electron.build"
let url = `${site}/configuration`
const targets = new Set(["mac", "dmg", "pkg", "mas", "win", "nsis", "appx", "linux", "appimage", "snap"])
const dataPath: string = error.dataPath == null ? null : error.dataPath
const targetPath = dataPath.startsWith(".") ? dataPath.substr(1).toLowerCase() : null
if (targetPath != null && targets.has(targetPath)) {
url = `${site}/${targetPath}`
}
return `${formattedError}\n How to fix:
1. Open ${url}
2. Search the option name on the page (or type in into Search to find across the docs).
* Not found? The option was deprecated or not exists (check spelling).
* Found? Check that the option in the appropriate place. e.g. "title" only in the "dmg", not in the root.
`
},
})
}
const DEFAULT_APP_DIR_NAMES = ["app", "www"]
export async function computeDefaultAppDirectory(projectDir: string, userAppDir: string | Nullish): Promise<string> {
if (userAppDir != null) {
const absolutePath = path.resolve(projectDir, userAppDir)
const stat = await statOrNull(absolutePath)
if (stat == null) {
throw new InvalidConfigurationError(`Application directory ${userAppDir} doesn't exist`)
} else if (!stat.isDirectory()) {
throw new InvalidConfigurationError(`Application directory ${userAppDir} is not a directory`)
} else if (projectDir === absolutePath) {
log.warn({ appDirectory: userAppDir }, `Specified application directory equals to project dir — superfluous or wrong configuration`)
}
return absolutePath
}
for (const dir of DEFAULT_APP_DIR_NAMES) {
const absolutePath = path.join(projectDir, dir)
const packageJson = path.join(absolutePath, "package.json")
const stat = await statOrNull(packageJson)
if (stat != null && stat.isFile()) {
return absolutePath
}
}
return projectDir
}