admin/yunhaifinance
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: ERP system with advance verification fixes

Browse Source
This commit is contained in:
System Administrator
2026-03-25 23:55:36 +07:00
commit 563ca12d76
5920 changed files with 828689 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
backups/20260325_002423/backend/node_modules/conf/dist/source/index.d.ts
Generated Vendored
+88
View File
@@ -0,0 +1,88 @@
/// <reference types="node" />
import { EventEmitter } from 'events';
import { OnDidChangeCallback, Options, Unsubscribe, Schema, OnDidAnyChangeCallback } from './types';
declare class Conf<T extends Record<string, any> = Record<string, unknown>> implements Iterable<[keyof T, T[keyof T]]> {
#private;
readonly path: string;
readonly events: EventEmitter;
constructor(partialOptions?: Readonly<Partial<Options<T>>>);
/**
Get an item.
@param key - The key of the item to get.
@param defaultValue - The default value if the item does not exist.
*/
get<Key extends keyof T>(key: Key): T[Key];
get<Key extends keyof T>(key: Key, defaultValue: Required<T>[Key]): Required<T>[Key];
get<Key extends string, Value = unknown>(key: Exclude<Key, keyof T>, defaultValue?: Value): Value;
/**
Set an item or multiple items at once.
@param {key|object} - You can use [dot-notation](https://github.com/sindresorhus/dot-prop) in a key to access nested properties. Or a hashmap of items to set at once.
@param value - Must be JSON serializable. Trying to set the type `undefined`, `function`, or `symbol` will result in a `TypeError`.
*/
set<Key extends keyof T>(key: Key, value?: T[Key]): void;
set(key: string, value: unknown): void;
set(object: Partial<T>): void;
/**
Check if an item exists.
@param key - The key of the item to check.
*/
has<Key extends keyof T>(key: Key | string): boolean;
/**
Reset items to their default values, as defined by the `defaults` or `schema` option.
@see `clear()` to reset all items.
@param keys - The keys of the items to reset.
*/
reset<Key extends keyof T>(...keys: Key[]): void;
/**
Delete an item.
@param key - The key of the item to delete.
*/
delete<Key extends keyof T>(key: Key): void;
/**
Delete all items.
This resets known items to their default values, if defined by the `defaults` or `schema` option.
*/
clear(): void;
/**
Watches the given `key`, calling `callback` on any changes.
@param key - The key wo watch.
@param callback - A callback function that is called on any changes. When a `key` is first set `oldValue` will be `undefined`, and when a key is deleted `newValue` will be `undefined`.
@returns A function, that when called, will unsubscribe.
*/
onDidChange<Key extends keyof T>(key: Key, callback: OnDidChangeCallback<T[Key]>): Unsubscribe;
/**
Watches the whole config object, calling `callback` on any changes.
@param callback - A callback function that is called on any changes. When a `key` is first set `oldValue` will be `undefined`, and when a key is deleted `newValue` will be `undefined`.
@returns A function, that when called, will unsubscribe.
*/
onDidAnyChange(callback: OnDidAnyChangeCallback<T>): Unsubscribe;
get size(): number;
get store(): T;
set store(value: T);
[Symbol.iterator](): IterableIterator<[keyof T, T[keyof T]]>;
private _encryptData;
private _handleChange;
private readonly _deserialize;
private readonly _serialize;
private _validate;
private _ensureDirectory;
private _write;
private _watch;
private _migrate;
private _containsReservedKey;
private _isVersionInRangeFormat;
private _shouldPerformMigration;
private _get;
private _set;
}
export { Schema, Options };
export default Conf;
backups/20260325_002423/backend/node_modules/conf/dist/source/index.js
Generated Vendored
+467
View File
@@ -0,0 +1,467 @@
"use strict";
var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, privateMap, value) {
if (!privateMap.has(receiver)) {
throw new TypeError("attempted to set private field on non-instance");
}
privateMap.set(receiver, value);
return value;
};
var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, privateMap) {
if (!privateMap.has(receiver)) {
throw new TypeError("attempted to get private field on non-instance");
}
return privateMap.get(receiver);
};
var _a, _b;
var _validator, _encryptionKey, _options, _defaultValues;
Object.defineProperty(exports, "__esModule", { value: true });
const fs = require("fs");
const path = require("path");
const crypto = require("crypto");
const assert = require("assert");
const events_1 = require("events");
const dotProp = require("dot-prop");
const makeDir = require("make-dir");
const pkgUp = require("pkg-up");
const envPaths = require("env-paths");
const atomically = require("atomically");
const ajv_1 = require("ajv");
const ajv_formats_1 = require("ajv-formats");
const debounceFn = require("debounce-fn");
const semver = require("semver");
const onetime = require("onetime");
const encryptionAlgorithm = 'aes-256-cbc';
const createPlainObject = () => {
return Object.create(null);
};
const isExist = (data) => {
return data !== undefined && data !== null;
};
// Prevent caching of this module so module.parent is always accurate
// eslint-disable-next-line @typescript-eslint/no-dynamic-delete
delete require.cache[__filename];
const parentDir = path.dirname((_b = (_a = module.parent) === null || _a === void 0 ? void 0 : _a.filename) !== null && _b !== void 0 ? _b : '.');
const checkValueType = (key, value) => {
const nonJsonTypes = new Set([
'undefined',
'symbol',
'function'
]);
const type = typeof value;
if (nonJsonTypes.has(type)) {
throw new TypeError(`Setting a value of type \`${type}\` for key \`${key}\` is not allowed as it's not supported by JSON`);
}
};
const INTERNAL_KEY = '__internal__';
const MIGRATION_KEY = `${INTERNAL_KEY}.migrations.version`;
class Conf {
constructor(partialOptions = {}) {
var _a;
_validator.set(this, void 0);
_encryptionKey.set(this, void 0);
_options.set(this, void 0);
_defaultValues.set(this, {});
this._deserialize = value => JSON.parse(value);
this._serialize = value => JSON.stringify(value, null, '\t');
const options = {
configName: 'config',
fileExtension: 'json',
projectSuffix: 'nodejs',
clearInvalidConfig: false,
accessPropertiesByDotNotation: true,
...partialOptions
};
const getPackageData = onetime(() => {
const packagePath = pkgUp.sync({ cwd: parentDir });
// Can't use `require` because of Webpack being annoying:
// https://github.com/webpack/webpack/issues/196
const packageData = packagePath && JSON.parse(fs.readFileSync(packagePath, 'utf8'));
return packageData !== null && packageData !== void 0 ? packageData : {};
});
if (!options.cwd) {
if (!options.projectName) {
options.projectName = getPackageData().name;
}
if (!options.projectName) {
throw new Error('Project name could not be inferred. Please specify the `projectName` option.');
}
options.cwd = envPaths(options.projectName, { suffix: options.projectSuffix }).config;
}
__classPrivateFieldSet(this, _options, options);
if (options.schema) {
if (typeof options.schema !== 'object') {
throw new TypeError('The `schema` option must be an object.');
}
const ajv = new ajv_1.default({
allErrors: true,
useDefaults: true
});
ajv_formats_1.default(ajv);
const schema = {
type: 'object',
properties: options.schema
};
__classPrivateFieldSet(this, _validator, ajv.compile(schema));
for (const [key, value] of Object.entries(options.schema)) {
if (value === null || value === void 0 ? void 0 : value.default) {
__classPrivateFieldGet(this, _defaultValues)[key] = value.default;
}
}
}
if (options.defaults) {
__classPrivateFieldSet(this, _defaultValues, {
...__classPrivateFieldGet(this, _defaultValues),
...options.defaults
});
}
if (options.serialize) {
this._serialize = options.serialize;
}
if (options.deserialize) {
this._deserialize = options.deserialize;
}
this.events = new events_1.EventEmitter();
__classPrivateFieldSet(this, _encryptionKey, options.encryptionKey);
const fileExtension = options.fileExtension ? `.${options.fileExtension}` : '';
this.path = path.resolve(options.cwd, `${(_a = options.configName) !== null && _a !== void 0 ? _a : 'config'}${fileExtension}`);
const fileStore = this.store;
const store = Object.assign(createPlainObject(), options.defaults, fileStore);
this._validate(store);
try {
assert.deepEqual(fileStore, store);
}
catch (_b) {
this.store = store;
}
if (options.watch) {
this._watch();
}
if (options.migrations) {
if (!options.projectVersion) {
options.projectVersion = getPackageData().version;
}
if (!options.projectVersion) {
throw new Error('Project version could not be inferred. Please specify the `projectVersion` option.');
}
this._migrate(options.migrations, options.projectVersion);
}
}
get(key, defaultValue) {
if (__classPrivateFieldGet(this, _options).accessPropertiesByDotNotation) {
return this._get(key, defaultValue);
}
return key in this.store ? this.store[key] : defaultValue;
}
set(key, value) {
if (typeof key !== 'string' && typeof key !== 'object') {
throw new TypeError(`Expected \`key\` to be of type \`string\` or \`object\`, got ${typeof key}`);
}
if (typeof key !== 'object' && value === undefined) {
throw new TypeError('Use `delete()` to clear values');
}
if (this._containsReservedKey(key)) {
throw new TypeError(`Please don't use the ${INTERNAL_KEY} key, as it's used to manage this module internal operations.`);
}
const { store } = this;
const set = (key, value) => {
checkValueType(key, value);
if (__classPrivateFieldGet(this, _options).accessPropertiesByDotNotation) {
dotProp.set(store, key, value);
}
else {
store[key] = value;
}
};
if (typeof key === 'object') {
const object = key;
for (const [key, value] of Object.entries(object)) {
set(key, value);
}
}
else {
set(key, value);
}
this.store = store;
}
/**
Check if an item exists.
@param key - The key of the item to check.
*/
has(key) {
if (__classPrivateFieldGet(this, _options).accessPropertiesByDotNotation) {
return dotProp.has(this.store, key);
}
return key in this.store;
}
/**
Reset items to their default values, as defined by the `defaults` or `schema` option.
@see `clear()` to reset all items.
@param keys - The keys of the items to reset.
*/
reset(...keys) {
for (const key of keys) {
if (isExist(__classPrivateFieldGet(this, _defaultValues)[key])) {
this.set(key, __classPrivateFieldGet(this, _defaultValues)[key]);
}
}
}
/**
Delete an item.
@param key - The key of the item to delete.
*/
delete(key) {
const { store } = this;
if (__classPrivateFieldGet(this, _options).accessPropertiesByDotNotation) {
dotProp.delete(store, key);
}
else {
// eslint-disable-next-line @typescript-eslint/no-dynamic-delete
delete store[key];
}
this.store = store;
}
/**
Delete all items.
This resets known items to their default values, if defined by the `defaults` or `schema` option.
*/
clear() {
this.store = createPlainObject();
for (const key of Object.keys(__classPrivateFieldGet(this, _defaultValues))) {
this.reset(key);
}
}
/**
Watches the given `key`, calling `callback` on any changes.
@param key - The key wo watch.
@param callback - A callback function that is called on any changes. When a `key` is first set `oldValue` will be `undefined`, and when a key is deleted `newValue` will be `undefined`.
@returns A function, that when called, will unsubscribe.
*/
onDidChange(key, callback) {
if (typeof key !== 'string') {
throw new TypeError(`Expected \`key\` to be of type \`string\`, got ${typeof key}`);
}
if (typeof callback !== 'function') {
throw new TypeError(`Expected \`callback\` to be of type \`function\`, got ${typeof callback}`);
}
return this._handleChange(() => this.get(key), callback);
}
/**
Watches the whole config object, calling `callback` on any changes.
@param callback - A callback function that is called on any changes. When a `key` is first set `oldValue` will be `undefined`, and when a key is deleted `newValue` will be `undefined`.
@returns A function, that when called, will unsubscribe.
*/
onDidAnyChange(callback) {
if (typeof callback !== 'function') {
throw new TypeError(`Expected \`callback\` to be of type \`function\`, got ${typeof callback}`);
}
return this._handleChange(() => this.store, callback);
}
get size() {
return Object.keys(this.store).length;
}
get store() {
try {
const data = fs.readFileSync(this.path, __classPrivateFieldGet(this, _encryptionKey) ? null : 'utf8');
const dataString = this._encryptData(data);
const deserializedData = this._deserialize(dataString);
this._validate(deserializedData);
return Object.assign(createPlainObject(), deserializedData);
}
catch (error) {
if (error.code === 'ENOENT') {
this._ensureDirectory();
return createPlainObject();
}
if (__classPrivateFieldGet(this, _options).clearInvalidConfig && error.name === 'SyntaxError') {
return createPlainObject();
}
throw error;
}
}
set store(value) {
this._ensureDirectory();
this._validate(value);
this._write(value);
this.events.emit('change');
}
*[(_validator = new WeakMap(), _encryptionKey = new WeakMap(), _options = new WeakMap(), _defaultValues = new WeakMap(), Symbol.iterator)]() {
for (const [key, value] of Object.entries(this.store)) {
yield [key, value];
}
}
_encryptData(data) {
if (!__classPrivateFieldGet(this, _encryptionKey)) {
return data.toString();
}
try {
// Check if an initialization vector has been used to encrypt the data
if (__classPrivateFieldGet(this, _encryptionKey)) {
try {
if (data.slice(16, 17).toString() === ':') {
const initializationVector = data.slice(0, 16);
const password = crypto.pbkdf2Sync(__classPrivateFieldGet(this, _encryptionKey), initializationVector.toString(), 10000, 32, 'sha512');
const decipher = crypto.createDecipheriv(encryptionAlgorithm, password, initializationVector);
data = Buffer.concat([decipher.update(Buffer.from(data.slice(17))), decipher.final()]).toString('utf8');
}
else {
const decipher = crypto.createDecipher(encryptionAlgorithm, __classPrivateFieldGet(this, _encryptionKey));
data = Buffer.concat([decipher.update(Buffer.from(data)), decipher.final()]).toString('utf8');
}
}
catch (_a) { }
}
}
catch (_b) { }
return data.toString();
}
_handleChange(getter, callback) {
let currentValue = getter();
const onChange = () => {
const oldValue = currentValue;
const newValue = getter();
try {
// TODO: Use `util.isDeepStrictEqual` when targeting Node.js 10
assert.deepEqual(newValue, oldValue);
}
catch (_a) {
currentValue = newValue;
callback.call(this, newValue, oldValue);
}
};
this.events.on('change', onChange);
return () => this.events.removeListener('change', onChange);
}
_validate(data) {
if (!__classPrivateFieldGet(this, _validator)) {
return;
}
const valid = __classPrivateFieldGet(this, _validator).call(this, data);
if (valid || !__classPrivateFieldGet(this, _validator).errors) {
return;
}
const errors = __classPrivateFieldGet(this, _validator).errors
.map(({ dataPath, message = '' }) => `\`${dataPath.slice(1)}\` ${message}`);
throw new Error('Config schema violation: ' + errors.join('; '));
}
_ensureDirectory() {
// TODO: Use `fs.mkdirSync` `recursive` option when targeting Node.js 12.
// Ensure the directory exists as it could have been deleted in the meantime.
makeDir.sync(path.dirname(this.path));
}
_write(value) {
let data = this._serialize(value);
if (__classPrivateFieldGet(this, _encryptionKey)) {
const initializationVector = crypto.randomBytes(16);
const password = crypto.pbkdf2Sync(__classPrivateFieldGet(this, _encryptionKey), initializationVector.toString(), 10000, 32, 'sha512');
const cipher = crypto.createCipheriv(encryptionAlgorithm, password, initializationVector);
data = Buffer.concat([initializationVector, Buffer.from(':'), cipher.update(Buffer.from(data)), cipher.final()]);
}
// Temporary workaround for Conf being packaged in a Ubuntu Snap app.
// See https://github.com/sindresorhus/conf/pull/82
if (process.env.SNAP) {
fs.writeFileSync(this.path, data);
}
else {
try {
atomically.writeFileSync(this.path, data);
}
catch (error) {
// Fix for https://github.com/sindresorhus/electron-store/issues/106
// Sometimes on Windows, we will get an EXDEV error when atomic writing
// (even though to the same directory), so we fall back to non atomic write
if (error.code === 'EXDEV') {
fs.writeFileSync(this.path, data);
return;
}
throw error;
}
}
}
_watch() {
this._ensureDirectory();
if (!fs.existsSync(this.path)) {
this._write(createPlainObject());
}
fs.watch(this.path, { persistent: false }, debounceFn(() => {
// On Linux and Windows, writing to the config file emits a `rename` event, so we skip checking the event type.
this.events.emit('change');
}, { wait: 100 }));
}
_migrate(migrations, versionToMigrate) {
let previousMigratedVersion = this._get(MIGRATION_KEY, '0.0.0');
const newerVersions = Object.keys(migrations)
.filter(candidateVersion => this._shouldPerformMigration(candidateVersion, previousMigratedVersion, versionToMigrate));
let storeBackup = { ...this.store };
for (const version of newerVersions) {
try {
const migration = migrations[version];
migration(this);
this._set(MIGRATION_KEY, version);
previousMigratedVersion = version;
storeBackup = { ...this.store };
}
catch (error) {
this.store = storeBackup;
throw new Error(`Something went wrong during the migration! Changes applied to the store until this failed migration will be restored. ${error}`);
}
}
if (this._isVersionInRangeFormat(previousMigratedVersion) || !semver.eq(previousMigratedVersion, versionToMigrate)) {
this._set(MIGRATION_KEY, versionToMigrate);
}
}
_containsReservedKey(key) {
if (typeof key === 'object') {
const firsKey = Object.keys(key)[0];
if (firsKey === INTERNAL_KEY) {
return true;
}
}
if (typeof key !== 'string') {
return false;
}
if (__classPrivateFieldGet(this, _options).accessPropertiesByDotNotation) {
if (key.startsWith(`${INTERNAL_KEY}.`)) {
return true;
}
return false;
}
return false;
}
_isVersionInRangeFormat(version) {
return semver.clean(version) === null;
}
_shouldPerformMigration(candidateVersion, previousMigratedVersion, versionToMigrate) {
if (this._isVersionInRangeFormat(candidateVersion)) {
if (previousMigratedVersion !== '0.0.0' && semver.satisfies(previousMigratedVersion, candidateVersion)) {
return false;
}
return semver.satisfies(versionToMigrate, candidateVersion);
}
if (semver.lte(candidateVersion, previousMigratedVersion)) {
return false;
}
if (semver.gt(candidateVersion, versionToMigrate)) {
return false;
}
return true;
}
_get(key, defaultValue) {
return dotProp.get(this.store, key, defaultValue);
}
_set(key, value) {
const { store } = this;
dotProp.set(store, key, value);
this.store = store;
}
}
exports.default = Conf;
// For CommonJS default export support
module.exports = Conf;
module.exports.default = Conf;
backups/20260325_002423/backend/node_modules/conf/dist/source/types.d.ts
Generated Vendored
+210
View File
@@ -0,0 +1,210 @@
/// <reference types="node" />
import { JSONSchema as TypedJSONSchema } from 'json-schema-typed';
import Conf from '.';
import { EventEmitter } from 'events';
export interface Options<T> {
/**
Config used if there are no existing config.
**Note:** The values in `defaults` will overwrite the `default` key in the `schema` option.
*/
defaults?: Readonly<T>;
/**
[JSON Schema](https://json-schema.org) to validate your config data.
Under the hood, the JSON Schema validator [ajv](https://github.com/epoberezkin/ajv) is used to validate your config. We use [JSON Schema draft-07](https://json-schema.org/latest/json-schema-validation.html) and support all [validation keywords](https://github.com/epoberezkin/ajv/blob/master/KEYWORDS.md) and [formats](https://github.com/epoberezkin/ajv#formats).
You should define your schema as an object where each key is the name of your data's property and each value is a JSON schema used to validate that property. See more [here](https://json-schema.org/understanding-json-schema/reference/object.html#properties).
@example
```
import Conf = require('conf');
const schema = {
foo: {
type: 'number',
maximum: 100,
minimum: 1,
default: 50
},
bar: {
type: 'string',
format: 'url'
}
};
const config = new Conf({schema});
console.log(config.get('foo'));
//=> 50
config.set('foo', '1');
// [Error: Config schema violation: `foo` should be number]
```
**Note:** The `default` value will be overwritten by the `defaults` option if set.
*/
schema?: Schema<T>;
/**
Name of the config file (without extension).
Useful if you need multiple config files for your app or module. For example, different config files between two major versions.
@default 'config'
*/
configName?: string;
/**
You only need to specify this if you don't have a package.json file in your project or if it doesn't have a name defined within it.
Default: The name field in the `package.json` closest to where `conf` is imported.
*/
projectName?: string;
/**
You only need to specify this if you don't have a package.json file in your project or if it doesn't have a version defined within it.
Default: The name field in the `package.json` closest to where `conf` is imported.
*/
projectVersion?: string;
/**
You can use migrations to perform operations to the store whenever a version is changed.
The `migrations` object should consist of a key-value pair of `'version': handler`. The `version` can also be a [semver range](https://github.com/npm/node-semver#ranges).
Note: The version the migrations use refers to the __project version__ by default. If you want to change this behavior, specify the `projectVersion` option.
@example
```
import Conf = require('conf');
const store = new Conf({
migrations: {
'0.0.1': store => {
store.set('debugPhase', true);
},
'1.0.0': store => {
store.delete('debugPhase');
store.set('phase', '1.0.0');
},
'1.0.2': store => {
store.set('phase', '1.0.2');
},
'>=2.0.0': store => {
store.set('phase', '>=2.0.0');
}
}
});
```
*/
migrations?: Migrations<T>;
/**
__You most likely don't need this. Please don't use it unless you really have to.__
The only use-case I can think of is having the config located in the app directory or on some external storage. Default: System default user [config directory](https://github.com/sindresorhus/env-paths#pathsconfig).
*/
cwd?: string;
/**
Note that this is __not intended for security purposes__, since the encryption key would be easily found inside a plain-text Node.js app.
Its main use is for obscurity. If a user looks through the config directory and finds the config file, since it's just a JSON file, they may be tempted to modify it. By providing an encryption key, the file will be obfuscated, which should hopefully deter any users from doing so.
It also has the added bonus of ensuring the config file's integrity. If the file is changed in any way, the decryption will not work, in which case the store will just reset back to its default state.
When specified, the store will be encrypted using the [`aes-256-cbc`](https://en.wikipedia.org/wiki/Block_cipher_mode_of_operation) encryption algorithm.
*/
encryptionKey?: string | Buffer | NodeJS.TypedArray | DataView;
/**
Extension of the config file.
You would usually not need this, but could be useful if you want to interact with a file with a custom file extension that can be associated with your app. These might be simple save/export/preference files that are intended to be shareable or saved outside of the app.
@default 'json'
*/
fileExtension?: string;
/**
The config is cleared if reading the config file causes a `SyntaxError`. This is a good behavior for unimportant data, as the config file is not intended to be hand-edited, so it usually means the config is corrupt and there's nothing the user can do about it anyway. However, if you let the user edit the config file directly, mistakes might happen and it could be more useful to throw an error when the config is invalid instead of clearing.
@default false
*/
clearInvalidConfig?: boolean;
/**
Function to serialize the config object to a UTF-8 string when writing the config file.
You would usually not need this, but it could be useful if you want to use a format other than JSON.
@default value => JSON.stringify(value, null, '\t')
*/
readonly serialize?: Serialize<T>;
/**
Function to deserialize the config object from a UTF-8 string when reading the config file.
You would usually not need this, but it could be useful if you want to use a format other than JSON.
@default JSON.parse
*/
readonly deserialize?: Deserialize<T>;
/**
__You most likely don't need this. Please don't use it unless you really have to.__
Suffix appended to `projectName` during config file creation to avoid name conflicts with native apps.
You can pass an empty string to remove the suffix.
For example, on macOS, the config file will be stored in the `~/Library/Preferences/foo-nodejs` directory, where `foo` is the `projectName`.
@default 'nodejs'
*/
readonly projectSuffix?: string;
/**
Access nested properties by dot notation.
@default true
@example
```
const config = new Conf();
config.set({
foo: {
bar: {
foobar: '🦄'
}
}
});
console.log(config.get('foo.bar.foobar'));
//=> '🦄'
```
Alternatively, you can set this option to `false` so the whole string would be treated as one key.
@example
```
const config = new Conf({accessPropertiesByDotNotation: false});
config.set({
`foo.bar.foobar`: '🦄'
});
console.log(config.get('foo.bar.foobar'));
//=> '🦄'
```
*/
readonly accessPropertiesByDotNotation?: boolean;
/**
Watch for any changes in the config file and call the callback for `onDidChange` or `onDidAnyChange` if set. This is useful if there are multiple processes changing the same config file.
@default false
*/
readonly watch?: boolean;
}
export declare type Migrations<T> = Record<string, (store: Conf<T>) => void>;
export declare type Schema<T> = {
[Property in keyof T]: ValueSchema;
};
export declare type ValueSchema = TypedJSONSchema;
export declare type Serialize<T> = (value: T) => string;
export declare type Deserialize<T> = (text: string) => T;
export declare type OnDidChangeCallback<T> = (newValue?: T, oldValue?: T) => void;
export declare type OnDidAnyChangeCallback<T> = (newValue?: Readonly<T>, oldValue?: Readonly<T>) => void;
export declare type Unsubscribe = () => EventEmitter;
backups/20260325_002423/backend/node_modules/conf/dist/source/types.js
Generated Vendored
+2
View File
@@ -0,0 +1,2 @@
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
backups/20260325_002423/backend/node_modules/conf/license
Generated Vendored
+9
View File
@@ -0,0 +1,9 @@
MIT License
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
backups/20260325_002423/backend/node_modules/conf/node_modules/.bin/semver
Generated Vendored
+15
View File
@@ -0,0 +1,15 @@
#!/bin/sh
basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
case `uname` in
*CYGWIN*) basedir=`cygpath -w "$basedir"`;;
esac
if [ -x "$basedir/node" ]; then
"$basedir/node" "$basedir/../../../semver/bin/semver.js" "$@"
ret=$?
else
node "$basedir/../../../semver/bin/semver.js" "$@"
ret=$?
fi
exit $ret
backups/20260325_002423/backend/node_modules/conf/node_modules/.bin/semver.cmd
Generated Vendored
+7
View File
@@ -0,0 +1,7 @@
@IF EXIST "%~dp0\node.exe" (
"%~dp0\node.exe" "%~dp0\..\..\..\semver\bin\semver.js" %*
) ELSE (
@SETLOCAL
@SET PATHEXT=%PATHEXT:;.JS;=;%
node "%~dp0\..\..\..\semver\bin\semver.js" %*
)
backups/20260325_002423/backend/node_modules/conf/package.json
Generated Vendored
+101
View File
@@ -0,0 +1,101 @@
{
"name": "conf",
"version": "9.0.2",
"description": "Simple config handling for your app or module",
"license": "MIT",
"repository": "sindresorhus/conf",
"funding": "https://github.com/sponsors/sindresorhus",
"author": {
"name": "Sindre Sorhus",
"email": "sindresorhus@gmail.com",
"url": "https://sindresorhus.com"
},
"main": "dist/source",
"engines": {
"node": ">=10"
},
"scripts": {
"test": "xo && npm run build && nyc ava",
"build": "del-cli dist && tsc",
"prepack": "npm run build"
},
"files": [
"dist/source"
],
"keywords": [
"config",
"store",
"app",
"storage",
"conf",
"configuration",
"settings",
"preferences",
"json",
"data",
"persist",
"persistent",
"save",
"load",
"read",
"write",
"cache"
],
"dependencies": {
"ajv": "^7.0.3",
"ajv-formats": "^1.5.1",
"atomically": "^1.7.0",
"debounce-fn": "^4.0.0",
"dot-prop": "^6.0.1",
"env-paths": "^2.2.0",
"json-schema-typed": "^7.0.3",
"make-dir": "^3.1.0",
"onetime": "^5.1.2",
"pkg-up": "^3.1.0",
"semver": "^7.3.4"
},
"devDependencies": {
"@ava/typescript": "^1.1.1",
"@sindresorhus/tsconfig": "^0.7.0",
"@types/node": "^14.14.20",
"@types/semver": "^7.3.4",
"@types/write-file-atomic": "^3.0.1",
"ava": "^3.15.0",
"clear-module": "^4.1.1",
"del": "^6.0.0",
"del-cli": "^3.0.1",
"delay": "^4.4.0",
"nyc": "^15.1.0",
"p-event": "^4.2.0",
"tempy": "^1.0.0",
"tsd": "^0.14.0",
"typescript": "4.1.3",
"xo": "^0.37.1"
},
"types": "dist/source",
"ava": {
"files": [
"test/*",
"!test/index.test-d.ts"
],
"timeout": "1m",
"typescript": {
"rewritePaths": {
"test/": "dist/test/"
}
}
},
"xo": {
"rules": {
"@typescript-eslint/no-implicit-any-catch": "off"
}
},
"nyc": {
"extension": [
".ts"
],
"exclude": [
"**/test/**"
]
}
}
backups/20260325_002423/backend/node_modules/conf/readme.md
Generated Vendored
+387
View File
@@ -0,0 +1,387 @@
# conf
> Simple config handling for your app or module
All you have to care about is what to persist. This module will handle all the dull details like where and how.
*If you need this for Electron, check out [`electron-store`](https://github.com/sindresorhus/electron-store) instead.*
## Install
```
$ npm install conf
```
## Usage
```js
const Conf = require('conf');
const config = new Conf();
config.set('unicorn', '🦄');
console.log(config.get('unicorn'));
//=> '🦄'
// Use dot-notation to access nested properties
config.set('foo.bar', true);
console.log(config.get('foo'));
//=> {bar: true}
config.delete('unicorn');
console.log(config.get('unicorn'));
//=> undefined
```
Or [create a subclass](https://github.com/sindresorhus/electron-store/blob/main/index.js).
## API
Changes are written to disk atomically, so if the process crashes during a write, it will not corrupt the existing config.
### Conf(options?)
Returns a new instance.
### options
Type: `object`
#### defaults
Type: `object`
Default values for the config items.
**Note:** The values in `defaults` will overwrite the `default` key in the `schema` option.
#### schema
Type: `object`
[JSON Schema](https://json-schema.org) to validate your config data.
Under the hood, the JSON Schema validator [ajv](https://github.com/epoberezkin/ajv) is used to validate your config. We use [JSON Schema draft-07](https://json-schema.org/latest/json-schema-validation.html) and support all [validation keywords](https://github.com/epoberezkin/ajv/blob/master/KEYWORDS.md) and [formats](https://github.com/epoberezkin/ajv#formats).
You should define your schema as an object where each key is the name of your data's property and each value is a JSON schema used to validate that property. See more [here](https://json-schema.org/understanding-json-schema/reference/object.html#properties).
Example:
```js
const Conf = require('conf');
const schema = {
foo: {
type: 'number',
maximum: 100,
minimum: 1,
default: 50
},
bar: {
type: 'string',
format: 'url'
}
};
const config = new Conf({schema});
console.log(config.get('foo'));
//=> 50
config.set('foo', '1');
// [Error: Config schema violation: `foo` should be number]
```
**Note:** The `default` value will be overwritten by the `defaults` option if set.
### migrations
Type: `object`
You can use migrations to perform operations to the store whenever a **project version** is upgraded.
The `migrations` object should consist of a key-value pair of `'version': handler`. The `version` can also be a [semver range](https://github.com/npm/node-semver#ranges).
Example:
```js
const Conf = require('conf');
const store = new Conf({
migrations: {
'0.0.1': store => {
store.set('debugPhase', true);
},
'1.0.0': store => {
store.delete('debugPhase');
store.set('phase', '1.0.0');
},
'1.0.2': store => {
store.set('phase', '1.0.2');
},
'>=2.0.0': store => {
store.set('phase', '>=2.0.0');
}
}
});
```
> Note: The version the migrations use refers to the **project version** by default. If you want to change this behavior, specify the [`projectVersion`](#projectVersion) option.
#### configName
Type: `string`\
Default: `'config'`
Name of the config file (without extension).
Useful if you need multiple config files for your app or module. For example, different config files between two major versions.
#### projectName
Type: `string`\
Default: The `name` field in the package.json closest to where `conf` is imported.
You only need to specify this if you don't have a package.json file in your project or if it doesn't have a name defined within it.
#### projectVersion
Type: `string`\
Default: The `version` field in the package.json closest to where `conf` is imported.
You only need to specify this if you don't have a package.json file in your project or if it doesn't have a version defined within it.
#### cwd
Type: `string`\
Default: System default [user config directory](https://github.com/sindresorhus/env-paths#pathsconfig)
**You most likely don't need this. Please don't use it unless you really have to. By default, it will pick the optimal location by adhering to system conventions. You are very likely to get this wrong and annoy users.**
Overrides `projectName`.
The only use-case I can think of is having the config located in the app directory or on some external storage.
#### encryptionKey
Type: `string | Buffer | TypedArray | DataView`\
Default: `undefined`
This can be used to secure sensitive data **if** the encryption key is stored in a secure manner (not plain-text) in the Node.js app. For example, by using [`node-keytar`](https://github.com/atom/node-keytar) to store the encryption key securely, or asking the encryption key from the user (a password) and then storing it in a variable.
In addition to security, this could be used for obscurity. If a user looks through the config directory and finds the config file, since it's just a JSON file, they may be tempted to modify it. By providing an encryption key, the file will be obfuscated, which should hopefully deter any users from doing so.
It also has the added bonus of ensuring the config file's integrity. If the file is changed in any way, the decryption will not work, in which case the store will just reset back to its default state.
When specified, the store will be encrypted using the [`aes-256-cbc`](https://en.wikipedia.org/wiki/Block_cipher_mode_of_operation) encryption algorithm.
#### fileExtension
Type: `string`\
Default: `'json'`
Extension of the config file.
You would usually not need this, but could be useful if you want to interact with a file with a custom file extension that can be associated with your app. These might be simple save/export/preference files that are intended to be shareable or saved outside of the app.
#### clearInvalidConfig
Type: `boolean`\
Default: `false`
The config is cleared if reading the config file causes a `SyntaxError`. This is a good behavior for unimportant data, as the config file is not intended to be hand-edited, so it usually means the config is corrupt and there's nothing the user can do about it anyway. However, if you let the user edit the config file directly, mistakes might happen and it could be more useful to throw an error when the config is invalid instead of clearing.
#### serialize
Type: `Function`\
Default: `value => JSON.stringify(value, null, '\t')`
Function to serialize the config object to a UTF-8 string when writing the config file.
You would usually not need this, but it could be useful if you want to use a format other than JSON.
#### deserialize
Type: `Function`\
Default: `JSON.parse`
Function to deserialize the config object from a UTF-8 string when reading the config file.
You would usually not need this, but it could be useful if you want to use a format other than JSON.
#### projectSuffix
Type: `string`\
Default: `'nodejs'`
**You most likely don't need this. Please don't use it unless you really have to.**
Suffix appended to `projectName` during config file creation to avoid name conflicts with native apps.
You can pass an empty string to remove the suffix.
For example, on macOS, the config file will be stored in the `~/Library/Preferences/foo-nodejs` directory, where `foo` is the `projectName`.
#### accessPropertiesByDotNotation
Type: `boolean`\
Default: `true`
Accessing nested properties by dot notation. For example:
```js
const Conf = require('conf');
const config = new Conf();
config.set({
foo: {
bar: {
foobar: '🦄'
}
}
});
console.log(config.get('foo.bar.foobar'));
//=> '🦄'
```
Alternatively, you can set this option to `false` so the whole string would be treated as one key.
```js
const Conf = require('conf');
const config = new Conf({accessPropertiesByDotNotation: false});
config.set({
`foo.bar.foobar`: '🦄'
});
console.log(config.get('foo.bar.foobar'));
//=> '🦄'
```
#### watch
type: `boolean`\
Default: `false`
Watch for any changes in the config file and call the callback for `onDidChange` or `onDidAnyChange` if set. This is useful if there are multiple processes changing the same config file.
### Instance
You can use [dot-notation](https://github.com/sindresorhus/dot-prop) in a `key` to access nested properties.
The instance is [`iterable`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Iteration_protocols) so you can use it directly in a [`for…of`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Statements/for...of) loop.
#### .set(key, value)
Set an item.
The `value` must be JSON serializable. Trying to set the type `undefined`, `function`, or `symbol` will result in a TypeError.
#### .set(object)
Set multiple items at once.
#### .get(key, defaultValue?)
Get an item or `defaultValue` if the item does not exist.
#### .reset(...keys)
Reset items to their default values, as defined by the `defaults` or `schema` option.
Use `.clear()` to reset all items.
#### .has(key)
Check if an item exists.
#### .delete(key)
Delete an item.
#### .clear()
Delete all items.
This resets known items to their default values, if defined by the `defaults` or `schema` option.
#### .onDidChange(key, callback)
`callback`: `(newValue, oldValue) => {}`
Watches the given `key`, calling `callback` on any changes.
When a key is first set `oldValue` will be `undefined`, and when a key is deleted `newValue` will be `undefined`.
Returns a function which you can use to unsubscribe:
```js
const unsubscribe = conf.onDidChange(key, callback);
unsubscribe();
```
#### .onDidAnyChange(callback)
`callback`: `(newValue, oldValue) => {}`
Watches the whole config object, calling `callback` on any changes.
`oldValue` and `newValue` will be the config object before and after the change, respectively. You must compare `oldValue` to `newValue` to find out what changed.
Returns a function which you can use to unsubscribe:
```js
const unsubscribe = conf.onDidAnyChange(callback);
unsubscribe();
```
#### .size
Get the item count.
#### .store
Get all the config as an object or replace the current config with an object:
```js
conf.store = {
hello: 'world'
};
```
#### .path
Get the path to the config file.
## FAQ
### How is this different from [`configstore`](https://github.com/yeoman/configstore)?
I'm also the author of `configstore`. While it's pretty good, I did make some mistakes early on that are hard to change at this point. This module is the result of everything I learned from making `configstore`. Mainly where the config is stored. In `configstore`, the config is stored in `~/.config` (which is mainly a Linux convention) on all systems, while `conf` stores config in the system default [user config directory](https://github.com/sindresorhus/env-paths#pathsconfig). The `~/.config` directory, it turns out, often have an incorrect permission on macOS and Windows, which has caused a lot of grief for users.
### Can I use YAML or another serialization format?
The `serialize` and `deserialize` options can be used to customize the format of the config file, as long as the representation is compatible with `utf8` encoding.
Example using YAML:
```js
const Conf = require('conf');
const yaml = require('js-yaml');
const config = new Conf({
fileExtension: 'yaml',
serialize: yaml.safeDump,
deserialize: yaml.safeLoad
});
```
## Related
- [electron-store](https://github.com/sindresorhus/electron-store) - Simple data persistence for your Electron app or module
- [cache-conf](https://github.com/SamVerschueren/cache-conf) - Simple cache config handling for your app or module