@satoshibits/functional 1.0.2

package/dist/option.mjs

@@ -0,0 +1,637 @@
+"use strict";
+/**
+ * @module option
+ * @description Option/Maybe type for explicit null/undefined handling in a functional way.
+ * Provides a safe alternative to nullable values by wrapping them in a container type.
+ * Forces explicit handling of edge cases and eliminates null pointer exceptions.
+ * Inspired by functional programming languages like Haskell and Rust.
+ *
+ * @example
+ * ```typescript
+ * import { Option, some, none, fromNullable, map, getOrElse } from './option.mts';
+ *
+ * // creating options
+ * const user = some({ id: '123', name: 'Alice' });
+ * const notFound = none();
+ * const maybeUser = fromNullable(localStorage.getItem('user'));
+ *
+ * // transforming values
+ * const userName = map((u: User) => u.name)(user);
+ *
+ * // extracting values safely
+ * const name = getOrElse(() => 'Anonymous')(userName);
+ *
+ * // chaining operations
+ * const greeting = pipe(
+ *   fromNullable(getUserById(id)),
+ *   map(u => u.name),
+ *   map(name => `Hello, ${name}!`),
+ *   getOrElse(() => 'Hello, stranger!')
+ * );
+ * ```
+ *
+ * @category Core
+ * @since 2025-07-03
+ */
+/**
+ * Creates a Some variant containing the provided value.
+ * @description Wraps a value in the Some variant of Option.
+ * Use this when you have a value that definitely exists.
+ *
+ * @template T - The type of the value to wrap
+ * @param {T} value - The value to wrap in Some
+ * @returns {Option<T>} A Some variant containing the value
+ *
+ * @category Constructors
+ * @example
+ * const user = some({ id: '123', name: 'Alice' });
+ * // => { _tag: 'Some', value: { id: '123', name: 'Alice' } }
+ *
+ * @example
+ * // Wrapping a found value
+ * const found = database.find(id);
+ * const result = found ? some(found) : none();
+ *
+ * @example
+ * // Creating from non-null assertion
+ * const config = getConfig();
+ * if (config.apiKey) {
+ *   return some(config.apiKey);
+ * }
+ *
+ * @see none - Create an empty Option
+ * @see fromNullable - Create Option from nullable value
+ * @since 2025-07-03
+ */
+export var some = function (value) { return ({
+    _tag: 'Some',
+    value: value,
+}); };
+/**
+ * Creates a None variant representing no value.
+ * @description Creates the None variant of Option, representing absence of value.
+ * Use this when you want to explicitly represent "no value" in a type-safe way.
+ *
+ * @returns {Option<never>} A None variant
+ *
+ * @category Constructors
+ * @example
+ * const notFound = none();
+ * // => { _tag: 'None' }
+ *
+ * @example
+ * // Representing search miss
+ * const user = users.find(u => u.id === targetId);
+ * return user ? some(user) : none();
+ *
+ * @example
+ * // Empty configuration
+ * const apiKey = process.env.API_KEY;
+ * return apiKey ? some(apiKey) : none();
+ *
+ * @see some - Create an Option with a value
+ * @see fromNullable - Create Option from nullable value
+ * @since 2025-07-03
+ */
+export var none = function () { return ({
+    _tag: 'None',
+}); };
+/**
+ * Creates an Option from a nullable value.
+ * @description Converts a nullable value into an Option.
+ * Returns Some if the value is not null/undefined, None otherwise.
+ * This is the primary way to bridge nullable APIs with Option.
+ *
+ * @template T - The type of the non-null value
+ * @param {T | null | undefined} value - The nullable value to convert
+ * @returns {Option<T>} Some if value exists, None otherwise
+ *
+ * @category Constructors
+ * @example
+ * const maybeUser = fromNullable(localStorage.getItem('user'));
+ * // => Some(userData) if exists, None if null
+ *
+ * @example
+ * // Safe property access
+ * const email = fromNullable(user?.contact?.email);
+ *
+ * @example
+ * // Array element access
+ * const firstItem = fromNullable(items[0]);
+ *
+ * @see some - Wrap a non-null value
+ * @see none - Create an empty Option
+ * @since 2025-07-03
+ */
+export var fromNullable = function (value) {
+    return value === null || value === undefined ? none() : some(value);
+};
+/**
+ * Creates an Option from a predicate function.
+ * Returns Some if the predicate is true, None otherwise.
+ *
+ * @category Constructors
+ * @example
+ * const positive = Option.fromPredicate((n: number) => n > 0);
+ * positive(5); // => Some(5)
+ * positive(-1); // => None
+ *
+ * @example
+ * // Validation wrapper
+ * const validEmail = Option.fromPredicate((s: string) =>
+ *   /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(s)
+ * );
+ *
+ * @example
+ * // Range check
+ * const inRange = Option.fromPredicate((n: number) => n >= 0 && n <= 100);
+ */
+export var fromPredicate = function (predicate) {
+    return function (value) {
+        return predicate(value) ? some(value) : none();
+    };
+};
+/**
+ * Type guard to check if an Option is Some.
+ *
+ * @category Type Guards
+ * @example
+ * const opt = Option.fromNullable(getValue());
+ * if (Option.isSome(opt)) {
+ *   console.log(opt.value); // TypeScript knows opt.value exists
+ * }
+ *
+ * @example
+ * // Filtering array of options
+ * const values = options.filter(Option.isSome).map(opt => opt.value);
+ *
+ * @example
+ * // Early return pattern
+ * if (!Option.isSome(result)) {
+ *   return defaultValue;
+ * }
+ * return processValue(result.value);
+ */
+export var isSome = function (option) {
+    return option._tag === 'Some';
+};
+/**
+ * Type guard to check if an Option is None.
+ *
+ * @category Type Guards
+ * @example
+ * const user = findUser(id);
+ * if (Option.isNone(user)) {
+ *   throw new Error('User not found');
+ * }
+ *
+ * @example
+ * // Conditional rendering
+ * if (Option.isNone(data)) {
+ *   return <LoadingSpinner />;
+ * }
+ *
+ * @example
+ * // Validation check
+ * const validated = validate(input);
+ * if (Option.isNone(validated)) {
+ *   return { error: 'Invalid input' };
+ * }
+ */
+export var isNone = function (option) {
+    return option._tag === 'None';
+};
+/**
+ * Maps a function over the value in Some, does nothing for None.
+ *
+ * @category Transformations
+ * @example
+ * const doubled = Option.map((n: number) => n * 2);
+ * doubled(Option.some(5)); // => Some(10)
+ * doubled(Option.none()); // => None
+ *
+ * @example
+ * // Transform user data
+ * const userName = pipe(
+ *   findUser(id),
+ *   Option.map(user => user.name),
+ *   Option.map(name => name.toUpperCase())
+ * );
+ *
+ * @example
+ * // Parse and transform
+ * const parsed = pipe(
+ *   Option.fromNullable(jsonString),
+ *   Option.map(str => JSON.parse(str)),
+ *   Option.map(data => data.value)
+ * );
+ */
+export var map = function (fn) {
+    return function (option) {
+        return isSome(option) ? some(fn(option.value)) : none();
+    };
+};
+/**
+ * FlatMaps a function over the value in Some, does nothing for None.
+ * Also known as chain or bind in other libraries.
+ *
+ * @category Transformations
+ * @example
+ * const safeDivide = (n: number) =>
+ *   n === 0 ? Option.none() : Option.some(10 / n);
+ *
+ * const result = pipe(
+ *   Option.some(5),
+ *   Option.flatMap(safeDivide)
+ * ); // => Some(2)
+ *
+ * @example
+ * // Chaining optional operations
+ * const getManager = (employee: Employee) =>
+ *   Option.fromNullable(employee.managerId)
+ *     .pipe(Option.flatMap(id => findEmployee(id)));
+ *
+ * @example
+ * // Validation chain
+ * const processUser = pipe(
+ *   parseUser(input),
+ *   Option.flatMap(validateAge),
+ *   Option.flatMap(validateEmail)
+ * );
+ */
+export var flatMap = function (fn) {
+    return function (option) {
+        return isSome(option) ? fn(option.value) : none();
+    };
+};
+/**
+ * Alias for flatMap - monadic bind operation.
+ *
+ * @category Transformations
+ * @see flatMap
+ */
+export var chain = flatMap;
+/**
+ * Returns the value if Some, otherwise returns the provided default.
+ *
+ * @category Extractors
+ * @example
+ * const value = Option.getOrElse(() => 'default')(maybeValue);
+ *
+ * @example
+ * // Configuration with defaults
+ * const port = pipe(
+ *   Option.fromNullable(process.env.PORT),
+ *   Option.map(parseInt),
+ *   Option.getOrElse(() => 3000)
+ * );
+ *
+ * @example
+ * // User preferences
+ * const theme = pipe(
+ *   getUserPreference('theme'),
+ *   Option.getOrElse(() => 'light')
+ * );
+ */
+export var getOrElse = function (defaultValue) {
+    return function (option) {
+        return isSome(option) ? option.value : defaultValue();
+    };
+};
+/**
+ * Returns the first Some option, or None if both are None.
+ * Useful for fallback chains.
+ *
+ * @category Combinations
+ * @example
+ * const config = Option.orElse(
+ *   () => Option.fromNullable(process.env.API_KEY)
+ * )(Option.fromNullable(config.apiKey));
+ *
+ * @example
+ * // Multiple fallbacks
+ * const findUser = (id: string) => pipe(
+ *   findInCache(id),
+ *   Option.orElse(() => findInDatabase(id)),
+ *   Option.orElse(() => findInArchive(id))
+ * );
+ *
+ * @example
+ * // Try alternative parsing
+ * const parsed = pipe(
+ *   tryParseJSON(input),
+ *   Option.orElse(() => tryParseYAML(input))
+ * );
+ */
+export var orElse = function (alternative) {
+    return function (option) {
+        return isSome(option) ? option : alternative();
+    };
+};
+export function filter(predicate) {
+    return function (option) {
+        return isSome(option) && predicate(option.value) ? option : none();
+    };
+}
+/**
+ * Pattern matching for Option types.
+ * Provides exhaustive handling of both Some and None cases.
+ *
+ * @category Pattern Matching
+ * @example
+ * const message = Option.match({
+ *   some: (user) => `Hello, ${user.name}!`,
+ *   none: () => 'Hello, guest!'
+ * })(maybeUser);
+ *
+ * @example
+ * // React component rendering
+ * const UserProfile = ({ userId }: Props) => {
+ *   const user = useUser(userId);
+ *
+ *   return Option.match({
+ *     some: (u) => <Profile user={u} />,
+ *     none: () => <NotFound />
+ *   })(user);
+ * };
+ *
+ * @example
+ * // API response handling
+ * const response = await Option.match({
+ *   some: async (data) => api.update(data),
+ *   none: async () => api.create(defaults)
+ * })(existingData);
+ */
+export var match = function (patterns) {
+    return function (option) {
+        return isSome(option) ? patterns.some(option.value) : patterns.none();
+    };
+};
+/**
+ * Converts an Option to a nullable value.
+ * Some(value) becomes value, None becomes null.
+ *
+ * @category Conversions
+ * @example
+ * const value = Option.toNullable(maybeValue);
+ * localStorage.setItem('key', value ?? '');
+ *
+ * @example
+ * // Database update
+ * const update = {
+ *   name: Option.toNullable(maybeName),
+ *   email: Option.toNullable(maybeEmail),
+ *   phone: Option.toNullable(maybePhone)
+ * };
+ *
+ * @example
+ * // JSON serialization
+ * const data = {
+ *   id: user.id,
+ *   nickname: Option.toNullable(user.nickname)
+ * };
+ */
+export var toNullable = function (option) {
+    return isSome(option) ? option.value : null;
+};
+/**
+ * Converts an Option to undefined if None.
+ * Some(value) becomes value, None becomes undefined.
+ *
+ * @category Conversions
+ * @example
+ * const params = {
+ *   limit: 10,
+ *   offset: Option.toUndefined(maybeOffset)
+ * };
+ *
+ * @example
+ * // Optional chaining alternative
+ * const city = Option.toUndefined(
+ *   Option.map((addr: Address) => addr.city)(maybeAddress)
+ * );
+ */
+export var toUndefined = function (option) {
+    return isSome(option) ? option.value : undefined;
+};
+/**
+ * Creates an Option from a function that might throw an error.
+ * Returns Some with the result if the function succeeds, None if it throws.
+ *
+ * @category Constructors
+ * @example
+ * const safeParse = (json: string) => Option.tryCatch(() => JSON.parse(json));
+ * safeParse('{"a":1}'); // => Some({ a: 1 })
+ * safeParse('invalid json'); // => None
+ *
+ * @example
+ * // Safe file parsing
+ * const config = Option.tryCatch(() =>
+ *   JSON.parse(fs.readFileSync('config.json', 'utf8'))
+ * );
+ *
+ * @example
+ * // Safe URL parsing
+ * const url = Option.tryCatch(() => new URL(input));
+ */
+export var tryCatch = function (fn) {
+    try {
+        return some(fn());
+    }
+    catch (_a) {
+        return none();
+    }
+};
+/**
+ * Executes a side-effecting function on the value in Some.
+ * Returns the original Option unchanged.
+ *
+ * @category Side Effects
+ * @example
+ * const logValue = pipe(
+ *   Option.some(42),
+ *   Option.tap(value => console.log('Found value:', value))
+ * ); // logs "Found value: 42" and returns Some(42)
+ *
+ * @example
+ * // Debug logging in a chain
+ * const result = pipe(
+ *   getUserInput(),
+ *   Option.tap(input => console.log('Raw input:', input)),
+ *   Option.map(normalize),
+ *   Option.tap(normalized => console.log('Normalized:', normalized)),
+ *   Option.filter(isValid)
+ * );
+ *
+ * @example
+ * // Side effects like analytics
+ * const trackEvent = pipe(
+ *   findUser(id),
+ *   Option.tap(user => analytics.track('user.found', { id: user.id }))
+ * );
+ */
+export var tap = function (fn) {
+    return function (option) {
+        if (isSome(option)) {
+            fn(option.value);
+        }
+        return option;
+    };
+};
+/**
+ * Namespace containing all Option utilities.
+ *
+ * @category Namespace
+ */
+export var Option = {
+    some: some,
+    none: none,
+    fromNullable: fromNullable,
+    fromPredicate: fromPredicate,
+    tryCatch: tryCatch,
+    isSome: isSome,
+    isNone: isNone,
+    map: map,
+    flatMap: flatMap,
+    chain: chain,
+    getOrElse: getOrElse,
+    orElse: orElse,
+    filter: filter,
+    tap: tap,
+    match: match,
+    toNullable: toNullable,
+    toUndefined: toUndefined,
+};
+/**
+ * Combines two Options using a binary function.
+ * Returns None if either Option is None.
+ *
+ * @category Combinations
+ * @example
+ * const add = (a: number, b: number) => a + b;
+ * const sum = lift2(add)(Option.some(5), Option.some(3));
+ * // => Some(8)
+ *
+ * @example
+ * // Form validation
+ * const createUser = (name: string, email: string) => ({ name, email });
+ * const validUser = lift2(createUser)(
+ *   validateName(input.name),
+ *   validateEmail(input.email)
+ * );
+ *
+ * @example
+ * // Coordinate operations
+ * const distance = (x: number, y: number) => Math.sqrt(x * x + y * y);
+ * const result = lift2(distance)(parseX(input), parseY(input));
+ */
+export var lift2 = function (fn) {
+    return function (optionA, optionB) {
+        return isSome(optionA) && isSome(optionB)
+            ? some(fn(optionA.value, optionB.value))
+            : none();
+    };
+};
+/**
+ * Sequences an array of Options into an Option of array.
+ * Returns Some with all values if all are Some, None if any is None.
+ *
+ * @category Combinations
+ * @example
+ * const results = sequence([
+ *   Option.some(1),
+ *   Option.some(2),
+ *   Option.some(3)
+ * ]);
+ * // => Some([1, 2, 3])
+ *
+ * @example
+ * // Parse multiple values
+ * const numbers = sequence(
+ *   inputs.map(input => parseNumber(input))
+ * );
+ *
+ * @example
+ * // Validate all fields
+ * const validatedFields = sequence([
+ *   validateField('name', data.name),
+ *   validateField('email', data.email),
+ *   validateField('age', data.age)
+ * ]);
+ */
+export var sequence = function (options) {
+    var results = [];
+    for (var _i = 0, options_1 = options; _i < options_1.length; _i++) {
+        var option = options_1[_i];
+        if (isNone(option)) {
+            return none();
+        }
+        results.push(option.value);
+    }
+    return some(results);
+};
+/**
+ * Applies a function wrapped in an Option to a value wrapped in an Option.
+ *
+ * @category Apply
+ * @example
+ * const addOne = (n: number) => n + 1;
+ * const result = ap(Option.some(addOne))(Option.some(5));
+ * // => Some(6)
+ *
+ * @example
+ * // Partial application with options
+ * const add = (a: number) => (b: number) => a + b;
+ * const maybeAdd5 = Option.map(add)(Option.some(5));
+ * const result = ap(maybeAdd5)(Option.some(3));
+ * // => Some(8)
+ */
+export var ap = function (optionFn) {
+    return function (optionA) {
+        return isSome(optionFn) && isSome(optionA)
+            ? some(optionFn.value(optionA.value))
+            : none();
+    };
+};
+/**
+ * Sequences a struct of Options into an Option of a struct.
+ * Returns Some with the struct of all values if all are Some, None if any is None.
+ *
+ * @category Combinations
+ * @example
+ * const result = sequenceS({
+ *   a: Option.some(1),
+ *   b: Option.some('hello')
+ * });
+ * // => Some({ a: 1, b: 'hello' })
+ *
+ * @example
+ * // Form validation
+ * const validForm = sequenceS({
+ *   name: validateName(input.name),
+ *   email: validateEmail(input.email),
+ *   age: validateAge(input.age)
+ * });
+ *
+ * @example
+ * // Configuration validation
+ * const config = sequenceS({
+ *   apiKey: Option.fromNullable(process.env.API_KEY),
+ *   port: Option.tryCatch(() => parseInt(process.env.PORT!)),
+ *   debug: Option.fromNullable(process.env.DEBUG).pipe(Option.map(v => v === 'true'))
+ * });
+ */
+export var sequenceS = function (struct) {
+    var result = {};
+    for (var key in struct) {
+        var option = struct[key];
+        if (option && isSome(option)) {
+            result[key] = option.value;
+        }
+        else {
+            return none();
+        }
+    }
+    return some(result);
+};
+//# sourceMappingURL=option.mjs.map

package/dist/option.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.mjs","sourceRoot":"","sources":["../src/option.mts"],"names":[],"mappings":"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"}