45 lines
2.3 KiB
JavaScript
45 lines
2.3 KiB
JavaScript
/**
|
|
* _tree-name.mjs — the ONE place the output tree's name is read.
|
|
*
|
|
* The built tree lives at public/<TREE_NAME>/ and every embeddable URL carries it
|
|
* (…/<TREE_NAME>/<bundle>/<profile>/index.html). Its name has always been configurable —
|
|
* vite.doxa-maps-build-config.json `name` — but a census on 2026-09-25 found 61 tooling files
|
|
* that ignored the knob and hardcoded 'doxa-maps' (181 literals), so changing the config renamed
|
|
* the build while those gates kept reading the old folder. Every tool now imports TREE_NAME from
|
|
* here, which makes renaming the tree a one-line config change (see
|
|
* internal-tracker/03-deployment-cycle/qa-loops/RENAME-IMPACT-dx.md, mechanism A).
|
|
*
|
|
* import { TREE_NAME, BUILD_CONFIG_FILE } from './_tree-name.mjs'
|
|
* TREE=$(node internal/_tree-name.mjs) # from a shell script
|
|
*
|
|
* The fallback, used only when the config is missing or has no name, is the historical name,
|
|
* so a checkout without the config behaves exactly as before.
|
|
*/
|
|
import { readFileSync } from 'node:fs'
|
|
import { resolve, dirname } from 'node:path'
|
|
import { fileURLToPath } from 'node:url'
|
|
|
|
const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
|
|
export const BUILD_CONFIG_FILE = resolve(ROOT, 'vite.doxa-maps-build-config.json')
|
|
const FALLBACK = 'doxa-maps'
|
|
|
|
function read() {
|
|
let name = ''
|
|
try {
|
|
const cfg = JSON.parse(readFileSync(BUILD_CONFIG_FILE, 'utf8'))
|
|
if (cfg && typeof cfg.name === 'string') name = cfg.name.trim()
|
|
} catch { /* no config: the fallback */ }
|
|
if (!name) return FALLBACK
|
|
// A tree name is ONE path segment that also appears in public URLs: refuse anything that could
|
|
// escape public/ or need escaping in a URL, rather than build into a surprising place.
|
|
if (!/^[a-z0-9][a-z0-9._-]*$/i.test(name) || name.includes('..')) {
|
|
throw new Error(`[_tree-name] build config "name" must be a single URL-safe path segment, got ${JSON.stringify(name)}`)
|
|
}
|
|
return name
|
|
}
|
|
|
|
export const TREE_NAME = read()
|
|
// The name escaped for use inside a RegExp source (a '.' in a future name must not match any char).
|
|
export const TREE_NAME_RE = TREE_NAME.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
|
|
|
|
if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) process.stdout.write(TREE_NAME + '\n')
|