@zelgadis87/utils-core 6.0.0-beta.5 → 6.0.0-beta.6

package/.rollup/index.cjs

@@ -221,9 +221,6 @@ class OptionalClz {
         this._value = defined ? t : undefined;
         this._present = defined;
     }
-    getRawValue() {
-        return this._value;
-    }
     get() {
         return this.getOrElseThrow();
     }
@@ -232,22 +229,6 @@ class OptionalClz {
             throw errorProducer();
         return this._value;
     }
-    set(t) {
-        if (isNullOrUndefined(t))
-            throw new ErrorSetEmptyOptional();
-        this._value = t;
-        this._present = true;
-    }
-    setNullable(t) {
-        if (isDefined(t)) {
-            return this.set(t);
-        }
-        return this;
-    }
-    clear() {
-        this._value = undefined;
-        this._present = false;
-    }
     isEmpty() {
         return !this._present;
     }
@@ -262,6 +243,13 @@ class OptionalClz {
         if (this.isPresent())
             return callback(this.get());
     }
+    /**
+     * Dispatches to one of two callbacks based on whether a value is present.
+     * Equivalent to `fold` (fp-ts), `match` (effect/Scala), and `ifPresentOrElse` (Java, but with return values).
+     * @param callbackIfPresent - called with the current value when present; its return value is forwarded
+     * @param callbackIfEmpty - called when empty; its return value is forwarded
+     * @returns the return value of whichever callback was invoked
+     */
     apply(callbackIfPresent, callbackIfEmpty) {
         if (this.isEmpty()) {
             return callbackIfEmpty();
@@ -292,44 +280,6 @@ class OptionalClz {
             return newValueProducer();
         }
     }
-    orElseReturnAndApply(newValue) {
-        if (this.isPresent()) {
-            return this.get();
-        }
-        else {
-            this.set(newValue);
-            return newValue;
-        }
-    }
-    orElseProduceAndApply(newValueProducer) {
-        if (this.isPresent()) {
-            return this.get();
-        }
-        else {
-            const newValue = newValueProducer();
-            this.set(newValue);
-            return newValue;
-        }
-    }
-    orElseReturnNullableAndApply(newValue) {
-        if (this.isPresent()) {
-            return this;
-        }
-        else {
-            this.setNullable(newValue);
-            return this;
-        }
-    }
-    orElseProduceNullableAndApply(newValueProducer) {
-        if (this.isPresent()) {
-            return this;
-        }
-        else {
-            const newValue = newValueProducer();
-            this.setNullable(newValue);
-            return this;
-        }
-    }
     orElseReturnNullable(newValue) {
         if (this.isEmpty())
             return OptionalClz.ofNullable(newValue);
@@ -353,7 +303,7 @@ class OptionalClz {
         throw errorProducer(this.get());
     }
     mapTo(mapper) {
-        return this.apply(() => OptionalClz.ofNullable(mapper(this.get())), () => OptionalClz.empty());
+        return this.apply(() => OptionalClz.of(mapper(this.get())), () => OptionalClz.empty());
     }
     flatMapTo(mapper) {
         return this.apply(() => mapper(this.get()), () => OptionalClz.empty());
@@ -368,11 +318,24 @@ class OptionalClz {
     static empty() {
         return new OptionalClz(undefined);
     }
+    /**
+     * Creates a present optional wrapping a non-null value.
+     * Throws {@link ErrorCannotInstantiatePresentOptionalWithEmptyValue} if `t` is null or undefined.
+     *
+     * ⚠️ Do NOT use this method when the value may be null/undefined.
+     * Anti-pattern: `value ? Optional.of(value!) : Optional.empty()` → use {@link ofNullable} instead.
+     * Only use this when you are certain the value is defined (e.g. a literal, a validated input, or a narrowed type).
+     */
     static of(t) {
         if (isNullOrUndefined(t))
             throw new ErrorCannotInstantiatePresentOptionalWithEmptyValue();
         return new OptionalClz(t);
     }
+    /**
+     * Creates an optional that is present when `t` is defined, or empty when null/undefined.
+     * This is the idiomatic replacement for the anti-pattern:
+     * `value ? Optional.of(value!) : Optional.empty()` → `Optional.ofNullable(value)`
+     */
     static ofNullable(t) {
         return new OptionalClz(t);
     }
@@ -389,11 +352,6 @@ class ErrorGetEmptyOptional extends Error {
         super("Cannot retrieve a value from an empty Optional.");
     }
 }
-class ErrorSetEmptyOptional extends Error {
-    constructor() {
-        super("Cannot set a null or undefined value.");
-    }
-}
 class ErrorCannotInstantiatePresentOptionalWithEmptyValue extends Error {
     constructor() {
         super("Cannot initialize a PresentOptional with a null or undefined value.");
@@ -4106,7 +4064,6 @@ exports.Deferred = Deferred;
 exports.DeferredCanceledError = DeferredCanceledError;
 exports.ErrorCannotInstantiatePresentOptionalWithEmptyValue = ErrorCannotInstantiatePresentOptionalWithEmptyValue;
 exports.ErrorGetEmptyOptional = ErrorGetEmptyOptional;
-exports.ErrorSetEmptyOptional = ErrorSetEmptyOptional;
 exports.Lazy = Lazy;
 exports.LazyAsync = LazyAsync;
 exports.LazyDictionary = LazyDictionary;