@push.rocks/smartconfig 6.0.0

package/dist_ts/00_commitinfo_data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export declare const commitinfo: {
+    name: string;
+    version: string;
+    description: string;
+};

package/dist_ts/00_commitinfo_data.js

@@ -0,0 +1,9 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+    name: '@push.rocks/smartconfig',
+    version: '6.0.0',
+    description: 'A comprehensive configuration management library providing key-value storage, environment variable mapping, and tool configuration.'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx5QkFBeUI7SUFDL0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHFJQUFxSTtDQUNuSixDQUFBIn0=

package/dist_ts/classes.appdata.d.ts

@@ -0,0 +1,72 @@
+import * as plugins from './plugins.js';
+import { KeyValueStore } from './classes.keyvaluestore.js';
+export interface IAppDataOptions<T = any> {
+    dirPath?: string;
+    requiredKeys?: Array<keyof T>;
+    /**
+     * Whether keys should be persisted on disk or not
+     */
+    ephemeral?: boolean;
+    /**
+     * @deprecated Use 'ephemeral' instead
+     */
+    ephermal?: boolean;
+    /**
+     * kvStoreKey: 'MY_ENV_VAR'
+     */
+    envMapping?: plugins.tsclass.typeFest.PartialDeep<T>;
+    overwriteObject?: plugins.tsclass.typeFest.PartialDeep<T>;
+}
+export declare class AppData<T = any> {
+    /**
+     * creates appdata. If no pathArg is given, data will be stored here:
+     * ${PWD}/.nogit/appdata
+     * @param pathArg
+     * @returns
+     */
+    static createAndInit<T = any>(optionsArg?: IAppDataOptions<T>): Promise<AppData<T>>;
+    /**
+     * Static helper to get an environment variable as a boolean
+     * @param envVarName The name of the environment variable
+     * @returns boolean value (true if env var is "true", false otherwise)
+     */
+    static valueAsBoolean(envVarName: string): Promise<boolean>;
+    /**
+     * Static helper to get an environment variable as parsed JSON
+     * @param envVarName The name of the environment variable
+     * @returns Parsed JSON object/array
+     */
+    static valueAsJson<R = any>(envVarName: string): Promise<R | undefined>;
+    /**
+     * Static helper to get an environment variable as base64 decoded string
+     * @param envVarName The name of the environment variable
+     * @returns Decoded string
+     */
+    static valueAsBase64(envVarName: string): Promise<string | undefined>;
+    /**
+     * Static helper to get an environment variable as a string
+     * @param envVarName The name of the environment variable
+     * @returns String value
+     */
+    static valueAsString(envVarName: string): Promise<string | undefined>;
+    /**
+     * Static helper to get an environment variable as a number
+     * @param envVarName The name of the environment variable
+     * @returns Number value
+     */
+    static valueAsNumber(envVarName: string): Promise<number | undefined>;
+    readyDeferred: plugins.smartpromise.Deferred<void>;
+    options: IAppDataOptions<T>;
+    private kvStore;
+    constructor(optionsArg?: IAppDataOptions<T>);
+    /**
+     * inits app data
+     */
+    private init;
+    /**
+     * returns a kvstore that resides in appdata
+     */
+    getKvStore(): Promise<KeyValueStore<T>>;
+    logMissingKeys(): Promise<Array<keyof T>>;
+    waitForAndGetKey<K extends keyof T>(keyArg: K): Promise<T[K] | undefined>;
+}

package/dist_ts/classes.appdata.js

