@leyyo/env 1.0.7 → 1.0.9

package/dist/field/index.types.d.ts

@@ -1,11 +1,10 @@
-import type { EnvScope } from "../scope";
+import type { EnvScopeConfigure, EnvScopeRuntime } from "../scope";
 import type { EnvBase } from "../core";
-import { DevOpt, EnumMap, KeyValue } from "@leyyo/common";
-import { EnumLiteral } from "@leyyo/common/dist/shared/index.types";
+import type { DevOpt, EnumMap, KeyValue } from "@leyyo/common";
+import type { EnumLiteral } from "@leyyo/common/dist/shared/index.types";
 export type EnvFieldCastLambda<E extends EnvBase = EnvBase, Z extends keyof E = keyof E> = (v: unknown) => E[Z];
 export type EnvFieldAssertLambda = (v: unknown) => void;
 export type EnvFieldType = 'string' | 'text' | 'float' | 'integer' | 'boolean' | 'literal' | 'enumeration';
-export type EnvFieldOtaLambda<E extends EnvBase = EnvBase, Z extends keyof E = keyof E> = (field: Z, data: E) => void;
 export interface EnvFieldArray {
     char?: ',' | ';' | '/' | '|' | string;
     min?: number;
@@ -34,84 +33,164 @@ export interface EnvFieldBoolean {
     yes?: string[];
     no?: string[];
 }
-export type EnvFieldPrintTag = 'required' | 'array' | 'secret' | 'ota';
 export interface EnvFieldPrint {
     scope: string;
     key: string;
     value?: any;
     type: EnvFieldType;
-    tags?: EnvFieldPrintTag[];
-    aliases?: string[];
+    opt?: Record<string, unknown>;
 }
-export interface EnvField<E extends EnvBase = EnvBase, Z extends keyof E = keyof E> {
+export interface EnvFieldConfigure<E extends EnvBase = EnvBase, Z extends keyof E = keyof E> {
+    /**
+     * Shift to runtime mode
+     * */
+    get runtime(): EnvFieldRuntime<E, Z>;
     /**
      * Key is required
      * */
-    required(): this;
+    required(): EnvFieldConfigure<E, Z>;
+    /**
+     * Key is required or not
+     * */
+    required(flag: boolean): EnvFieldConfigure<E, Z>;
+    /**
+     * Key is required by given condition
+     * */
+    required(fn: EnvFieldOnLambda<E, Z, boolean>): EnvFieldConfigure<E, Z>;
     /**
      * Key is array, so value is split by char
      * */
-    array(opt?: EnvFieldArray): this;
+    array(opt?: EnvFieldArray): EnvFieldConfigure<E, Z>;
     /**
      * Key is secret value
      * */
-    secret(opt?: EnvFieldSecret): this;
+    secret(opt?: EnvFieldSecret): EnvFieldConfigure<E, Z>;
+    /**
+     * Cloned key
+     * */
+    clone(name: string): EnvFieldConfigure<E, Z>;
     /**
      * Set default value
      * */
-    def(value: E[Z]): this;
+    def(value: E[Z]): EnvFieldConfigure<E, Z>;
     /**
      * Value may have another aliases
      * */
-    alias(...keys: string[]): this;
+    alias(...keys: string[]): EnvFieldConfigure<E, Z>;
     /**
      * Value is string (can be empty)
      * */
-    string(opt?: EnvFieldString): this;
+    string(opt?: EnvFieldString): EnvFieldConfigure<E, Z>;
     /**
      * Value is text (can not be empty)
      * */
-    text(opt?: EnvFieldString): this;
+    text(opt?: EnvFieldString): EnvFieldConfigure<E, Z>;
     /**
      * Value is float
      * */
-    float(opt?: EnvFieldFloat): this;
+    float(opt?: EnvFieldFloat): EnvFieldConfigure<E, Z>;
     /**
      * Value is integer
      * */
-    integer(opt?: EnvFieldInteger): this;
+    integer(opt?: EnvFieldInteger): EnvFieldConfigure<E, Z>;
     /**
      * Value is boolean
      * */
-    boolean(opt?: EnvFieldBoolean): this;
+    boolean(opt?: EnvFieldBoolean): EnvFieldConfigure<E, Z>;
     /**
      * Value is literal
      * */
-    literal<L extends KeyValue = string>(keys: EnumLiteral<L>): this;
+    literal<L extends KeyValue = string>(keys: EnumLiteral<L>): EnvFieldConfigure<E, Z>;
     /**
      * Value is enumeration
      * */
-    enumeration<L extends KeyValue = string>(map: EnumMap<L>): this;
+    enumeration<L extends KeyValue = string>(map: EnumMap<L>): EnvFieldConfigure<E, Z>;
+    /**
+     * Emit an event when ota is occurred
+     * */
+    onOta(fn?: EnvFieldOnLambda<E, Z, void>): EnvFieldConfigure<E, Z>;
+    /**
+     * Emit an event when value is changed
+     * */
+    onChange(fn: EnvFieldOnLambda<E, Z, void>): EnvFieldConfigure<E, Z>;
+    /**
+     * Emit an event when value is set
+     * */
+    onSet(fn: EnvFieldOnLambda<E, Z, void>): EnvFieldConfigure<E, Z>;
     /**
-     * Value has ota for remote configuration
+     * Set cast function, please take attention
      * */
-    ota(fn?: EnvFieldOtaLambda<E, Z>): this;
+    cast(fn: EnvFieldCastLambda<E, Z>): EnvFieldConfigure<E, Z>;
+    /**
+     * Set asset function, please take attention
+     * */
+    assert(fn: EnvFieldAssertLambda): EnvFieldConfigure<E, Z>;
     /**
      * Go back to scope
      * */
-    end(): EnvScope<E>;
+    get end(): EnvScopeConfigure<E>;
+}
+export interface EnvFieldRuntime<E extends EnvBase = EnvBase, Z extends keyof E = keyof E> {
     /**
      * Scope
      * */
-    get scope(): EnvScope<E>;
-    $run(): void;
-    $print(): EnvFieldPrint;
-    $fromOta(value: unknown): void;
-    $cast(fn: EnvFieldCastLambda<E, Z>): this;
-    $assert(fn: EnvFieldAssertLambda): this;
+    readonly scope: EnvScopeRuntime<E>;
+    /**
+     * Name of field
+     * */
+    readonly name: Z;
+    /**
+     * Shift to configure mode
+     * */
+    get configure(): EnvFieldConfigure<E, Z>;
+    /**
+     * Shift to secure mode
+     * */
+    get $secure(): EnvFieldSecure<E, Z>;
+    /**
+     * Read value, and call cast (if defined), assert (if defined), onChanged (if changed), onSet (if exists)
+     * */
+    read(): boolean;
+    /**
+     * Print value and other settings
+     * */
+    print(): EnvFieldPrint;
+    /**
+     * Return raw value
+     * */
+    get raw(): E[Z] | undefined;
+    /**
+     * Value is being set from ota
+     * */
+    fromOta(value: unknown): boolean;
+    /**
+     * Set value with all controls
+     * */
+    set(value: E[Z]): void;
+}
+export interface EnvFieldSecure<E extends EnvBase = EnvBase, Z extends keyof E = keyof E> {
+    /**
+     * Shift to runtime mode
+     * */
+    get runtime(): EnvFieldRuntime<E, Z>;
+    /**
+     * Set value without any control
+     * */
+    $set(value: unknown): void;
+    /**
+     * Set cast function without any control
+     * */
+    $cast(fn: EnvFieldCastLambda<E, Z>): void;
+    /**
+     * Set asset function without any control
+     * */
+    $assert(fn: EnvFieldAssertLambda): void;
+}
+export interface EnvField<E extends EnvBase = EnvBase, Z extends keyof E = keyof E> extends EnvFieldConfigure<E, Z>, EnvFieldRuntime<E, Z>, EnvFieldSecure<E, Z> {
 }
 export type EnvFieldCastBasicLambda<T> = (value: unknown, opt: DevOpt, required: boolean) => T | undefined;
 export type EnvFieldCastEnumLambda<T extends KeyValue> = (value: unknown, keys: unknown, opt: DevOpt, required: boolean) => T | undefined;
+export type EnvFieldOnLambda<E extends EnvBase = EnvBase, Z extends keyof E = keyof E, R = unknown> = (field: EnvFieldRuntime<E, Z>) => R;
 export interface EnvFieldLambdaItem {
     string: EnvFieldCastBasicLambda<string>;
     text: EnvFieldCastBasicLambda<string>;

package/dist/scope/env-scope.impl.d.ts

@@ -1,24 +1,34 @@
-import type { EnvBase, EnvCore } from "../core";
-import type { EnvField, EnvFieldPrint } from "../field";
-import type { EnvScope } from "./index.types";
+import type { EnvBase, EnvCoreRuntime } from "../core";
+import type { EnvFieldConfigure, EnvFieldPrint, EnvFieldRuntime } from "../field";
+import { EnvScope, EnvScopeConfigure, EnvScopeOnLambda, EnvScopeRuntime, EnvScopeSecure } from "./index.types";
 export declare class EnvScopeImpl<E extends EnvBase = EnvBase> implements EnvScope<E> {
-    readonly core: EnvCore;
+    readonly core: EnvCoreRuntime;
     readonly name: string;
     private _raw;
     private _run;
     private readonly _fields;
     private readonly _otaList;
-    constructor(core: EnvCore, name: string);
-    field<Z extends keyof E = keyof E>(name: Z): EnvField<E, Z>;
-    get<Z extends keyof E = keyof E>(name: Z): EnvField<E, Z>;
-    has<Z extends keyof E = keyof E>(field: Z): boolean;
-    uses<E2 extends EnvBase = EnvBase>(scope: string | EnvScope<E2>): this;
-    run(): void;
+    private _onOta;
+    private _onChangeList;
+    private _onSet;
+    constructor(core: EnvCoreRuntime, name: string);
+    field<Z extends keyof E = keyof E>(name: Z): EnvFieldConfigure<E, Z>;
+    uses<E2 extends EnvBase = EnvBase>(scope: string | EnvScopeRuntime<E2>): EnvScopeConfigure<E>;
+    onChange(fn: EnvScopeOnLambda<E, void>): EnvScopeConfigure<E>;
+    onSet(fn: EnvScopeOnLambda<E, void>): EnvScopeConfigure<E>;
+    onOta(fn: EnvScopeOnLambda<E, void>): EnvScopeConfigure<E>;
+    get<Z extends keyof E = keyof E>(name: Z): EnvFieldRuntime<E, Z>;
+    has<Z extends keyof E = keyof E>(name: Z): boolean;
+    read(): void;
     print(): EnvFieldPrint[];
     get raw(): E;
+    refresh(): void;
+    clear(): void;
+    fromOta(values: Partial<E>): void;
+    $read(): void;
     $print(): EnvFieldPrint[];
-    $run(): void;
-    $refresh(): void;
     $addOta(name: keyof E): void;
-    $fromOta(values: Partial<E>): void;
+    get runtime(): EnvScopeRuntime<E>;
+    get configure(): EnvScopeConfigure<E>;
+    get $secure(): EnvScopeSecure<E>;
 }

package/dist/scope/env-scope.impl.js

@@ -4,60 +4,83 @@ exports.EnvScopeImpl = void 0;
 const internal_1 = require("../internal");
 const common_1 = require("@leyyo/common");
 const env_field_impl_1 = require("../field/env-field.impl");
+const error_enveloper_1 = require("@leyyo/error-enveloper");
 const WHERE = `${internal_1.FQN}.EnvScopeImpl`;
 class EnvScopeImpl {
+    // endregion property
     constructor(core, name) {
         this.core = core;
         this.name = name;
         this._fields = common_1.$repo.newMap(WHERE, 'fields'); // field name x field instance
         this._otaList = common_1.$repo.newArray(WHERE, 'otaList'); // field name
     }
+    // region configure
     field(name) {
         common_1.$assert.text(name, () => {
-            return { field: 'name', where: WHERE, scope: this.name };
+            return { where: WHERE, scope: this.name, method: 'field' };
         });
         if (this._fields.has(name)) {
-            throw common_1.$dev.developerError2(internal_1.FQN, 701, { message: 'Field is duplicated', field: name, scope: this.name, where: WHERE });
+            throw common_1.$dev.developerError2(internal_1.FQN, 701, { message: 'Field is duplicated', where: WHERE, scope: this.name, method: 'field', field: name });
         }
         const ins = new env_field_impl_1.EnvFieldImpl(this, name);
         this._fields.set(name, ins);
-        this.core.$addKey(name, this.name);
+        this.core.$secure.$addKey(name, ins);
         return ins;
     }
-    get(name) {
-        common_1.$assert.text(name, () => {
-            return { field: 'name', where: WHERE, scope: this.name };
-        });
-        if (!this._fields.has(name)) {
-            throw common_1.$dev.developerError2(internal_1.FQN, 701, { message: 'Field could not found', field: name, scope: this.name, where: WHERE });
-        }
-        return this._fields.get(name);
-    }
-    has(field) {
-        common_1.$assert.text(field, () => {
-            return { field: 'name', where: WHERE, scope: this.name };
-        });
-        return this._fields.has(field);
-    }
     uses(scope) {
         if (typeof scope === 'string') {
-            if (this.core.has(scope)) {
-                this.core.get(scope).$run();
+            if (this.core.hasScope(scope)) {
+                this.core.getScope(scope).$secure.$read();
             }
             else {
                 console.warn(`Not found scope: ${scope}`);
             }
         }
         else if (common_1.$is.object(scope) && scope instanceof env_field_impl_1.EnvFieldImpl) {
-            scope.$run();
+            scope.$secure.$read();
         }
         else {
             console.warn(`Invalid scope type: ${typeof scope}`);
         }
         return this;
     }
-    run() {
-        this.core.run();
+    onChange(fn) {
+        common_1.$assert.func(fn, { where: WHERE, scope: this.name, method: 'onChange' });
+        if (!Array.isArray(this._onChangeList)) {
+            this._onChangeList = [];
+        }
+        this._onChangeList.push(fn);
+        return this;
+    }
+    onSet(fn) {
+        common_1.$assert.func(fn, { where: WHERE, scope: this.name, method: 'onSet' });
+        this._onSet = fn;
+        return this;
+    }
+    onOta(fn) {
+        common_1.$assert.func(fn, { where: WHERE, scope: this.name, method: 'onOta' });
+        this._onOta = fn;
+        return this;
+    }
+    // endregion configure
+    // region runtime
+    get(name) {
+        common_1.$assert.text(name, () => {
+            return { where: WHERE, scope: this.name, method: 'get' };
+        });
+        if (!this._fields.has(name)) {
+            throw common_1.$dev.developerError2(internal_1.FQN, 701, { message: 'Field could not found', where: WHERE, scope: this.name, method: 'get', field: name });
+        }
+        return this._fields.get(name);
+    }
+    has(name) {
+        common_1.$assert.text(name, () => {
+            return { where: WHERE, scope: this.name, method: 'has' };
+        });
+        return this._fields.has(name);
+    }
+    read() {
+        this.core.read();
     }
     print() {
         return this.core.print();
@@ -73,37 +96,72 @@ class EnvScopeImpl {
         });
         return this._raw;
     }
-    $print() {
-        return Array.from(this._fields.values())
-            .map(field => field.$print());
+    refresh() {
+        this._run = false;
+        this._raw = undefined;
     }
-    $run() {
+    clear() {
+        this._raw = undefined;
+    }
+    fromOta(values) {
+        this.refresh();
+        if (common_1.$is.bareObject(values)) {
+            let changedAny = false;
+            for (const [name, value] of Object.entries(values)) {
+                const ins = this._fields.get(name);
+                if (ins) {
+                    if (ins.fromOta(value)) {
+                        changedAny = true;
+                    }
+                }
+            }
+            if (changedAny && this._onOta) {
+                error_enveloper_1.errorEnveloper.handle(() => this._onOta(this), (e) => console.log(`OnOta Error: ${e.message}, where: ${WHERE}, scope: ${this.name}`));
+            }
+        }
+    }
+    // endregion runtime
+    // region secure
+    $read() {
         if (this._run) {
             return;
         }
         this._run = true;
+        let changedAny = false;
         Array.from(this._fields.values())
-            .forEach(ins => ins.$run());
+            .forEach(ins => {
+            if (ins.read()) {
+                changedAny = true;
+            }
+        });
+        if (changedAny && this._onChangeList) {
+            this._onChangeList.forEach(fn => {
+                error_enveloper_1.errorEnveloper.handle(() => fn(this), (e) => console.log(`OnChange Error: ${e.message}, where: ${WHERE}, scope: ${this.name}`));
+            });
+        }
+        if (this._onSet) {
+            error_enveloper_1.errorEnveloper.handle(() => this._onSet(this), (e) => console.log(`OnSet Error: ${e.message}, where: ${WHERE}, scope: ${this.name}`));
+        }
     }
-    $refresh() {
-        this._run = false;
-        this._raw = undefined;
+    $print() {
+        return Array.from(this._fields.values())
+            .map(field => field.print());
     }
     $addOta(name) {
         if (!this._otaList.includes(name)) {
             this._otaList.push(name);
         }
     }
-    $fromOta(values) {
-        this.$refresh();
-        if (common_1.$is.bareObject(values)) {
-            for (const [name, value] of Object.entries(values)) {
-                const ins = this._fields.get(name);
-                if (ins) {
-                    ins.$fromOta(value);
-                }
-            }
-        }
+    // endregion secure
+    // region mode
+    get runtime() {
+        return this;
+    }
+    get configure() {
+        return this;
+    }
+    get $secure() {
+        return this;
     }
 }
 exports.EnvScopeImpl = EnvScopeImpl;

package/dist/scope/env-scope.impl.js.map

@@ -1 +1 @@
-{"version":3,"file":"env-scope.impl.js","sourceRoot":"","sources":["../../src/scope/env-scope.impl.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"env-scope.impl.js","sourceRoot":"","sources":["../../src/scope/env-scope.impl.ts"],"names":[],"mappings":";;;AAAA,0CAAgC;AAChC,0CAAwD;AACxD,4DAAqD;AACrD,4DAAsD;AAMtD,MAAM,KAAK,GAAG,GAAG,cAAG,eAAe,CAAC;AAEpC,MAAa,YAAY;IASrB,qBAAqB;IAErB,YAAqB,IAAoB,EAAW,IAAY;QAA3C,SAAI,GAAJ,IAAI,CAAgB;QAAW,SAAI,GAAJ,IAAI,CAAQ;QAP/C,YAAO,GAAG,cAAK,CAAC,MAAM,CAA8B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,8BAA8B;QACpG,aAAQ,GAAG,cAAK,CAAC,QAAQ,CAAU,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa;IAOpF,CAAC;IAED,mBAAmB;IACnB,KAAK,CAA8B,IAAO;QACtC,gBAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;YACpB,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAC,CAAA;QAC5D,CAAC,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,aAAI,CAAC,eAAe,CAAC,cAAG,EAAE,GAAG,EAAE,EAAC,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAc,EAAC,CAAC,CAAC;QACnJ,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,6BAAY,CAAO,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAc,EAAE,GAAsB,CAAC,CAAC;QAClE,OAAO,GAAG,CAAC;IACf,CAAC;IAED,IAAI,CAA+B,KAAiC;QAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9C,CAAC;iBACI,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;YAC9C,CAAC;QACL,CAAC;aACI,IAAI,YAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,6BAAY,EAAE,CAAC;YAC1D,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;aACI,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,uBAAuB,OAAO,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,QAAQ,CAAC,EAA6B;QAClC,gBAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAC,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,KAAK,CAAC,EAA6B;QAC/B,gBAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAC,KAAK,EAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAC,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,KAAK,CAAC,EAA6B;QAC/B,gBAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAC,KAAK,EAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAC,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,sBAAsB;IAEtB,iBAAiB;IAEjB,GAAG,CAA8B,IAAO;QACpC,gBAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;YACpB,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAC,CAAA;QAC1D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,aAAI,CAAC,eAAe,CAAC,cAAG,EAAE,GAAG,EAAE,EAAC,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAc,EAAC,CAAC,CAAC;QACnJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAA0B,CAAC;IAC3D,CAAC;IACD,GAAG,CAA8B,IAAO;QACpC,gBAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;YACpB,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAC,CAAA;QAC1D,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI;QACA,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IACD,KAAK;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,GAAG;QACH,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,EAAO,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aAC1B,OAAO,CAAC,GAAG,CAAC,EAAE;YACX,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAa,CAAe,CAAC;QAC9D,CAAC,CAAC,CAAC;QACP,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,OAAO;QACH,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IAC1B,CAAC;IACD,KAAK;QACD,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IAC1B,CAAC;IACD,OAAO,CAAC,MAAkB;QACtB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,YAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAe,CAAC,CAAC;gBAC9C,IAAI,GAAG,EAAE,CAAC;oBACN,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACrB,UAAU,GAAG,IAAI,CAAC;oBACtB,CAAC;gBACL,CAAC;YACL,CAAC;YACD,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC5B,gCAAc,CAAC,MAAM,CACjB,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EACvB,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,OAAO,YAAY,KAAK,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CACxF,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,oBAAoB;IAEpB,gBAAgB;IAEhB,KAAK;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO;QACX,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aAC5B,OAAO,CAAC,GAAG,CAAC,EAAE;YACX,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBACb,UAAU,GAAG,IAAI,CAAC;YACtB,CAAC;QACL,CAAC,CAAC,CAAC;QACP,IAAI,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;gBAC5B,gCAAc,CAAC,MAAM,CACjB,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EACd,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,OAAO,YAAY,KAAK,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAC3F,CAAC;YACN,CAAC,CAAC,CAAA;QACN,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,gCAAc,CAAC,MAAM,CACjB,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EACvB,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,OAAO,YAAY,KAAK,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CACxF,CAAC;QACN,CAAC;IACL,CAAC;IAED,MAAM;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aACnC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,IAAa;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;IACD,mBAAmB;IAEnB,cAAc;IACd,IAAI,OAAO;QACP,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,OAAO;QACP,OAAO,IAAI,CAAC;IAChB,CAAC;CAGJ;AA3LD,oCA2LC"}

package/dist/scope/index.types.d.ts

@@ -1,19 +1,34 @@
-import type { EnvField, EnvFieldPrint } from "../field";
-import type { EnvBase, EnvCore } from "../core";
-export interface EnvScope<E extends EnvBase = EnvBase> {
-    field<Z extends keyof E = keyof E>(field: Z): EnvField<E, Z>;
-    get<Z extends keyof E = keyof E>(field: Z): EnvField<E, Z>;
-    has<Z extends keyof E = keyof E>(field: Z): boolean;
-    uses(scope: string): this;
-    uses<E2 extends EnvBase = EnvBase>(scope: EnvScope<E2>): this;
-    run(): void;
+import type { EnvFieldConfigure, EnvFieldPrint, EnvFieldRuntime } from "../field";
+import type { EnvBase, EnvCoreRuntime } from "../core";
+export interface EnvScopeConfigure<E extends EnvBase = EnvBase> {
+    get runtime(): EnvScopeRuntime<E>;
+    field<Z extends keyof E = keyof E>(name: Z): EnvFieldConfigure<E, Z>;
+    uses(scope: string): EnvScopeConfigure<E>;
+    uses<E2 extends EnvBase = EnvBase>(scope: EnvScopeRuntime<E2>): EnvScopeConfigure<E>;
+    onChange(fn: EnvScopeOnLambda<E, void>): EnvScopeConfigure<E>;
+    onSet(fn: EnvScopeOnLambda<E, void>): EnvScopeConfigure<E>;
+    onOta(fn: EnvScopeOnLambda<E, void>): EnvScopeConfigure<E>;
+}
+export interface EnvScopeRuntime<E extends EnvBase = EnvBase> {
+    readonly name: string;
+    readonly core: EnvCoreRuntime;
+    get configure(): EnvScopeConfigure<E>;
+    get $secure(): EnvScopeSecure<E>;
+    get<Z extends keyof E = keyof E>(name: Z): EnvFieldRuntime<E, Z>;
+    has<Z extends keyof E = keyof E>(name: Z): boolean;
+    read(): void;
     print(): EnvFieldPrint[];
     get raw(): E;
-    get name(): string;
-    get core(): EnvCore;
-    $run(): void;
+    refresh(): void;
+    clear(): void;
+    fromOta(values: Partial<E>): void;
+}
+export interface EnvScopeSecure<E extends EnvBase = EnvBase> {
+    get runtime(): EnvScopeRuntime<E>;
+    $read(): void;
     $print(): EnvFieldPrint[];
-    $refresh(): void;
-    $fromOta(values: Partial<E>): void;
     $addOta(name: keyof E): void;
 }
+export interface EnvScope<E extends EnvBase = EnvBase> extends EnvScopeConfigure<E>, EnvScopeRuntime<E>, EnvScopeSecure<E> {
+}
+export type EnvScopeOnLambda<E extends EnvBase = EnvBase, R = unknown> = (scope: EnvScopeRuntime<E>) => R;

package/dist/server.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("./core");
-core_1.envCore.run();
+core_1.envCore.read();
 console.log('success');
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;AAAA,iCAA+B;AAE/B,cAAO,CAAC,GAAG,EAAE,CAAC;AACd,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;AAAA,iCAA+B;AAE/B,cAAO,CAAC,IAAI,EAAE,CAAC;AACf,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leyyo/env",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Environment library",
   "keywords": [
     "env",
@@ -51,6 +51,7 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "@leyyo/common": "^1.0.13"
+    "@leyyo/common": "^1.0.13",
+    "@leyyo/error-enveloper": "^1.0.3"
   }
 }