@leyyo/env 1.0.13 → 1.2.1

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

@@ -38,61 +38,77 @@ const internal_1 = require("../internal");
 const env_scope_impl_1 = require("../scope/env-scope.impl");
 const common_1 = require("@leyyo/common");
 const util = __importStar(require("node:util"));
+const environment_error_1 = require("./environment.error");
+const type_1 = require("@leyyo/type");
 const WHERE = `${internal_1.FQN}.EnvCore`;
+/**
+ * Environment core class
+ * */
 class EnvCoreImpl {
     // endregion property
     constructor() {
         // region property
+        /**
+         * Stores scopes with name
+         * */
         this._scopes = common_1.$repo.newMap(internal_1.FQN, 'scopes'); // scope name x scope instance
+        /**
+         * Stores fields with full name
+         * */
         this._keys = common_1.$repo.newMap(internal_1.FQN, 'keys'); // field name x scope name[]
     }
     // region configure
-    scope(name) {
-        common_1.$assert.text(name, () => {
-            return { field: 'name', where: WHERE };
-        });
+    /** @inheritDoc */
+    scope(name, prefix) {
+        (0, type_1.assertText)(name, () => common_1.$opt.fn({ field: 'name', where: WHERE, method: 'scope' }));
         if (this._scopes.has(name)) {
-            throw common_1.$dev.developerError2(internal_1.FQN, 701, { message: 'Scope is duplicated', scope: name, where: WHERE });
+            throw new environment_error_1.EnvironmentError('scope.duplicated', `Scope[${name}] is duplicated`, { value: name, where: WHERE, method: 'scope' });
+        }
+        if (prefix) {
+            (0, type_1.assertText)(prefix, () => common_1.$opt.fn({ where: WHERE, scope: name, method: 'scope', field: 'prefix' }));
+        }
+        else {
+            prefix = undefined;
         }
-        const ins = new env_scope_impl_1.EnvScopeImpl(this, name);
+        const ins = new env_scope_impl_1.EnvScopeImpl(this, name, prefix, undefined);
         this._scopes.set(name, ins);
         return ins;
     }
     // endregion configure
     // region runtime
+    /** @inheritDoc */
     getScope(name) {
-        common_1.$assert.text(name, () => {
-            return { where: WHERE, method: 'getScope' };
-        });
+        (0, type_1.assertText)(name, () => common_1.$opt.fn({ field: 'scope', where: WHERE, method: 'getScope' }));
         if (!this._scopes.has(name)) {
-            throw common_1.$dev.developerError2(internal_1.FQN, 701, { message: 'Scope could not found', scope: name, where: WHERE });
+            throw new environment_error_1.EnvironmentError('scope.not.found', `Scope[${name}] could not found`, { value: name, where: WHERE, method: 'getScope' });
         }
         return this._scopes.get(name);
     }
+    /** @inheritDoc */
     hasScope(name) {
-        common_1.$assert.text(name, () => {
-            return { where: WHERE, method: 'hasScope' };
-        });
+        (0, type_1.assertText)(name, () => common_1.$opt.fn({ field: 'scope', where: WHERE, method: 'hasScope' }));
         return this._scopes.has(name);
     }
-    getKey(name) {
-        common_1.$assert.text(name, () => {
-            return { where: WHERE, method: 'getKey' };
-        });
-        if (!this._keys.has(name)) {
-            throw common_1.$dev.developerError2(internal_1.FQN, 701, { message: 'Key could not found', key: name, where: WHERE });
+    /** @inheritDoc */
+    getKey(key) {
+        (0, type_1.assertText)(key, () => common_1.$opt.fn({ field: 'key', where: WHERE, method: 'getKey' }));
+        if (!this._keys.has(key)) {
+            throw new environment_error_1.EnvironmentError('field.not.found', `Key[${key}] could not found`, { value: key, where: WHERE, method: 'getKey' });
         }
-        return this._keys.get(name);
+        return this._keys.get(key);
     }
-    hasKey(name) {
-        common_1.$assert.text(name, () => {
-            return { where: WHERE, method: 'hasKey' };
+    /** @inheritDoc */
+    hasKey(key) {
+        (0, type_1.assertText)(key, () => {
+            return { field: key, where: WHERE, method: 'hasKey' };
         });
-        return this._keys.has(name);
+        return this._keys.has(key);
     }
-    get raw() {
+    /** @inheritDoc */
+    get allValues() {
         return JSON.parse(JSON.stringify(process.env));
     }
+    /** @inheritDoc */
     get keys() {
         const doc = {};
         for (const [key, value] of this._keys.entries()) {
@@ -100,13 +116,16 @@ class EnvCoreImpl {
         }
         return doc;
     }
+    /** @inheritDoc */
     get scopes() {
         return Array.from(this._scopes.values());
     }
+    /** @inheritDoc */
     read() {
         Array.from(this._scopes.values())
             .forEach(ins => ins.$secure.$read());
     }
+    /** @inheritDoc */
     print(asObject) {
         const result = [];
         Array.from(this._scopes.values())
@@ -116,8 +135,9 @@ class EnvCoreImpl {
         }
         return util.inspect(result, { showHidden: false, depth: null, colors: true });
     }
+    /** @inheritDoc */
     fromOta(values) {
-        if (common_1.$is.bareObject(values)) {
+        if ((0, type_1.isObjectBare)(values)) {
             const scopeMap = {};
             for (const [key, value] of Object.entries(values)) {
                 if (this._keys.has(key)) {
@@ -141,6 +161,7 @@ class EnvCoreImpl {
     }
     // endregion runtime
     // region secure
+    /** @inheritDoc */
     $addKey(key, field, alternative) {
         var _a;
         if (this._keys.has(key)) {
@@ -151,12 +172,15 @@ class EnvCoreImpl {
     }
     // endregion secure
     // region mode
+    /** @inheritDoc */
     get runtime() {
         return this;
     }
+    /** @inheritDoc */
     get configure() {
         return this;
     }
+    /** @inheritDoc */
     get $secure() {
         return this;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"env-core.impl.js","sourceRoot":"","sources":["../../src/core/env-core.impl.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"env-core.impl.js","sourceRoot":"","sources":["../../src/core/env-core.impl.ts"],"names":[],"mappings":"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"}

package/dist/core/environment.error.d.ts

@@ -0,0 +1,12 @@
+import { LeyyoError, type Opt } from "@leyyo/common";
+/**
+ * Environment error
+ * */
+export declare class EnvironmentError extends LeyyoError {
+    /**
+     * @param {string} issue - error code or issue code
+     * @param {string} message - error message
+     * @param {Opt} params - error parameters
+     * */
+    constructor(issue: string, message?: string, params?: Opt);
+}

package/dist/core/environment.error.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentError = void 0;
+const common_1 = require("@leyyo/common");
+/**
+ * Environment error
+ * */
+class EnvironmentError extends common_1.LeyyoError {
+    /**
+     * @param {string} issue - error code or issue code
+     * @param {string} message - error message
+     * @param {Opt} params - error parameters
+     * */
+    constructor(issue, message, params) {
+        super(message !== null && message !== void 0 ? message : issue, Object.assign(Object.assign({}, params), { issue }));
+    }
+}
+exports.EnvironmentError = EnvironmentError;
+//# sourceMappingURL=environment.error.js.map

package/dist/core/environment.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.error.js","sourceRoot":"","sources":["../../src/core/environment.error.ts"],"names":[],"mappings":";;;AAAA,0CAAmD;AAEnD;;KAEK;AACL,MAAa,gBAAiB,SAAQ,mBAAU;IAE5C;;;;SAIK;IACL,YAAY,KAAa,EAAE,OAAgB,EAAE,MAAY;QACrD,KAAK,CAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,KAAK,kCAAM,MAAM,KAAE,KAAK,IAAE,CAAC;IAChD,CAAC;CACJ;AAVD,4CAUC"}

package/dist/core/index.d.ts

@@ -1,2 +1,3 @@
 export * from './index.types';
 export * from './env-core.impl';
+export * from './environment.error';

package/dist/core/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./index.types"), exports);
 __exportStar(require("./env-core.impl"), exports);
+__exportStar(require("./environment.error"), exports);
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,kDAAgC;AAChC,sDAAoC"}

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

@@ -1,31 +1,141 @@
-import { EnvScopeConfigure, EnvScopePrint, EnvScopeRuntime } from "../scope";
+import type { EnvScopeConfigure, EnvScopePrint, EnvScopeRuntime } from "../scope";
 import type { EnvFieldRuntime } from "../field";
-export type EnvBase = Object;
+/**
+ * Environment base object
+ * */
+export type EnvBase = {};
+/**
+ * Environment core, configure mode
+ * */
 export interface EnvCoreConfigure {
+    /**
+     * Shift to runtime mode
+     *
+     * @return {EnvCoreRuntime} - runtime mode
+     * */
     get runtime(): EnvCoreRuntime;
-    scope<E extends EnvBase = EnvBase>(name: string): EnvScopeConfigure<E>;
+    /**
+     * Create new scope
+     *
+     * @param {string} name - name of scope
+     * @param {string} prefix - prefix of scope
+     * @return {EnvScopeConfigure} - created scope instance
+     * */
+    scope<C extends EnvBase, P extends string>(name: string, prefix?: P): EnvScopeConfigure<C, P>;
 }
+/**
+ * Environment core, runtime mode
+ * */
 export interface EnvCoreRuntime {
+    /**
+     * Shift to `configure` mode
+     * */
     get configure(): EnvCoreConfigure;
+    /**
+     * Shift to `secure` mode
+     * */
     get $secure(): EnvCoreSecure;
-    getScope(name: string): EnvScopeRuntime;
-    hasScope(name: string): boolean;
-    getKey(name: string): EnvCoreKeyRec;
-    hasKey(name: string): boolean;
-    get raw(): EnvBase;
+    /**
+     * Get scope
+     *
+     * @param {string} scope - scope name
+     * @return {EnvScopeRuntime}
+     * */
+    getScope<C extends EnvBase = EnvBase, P extends string = string, A extends string = undefined>(scope: string): EnvScopeRuntime<C, P, A>;
+    /**
+     * Has scope?
+     *
+     * @param {string} scope - scope name
+     * @return {boolean}
+     * */
+    hasScope(scope: string): boolean;
+    /**
+     * Get key
+     *
+     * @param {string} key - key name in dot-env
+     * @return {EnvCoreKeyRec}
+     * */
+    getKey(key: string): EnvCoreKeyRec;
+    /**
+     * Has key?
+     *
+     * @param {string} key - key name
+     * @return {boolean}
+     * */
+    hasKey(key: string): boolean;
+    /**
+     * Return all values
+     *
+     * @return {EnvBase}
+     * */
+    get allValues(): EnvBase;
+    /**
+     * Return keys
+     *
+     * @return {Record}
+     * */
     get keys(): Record<string, EnvCoreKeyRec>;
+    /**
+     * Return scopes
+     *
+     * @return {EnvScopeRuntime[]}
+     * */
     get scopes(): EnvScopeRuntime[];
+    /**
+     * Read values from dot-env
+     *
+     * @return {EnvScopeRuntime[]}
+     * */
     read(): void;
+    /**
+     * Print all environments
+     *
+     * @return {(string|EnvScopePrint[])}
+     * */
     print(asObject?: boolean): string | EnvScopePrint[];
+    /**
+     * Read from OTA
+     *
+     * @param {EnvBase} values - incoming env data
+     * */
     fromOta(values: EnvBase): void;
 }
+/**
+ * Environment core, secure mode
+ * */
 export interface EnvCoreSecure {
+    /**
+     * Return runtime value
+     * */
     get runtime(): EnvCoreRuntime;
-    $addKey(key: string, field: EnvFieldRuntime, alternative?: string): void;
+    /**
+     * Add key into repository
+     *
+     * @param {string} key - key name
+     * @param {EnvFieldRuntime} field - field structure
+     * @param {string?} alternative - alternative name
+     * */
+    $addKey(key: string, field: EnvFieldRuntime<EnvBase, string, undefined>, alternative?: string): void;
 }
+/**
+ * Environment core, all modes
+ * */
 export interface EnvCore extends EnvCoreConfigure, EnvCoreRuntime, EnvCoreSecure {
 }
+/**
+ * Basic record for any field
+ * */
 export interface EnvCoreKeyRec {
-    field: EnvFieldRuntime;
+    /**
+     * Key instance
+     *
+     * @type {EnvFieldRuntime}
+     * */
+    field: EnvFieldRuntime<EnvBase, string, undefined>;
+    /**
+     * Alternative name
+     *
+     * @type {string?}
+     * */
     alternative?: string;
 }

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

@@ -1,9 +1,10 @@
-import { EnvField, EnvFieldArray, EnvFieldAssertLambda, EnvFieldBoolean, EnvFieldCastLambda, EnvFieldConfigure, EnvFieldFloat, EnvFieldInteger, EnvFieldOnLambda, EnvFieldPrint, EnvFieldRuntime, EnvFieldSecret, EnvFieldSecure, EnvFieldString } from "./index.types";
-import type { EnvScopeConfigure, EnvScopeRuntime } from "../scope";
+import type { EnvField, EnvFieldConfigure, EnvFieldOnLambda, EnvFieldPrint, EnvFieldRuntime, EnvFieldSecure } from "./index.types";
+import { EnvScopeConfigure, EnvScopeRuntime, EnvVariation, EnvVariationValue } from "../scope";
 import type { EnvBase } from "../core";
-import type { EnumMap, KeyValue, EnumLiteral } from "@leyyo/common";
-export declare class EnvFieldImpl<E extends EnvBase = EnvBase, Z extends keyof E = keyof E> implements EnvField<E, Z> {
-    readonly scope: EnvScopeRuntime<E>;
+import type { EnumLiteral, EnumMap, KeyValue } from "@leyyo/common";
+import { type AssertBasicFn, type ToLambda } from "@leyyo/type";
+export declare class EnvFieldImpl<C extends EnvBase = EnvBase, P extends string = string, A extends string = undefined, Z extends keyof C = keyof C> implements EnvField<C, P, A, Z> {
+    readonly scope: EnvScopeRuntime<C, P, A>;
     readonly name: Z;
     private _required;
     private _requiredFn;
@@ -12,10 +13,8 @@ export declare class EnvFieldImpl<E extends EnvBase = EnvBase, Z extends keyof E
     private _def;
     private _clone;
     private _secret;
-    private _secretOpt;
     private _aliases;
     private _array;
-    private _arrayOpt;
     private _initialized;
     private _type;
     private _typeOpt;
@@ -23,56 +22,53 @@ export declare class EnvFieldImpl<E extends EnvBase = EnvBase, Z extends keyof E
     private _onChangeList;
     private _onSet;
     private _value;
-    constructor(scope: EnvScopeRuntime<E>, name: Z);
-    private static _lambdaMap;
+    readonly full: keyof EnvVariation<C, P, A>;
+    constructor(scope: EnvScopeRuntime<C, P, A>, name: Z);
     private get _f();
-    private _removeOpt;
-    private _setOrRemoveOpt;
     private get _devOne();
-    private _devMore;
     private get _findRequired();
     private _initialize;
     private get _fromDef();
     private get _plainValue();
     /** {@inheritDoc} */
-    required(p1?: boolean | EnvFieldOnLambda<E, Z, boolean>): EnvFieldConfigure<E, Z>;
+    required(p1?: boolean | EnvFieldOnLambda<C, P, A, Z, boolean>): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    array(opt?: EnvFieldArray): EnvFieldConfigure<E, Z>;
+    array(): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    secret(opt?: EnvFieldSecret): EnvFieldConfigure<E, Z>;
-    clone(name: string): EnvFieldConfigure<E, Z>;
+    secret(): EnvFieldConfigure<C, P, A, Z>;
+    clone(name: string): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    def(value: E[Z] | EnvFieldOnLambda<E, Z, E[Z]>): EnvFieldConfigure<E, Z>;
+    def(value: C[Z] | EnvFieldOnLambda<C, P, A, Z, C[Z]>): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    alias(...keys: string[]): EnvFieldConfigure<E, Z>;
+    alias(...keys: string[]): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    string(opt?: EnvFieldString): EnvFieldConfigure<E, Z>;
+    string(): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    text(opt?: EnvFieldString): EnvFieldConfigure<E, Z>;
+    text(): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    float(opt?: EnvFieldFloat): EnvFieldConfigure<E, Z>;
+    float(): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    integer(opt?: EnvFieldInteger): EnvFieldConfigure<E, Z>;
+    integer(): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    boolean(opt?: EnvFieldBoolean): EnvFieldConfigure<E, Z>;
+    boolean(): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    literal<L extends KeyValue = string>(keys: EnumLiteral<L>): EnvFieldConfigure<E, Z>;
+    literal<L extends KeyValue = string>(keys: EnumLiteral<L>): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    enumeration<L extends KeyValue = string>(map: EnumMap<L>): EnvFieldConfigure<E, Z>;
+    enumeration<L extends KeyValue = string>(map: EnumMap<L>): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    onOta(fn?: EnvFieldOnLambda<E, Z, void>): EnvFieldConfigure<E, Z>;
+    onOta(fn?: EnvFieldOnLambda<C, P, A, Z, void>): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    onChange(fn: EnvFieldOnLambda<E, Z, void>): EnvFieldConfigure<E, Z>;
+    onChange(fn: EnvFieldOnLambda<C, P, A, Z, void>): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    onSet(fn: EnvFieldOnLambda<E, Z, void>): EnvFieldConfigure<E, Z>;
+    onSet(fn: EnvFieldOnLambda<C, P, A, Z, void>): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    cast(fn: EnvFieldCastLambda<E, Z>): EnvFieldConfigure<E, Z>;
+    cast(fn: ToLambda<C[Z]>): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    assert(fn: EnvFieldAssertLambda): EnvFieldConfigure<E, Z>;
+    assert(fn: AssertBasicFn): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    get end(): EnvScopeConfigure<E>;
+    end(): EnvScopeConfigure<C, P, A>;
     /** {@inheritDoc} */
-    set(value: E[Z]): void;
+    set(value: C[Z]): void;
     private _printValue;
     /** {@inheritDoc} */
     print(): EnvFieldPrint;
@@ -81,13 +77,13 @@ export declare class EnvFieldImpl<E extends EnvBase = EnvBase, Z extends keyof E
     /** {@inheritDoc} */
     fromOta(value: unknown): boolean;
     /** {@inheritDoc} */
-    get raw(): E[Z] | undefined;
+    get value(): EnvVariationValue<C, P, A, Z> | undefined;
     $set(value: unknown): void;
-    $cast(fn: EnvFieldCastLambda<E, Z>): void;
-    $assert(fn: EnvFieldAssertLambda): void;
+    $cast(fn: ToLambda<C[Z]>): void;
+    $assert(fn: AssertBasicFn): void;
     /** {@inheritDoc} */
-    get configure(): EnvFieldConfigure<E, Z>;
+    get configure(): EnvFieldConfigure<C, P, A, Z>;
     /** {@inheritDoc} */
-    get runtime(): EnvFieldRuntime<E, Z>;
-    get $secure(): EnvFieldSecure<E, Z>;
+    get runtime(): EnvFieldRuntime<C, P, A, Z>;
+    get $secure(): EnvFieldSecure<C, P, A, Z>;
 }