@@ -0,0 +1,454 @@
+import * as plugins from './plugins.js';
+import { KeyValueStore } from './classes.keyvaluestore.js';
+// ============================================================================
+// Singleton Qenv Provider
+// ============================================================================
+let sharedQenv;
+function getQenv() {
+    if (!sharedQenv) {
+        sharedQenv = new plugins.qenv.Qenv(process.cwd(), plugins.path.join(process.cwd(), '.nogit'));
+    }
+    return sharedQenv;
+}
+// ============================================================================
+// Security - Redaction for sensitive data
+// ============================================================================
+/**
+ * Redacts sensitive values in logs to prevent exposure of secrets
+ */
+function redactSensitiveValue(key, value) {
+    // List of patterns that indicate sensitive data
+    const sensitivePatterns = [
+        /secret/i, /token/i, /key/i, /password/i, /pass/i,
+        /api/i, /credential/i, /auth/i, /private/i, /jwt/i,
+        /cert/i, /signature/i, /bearer/i
+    ];
+    // Check if key contains sensitive pattern
+    const isSensitive = sensitivePatterns.some(pattern => pattern.test(key));
+    if (isSensitive) {
+        if (typeof value === 'string') {
+            // Show first 3 chars and length for debugging
+            return value.length > 3
+                ? `${value.substring(0, 3)}...[${value.length} chars]`
+                : '[redacted]';
+        }
+        return '[redacted]';
+    }
+    // Check if value looks like a JWT token or base64 secret
+    if (typeof value === 'string') {
+        // JWT tokens start with eyJ
+        if (value.startsWith('eyJ')) {
+            return `eyJ...[${value.length} chars]`;
+        }
+        // Very long strings might be encoded secrets
+        if (value.length > 100) {
+            return `${value.substring(0, 50)}...[${value.length} chars total]`;
+        }
+    }
+    return JSON.stringify(value);
+}
+// ============================================================================
+// Type Converters - Centralized conversion logic
+// ============================================================================
+function toBoolean(value) {
+    // If already boolean, return as-is
+    if (typeof value === 'boolean') {
+        console.log(`    🔹 toBoolean: value is already boolean: ${value}`);
+        return value;
+    }
+    // Handle null/undefined
+    if (value == null) {
+        console.log(`    🔹 toBoolean: value is null/undefined, returning false`);
+        return false;
+    }
+    // Handle string representations
+    const s = String(value).toLowerCase().trim();
+    // True values: "true", "1", "yes", "y", "on"
+    if (['true', '1', 'yes', 'y', 'on'].includes(s)) {
+        console.log(`    🔹 toBoolean: converting "${value}" to true`);
+        return true;
+    }
+    // False values: "false", "0", "no", "n", "off"
+    if (['false', '0', 'no', 'n', 'off'].includes(s)) {
+        console.log(`    🔹 toBoolean: converting "${value}" to false`);
+        return false;
+    }
+    // Default: non-empty string = true, empty = false
+    const result = s.length > 0;
+    console.log(`    🔹 toBoolean: defaulting "${value}" to ${result}`);
+    return result;
+}
+function toJson(value) {
+    if (value == null)
+        return undefined;
+    if (typeof value === 'string') {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return value;
+}
+function fromBase64(value) {
+    if (value == null)
+        return undefined;
+    try {
+        return Buffer.from(String(value), 'base64').toString('utf8');
+    }
+    catch {
+        return String(value);
+    }
+}
+function toNumber(value) {
+    if (value == null)
+        return undefined;
+    const num = Number(value);
+    return Number.isNaN(num) ? undefined : num;
+}
+function toString(value) {
+    if (value == null)
+        return undefined;
+    return String(value);
+}
+// Transform registry for extensibility
+const transformRegistry = {
+    boolean: toBoolean,
+    json: toJson,
+    base64: fromBase64,
+    number: toNumber,
+};
+/**
+ * Parse a mapping string into a declarative spec
+ */
+function parseMappingSpec(input) {
+    const transforms = [];
+    let remaining = input;
+    // Check for hardcoded prefixes with type conversion
+    if (remaining.startsWith('hard_boolean:')) {
+        return {
+            source: { type: 'hard', value: remaining.slice(13) },
+            transforms: ['boolean']
+        };
+    }
+    if (remaining.startsWith('hard_json:')) {
+        return {
+            source: { type: 'hard', value: remaining.slice(10) },
+            transforms: ['json']
+        };
+    }
+    if (remaining.startsWith('hard_base64:')) {
+        return {
+            source: { type: 'hard', value: remaining.slice(12) },
+            transforms: ['base64']
+        };
+    }
+    // Check for generic hard: prefix
+    if (remaining.startsWith('hard:')) {
+        remaining = remaining.slice(5);
+        // Check for legacy suffixes on hardcoded values
+        if (remaining.endsWith('_JSON')) {
+            transforms.push('json');
+            remaining = remaining.slice(0, -5);
+        }
+        else if (remaining.endsWith('_BASE64')) {
+            transforms.push('base64');
+            remaining = remaining.slice(0, -7);
+        }
+        return {
+            source: { type: 'hard', value: remaining },
+            transforms
+        };
+    }
+    // Check for env var prefixes
+    if (remaining.startsWith('boolean:')) {
+        transforms.push('boolean');
+        remaining = remaining.slice(8);
+    }
+    else if (remaining.startsWith('json:')) {
+        transforms.push('json');
+        remaining = remaining.slice(5);
+    }
+    else if (remaining.startsWith('base64:')) {
+        transforms.push('base64');
+        remaining = remaining.slice(7);
+    }
+    // Check for legacy suffixes on env vars
+    if (remaining.endsWith('_JSON')) {
+        transforms.push('json');
+        remaining = remaining.slice(0, -5);
+    }
+    else if (remaining.endsWith('_BASE64')) {
+        transforms.push('base64');
+        remaining = remaining.slice(0, -7);
+    }
+    return {
+        source: { type: 'env', key: remaining },
+        transforms
+    };
+}
+/**
+ * Resolve the source value (env var or hardcoded)
+ */
+async function resolveSource(source) {
+    if (source.type === 'hard') {
+        return source.value;
+    }
+    // source.type === 'env'
+    // Workaround for Qenv bug where empty strings are treated as undefined
+    // Check process.env directly first to preserve empty strings
+    if (Object.prototype.hasOwnProperty.call(process.env, source.key)) {
+        return process.env[source.key];
+    }
+    // Fall back to Qenv for other sources (env.json, docker secrets, etc.)
+    return await getQenv().getEnvVarOnDemand(source.key);
+}
+/**
+ * Apply transformations in sequence
+ */
+function applyTransforms(value, transforms) {
+    return transforms.reduce((acc, transform) => {
+        const fn = transformRegistry[transform];
+        return fn ? fn(acc) : acc;
+    }, value);
+}
+/**
+ * Process a mapping value through the complete pipeline
+ */
+async function processMappingValue(mappingString) {
+    const spec = parseMappingSpec(mappingString);
+    const keyName = spec.source.type === 'env' ? spec.source.key : 'hardcoded';
+    console.log(`    🔍 Processing mapping: "${mappingString}"`);
+    console.log(`       Source: ${spec.source.type === 'env' ? `env:${spec.source.key}` : `hard:${spec.source.value}`}`);
+    console.log(`       Transforms: ${spec.transforms.length > 0 ? spec.transforms.join(', ') : 'none'}`);
+    const rawValue = await resolveSource(spec.source);
+    console.log(`       Raw value: ${redactSensitiveValue(keyName, rawValue)} (type: ${typeof rawValue})`);
+    if (rawValue === undefined || rawValue === null) {
+        console.log(`       ⚠️ Raw value is undefined/null, returning undefined`);
+        return undefined;
+    }
+    const result = applyTransforms(rawValue, spec.transforms);
+    console.log(`       Final value: ${redactSensitiveValue(keyName, result)} (type: ${typeof result})`);
+    return result;
+}
+/**
+ * Recursively evaluate mapping values (strings or nested objects)
+ */
+async function evaluateMappingValue(mappingValue) {
+    // Handle null explicitly - it should return null, not be treated as object
+    if (mappingValue === null) {
+        console.log(`    📌 Value is null, returning null`);
+        return null;
+    }
+    // Handle strings (mapping specs)
+    if (typeof mappingValue === 'string') {
+        return processMappingValue(mappingValue);
+    }
+    // Handle objects (but not arrays or null)
+    if (mappingValue && typeof mappingValue === 'object' && !Array.isArray(mappingValue)) {
+        console.log(`    📂 Processing nested object with ${Object.keys(mappingValue).length} keys`);
+        const result = {};
+        for (const [key, value] of Object.entries(mappingValue)) {
+            console.log(`      → Processing nested key "${key}"`);
+            const evaluated = await evaluateMappingValue(value);
+            // Important: Don't filter out false or other falsy values!
+            // Only skip if explicitly undefined
+            if (evaluated !== undefined) {
+                result[key] = evaluated;
+                console.log(`      ✓ Nested key "${key}" = ${redactSensitiveValue(key, evaluated)} (type: ${typeof evaluated})`);
+            }
+            else {
+                console.log(`      ⚠️ Nested key "${key}" evaluated to undefined, skipping`);
+            }
+        }
+        return result;
+    }
+    // For any other type (numbers, booleans, etc.), return as-is
+    // Note: We don't have key context here, so we'll just indicate the type
+    console.log(`    📎 Returning value as-is: [value] (type: ${typeof mappingValue})`);
+    return mappingValue;
+}
+export class AppData {
+    /**
+     * creates appdata. If no pathArg is given, data will be stored here:
+     * ${PWD}/.nogit/appdata
+     * @param pathArg
+     * @returns
+     */
+    static async createAndInit(optionsArg = {}) {
+        const appData = new AppData(optionsArg);
+        await appData.readyDeferred.promise;
+        return appData;
+    }
+    /**
+     * Static helper to get an environment variable as a boolean
+     * @param envVarName The name of the environment variable
+     * @returns boolean value (true if env var is "true", false otherwise)
+     */
+    static async valueAsBoolean(envVarName) {
+        const value = await getQenv().getEnvVarOnDemand(envVarName);
+        return toBoolean(value);
+    }
+    /**
+     * Static helper to get an environment variable as parsed JSON
+     * @param envVarName The name of the environment variable
+     * @returns Parsed JSON object/array
+     */
+    static async valueAsJson(envVarName) {
+        const value = await getQenv().getEnvVarOnDemand(envVarName);
+        return toJson(value);
+    }
+    /**
+     * Static helper to get an environment variable as base64 decoded string
+     * @param envVarName The name of the environment variable
+     * @returns Decoded string
+     */
+    static async valueAsBase64(envVarName) {
+        const value = await getQenv().getEnvVarOnDemand(envVarName);
+        return fromBase64(value);
+    }
+    /**
+     * Static helper to get an environment variable as a string
+     * @param envVarName The name of the environment variable
+     * @returns String value
+     */
+    static async valueAsString(envVarName) {
+        const value = await getQenv().getEnvVarOnDemand(envVarName);
+        return toString(value);
+    }
+    /**
+     * Static helper to get an environment variable as a number
+     * @param envVarName The name of the environment variable
+     * @returns Number value
+     */
+    static async valueAsNumber(envVarName) {
+        const value = await getQenv().getEnvVarOnDemand(envVarName);
+        return toNumber(value);
+    }
+    constructor(optionsArg = {}) {
+        // instance
+        this.readyDeferred = plugins.smartpromise.defer();
+        this.options = optionsArg;
+        this.init();
+    }
+    /**
+     * inits app data
+     */
+    async init() {
+        console.log('🚀 Initializing AppData...');
+        // Handle backward compatibility for typo
+        const isEphemeral = this.options.ephemeral ?? this.options.ephermal ?? false;
+        if (this.options.ephermal && !this.options.ephemeral) {
+            console.warn('⚠️ Option "ephermal" is deprecated, use "ephemeral" instead.');
+        }
+        if (this.options.dirPath) {
+            console.log(`  📁 Using custom directory: ${this.options.dirPath}`);
+        }
+        else if (isEphemeral) {
+            console.log(`  💨 Using ephemeral storage (in-memory only)`);
+        }
+        else {
+            const appDataDir = '/app/data';
+            const dataDir = '/data';
+            const nogitAppData = '.nogit/appdata';
+            const appDataExists = plugins.smartfile.fs.isDirectory(appDataDir);
+            const dataExists = plugins.smartfile.fs.isDirectory(dataDir);
+            if (appDataExists) {
+                this.options.dirPath = appDataDir;
+                console.log(`  📁 Auto-selected container directory: ${appDataDir}`);
+            }
+            else if (dataExists) {
+                this.options.dirPath = dataDir;
+                console.log(`  📁 Auto-selected data directory: ${dataDir}`);
+            }
+            else {
+                await plugins.smartfile.fs.ensureDir(nogitAppData);
+                this.options.dirPath = nogitAppData;
+                console.log(`  📁 Auto-selected local directory: ${nogitAppData}`);
+            }
+        }
+        this.kvStore = new KeyValueStore({
+            typeArg: isEphemeral ? 'ephemeral' : 'custom',
+            identityArg: 'appkv',
+            customPath: this.options.dirPath,
+            mandatoryKeys: this.options.requiredKeys,
+        });
+        if (this.options.envMapping) {
+            console.log(`📦 Processing envMapping for AppData...`);
+            const totalKeys = Object.keys(this.options.envMapping).length;
+            let processedCount = 0;
+            // Process each top-level key in envMapping
+            for (const key in this.options.envMapping) {
+                try {
+                    const mappingSpec = this.options.envMapping[key];
+                    const specType = mappingSpec === null ? 'null' :
+                        typeof mappingSpec === 'string' ? mappingSpec :
+                            typeof mappingSpec === 'object' ? 'nested object' :
+                                typeof mappingSpec;
+                    console.log(`  → Processing key "${key}" with spec: ${specType}`);
+                    const evaluated = await evaluateMappingValue(mappingSpec);
+                    // Important: Don't skip false, 0, empty string, or null values!
+                    // Only skip if explicitly undefined
+                    if (evaluated !== undefined) {
+                        await this.kvStore.writeKey(key, evaluated);
+                        processedCount++;
+                        const valueType = evaluated === null ? 'null' :
+                            Array.isArray(evaluated) ? 'array' :
+                                typeof evaluated;
+                        const valuePreview = evaluated === null ? 'null' :
+                            typeof evaluated === 'object' ?
+                                (Array.isArray(evaluated) ? `[${evaluated.length} items]` : `{${Object.keys(evaluated).length} keys}`) :
+                                redactSensitiveValue(key, evaluated);
+                        console.log(`  ✅ Successfully processed key "${key}" = ${valuePreview} (type: ${valueType})`);
+                    }
+                    else {
+                        console.log(`  ⚠️ Key "${key}" evaluated to undefined, skipping`);
+                    }
+                }
+                catch (err) {
+                    console.error(`  ❌ Failed to evaluate envMapping for key "${key}":`, err);
+                }
+            }
+            console.log(`📊 EnvMapping complete: ${processedCount}/${totalKeys} keys successfully processed`);
+        }
+        // Apply overwrite object after env mapping
+        if (this.options.overwriteObject) {
+            const overwriteKeys = Object.keys(this.options.overwriteObject);
+            console.log(`🔄 Applying overwriteObject with ${overwriteKeys.length} key(s)...`);
+            for (const key of overwriteKeys) {
+                const value = this.options.overwriteObject[key];
+                const valueType = Array.isArray(value) ? 'array' : typeof value;
+                console.log(`  🔧 Overwriting key "${key}" with ${valueType} value`);
+                await this.kvStore.writeKey(key, value);
+            }
+            console.log(`✅ OverwriteObject complete: ${overwriteKeys.length} key(s) overwritten`);
+        }
+        this.readyDeferred.resolve();
+        console.log('✨ AppData initialization complete!');
+    }
+    /**
+     * returns a kvstore that resides in appdata
+     */
+    async getKvStore() {
+        await this.readyDeferred.promise;
+        return this.kvStore;
+    }
+    async logMissingKeys() {
+        const kvStore = await this.getKvStore();
+        const missingMandatoryKeys = await kvStore.getMissingMandatoryKeys();
+        if (missingMandatoryKeys.length > 0) {
+            console.log(`The following mandatory keys are missing in the appdata:\n   -> ${missingMandatoryKeys.join(',\n   -> ')}`);
+        }
+        else {
+            console.log('All mandatory keys are present in the appdata');
+        }
+        return missingMandatoryKeys;
+    }
+    async waitForAndGetKey(keyArg) {
+        await this.readyDeferred.promise;
+        await this.kvStore.waitForKeysPresent([keyArg]);
+        return this.kvStore.readKey(keyArg);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5hcHBkYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2xhc3Nlcy5hcHBkYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUUzRCwrRUFBK0U7QUFDL0UsMEJBQTBCO0FBQzFCLCtFQUErRTtBQUMvRSxJQUFJLFVBQXlDLENBQUM7QUFFOUMsU0FBUyxPQUFPO0lBQ2QsSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFDO1FBQ2hCLFVBQVUsR0FBRyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUNoQyxPQUFPLENBQUMsR0FBRyxFQUFFLEVBQ2IsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsRUFBRSxFQUFFLFFBQVEsQ0FBQyxDQUMzQyxDQUFDO0lBQ0osQ0FBQztJQUNELE9BQU8sVUFBVSxDQUFDO0FBQ3BCLENBQUM7QUFFRCwrRUFBK0U7QUFDL0UsMENBQTBDO0FBQzFDLCtFQUErRTtBQUMvRTs7R0FFRztBQUNILFNBQVMsb0JBQW9CLENBQUMsR0FBVyxFQUFFLEtBQWM7SUFDdkQsZ0RBQWdEO0lBQ2hELE1BQU0saUJBQWlCLEdBQUc7UUFDeEIsU0FBUyxFQUFFLFFBQVEsRUFBRSxNQUFNLEVBQUUsV0FBVyxFQUFFLE9BQU87UUFDakQsTUFBTSxFQUFFLGFBQWEsRUFBRSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU07UUFDbEQsT0FBTyxFQUFFLFlBQVksRUFBRSxTQUFTO0tBQ2pDLENBQUM7SUFFRiwwQ0FBMEM7SUFDMUMsTUFBTSxXQUFXLEdBQUcsaUJBQWlCLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDO0lBRXpFLElBQUksV0FBVyxFQUFF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

package/dist_ts/classes.keyvaluestore.d.ts

@@ -0,0 +1,63 @@
+import * as plugins from './plugins.js';
+export type TKeyValueStore = 'custom' | 'userHomeDir' | 'ephemeral';
+export interface IKvStoreConstructorOptions<T> {
+    typeArg: TKeyValueStore;
+    identityArg: string;
+    customPath?: string;
+    mandatoryKeys?: Array<keyof T>;
+}
+/**
+ * kvStore is a simple key value store to store data about projects between runs
+ */
+export declare class KeyValueStore<T = any> {
+    private dataObject;
+    private deletedObject;
+    private mandatoryKeys;
+    changeSubject: plugins.smartrx.rxjs.Subject<Partial<T>>;
+    private storedStateString;
+    syncTask: plugins.taskbuffer.Task<undefined>;
+    /**
+     * computes the identity and filePath
+     */
+    private initFilePath;
+    type: TKeyValueStore;
+    identity: string;
+    filePath?: string;
+    private customPath?;
+    /**
+     * the constructor of keyvalue store
+     * @param typeArg
+     * @param identityArg
+     * @param customPath Optional custom path for the keyValue store
+     */
+    constructor(optionsArg: IKvStoreConstructorOptions<T>);
+    /**
+     * reads all keyValue pairs at once and returns them
+     */
+    readAll(): Promise<Partial<T>>;
+    /**
+     * reads a keyValueFile from disk
+     */
+    readKey<K extends keyof T>(keyArg: K): Promise<T[K]>;
+    /**
+     * writes a specific key to the keyValueStore
+     */
+    writeKey<K extends keyof T>(keyArg: K, valueArg: T[K]): Promise<void>;
+    deleteKey<K extends keyof T>(keyArg: K): Promise<void>;
+    /**
+     * writes all keyValue pairs in the object argument
+     */
+    writeAll(keyValueObject: Partial<T>): Promise<void>;
+    /**
+     * wipes a key value store from disk
+     */
+    wipe(): Promise<void>;
+    /**
+     * resets the KeyValueStore to the initial state by syncing first, deleting all keys, and then triggering a sync again
+     */
+    reset(): Promise<void>;
+    private setMandatoryKeys;
+    getMissingMandatoryKeys(): Promise<Array<keyof T>>;
+    waitForKeysPresent<K extends keyof T>(keysArg: K[]): Promise<void>;
+    waitForAndGetKey<K extends keyof T>(keyArg: K): Promise<T[K] | undefined>;
+}