adaptive-extender 0.8.1 → 0.8.2

package/CHANGELOG.md

@@ -1,5 +1,5 @@
-## 0.8.1 (28.11.2025)
-- Added [environment](./src/node/environment.ts) module.
+## 0.8.2 (29.11.2025)
+- Added [reflect](./src/core/reflect.ts), [environment](./src/node/environment.ts) modules.
 
 ## 0.8.0 (03.11.2025)
 - Added missing documentation.

package/dist/core/global.d.ts

@@ -1,4 +1,12 @@
 declare global {
+    /**
+     * Exclude null from T
+     */
+    type NonNull<T> = T & ({} | undefined);
+    /**
+     * Exclude undefined from T
+     */
+    type NonUndefined<T> = T & ({} | null);
     /**
      * Returns the prototype of the given non-nullable value.
      * @param value The value whose prototype is to be retrieved. It cannot be null or undefined.

package/dist/core/global.js.map

@@ -1 +1 @@
-{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/core/global.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAiBb,UAAU,CAAC,SAAS,GAAG,UAAa,KAAqB;IACxD,OAAO,KAAK,CAAC,WAAW,CAAC;AAC1B,CAAC,CAAC;AAEF,UAAU,CAAC,QAAQ,GAAG,UAAU,KAAU;IACzC,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,OAAO,WAAW,CAAC;QACnC,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC;QACzB,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;AACF,CAAC,CAAC;AACF,YAAY;AAEZ,OAAO,EAAG,CAAC"}
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/core/global.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AA4Bb,UAAU,CAAC,SAAS,GAAG,UAAa,KAAqB;IACxD,OAAO,KAAK,CAAC,WAAW,CAAC;AAC1B,CAAC,CAAC;AAEF,UAAU,CAAC,QAAQ,GAAG,UAAU,KAAU;IACzC,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,OAAO,WAAW,CAAC;QACnC,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC;QACzB,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;AACF,CAAC,CAAC;AACF,YAAY;AAEZ,OAAO,EAAG,CAAC"}

package/dist/core/index.d.ts

@@ -7,6 +7,7 @@ export * from "./date.js";
 export * from "./math.js";
 export * from "./array.js";
 export * from "./object.js";
+export * from "./reflect.js";
 export * from "./archivable.js";
 export * from "./error.js";
 export * from "./promise.js";

package/dist/core/index.js

@@ -8,6 +8,7 @@ export * from "./date.js";
 export * from "./math.js";
 export * from "./array.js";
 export * from "./object.js";
+export * from "./reflect.js";
 export * from "./archivable.js";
 export * from "./error.js";
 export * from "./promise.js";

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/core/object.d.ts

@@ -8,13 +8,6 @@ declare global {
          * @throws {TypeError} If the source is not an object or null.
          */
         import(source: any, name?: string): object;
-        /**
-         * Applies a callback function to a non-nullable value, or returns the original nullable value.
-         * @param value The value to map.
-         * @param callback The function to apply if the value is non-nullable.
-         * @returns The mapped result.
-         */
-        map<T, N extends Exclude<T, NonNullable<T>>, R>(value: NonNullable<T> | N, callback: (object: NonNullable<T>) => R): R | N;
     }
 }
 export {};

package/dist/core/object.js

@@ -4,12 +4,6 @@ Object.import = function (source, name = "[source]") {
         throw new TypeError(`Unable to import object from ${name} due its ${typename(source)} type`);
     return source;
 };
-Object.map = function (value, callback) {
-    if (value === null || value === undefined)
-        return value;
-    else
-        return callback(value);
-};
 //#endregion
 export {};
 //# sourceMappingURL=object.js.map

package/dist/core/object.js.map

@@ -1 +1 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/core/object.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAuBb,MAAM,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,OAAe,UAAU;IAC/D,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClJ,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,GAAG,GAAG,UAAmB,KAAyB,EAAE,QAAuC;IACjG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;;QACnD,OAAO,QAAQ,CAAC,KAAuB,CAAC,CAAC;AAC/C,CAAC,CAAC;AACF,YAAY;AAEZ,OAAO,EAAG,CAAC"}
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/core/object.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAgBb,MAAM,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,OAAe,UAAU;IAC/D,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClJ,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AACF,YAAY;AAEZ,OAAO,EAAG,CAAC"}

package/dist/core/reflect.d.ts

