0f8399ec88
Replace CDN React/ReactDOM/Babel with local libs; remove Babel and inline scripts Build Tailwind locally, add safelist; switch to assets/tailwind.css Self-host Font Awesome and Inter (CSS + woff2); remove external font CDNs Implement strict CSP (no unsafe-inline/eval; scripts/styles/fonts from self) Extract inline handlers; move PWA scripts to external files Add local QR code generation (qrcode lib) and remove api.qrserver.com Improve SessionTypeSelector visual selection (highlighted background and ring) Keep PWA working with service worker and offline assets Refs: CSP hardening, offline-first, no external dependencies
331 lines
13 KiB
JavaScript
331 lines
13 KiB
JavaScript
"use strict";
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.validation = void 0;
|
|
const argsert_1 = require("./argsert");
|
|
const common_types_1 = require("./common-types");
|
|
const levenshtein_1 = require("./levenshtein");
|
|
const obj_filter_1 = require("./obj-filter");
|
|
const specialKeys = ['$0', '--', '_'];
|
|
// validation-type-stuff, missing params,
|
|
// bad implications, custom checks.
|
|
function validation(yargs, usage, y18n) {
|
|
const __ = y18n.__;
|
|
const __n = y18n.__n;
|
|
const self = {};
|
|
// validate appropriate # of non-option
|
|
// arguments were provided, i.e., '_'.
|
|
self.nonOptionCount = function nonOptionCount(argv) {
|
|
const demandedCommands = yargs.getDemandedCommands();
|
|
// don't count currently executing commands
|
|
const _s = argv._.length - yargs.getContext().commands.length;
|
|
if (demandedCommands._ && (_s < demandedCommands._.min || _s > demandedCommands._.max)) {
|
|
if (_s < demandedCommands._.min) {
|
|
if (demandedCommands._.minMsg !== undefined) {
|
|
usage.fail(
|
|
// replace $0 with observed, $1 with expected.
|
|
demandedCommands._.minMsg
|
|
? demandedCommands._.minMsg.replace(/\$0/g, _s.toString()).replace(/\$1/, demandedCommands._.min.toString())
|
|
: null);
|
|
}
|
|
else {
|
|
usage.fail(__n('Not enough non-option arguments: got %s, need at least %s', 'Not enough non-option arguments: got %s, need at least %s', _s, _s, demandedCommands._.min));
|
|
}
|
|
}
|
|
else if (_s > demandedCommands._.max) {
|
|
if (demandedCommands._.maxMsg !== undefined) {
|
|
usage.fail(
|
|
// replace $0 with observed, $1 with expected.
|
|
demandedCommands._.maxMsg
|
|
? demandedCommands._.maxMsg.replace(/\$0/g, _s.toString()).replace(/\$1/, demandedCommands._.max.toString())
|
|
: null);
|
|
}
|
|
else {
|
|
usage.fail(__n('Too many non-option arguments: got %s, maximum of %s', 'Too many non-option arguments: got %s, maximum of %s', _s, _s, demandedCommands._.max));
|
|
}
|
|
}
|
|
}
|
|
};
|
|
// validate the appropriate # of <required>
|
|
// positional arguments were provided:
|
|
self.positionalCount = function positionalCount(required, observed) {
|
|
if (observed < required) {
|
|
usage.fail(__n('Not enough non-option arguments: got %s, need at least %s', 'Not enough non-option arguments: got %s, need at least %s', observed, observed, required));
|
|
}
|
|
};
|
|
// make sure all the required arguments are present.
|
|
self.requiredArguments = function requiredArguments(argv) {
|
|
const demandedOptions = yargs.getDemandedOptions();
|
|
let missing = null;
|
|
for (const key of Object.keys(demandedOptions)) {
|
|
if (!Object.prototype.hasOwnProperty.call(argv, key) || typeof argv[key] === 'undefined') {
|
|
missing = missing || {};
|
|
missing[key] = demandedOptions[key];
|
|
}
|
|
}
|
|
if (missing) {
|
|
const customMsgs = [];
|
|
for (const key of Object.keys(missing)) {
|
|
const msg = missing[key];
|
|
if (msg && customMsgs.indexOf(msg) < 0) {
|
|
customMsgs.push(msg);
|
|
}
|
|
}
|
|
const customMsg = customMsgs.length ? `\n${customMsgs.join('\n')}` : '';
|
|
usage.fail(__n('Missing required argument: %s', 'Missing required arguments: %s', Object.keys(missing).length, Object.keys(missing).join(', ') + customMsg));
|
|
}
|
|
};
|
|
// check for unknown arguments (strict-mode).
|
|
self.unknownArguments = function unknownArguments(argv, aliases, positionalMap, isDefaultCommand) {
|
|
const commandKeys = yargs.getCommandInstance().getCommands();
|
|
const unknown = [];
|
|
const currentContext = yargs.getContext();
|
|
Object.keys(argv).forEach((key) => {
|
|
if (specialKeys.indexOf(key) === -1 &&
|
|
!Object.prototype.hasOwnProperty.call(positionalMap, key) &&
|
|
!Object.prototype.hasOwnProperty.call(yargs._getParseContext(), key) &&
|
|
!self.isValidAndSomeAliasIsNotNew(key, aliases)) {
|
|
unknown.push(key);
|
|
}
|
|
});
|
|
if ((currentContext.commands.length > 0) || (commandKeys.length > 0) || isDefaultCommand) {
|
|
argv._.slice(currentContext.commands.length).forEach((key) => {
|
|
if (commandKeys.indexOf(key) === -1) {
|
|
unknown.push(key);
|
|
}
|
|
});
|
|
}
|
|
if (unknown.length > 0) {
|
|
usage.fail(__n('Unknown argument: %s', 'Unknown arguments: %s', unknown.length, unknown.join(', ')));
|
|
}
|
|
};
|
|
self.unknownCommands = function unknownCommands(argv) {
|
|
const commandKeys = yargs.getCommandInstance().getCommands();
|
|
const unknown = [];
|
|
const currentContext = yargs.getContext();
|
|
if ((currentContext.commands.length > 0) || (commandKeys.length > 0)) {
|
|
argv._.slice(currentContext.commands.length).forEach((key) => {
|
|
if (commandKeys.indexOf(key) === -1) {
|
|
unknown.push(key);
|
|
}
|
|
});
|
|
}
|
|
if (unknown.length > 0) {
|
|
usage.fail(__n('Unknown command: %s', 'Unknown commands: %s', unknown.length, unknown.join(', ')));
|
|
return true;
|
|
}
|
|
else {
|
|
return false;
|
|
}
|
|
};
|
|
// check for a key that is not an alias, or for which every alias is new,
|
|
// implying that it was invented by the parser, e.g., during camelization
|
|
self.isValidAndSomeAliasIsNotNew = function isValidAndSomeAliasIsNotNew(key, aliases) {
|
|
if (!Object.prototype.hasOwnProperty.call(aliases, key)) {
|
|
return false;
|
|
}
|
|
const newAliases = yargs.parsed.newAliases;
|
|
for (const a of [key, ...aliases[key]]) {
|
|
if (!Object.prototype.hasOwnProperty.call(newAliases, a) || !newAliases[key]) {
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
};
|
|
// validate arguments limited to enumerated choices
|
|
self.limitedChoices = function limitedChoices(argv) {
|
|
const options = yargs.getOptions();
|
|
const invalid = {};
|
|
if (!Object.keys(options.choices).length)
|
|
return;
|
|
Object.keys(argv).forEach((key) => {
|
|
if (specialKeys.indexOf(key) === -1 &&
|
|
Object.prototype.hasOwnProperty.call(options.choices, key)) {
|
|
[].concat(argv[key]).forEach((value) => {
|
|
// TODO case-insensitive configurability
|
|
if (options.choices[key].indexOf(value) === -1 &&
|
|
value !== undefined) {
|
|
invalid[key] = (invalid[key] || []).concat(value);
|
|
}
|
|
});
|
|
}
|
|
});
|
|
const invalidKeys = Object.keys(invalid);
|
|
if (!invalidKeys.length)
|
|
return;
|
|
let msg = __('Invalid values:');
|
|
invalidKeys.forEach((key) => {
|
|
msg += `\n ${__('Argument: %s, Given: %s, Choices: %s', key, usage.stringifiedValues(invalid[key]), usage.stringifiedValues(options.choices[key]))}`;
|
|
});
|
|
usage.fail(msg);
|
|
};
|
|
// custom checks, added using the `check` option on yargs.
|
|
let checks = [];
|
|
self.check = function check(f, global) {
|
|
checks.push({
|
|
func: f,
|
|
global
|
|
});
|
|
};
|
|
self.customChecks = function customChecks(argv, aliases) {
|
|
for (let i = 0, f; (f = checks[i]) !== undefined; i++) {
|
|
const func = f.func;
|
|
let result = null;
|
|
try {
|
|
result = func(argv, aliases);
|
|
}
|
|
catch (err) {
|
|
usage.fail(err.message ? err.message : err, err);
|
|
continue;
|
|
}
|
|
if (!result) {
|
|
usage.fail(__('Argument check failed: %s', func.toString()));
|
|
}
|
|
else if (typeof result === 'string' || result instanceof Error) {
|
|
usage.fail(result.toString(), result);
|
|
}
|
|
}
|
|
};
|
|
// check implications, argument foo implies => argument bar.
|
|
let implied = {};
|
|
self.implies = function implies(key, value) {
|
|
argsert_1.argsert('<string|object> [array|number|string]', [key, value], arguments.length);
|
|
if (typeof key === 'object') {
|
|
Object.keys(key).forEach((k) => {
|
|
self.implies(k, key[k]);
|
|
});
|
|
}
|
|
else {
|
|
yargs.global(key);
|
|
if (!implied[key]) {
|
|
implied[key] = [];
|
|
}
|
|
if (Array.isArray(value)) {
|
|
value.forEach((i) => self.implies(key, i));
|
|
}
|
|
else {
|
|
common_types_1.assertNotStrictEqual(value, undefined);
|
|
implied[key].push(value);
|
|
}
|
|
}
|
|
};
|
|
self.getImplied = function getImplied() {
|
|
return implied;
|
|
};
|
|
function keyExists(argv, val) {
|
|
// convert string '1' to number 1
|
|
const num = Number(val);
|
|
val = isNaN(num) ? val : num;
|
|
if (typeof val === 'number') {
|
|
// check length of argv._
|
|
val = argv._.length >= val;
|
|
}
|
|
else if (val.match(/^--no-.+/)) {
|
|
// check if key/value doesn't exist
|
|
val = val.match(/^--no-(.+)/)[1];
|
|
val = !argv[val];
|
|
}
|
|
else {
|
|
// check if key/value exists
|
|
val = argv[val];
|
|
}
|
|
return val;
|
|
}
|
|
self.implications = function implications(argv) {
|
|
const implyFail = [];
|
|
Object.keys(implied).forEach((key) => {
|
|
const origKey = key;
|
|
(implied[key] || []).forEach((value) => {
|
|
let key = origKey;
|
|
const origValue = value;
|
|
key = keyExists(argv, key);
|
|
value = keyExists(argv, value);
|
|
if (key && !value) {
|
|
implyFail.push(` ${origKey} -> ${origValue}`);
|
|
}
|
|
});
|
|
});
|
|
if (implyFail.length) {
|
|
let msg = `${__('Implications failed:')}\n`;
|
|
implyFail.forEach((value) => {
|
|
msg += (value);
|
|
});
|
|
usage.fail(msg);
|
|
}
|
|
};
|
|
let conflicting = {};
|
|
self.conflicts = function conflicts(key, value) {
|
|
argsert_1.argsert('<string|object> [array|string]', [key, value], arguments.length);
|
|
if (typeof key === 'object') {
|
|
Object.keys(key).forEach((k) => {
|
|
self.conflicts(k, key[k]);
|
|
});
|
|
}
|
|
else {
|
|
yargs.global(key);
|
|
if (!conflicting[key]) {
|
|
conflicting[key] = [];
|
|
}
|
|
if (Array.isArray(value)) {
|
|
value.forEach((i) => self.conflicts(key, i));
|
|
}
|
|
else {
|
|
conflicting[key].push(value);
|
|
}
|
|
}
|
|
};
|
|
self.getConflicting = () => conflicting;
|
|
self.conflicting = function conflictingFn(argv) {
|
|
Object.keys(argv).forEach((key) => {
|
|
if (conflicting[key]) {
|
|
conflicting[key].forEach((value) => {
|
|
// we default keys to 'undefined' that have been configured, we should not
|
|
// apply conflicting check unless they are a value other than 'undefined'.
|
|
if (value && argv[key] !== undefined && argv[value] !== undefined) {
|
|
usage.fail(__('Arguments %s and %s are mutually exclusive', key, value));
|
|
}
|
|
});
|
|
}
|
|
});
|
|
};
|
|
self.recommendCommands = function recommendCommands(cmd, potentialCommands) {
|
|
const threshold = 3; // if it takes more than three edits, let's move on.
|
|
potentialCommands = potentialCommands.sort((a, b) => b.length - a.length);
|
|
let recommended = null;
|
|
let bestDistance = Infinity;
|
|
for (let i = 0, candidate; (candidate = potentialCommands[i]) !== undefined; i++) {
|
|
const d = levenshtein_1.levenshtein(cmd, candidate);
|
|
if (d <= threshold && d < bestDistance) {
|
|
bestDistance = d;
|
|
recommended = candidate;
|
|
}
|
|
}
|
|
if (recommended)
|
|
usage.fail(__('Did you mean %s?', recommended));
|
|
};
|
|
self.reset = function reset(localLookup) {
|
|
implied = obj_filter_1.objFilter(implied, k => !localLookup[k]);
|
|
conflicting = obj_filter_1.objFilter(conflicting, k => !localLookup[k]);
|
|
checks = checks.filter(c => c.global);
|
|
return self;
|
|
};
|
|
const frozens = [];
|
|
self.freeze = function freeze() {
|
|
frozens.push({
|
|
implied,
|
|
checks,
|
|
conflicting
|
|
});
|
|
};
|
|
self.unfreeze = function unfreeze() {
|
|
const frozen = frozens.pop();
|
|
common_types_1.assertNotStrictEqual(frozen, undefined);
|
|
({
|
|
implied,
|
|
checks,
|
|
conflicting
|
|
} = frozen);
|
|
};
|
|
return self;
|
|
}
|
|
exports.validation = validation;
|