Make configs readonly inside validators

This commit is contained in:
Cooldude2606 committed 2026-03-20 18:56:55 +00:00
1 parent 5d0985cafc
commit 93271730eb
2 files changed
+129 -26

No files matched your search

+83 -26
View File
@@ -230,6 +230,8 @@ export class Config<
private fields: Fields; private fields: Fields;
private _unknownFields: Record<string, FieldValue> = {}; private _unknownFields: Record<string, FieldValue> = {};
/** Set to true during validators to prevent edits */
private _readonly = false; // TODO replace with "using config.asReadonly()"
/** Set to true when a field in the config is changed. */ /** Set to true when a field in the config is changed. */
private dirty = false; private dirty = false;
/** Set to true when a 'restart required' field in the config is changed. */ /** Set to true when a 'restart required' field in the config is changed. */
@@ -274,6 +276,7 @@ export class Config<
private _staging?: { config: Config<Fields>, changes: Set<string>}; private _staging?: { config: Config<Fields>, changes: Set<string>};
/** Get the latest version of staging */ /** Get the latest version of staging */
// TODO replace with "using config.startStating()"
get staging(): Config<Fields> { get staging(): Config<Fields> {
if (this._staging) { return this._staging.config; } if (this._staging) { return this._staging.config; }
const config = new this.constructor(this.location, this.fields); const config = new this.constructor(this.location, this.fields);
@@ -417,9 +420,14 @@ export class Config<
* @param notify - False to skip setting dirty flags and emitting events * @param notify - False to skip setting dirty flags and emitting events
*/ */
_set(name: keyof Fields & string, value: FieldValue, notify: boolean = true) { _set(name: keyof Fields & string, value: FieldValue, notify: boolean = true) {
if (this._readonly) {
throw new Error("config is readonly and cannot have values changed");
}
const prev = this.fields[name]; const prev = this.fields[name];
this.fields[name] = value as any; this.fields[name] = value as any;
this.revertStaging(); this.revertStaging();
if (notify && !isDeepStrictEqual(value, prev)) { if (notify && !isDeepStrictEqual(value, prev)) {
const def = this.constructor.fieldDefinitions[name]; const def = this.constructor.fieldDefinitions[name];
if (def.restartRequired) { if (def.restartRequired) {
@@ -650,23 +658,37 @@ export class Config<
const value = Config._coerceValue(name, def, newValue); const value = Config._coerceValue(name, def, newValue);
if (def.validator) { const _readonly = this._readonly;
try { this.staging._readonly = true;
def.validator(value, this); this._readonly = true;
} catch (err: any) { try {
throw new InvalidValue(`Failed validation of ${name}: ${err.message}`); if (def.validator) {
try {
def.validator(value, this);
} catch (err: any) {
throw new InvalidValue(`Failed validation of ${name}: ${err.message}`);
}
} }
} finally {
this._readonly = _readonly;
this.staging._readonly = _readonly;
} }
const dependents = this.constructor.fieldDependents.get(name); const dependents = this.constructor.fieldDependents.get(name);
if (dependents) { if (dependents) {
// This mimics stage + commit but optimised for a single value
this.staging._set(name, value); this.staging._set(name, value);
for (const dependent of dependents) { this.staging._readonly = true;
try { try {
dependent.def.validator(this.get(dependent.name as keyof Fields & string, remote), this.staging); for (const dependent of dependents) {
} catch (err: any) { try {
throw new InvalidValue(`Failed validation of dependent ${dependent.name}: ${err.message}`); dependent.def.validator(this.get(dependent.name as any, remote), this.staging);
} catch (err: any) {
throw new InvalidValue(`Failed validation of dependent ${dependent.name}: ${err.message}`);
}
} }
} finally {
this.revertStaging();
} }
} }
@@ -715,23 +737,37 @@ export class Config<
delete updated[prop]; delete updated[prop];
} }
if (def.validator) { const _readonly = this._readonly;
try { this.staging._readonly = true;
def.validator(updated, this); this._readonly = true;
} catch (err: any) { try {
throw new InvalidValue(`Failed validation of ${name}: ${err.message}`); if (def.validator) {
try {
def.validator(updated, this);
} catch (err: any) {
throw new InvalidValue(`Failed validation of ${name}: ${err.message}`);
}
} }
} finally {
this._readonly = _readonly;
this.staging._readonly = _readonly;
} }
const dependents = this.constructor.fieldDependents.get(name); const dependents = this.constructor.fieldDependents.get(name);
if (dependents) { if (dependents) {
// This mimics stage + commit but optimised for a single value
this.staging._set(name, updated); this.staging._set(name, updated);
for (const dependent of dependents) { this.staging._readonly = true;
try { try {
dependent.def.validator(this.get(dependent.name as keyof Fields & string, remote), this.staging); for (const dependent of dependents) {
} catch (err: any) { try {
throw new InvalidValue(`Failed validation of dependent ${dependent.name}: ${err.message}`); dependent.def.validator(this.get(dependent.name as any, remote), this.staging);
} catch (err: any) {
throw new InvalidValue(`Failed validation of dependent ${dependent.name}: ${err.message}`);
}
} }
} finally {
this.revertStaging();
} }
} }
@@ -749,6 +785,10 @@ export class Config<
* @throws {InvalidValue} if value is not allowed for the field. * @throws {InvalidValue} if value is not allowed for the field.
*/ */
stage<Field extends keyof Fields & string>(name: Field, newValue: Fields[Field], remote = this.location) { stage<Field extends keyof Fields & string>(name: Field, newValue: Fields[Field], remote = this.location) {
if (this._readonly) {
throw new Error("config is readonly and cannot have values changed");
}
const def = this.constructor.fieldDefinitions[name]; const def = this.constructor.fieldDefinitions[name];
if (!def) { if (!def) {
throw new InvalidField(`No field named '${name}'`); throw new InvalidField(`No field named '${name}'`);
@@ -780,6 +820,10 @@ export class Config<
value?: unknown, value?: unknown,
remote = this.location, remote = this.location,
) { ) {
if (this._readonly) {
throw new Error("config is readonly and cannot have values changed");
}
const def = this.constructor.fieldDefinitions[name]; const def = this.constructor.fieldDefinitions[name];
if (!def) { if (!def) {
throw new InvalidField(`No field named '${name}'`); throw new InvalidField(`No field named '${name}'`);
@@ -812,6 +856,10 @@ export class Config<
* @throws {InvalidValue} if a value is not allowed for its field. * @throws {InvalidValue} if a value is not allowed for its field.
*/ */
commitStaging() { commitStaging() {
if (this._readonly) {
throw new Error("config is readonly and cannot have values changed");
}
const staging = this._staging; const staging = this._staging;
if (!staging) { if (!staging) {
return; // Nothing to commit return; // Nothing to commit
@@ -819,14 +867,20 @@ export class Config<
// Validate all fields using the current state of staging // Validate all fields using the current state of staging
const config = staging.config; const config = staging.config;
for (const [fieldName, fieldDef] of Object.entries(this.constructor.fieldDefinitions)) { const _readonly = this._readonly;
if (fieldDef.validator) { config._readonly = true;
try { try {
fieldDef.validator(config.fields[fieldName as keyof Fields], config); for (const [fieldName, fieldDef] of Object.entries(this.constructor.fieldDefinitions)) {
} catch (err: any) { if (fieldDef.validator) {
throw new InvalidValue(`Failed validation of ${fieldName}: ${err.message}`); try {
fieldDef.validator(config.fields[fieldName as keyof Fields], config);
} catch (err: any) {
throw new InvalidValue(`Failed validation of ${fieldName}: ${err.message}`);
}
} }
} }
} finally {
config._readonly = _readonly;
} }
// Validation success, set all values which have changed // Validation success, set all values which have changed
@@ -838,6 +892,9 @@ export class Config<
/** Revert all changes in staging */ /** Revert all changes in staging */
revertStaging() { revertStaging() {
if (this._readonly) {
throw new Error("config is readonly and cannot have values changed");
}
this._staging = undefined; this._staging = undefined;
} }
} }
+46
View File
@@ -90,6 +90,29 @@ describe("lib/config/classes", function() {
} }
}, },
}, },
"test.badValidator": {
type: "string",
optional: true,
dependsOn: ["test.base"],
validator(value, config) {
if (config.get("test.base") < 1) {
return;
}
if (value === "set") {
config.set("alpha.foo", "BAD");
} else if (value === "setProp") {
config.setProp("beta.bar", "baz", "BAD");
} else if (value === "stage") {
config.stage("alpha.foo", "BAD");
} else if (value === "stageProp") {
config.stageProp("beta.bar", "baz", "BAD");
} else if (value === "commitStaging") {
config.commitStaging();
} else if (value === "revertStaging") {
config.revertStaging();
}
},
},
}; };
} }
@@ -1076,5 +1099,28 @@ describe("lib/config/classes", function() {
assert.equal(testInstance.get("alpha.foo"), null); assert.equal(testInstance.get("alpha.foo"), null);
}); });
}); });
describe("is readonly in validators", function() {
for (const method of [
"set", "setProp", "stage", "stageProp", "commitStaging", "revertStaging",
]) {
it(`${method} should throw if called inside a validator`, function() {
const testInstance = new TestConfig("local");
assert.throws(
() => testInstance.set("test.badValidator", method),
/config is readonly and cannot have values changed/
);
});
it(`${method} should throw if called inside a dependent validator`, function() {
const testInstance = new TestConfig("local");
testInstance.set("test.base", 0);
testInstance.set("test.badValidator", method);
assert.throws(
() => testInstance.set("test.base", 1),
/config is readonly and cannot have values changed/
);
});
}
});
}); });
}); });