@@ -0,0 +1,26 @@
+declare global {
+    namespace Reflect {
+        /**
+         * Applies a callback function to a non-null value, or returns the original null value.
+         * @param value The value to map.
+         * @param callback The function to apply if the value is non-null.
+         * @returns The mapped result.
+         */
+        function mapNull<T, N extends Exclude<T, NonNull<T>>, R>(value: NonNull<T> | N, callback: (value: NonNull<T>) => R): R | N;
+        /**
+         * Applies a callback function to a non-undefined value, or returns the original undefined value.
+         * @param value The value to map.
+         * @param callback The function to apply if the value is non-undefined.
+         * @returns The mapped result.
+         */
+        function mapUndefined<T, N extends Exclude<T, NonUndefined<T>>, R>(value: NonUndefined<T> | N, callback: (value: NonUndefined<T>) => R): R | N;
+        /**
+         * Applies a callback function to a non-nullable value, or returns the original nullable value.
+         * @param value The value to map.
+         * @param callback The function to apply if the value is non-nullable.
+         * @returns The mapped result.
+         */
+        function mapNullable<T, N extends Exclude<T, NonNullable<T>>, R>(value: NonNullable<T> | N, callback: (object: NonNullable<T>) => R): R | N;
+    }
+}
+export {};

package/dist/core/reflect.js

@@ -0,0 +1,19 @@
+"use strict";
+Reflect.mapNull = function (value, callback) {
+    if (value === null)
+        return value;
+    return callback(value);
+};
+Reflect.mapUndefined = function (value, callback) {
+    if (value === undefined)
+        return value;
+    return callback(value);
+};
+Reflect.mapNullable = function (value, callback) {
+    if (value === null || value === undefined)
+        return value;
+    return callback(value);
+};
+//#endregion
+export {};
+//# sourceMappingURL=reflect.js.map

package/dist/core/reflect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.js","sourceRoot":"","sources":["../../src/core/reflect.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AA6Bb,OAAO,CAAC,OAAO,GAAG,UAAkD,KAAqB,EAAE,QAAkC;IAC5H,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,QAAQ,CAAC,KAAK,CAAe,CAAC;AACtC,CAAC,CAAC;AAEF,OAAO,CAAC,YAAY,GAAG,UAAuD,KAA0B,EAAE,QAAuC;IAChJ,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,QAAQ,CAAC,KAAK,CAAoB,CAAC;AAC3C,CAAC,CAAC;AAEF,OAAO,CAAC,WAAW,GAAG,UAAsD,KAAyB,EAAE,QAAsC;IAC5I,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,QAAQ,CAAC,KAAK,CAAmB,CAAC;AAC1C,CAAC,CAAC;AACF,YAAY;AAEZ,OAAO,EAAG,CAAC"}

package/dist/node/environment.d.ts

@@ -1,8 +1,21 @@
 import "../core/index.js";
 import "dotenv/config";
+/**
+ * Represents the system environment and provides utility methods to access environment variables.
+ */
 declare class Environment {
+    /**
+     * Retrieves a new instance of the Environment class.
+     */
     static get env(): Environment;
+    /**
+     * Checks if a specific key exists within the environment variables.
+     */
     hasValue(key: string): boolean;
+    /**
+     * Reads and parses the value of a specific environment variable.
+     * @throws {ReferenceError} if the key is missing.
+     */
     readValue(key: string): any;
 }
 export { Environment };

package/dist/node/environment.js

@@ -2,14 +2,27 @@
 import "../core/index.js";
 import "dotenv/config";
 //#region Environment
+/**
+ * Represents the system environment and provides utility methods to access environment variables.
+ */
 class Environment {
+    /**
+     * Retrieves a new instance of the Environment class.
+     */
     static get env() {
         return new Environment();
     }
+    /**
+     * Checks if a specific key exists within the environment variables.
+     */
     hasValue(key) {
         const { env } = process;
         return (env[key] !== undefined);
     }
+    /**
+     * Reads and parses the value of a specific environment variable.
+     * @throws {ReferenceError} if the key is missing.
+     */
     readValue(key) {
         const { env } = process;
         const text = ReferenceError.suppress(env[key], `Key '${key}' at environment not registered`);

package/dist/node/environment.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/node/environment.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,kBAAkB,CAAC;AAC1B,OAAO,eAAe,CAAC;AAEvB,qBAAqB;AACrB,MAAM,WAAW;IAChB,MAAM,KAAK,GAAG;QACb,OAAO,IAAI,WAAW,EAAE,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,GAAW;QACnB,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,GAAW;QACpB,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QACxB,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,iCAAiC,CAAC,CAAC;QAC7F,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;CACD;AACD,YAAY;AAEZ,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/node/environment.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,kBAAkB,CAAC;AAC1B,OAAO,eAAe,CAAC;AAEvB,qBAAqB;AACrB;;GAEG;AACH,MAAM,WAAW;IAChB;;OAEG;IACH,MAAM,KAAK,GAAG;QACb,OAAO,IAAI,WAAW,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAW;QACnB,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,GAAW;QACpB,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QACxB,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,iCAAiC,CAAC,CAAC;QAC7F,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;CACD;AACD,YAAY;AAEZ,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "adaptive-extender",
-	"version": "0.8.1",
+	"version": "0.8.2",
 	"description": "Adaptive library for JS/TS development environments",
 	"type": "module",
 	"main": "./dist/core/index.js",