ultrawidify/src/ext/lib/Settings.ts

368 lines
12 KiB
TypeScript
Raw Normal View History

import Debug from '../conf/Debug';
import currentBrowser from '../conf/BrowserDetect';
import ExtensionConf from '../conf/ExtensionConf';
import ExtensionMode from '../../common/enums/ExtensionMode.enum';
import ObjectCopy from './ObjectCopy';
import StretchType from '../../common/enums/StretchType.enum';
import VideoAlignmentType from '../../common/enums/VideoAlignmentType.enum';
2019-07-05 23:45:29 +02:00
import ExtensionConfPatch from '../conf/ExtConfPatches';
import CropModePersistence from '../../common/enums/CropModePersistence.enum';
import BrowserDetect from '../conf/BrowserDetect';
import Logger from './Logger';
import SettingsInterface from '../../common/interfaces/SettingsInterface';
import AspectRatioType from '../../common/enums/AspectRatioType.enum';
import { SiteSettings } from './settings/SiteSettings';
2020-04-13 15:20:29 +02:00
if(process.env.CHANNEL !== 'stable'){
2020-12-03 01:05:39 +01:00
console.info("Loading Settings");
2020-04-13 15:20:29 +02:00
}
class Settings {
//#region flags
useSync: boolean = false;
version: string;
//#endregion
//#region helper classes
logger: Logger;
//#endregion
//#region data
default: SettingsInterface; // default settings
active: SettingsInterface; // currently active settings
//#endregion
//#region callbacks
onSettingsChanged: any;
afterSettingsSaved: any;
//#endregion
2019-09-03 00:28:35 +02:00
constructor(options) {
// Options: activeSettings, updateCallback, logger
this.logger = options?.logger;
this.onSettingsChanged = options?.onSettingsChanged;
this.afterSettingsSaved = options?.afterSettingsSaved;
this.active = options?.activeSettings ?? undefined;
this.default = ExtensionConf;
2019-08-25 01:52:04 +02:00
this.default['version'] = this.getExtensionVersion();
chrome.storage.onChanged.addListener((changes, area) => {this.storageChangeListener(changes, area)});
2019-10-24 00:44:27 +02:00
}
private storageChangeListener(changes, area) {
if (!changes.uwSettings) {
return;
}
this.logger?.log('info', 'settings', "[Settings::<storage/on change>] Settings have been changed outside of here. Updating active settings. Changes:", changes, "storage area:", area);
// if (changes['uwSettings'] && changes['uwSettings'].newValue) {
// this.logger?.log('info', 'settings',"[Settings::<storage/on change>] new settings object:", JSON.parse(changes.uwSettings.newValue));
// }
const parsedSettings = JSON.parse(changes.uwSettings.newValue);
this.setActive(parsedSettings);
this.logger?.log('info', 'debug', 'Does parsedSettings.preventReload exist?', parsedSettings.preventReload, "Does callback exist?", !!this.onSettingsChanged);
2019-10-24 00:44:27 +02:00
if (!parsedSettings.preventReload && this.onSettingsChanged) {
2019-10-24 00:44:27 +02:00
try {
this.onSettingsChanged();
2021-04-01 21:44:07 +02:00
this.logger?.log('info', 'settings', '[Settings] Update callback finished.')
2019-10-24 00:44:27 +02:00
} catch (e) {
this.logger?.log('error', 'settings', "[Settings] CALLING UPDATE CALLBACK FAILED. Reason:", e)
2019-10-24 00:44:27 +02:00
}
}
2020-12-21 23:27:45 +01:00
if (this.afterSettingsSaved) {
this.afterSettingsSaved();
}
}
static getExtensionVersion(): string {
return chrome.runtime.getManifest().version;
}
getExtensionVersion(): string {
return Settings.getExtensionVersion();
2019-08-25 01:52:04 +02:00
}
private compareExtensionVersions(a, b) {
let aa = a.split('.');
let bb = b.split('.');
2019-09-03 00:28:35 +02:00
if (+aa[0] !== +bb[0]) {
// difference on first digit
return +aa[0] - +bb[0];
2019-09-03 00:28:35 +02:00
} if (+aa[1] !== +bb[1]) {
// first digit same, difference on second digit
return +aa[1] - +bb[1];
2019-09-03 00:28:35 +02:00
} if (+aa[2] !== +bb[2]) {
return +aa[2] - +bb[2];
2019-09-03 00:28:35 +02:00
// first two digits the same, let's check the third digit
} else {
// fourth digit is optional. When not specified, 0 is implied
// btw, ++(aa[3] || 0) - ++(bb[3] || 0) doesn't work
// Since some things are easier if we actually have a value for
// the fourth digit, we turn a possible undefined into a zero
aa[3] = aa[3] === undefined ? 0 : aa[3];
bb[3] = bb[3] === undefined ? 0 : bb[3];
// also, the fourth digit can start with a letter.
// versions that start with a letter are ranked lower than
// versions x.x.x.0
if (
(isNaN(+aa[3]) && !isNaN(+bb[3]))
|| (!isNaN(+aa[3]) && isNaN(+bb[3]))
) {
return isNaN(+aa[3]) ? -1 : 1;
}
// at this point, either both version numbers are a NaN or
// both versions are a number.
if (!isNaN(+aa[3])) {
return +aa[3] - +bb[3];
}
// letters have their own hierarchy:
// dev < a < b < rc
let av = this.getPrereleaseVersionHierarchy(aa[3]);
let bv = this.getPrereleaseVersionHierarchy(bb[3]);
if (av !== bv) {
return av - bv;
} else {
return +(aa[3].replace(/\D/g,'')) - +(bb[3].replace(/\D/g, ''));
}
}
}
private getPrereleaseVersionHierarchy(version) {
if (version.startsWith('dev')) {
return 0;
2019-09-03 00:28:35 +02:00
}
if (version.startsWith('a')) {
return 1;
}
if (version.startsWith('b')) {
return 2;
}
return 3;
2019-09-03 00:28:35 +02:00
}
private sortConfPatches(patchesIn) {
return patchesIn.sort( (a, b) => this.compareExtensionVersions(a.forVersion, b.forVersion));
2019-09-03 00:28:35 +02:00
}
private findFirstNecessaryPatch(version, extconfPatches) {
2019-09-03 00:28:35 +02:00
const sorted = this.sortConfPatches(extconfPatches);
return sorted.findIndex(x => this.compareExtensionVersions(x.forVersion, version) > 0);
2019-09-03 00:28:35 +02:00
}
private applySettingsPatches(oldVersion, patches) {
2019-09-03 00:28:35 +02:00
let index = this.findFirstNecessaryPatch(oldVersion, patches);
if (index === -1) {
this.logger?.log('info','settings','[Settings::applySettingsPatches] There are no pending conf patches.');
2019-09-03 00:28:35 +02:00
return;
}
// apply all remaining patches
this.logger?.log('info', 'settings', `[Settings::applySettingsPatches] There are ${patches.length - index} settings patches to apply`);
while (index < patches.length) {
2019-11-02 01:05:36 +01:00
const updateFn = patches[index].updateFn;
2019-09-03 00:28:35 +02:00
delete patches[index].forVersion;
2019-11-02 01:05:36 +01:00
delete patches[index].updateFn;
2019-11-02 01:05:36 +01:00
if (Object.keys(patches[index]).length > 0) {
ObjectCopy.overwrite(this.active, patches[index]);
}
if (updateFn) {
try {
updateFn(this.active, this.getDefaultSettings());
} catch (e) {
this.logger?.log('error', 'settings', '[Settings::applySettingsPatches] Failed to execute update function. Keeping settings object as-is. Error:', e);
2019-11-02 01:05:36 +01:00
}
}
index++;
}
2019-09-03 00:28:35 +02:00
}
async init() {
2018-08-21 23:48:47 +02:00
const settings = await this.get();
this.version = this.getExtensionVersion();
// |—> on first setup, settings is undefined & settings.version is haram
// | since new installs ship with updates by default, no patching is
// | needed. In this case, we assume we're on the current version
const oldVersion = (settings && settings.version) || this.version;
2019-10-27 00:10:49 +02:00
if (settings) {
this.logger?.log('info', 'settings', "[Settings::init] Configuration fetched from storage:", settings,
"\nlast saved with:", settings.version,
"\ncurrent version:", this.version
);
}
2019-10-27 00:10:49 +02:00
// if (Debug.flushStoredSettings) {
// this.logger?.log('info', 'settings', "%c[Settings::init] Debug.flushStoredSettings is true. Using default settings", "background: #d00; color: #ffd");
2019-10-27 00:10:49 +02:00
// Debug.flushStoredSettings = false; // don't do it again this session
// this.active = this.getDefaultSettings();
// this.active.version = this.version;
// this.set(this.active);
// return this.active;
// }
// if there's no settings saved, return default settings.
2018-08-07 23:31:28 +02:00
if(! settings || (Object.keys(settings).length === 0 && settings.constructor === Object)) {
this.logger?.log(
'info',
'settings',
'[Settings::init] settings don\'t exist. Using defaults.\n#keys:',
settings ? Object.keys(settings).length : 0,
'\nsettings:',
2019-09-25 07:10:36 +02:00
settings
);
this.active = this.getDefaultSettings();
this.active.version = this.version;
await this.save();
return this.active;
}
// if there's settings, set saved object as active settings
this.active = settings;
// if version number is undefined, we make it defined
// this should only happen on first extension initialization
if (!this.active.version) {
this.active.version = this.version;
await this.save();
return this.active;
}
2019-08-25 01:52:04 +02:00
// check if extension has been updated. If not, return settings as they were retrieved
if (this.active.version === this.version) {
this.logger?.log('info', 'settings', "[Settings::init] extension was saved with current version of ultrawidify. Returning object as-is.");
return this.active;
}
// This means extension update happened.
// btw fun fact — we can do version rollbacks, which might come in handy while testing
this.active.version = this.version;
// if extension has been updated, update existing settings with any options added in the
// new version. In addition to that, we remove old keys that are no longer used.
const patched = ObjectCopy.addNew(settings, this.default);
this.logger?.log('info', 'settings',"[Settings.init] Results from ObjectCopy.addNew()?", patched, "\n\nSettings from storage", settings, "\ndefault?", this.default);
if (patched) {
this.active = patched;
}
2018-08-22 22:34:07 +02:00
2019-07-05 23:45:29 +02:00
// in case settings in previous version contained a fucky wucky, we overwrite existing settings with a patch
2019-09-03 00:28:35 +02:00
this.applySettingsPatches(oldVersion, ExtensionConfPatch);
2019-07-05 23:45:29 +02:00
2019-09-03 00:28:35 +02:00
// set 'whatsNewChecked' flag to false when updating, always
this.active.whatsNewChecked = false;
2019-08-25 01:52:04 +02:00
// update settings version to current
this.active.version = this.version;
await this.save();
return this.active;
}
async get() {
2019-05-10 19:21:17 +02:00
let ret;
ret = await chrome.storage.local.get('uwSettings');
2019-05-10 19:21:17 +02:00
this.logger?.log('info', 'settings', 'Got settings:', ret && ret.uwSettings && JSON.parse(ret.uwSettings));
2019-05-10 19:21:17 +02:00
try {
return JSON.parse(ret.uwSettings);
} catch(e) {
return undefined;
}
}
async set(extensionConf, options?) {
2019-11-02 01:05:36 +01:00
if (!options || !options.forcePreserveVersion) {
extensionConf.version = this.version;
}
this.logger?.log('info', 'settings', "[Settings::set] setting new settings:", extensionConf)
return chrome.storage.local.set( {'uwSettings': JSON.stringify(extensionConf)});
}
2018-08-07 23:31:28 +02:00
async setActive(activeSettings) {
this.active = activeSettings;
}
async setProp(prop, value) {
this.active[prop] = value;
}
async save(options?) {
if (Debug.debug && Debug.storage) {
console.log("[Settings::save] Saving active settings:", this.active);
}
this.active.preventReload = undefined;
2019-11-02 01:05:36 +01:00
await this.set(this.active, options);
2018-08-07 23:31:28 +02:00
}
2019-10-24 00:44:27 +02:00
async saveWithoutReload() {
this.active.preventReload = true;
await this.set(this.active);
2019-10-24 00:44:27 +02:00
}
async rollback() {
this.active = await this.get();
}
getDefaultSettings() {
return JSON.parse(JSON.stringify(this.default));
}
getDefaultOption(option?) {
2019-02-13 23:58:19 +01:00
const allDefault = {
mode: ExtensionMode.Default,
autoar: ExtensionMode.Default,
autoarFallback: ExtensionMode.Default,
stretch: StretchType.Default,
videoAlignment: VideoAlignmentType.Default,
2019-02-13 23:58:19 +01:00
};
if (!option || allDefault[option] === undefined) {
return allDefault;
}
2019-02-13 23:58:19 +01:00
return allDefault[option];
}
/**
* Gets default site configuration. Only returns essential settings.
* @returns
*/
getDefaultSiteConfiguration() {
return {
type: 'user-added',
defaultCrop: {
type: AspectRatioType.Automatic, // AARD is enabled by default
},
defaultStretch: {
type: StretchType.NoStretch, // because we aren't uncultured savages
},
}
}
getSiteSettings(site: string = window.location.hostname): SiteSettings {
return new SiteSettings(this, site);
}
}
export default Settings;
2020-12-03 01:05:39 +01:00
if(process.env.CHANNEL !== 'stable'){
console.info("Settings loaded");
}