kfg 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -171,18 +171,9 @@ function buildTypeBoxSchema(definition) {
   return import_typebox.Type.Object(properties, { additionalProperties: true });
 }
 function buildDefaultObject(definition) {
-  const obj = {};
-  for (const key in definition) {
-    const value = definition[key];
-    if (value[Symbol.for("TypeBox.Kind")]) {
-      if (value.default !== void 0) {
-        obj[key] = value.default;
-      }
-    } else if (typeof value === "object" && value !== null) {
-      obj[key] = buildDefaultObject(value);
-    }
-  }
-  return obj;
+  const schema = buildTypeBoxSchema(definition);
+  addSmartDefaults(schema);
+  return import_value.Value.Default(schema, {});
 }
 function makeSchemaOptional(definition) {
   const newDefinition = {};
@@ -210,20 +201,30 @@ var Kfg = class {
   driver;
   schema;
   loaded = false;
+  _lastOptions;
   /**
    * Creates a new instance of Kfg.
    * @param driver The driver to use for loading and saving the configuration.
    * @param schema The schema to use for validating the configuration.
    */
   constructor(driver, schema) {
-    this.driver = driver;
+    this.driver = driver.clone();
     this.schema = schema;
   }
+  /**
+   * Reloads the configuration.
+   * @param options - The loading options.
+   */
+  reload(options) {
+    this.loaded = false;
+    return this.load(options || this._lastOptions);
+  }
   /**
    * Loads the configuration.
    * @param options - The loading options.
    */
   load(options) {
+    this._lastOptions = options;
     let schemaToLoad = this.schema;
     if (options?.only_importants) {
       schemaToLoad = makeSchemaOptional(this.schema);
@@ -293,6 +294,16 @@ var Kfg = class {
     }
     return this.driver.insert(path3, partial);
   }
+  /**
+   * Injects a partial value directly into the root configuration object.
+   * @param data The partial data to inject.
+   */
+  inject(data) {
+    if (!this.loaded) {
+      throw new Error("[Kfg] Config not loaded. Call load() first.");
+    }
+    return this.driver.inject(data);
+  }
   /**
    * Deletes a value from the configuration.
    * @param path The path to the value.
@@ -314,6 +325,14 @@ var Kfg = class {
     }
     return getProperty(this.schema, path3);
   }
+  /**
+   * Returns the schema definition for a given path.
+   * @param path The path to the schema.
+   * @returns The schema at the given path.
+   */
+  schematic(path3) {
+    return this.conf(path3);
+  }
   /**
    * Returns cached data
    * @returns
@@ -534,6 +553,44 @@ var KfgFS = class {
     }
     return this.pathFn(id);
   }
+  /**
+   * Checks if a configuration file exists for a given ID.
+   * @param id The ID of the configuration file.
+   * @returns True if the file exists, false otherwise.
+   */
+  exist(id) {
+    const filePath = this.getPath(id);
+    return fs.existsSync(filePath);
+  }
+  /**
+   * Creates a new configuration file for a given ID.
+   * @param id The ID of the configuration file.
+   * @param data Optional initial data for the configuration.
+   * @returns The created KfgFileFS instance.
+   */
+  create(id, data) {
+    if (this.exist(id)) {
+      throw new Error(`[KfgFS] Config with id '${id}' already exists.`);
+    }
+    const instanceOrPromise = this.file(id);
+    const initialize = (instance) => {
+      if (data) {
+        instance.inject(data);
+      }
+      const saveResult = instance.save();
+      if (this.driver.async) {
+        return saveResult.then(() => instance);
+      }
+      return instance;
+    };
+    if (this.driver.async) {
+      return instanceOrPromise.then(
+        initialize
+      );
+    } else {
+      return initialize(instanceOrPromise);
+    }
+  }
   /**
    * Gets a file-based configuration for a given ID.
    * @param id The ID of the configuration file.
@@ -616,6 +673,23 @@ var KfgDriver = class {
   // Utilities passed to drivers
   buildDefaultObject = buildDefaultObject;
   deepMerge = deepMerge;
+  /**
+   * Clones the driver.
+   * @returns A new instance of the driver with the same options.
+   */
+  clone() {
+    const Constructor = this.constructor;
+    return new Constructor(this.options);
+  }
+  /**
+   * Injects data directly into the driver's data store.
+   * This data is merged with the existing data.
+   * @param data The data to inject.
+   */
+  inject(data) {
+    this.data = this.deepMerge(this.data, data);
+    return this.async ? Promise.resolve() : void 0;
+  }
   /**
    * Loads the configuration.
    * @param schema The schema to use for validating the configuration.
@@ -709,17 +783,17 @@ var KfgDriver = class {
    */
   validate(config = this.data) {
     if (!this.compiledSchema) return;
-    this.data = import_value2.Value.Default(this.compiledSchema, {});
-    import_value2.Value.Convert(this.compiledSchema, config);
-    if (!import_value2.Value.Check(this.compiledSchema, config)) {
-      const errors = [...import_value2.Value.Errors(this.compiledSchema, config)];
+    const configWithDefaults = import_value2.Value.Default(this.compiledSchema, config);
+    import_value2.Value.Convert(this.compiledSchema, configWithDefaults);
+    if (!import_value2.Value.Check(this.compiledSchema, configWithDefaults)) {
+      const errors = [...import_value2.Value.Errors(this.compiledSchema, configWithDefaults)];
       throw new Error(
         `[Kfg] Validation failed:
 ${errors.map((e) => `- ${e.path}: ${e.message}`).join("\n")}`
         // Corrected: escaped backtick in template literal
       );
     }
-    this.data = config;
+    this.data = configWithDefaults;
   }
 };
 

package/dist/index.d.ts

@@ -13,12 +13,20 @@ export declare class Kfg<D extends KfgDriver<any, any, any>, S extends SchemaDef
 	driver: D;
 	schema: S;
 	private loaded;
+	private _lastOptions;
 	/**
 	 * Creates a new instance of Kfg.
 	 * @param driver The driver to use for loading and saving the configuration.
 	 * @param schema The schema to use for validating the configuration.
 	 */
 	constructor(driver: D, schema: S);
+	/**
+	 * Reloads the configuration.
+	 * @param options - The loading options.
+	 */
+	reload(options?: Partial<D["config"]> & {
+		only_importants?: boolean;
+	}): inPromise<D["async"], void>;
 	/**
 	 * Loads the configuration.
 	 * @param options - The loading options.
@@ -64,6 +72,11 @@ export declare class Kfg<D extends KfgDriver<any, any, any>, S extends SchemaDef
 	 * @param partial The partial value to insert.
 	 */
 	insert<P extends RootPaths<StaticSchema<S>>>(path: P, partial: Partial<DeepGet<StaticSchema<S>, P>>): inPromise<D["async"], void>;
+	/**
+	 * Injects a partial value directly into the root configuration object.
+	 * @param data The partial data to inject.
+	 */
+	inject(data: Partial<StaticSchema<S>>): inPromise<D["async"], void>;
 	/**
 	 * Deletes a value from the configuration.
 	 * @param path The path to the value.
@@ -75,6 +88,12 @@ export declare class Kfg<D extends KfgDriver<any, any, any>, S extends SchemaDef
 	 * @returns The schema at the given path.
 	 */
 	conf<P extends Paths<StaticSchema<S>>>(path: P): DeepGet<S, P>;
+	/**
+	 * Returns the schema definition for a given path.
+	 * @param path The path to the schema.
+	 * @returns The schema at the given path.
+	 */
+	schematic<P extends Paths<StaticSchema<S>>>(path: P): DeepGet<S, P>;
 	/**
 	 * Returns cached data
 	 * @returns
@@ -106,6 +125,17 @@ export declare class KfgDriver<C extends DriverConfig, S extends DriverStore, As
 	 * @param options The driver options.
 	 */
 	constructor(options: KfgDriverOptions<C, S, Async>);
+	/**
+	 * Clones the driver.
+	 * @returns A new instance of the driver with the same options.
+	 */
+	clone(): KfgDriver<C, S, Async>;
+	/**
+	 * Injects data directly into the driver's data store.
+	 * This data is merged with the existing data.
+	 * @param data The data to inject.
+	 */
+	inject(data: Partial<StaticSchema<any>>): inPromise<Async, void>;
 	/**
 	 * Loads the configuration.
 	 * @param schema The schema to use for validating the configuration.
@@ -192,6 +222,19 @@ export declare class KfgFS<D extends KfgDriver<any, any, any>, S extends SchemaD
 	 * @returns The file path.
 	 */
 	private getPath;
+	/**
+	 * Checks if a configuration file exists for a given ID.
+	 * @param id The ID of the configuration file.
+	 * @returns True if the file exists, false otherwise.
+	 */
+	exist(id: string): boolean;
+	/**
+	 * Creates a new configuration file for a given ID.
+	 * @param id The ID of the configuration file.
+	 * @param data Optional initial data for the configuration.
+	 * @returns The created KfgFileFS instance.
+	 */
+	create(id: string, data?: Partial<StaticSchema<S>>): inPromise<D["async"], KfgFileFS<D, S>>;
 	/**
 	 * Gets a file-based configuration for a given ID.
 	 * @param id The ID of the configuration file.

package/dist/index.js

@@ -122,18 +122,9 @@ function buildTypeBoxSchema(definition) {
   return Type.Object(properties, { additionalProperties: true });
 }
 function buildDefaultObject(definition) {
-  const obj = {};
-  for (const key in definition) {
-    const value = definition[key];
-    if (value[Symbol.for("TypeBox.Kind")]) {
-      if (value.default !== void 0) {
-        obj[key] = value.default;
-      }
-    } else if (typeof value === "object" && value !== null) {
-      obj[key] = buildDefaultObject(value);
-    }
-  }
-  return obj;
+  const schema = buildTypeBoxSchema(definition);
+  addSmartDefaults(schema);
+  return Value.Default(schema, {});
 }
 function makeSchemaOptional(definition) {
   const newDefinition = {};
@@ -161,20 +152,30 @@ var Kfg = class {
   driver;
   schema;
   loaded = false;
+  _lastOptions;
   /**
    * Creates a new instance of Kfg.
    * @param driver The driver to use for loading and saving the configuration.
    * @param schema The schema to use for validating the configuration.
    */
   constructor(driver, schema) {
-    this.driver = driver;
+    this.driver = driver.clone();
     this.schema = schema;
   }
+  /**
+   * Reloads the configuration.
+   * @param options - The loading options.
+   */
+  reload(options) {
+    this.loaded = false;
+    return this.load(options || this._lastOptions);
+  }
   /**
    * Loads the configuration.
    * @param options - The loading options.
    */
   load(options) {
+    this._lastOptions = options;
     let schemaToLoad = this.schema;
     if (options?.only_importants) {
       schemaToLoad = makeSchemaOptional(this.schema);
@@ -244,6 +245,16 @@ var Kfg = class {
     }
     return this.driver.insert(path3, partial);
   }
+  /**
+   * Injects a partial value directly into the root configuration object.
+   * @param data The partial data to inject.
+   */
+  inject(data) {
+    if (!this.loaded) {
+      throw new Error("[Kfg] Config not loaded. Call load() first.");
+    }
+    return this.driver.inject(data);
+  }
   /**
    * Deletes a value from the configuration.
    * @param path The path to the value.
@@ -265,6 +276,14 @@ var Kfg = class {
     }
     return getProperty(this.schema, path3);
   }
+  /**
+   * Returns the schema definition for a given path.
+   * @param path The path to the schema.
+   * @returns The schema at the given path.
+   */
+  schematic(path3) {
+    return this.conf(path3);
+  }
   /**
    * Returns cached data
    * @returns
@@ -485,6 +504,44 @@ var KfgFS = class {
     }
     return this.pathFn(id);
   }
+  /**
+   * Checks if a configuration file exists for a given ID.
+   * @param id The ID of the configuration file.
+   * @returns True if the file exists, false otherwise.
+   */
+  exist(id) {
+    const filePath = this.getPath(id);
+    return fs.existsSync(filePath);
+  }
+  /**
+   * Creates a new configuration file for a given ID.
+   * @param id The ID of the configuration file.
+   * @param data Optional initial data for the configuration.
+   * @returns The created KfgFileFS instance.
+   */
+  create(id, data) {
+    if (this.exist(id)) {
+      throw new Error(`[KfgFS] Config with id '${id}' already exists.`);
+    }
+    const instanceOrPromise = this.file(id);
+    const initialize = (instance) => {
+      if (data) {
+        instance.inject(data);
+      }
+      const saveResult = instance.save();
+      if (this.driver.async) {
+        return saveResult.then(() => instance);
+      }
+      return instance;
+    };
+    if (this.driver.async) {
+      return instanceOrPromise.then(
+        initialize
+      );
+    } else {
+      return initialize(instanceOrPromise);
+    }
+  }
   /**
    * Gets a file-based configuration for a given ID.
    * @param id The ID of the configuration file.
@@ -567,6 +624,23 @@ var KfgDriver = class {
   // Utilities passed to drivers
   buildDefaultObject = buildDefaultObject;
   deepMerge = deepMerge;
+  /**
+   * Clones the driver.
+   * @returns A new instance of the driver with the same options.
+   */
+  clone() {
+    const Constructor = this.constructor;
+    return new Constructor(this.options);
+  }
+  /**
+   * Injects data directly into the driver's data store.
+   * This data is merged with the existing data.
+   * @param data The data to inject.
+   */
+  inject(data) {
+    this.data = this.deepMerge(this.data, data);
+    return this.async ? Promise.resolve() : void 0;
+  }
   /**
    * Loads the configuration.
    * @param schema The schema to use for validating the configuration.
@@ -660,17 +734,17 @@ var KfgDriver = class {
    */
   validate(config = this.data) {
     if (!this.compiledSchema) return;
-    this.data = Value2.Default(this.compiledSchema, {});
-    Value2.Convert(this.compiledSchema, config);
-    if (!Value2.Check(this.compiledSchema, config)) {
-      const errors = [...Value2.Errors(this.compiledSchema, config)];
+    const configWithDefaults = Value2.Default(this.compiledSchema, config);
+    Value2.Convert(this.compiledSchema, configWithDefaults);
+    if (!Value2.Check(this.compiledSchema, configWithDefaults)) {
+      const errors = [...Value2.Errors(this.compiledSchema, configWithDefaults)];
       throw new Error(
         `[Kfg] Validation failed:
 ${errors.map((e) => `- ${e.path}: ${e.message}`).join("\n")}`
         // Corrected: escaped backtick in template literal
       );
     }
-    this.data = config;
+    this.data = configWithDefaults;
   }
 };
 

package/package.json

@@ -2,13 +2,13 @@
   "name": "kfg",
   "type": "module",
   "description": "Simple system of standardization of configurations for node js and bun.",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/drylian/kfg.git"
+    "url": "git+https://github.com/drysius/kfg.git"
   },
   "typesVersions": {
     "*": {
@@ -46,12 +46,12 @@
     "output",
     "performance"
   ],
-  "author": "Drylian",
+  "author": "Drysius",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/drylian/kfg/issues"
+    "url": "https://github.com/drysius/kfg/issues"
   },
-  "homepage": "https://github.com/drylian/kfg#readme",
+  "homepage": "https://kfg.js.org",
   "files": [
     "dist"
   ],
@@ -74,4 +74,4 @@
   "dependencies": {
     "@sinclair/typebox": "^0.34.41"
   }
-}
+}