@resultsafe/core-fp-result 0.1.0

package/dist/umd/resultsafe-monorepo-core-fp-result.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultsafe-monorepo-core-fp-result.umd.js","sources":["../../src/constructors/Err.ts","../../src/constructors/Ok.ts","../../src/guards/isErr.ts","../../src/guards/isErrAnd.ts","../../src/guards/isOk.ts","../../src/guards/isOkAnd.ts","../../src/methods/andThen.ts","../../src/internal/option.ts","../../src/methods/err.ts","../../src/methods/expect.ts","../../src/methods/expectErr.ts","../../src/methods/flatten.ts","../../src/methods/inspect.ts","../../src/methods/inspectErr.ts","../../src/methods/map.ts","../../src/methods/mapErr.ts","../../src/methods/match.ts","../../src/methods/ok.ts","../../src/methods/orElse.ts","../../src/methods/tap.ts","../../src/methods/tapErr.ts","../../src/methods/transpose.ts","../../src/methods/unwrap.ts","../../src/methods/unwrapErr.ts","../../src/methods/unwrapOr.ts","../../src/methods/unwrapOrElse.ts","../../src/refiners/isTypedVariant.ts","../../src/refiners/isTypedVariantOf.ts","../../src/refiners/matchVariant.ts","../../src/refiners/matchVariantStrict.ts","../../src/internal/object.ts","../../src/refiners/refineAsyncResult.ts","../../src/refiners/refineAsyncResultU.ts","../../src/refiners/utils/getPayloadKeys.ts","../../src/refiners/refineResult.ts","../../src/refiners/refineResultU.ts","../../src/refiners/refineVariantMap.ts"],"sourcesContent":["import type { Result } from '../shared-types.js';\n\n/**\n * Создает ошибочное значение `Result` из переданного payload ошибки.\n *\n * @typeParam E - Тип значения ошибки.\n * @typeParam T - The success type for the resulting `Result`.\n * @param error - Payload ошибки для обёртки.\n * @returns A `Result` with `ok: false` and the provided `error`.\n * @since 0.1.0\n * @see {@link Ok} - Creates a successful `Result`.\n * @example\n * ```ts\n * import { Err } from '@resultsafe/core-fp-result';\n *\n * const result = Err<string, number>('boom');\n * console.log(result.ok); // false\n * ```\n * @public\n */\nexport const Err = <E, T = never>(error: E): Result<T, E> =>\n  ({ ok: false, error }) as const;\n\r\n\r\n","import type { Result } from '../shared-types.js';\n\n/**\n * Создает успешное значение `Result` из переданного payload.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - The error type for the resulting `Result`.\n * @param value - Payload успеха для обёртки.\n * @returns A `Result` with `ok: true` and the provided `value`.\n * @since 0.1.0\n * @see {@link Err} - Creates an error `Result`.\n * @example\n * ```ts\n * import { Ok } from '@resultsafe/core-fp-result';\n *\n * const result = Ok<number, string>(42);\n * console.log(result.ok); // true\n * ```\n * @public\n */\nexport const Ok = <T, E = never>(value: T): Result<T, E> =>\n  ({ ok: true, value }) as const;\n\r\n\r\n","import type { Result } from '../shared-types.js';\n\n/**\n * Проверяет, находится ли `Result` в ветке ошибки.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - `Result` для проверки.\n * @returns `true` when `result.ok` equals `false`.\n * @since 0.1.0\n * @see {@link isOk} - Checks the success branch.\n * @example\n * ```ts\n * import { Err, isErr } from '@resultsafe/core-fp-result';\n *\n * const result = Err('boom');\n * console.log(isErr(result)); // true\n * ```\n * @public\n */\nexport const isErr = <T, E>(\n  result: Result<T, E>,\n): result is { ok: false; error: E } => result.ok === false;\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isErr } from './isErr.js';\n\n/**\n * Проверяет, что `Result` завершился ошибкой и удовлетворяет предикату.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - `Result` для проверки.\n * @param predicate - Предикат, применяемый к значению ошибки.\n * @returns `true` when the value is `Err` and the predicate returns `true`.\n * @since 0.1.0\n * @see {@link isErr} - Performs the base error check.\n * @example\n * ```ts\n * import { Err, isErrAnd } from '@resultsafe/core-fp-result';\n *\n * const result = Err({ code: 503 });\n * console.log(isErrAnd(result, (error) => error.code >= 500)); // true\n * ```\n * @public\n */\nexport const isErrAnd = <T, E>(\n  result: Result<T, E>,\n  predicate: (error: E) => boolean,\n): boolean => isErr(result) && predicate(result.error);\n\r\n\r\n","import type { Result } from '../shared-types.js';\n\n/**\n * Проверяет, находится ли `Result` в ветке успеха.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - `Result` для проверки.\n * @returns `true` when `result.ok` equals `true`.\n * @since 0.1.0\n * @see {@link isErr} - Checks the error branch.\n * @example\n * ```ts\n * import { Ok, isOk } from '@resultsafe/core-fp-result';\n *\n * const result = Ok(10);\n * console.log(isOk(result)); // true\n * ```\n * @public\n */\nexport const isOk = <T, E>(\n  result: Result<T, E>,\n): result is { ok: true; value: T } => result.ok === true;\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isOk } from './isOk.js';\n\n/**\n * Проверяет, что `Result` успешен и удовлетворяет предикату.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - `Result` для проверки.\n * @param predicate - Предикат, применяемый к успешному значению.\n * @returns `true` when the value is `Ok` and the predicate returns `true`.\n * @since 0.1.0\n * @see {@link isOk} - Performs the base success check.\n * @example\n * ```ts\n * import { Ok, isOkAnd } from '@resultsafe/core-fp-result';\n *\n * const result = Ok(8);\n * console.log(isOkAnd(result, (value) => value % 2 === 0)); // true\n * ```\n * @public\n */\nexport const isOkAnd = <T, E>(\n  result: Result<T, E>,\n  predicate: (value: T) => boolean,\n): boolean => isOk(result) && predicate(result.value);\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\n\n/**\n * Цепляет вычисление, которое возвращает другой `Result`.\n *\n * @typeParam T - The input success type.\n * @typeParam U - The output success type.\n * @typeParam E - Общий тип ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Функция, применяемая, когда `result` имеет `Ok`.\n * @returns Преобразованный `Result` или исходный `Err`.\n * @since 0.1.0\n * @see {@link map} - Преобразует только успешное значение.\n * @example\n * ```ts\n * import { Ok, Err, andThen } from '@resultsafe/core-fp-result';\n *\n * const parsed = andThen(Ok('12'), (value) => {\n *   const n = Number(value);\n *   return Number.isNaN(n) ? Err('invalid') : Ok(n);\n * });\n * console.log(parsed.ok); // true\n * ```\n * @public\n */\nexport const andThen = <T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => Result<U, E>,\n): Result<U, E> => (isOk(result) ? fn(result.value) : (result as Result<U, E>));\n\r\n\r\n","/** Represents an empty internal option value. @internal */\nexport const None = { some: false } as const;\n\n/** Wraps an internal option value as present. @internal */\nexport const Some = <T>(value: T) => ({ some: true, value }) as const;\n","import { type Option } from '../shared-types.js';\nimport { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\nimport { None, Some } from '../internal/option.js';\n\n/**\n * Извлекает ветку ошибки в виде `Option`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @returns `Some(error)` для `Err`, иначе `None`.\n * @since 0.1.0\n * @see {@link ok} - Извлекает ветку успеха.\n * @example\n * ```ts\n * import { Err, err } from '@resultsafe/core-fp-result';\n *\n * const value = err(Err('boom'));\n * console.log(value.some); // true\n * ```\n * @public\n */\nexport const err = <T, E>(result: Result<T, E>): Option<E> =>\n  isErr(result) ? Some(result.error) : None;\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\n\n/**\n * Возвращает успешное значение или выбрасывает исключение с пользовательским сообщением.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param msg - Сообщение об ошибке, используемое когда `result` имеет `Err`.\n * @returns Распакованное успешное значение.\n * @throws Error - Выбрасывает исключение, когда `result` имеет `Err`.\n * @since 0.1.0\n * @see {@link expectErr} - Симметричный helper для ветки ошибки.\n * @example\n * ```ts\n * import { Ok, expect } from '@resultsafe/core-fp-result';\n *\n * const value = expect(Ok(5), 'must be ok');\n * console.log(value); // 5\n * ```\n * @public\n */\nexport const expect = <T, E>(result: Result<T, E>, msg: string): T => {\n  if (isOk(result)) {\n    return result.value;\n  }\n  throw new Error(msg);\n};\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\n\n/**\n * Возвращает значение ошибки или выбрасывает исключение с пользовательским сообщением.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param msg - Сообщение об ошибке, используемое когда `result` имеет `Ok`.\n * @returns Распакованное значение ошибки.\n * @throws Error - Выбрасывает исключение, когда `result` имеет `Ok`.\n * @since 0.1.0\n * @see {@link expect} - Симметричный helper для ветки успеха.\n * @example\n * ```ts\n * import { Err, expectErr } from '@resultsafe/core-fp-result';\n *\n * const error = expectErr(Err('boom'), 'must be err');\n * console.log(error); // boom\n * ```\n * @public\n */\nexport const expectErr = <T, E>(result: Result<T, E>, msg: string): E => {\n  if (isErr(result)) {\n    return result.error;\n  }\n  throw new Error(msg);\n};\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\n/**\n * Схлопывает вложенный `Result<Result<T, E>, E>` на один уровень.\n *\n * @typeParam T - The inner success value type.\n * @typeParam E - The shared error value type.\n * @param result - Вложенный `Result` для схлопывания.\n * @returns A single-layer `Result<T, E>`.\n * @since 0.1.0\n * @see {@link andThen} - Chains computations that already return `Result`.\n * @example\n * ```ts\n * import { Ok, flatten } from '@resultsafe/core-fp-result';\n *\n * const value = flatten(Ok(Ok(3)));\n * console.log(value.ok); // true\n * ```\n * @public\n */\nexport const flatten = <T, E>(result: Result<Result<T, E>, E>): Result<T, E> =>\n  result.ok ? result.value : { ok: false, error: result.error };\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\n\n/**\n * Выполняет побочный эффект для успешного значения и возвращает исходный `Result`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Функция побочного эффекта для ветки успеха.\n * @returns Тот же экземпляр `Result`.\n * @since 0.1.0\n * @see {@link tap} - Эквивалентный helper для ветки успеха.\n * @example\n * ```ts\n * import { Ok, inspect } from '@resultsafe/core-fp-result';\n *\n * const result = inspect(Ok(1), (value) => console.log(value)); // 1\n * console.log(result.ok); // true\n * ```\n * @public\n */\nexport const inspect = <T, E>(\n  result: Result<T, E>,\n  fn: (value: T) => void,\n): Result<T, E> => {\n  if (isOk(result)) {\n    fn(result.value);\n  }\n  return result;\n};\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\n\n/**\n * Выполняет побочный эффект для значения ошибки и возвращает исходный `Result`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Функция побочного эффекта для ветки ошибки.\n * @returns Тот же экземпляр `Result`.\n * @since 0.1.0\n * @see {@link tapErr} - Эквивалентный helper для ветки ошибки.\n * @example\n * ```ts\n * import { Err, inspectErr } from '@resultsafe/core-fp-result';\n *\n * const result = inspectErr(Err('boom'), (error) => console.log(error)); // boom\n * console.log(result.ok); // false\n * ```\n * @public\n */\nexport const inspectErr = <T, E>(\n  result: Result<T, E>,\n  fn: (error: E) => void,\n): Result<T, E> => {\n  if (isErr(result)) {\n    fn(result.error);\n  }\n  return result;\n};\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\n\n/**\n * Преобразует успешное значение, сохраняя ветку ошибки.\n *\n * @typeParam T - Тип входного успешного значения.\n * @typeParam U - Тип выходного успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Функция преобразования успешного значения.\n * @returns Преобразованный `Ok` или исходный `Err`.\n * @since 0.1.0\n * @see {@link mapErr} - Преобразует ветку ошибки.\n * @example\n * ```ts\n * import { Ok, map } from '@resultsafe/core-fp-result';\n *\n * const result = map(Ok(2), (value) => value * 10);\n * console.log(result.ok); // true\n * ```\n * @public\n */\nexport const map = <T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => U,\n): Result<U, E> =>\n  isOk(result)\n    ? { ok: true, value: fn(result.value) }\n    : (result as Result<U, E>);\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\n\n/**\n * Преобразует значение ошибки, сохраняя ветку успеха.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип входного значения ошибки.\n * @typeParam F - Тип выходного значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Функция преобразования значения ошибки.\n * @returns Преобразованный `Err` или исходный `Ok`.\n * @since 0.1.0\n * @see {@link map} - Transforms the success branch.\n * @example\n * ```ts\n * import { Err, mapErr } from '@resultsafe/core-fp-result';\n *\n * const result = mapErr(Err('e1'), (error) => `mapped:${error}`);\n * console.log(result.ok); // false\n * ```\n * @public\n */\nexport const mapErr = <T, E, F>(\n  result: Result<T, E>,\n  fn: (error: E) => F,\n): Result<T, F> =>\n  isErr(result)\n    ? { ok: false, error: fn(result.error) }\n    : (result as Result<T, F>);\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\n/**\n * Выполняет сопоставление `Result` в единое выходное значение.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @typeParam U - The output type returned by both handlers.\n * @param result - Исходный `Result`.\n * @param okFn - Обработчик для ветки успеха.\n * @param errFn - Обработчик для ветки ошибки.\n * @returns Выходное значение, полученное от выбранного обработчика.\n * @since 0.1.0\n * @see {@link unwrapOrElse} - Similar shape with default fallback semantics.\n * @example\n * ```ts\n * import { Ok, match } from '@resultsafe/core-fp-result';\n *\n * const value = match(Ok(3), (x) => `ok:${x}`, (e) => `err:${e}`);\n * console.log(value); // ok:3\n * ```\n * @public\n */\nexport const match = <T, E, U>(\n  result: Result<T, E>,\n  okFn: (value: T) => U,\n  errFn: (error: E) => U,\n): U => {\n  if (result.ok) {\n    return okFn(result.value);\n  } else {\n    const { error } = result;\n    return errFn(error);\n  }\n};\n\r\n\r\n","import { type Option } from '../shared-types.js';\nimport { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\nimport { None, Some } from '../internal/option.js';\n\n/**\n * Извлекает успешную ветку в виде `Option`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @returns `Some(value)` для `Ok`, иначе `None`.\n * @since 0.1.0\n * @see {@link err} - Извлекает ветку ошибки.\n * @example\n * ```ts\n * import { Ok, ok } from '@resultsafe/core-fp-result';\n *\n * const value = ok(Ok(10));\n * console.log(value.some); // true\n * ```\n * @public\n */\nexport const ok = <T, E>(result: Result<T, E>): Option<T> =>\n  isOk(result) ? Some(result.value) : None;\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\n\n/**\n * Восстанавливается из ошибки, преобразуя `Err` в другой `Result`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип входного значения ошибки.\n * @typeParam F - Тип выходного значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Функция восстановления, применяемая для `Err`.\n * @returns Восстановленный `Result` или исходный `Ok`.\n * @since 0.1.0\n * @see {@link andThen} - Цепляет ветку успеха.\n * @example\n * ```ts\n * import { Err, Ok, orElse } from '@resultsafe/core-fp-result';\n *\n * const result = orElse(Err('network'), () => Ok('cached'));\n * console.log(result.ok); // true\n * ```\n * @public\n */\nexport const orElse = <T, E, F>(\n  result: Result<T, E>,\n  fn: (error: E) => Result<T, F>,\n): Result<T, F> =>\n  isErr(result) ? fn(result.error) : (result as Result<T, F>);\n\r\n\r\n","import type { Result } from '../shared-types.js';\n\n/**\n * Выполняет побочный эффект для значения `Ok` и возвращает входной `Result`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Колбэк побочного эффекта для ветки успеха.\n * @returns Неизмененный `Result`.\n * @since 0.1.0\n * @see {@link tapErr} - Executes a side effect for the error branch.\n * @example\n * ```ts\n * import { Ok, tap } from '@resultsafe/core-fp-result';\n *\n * const result = tap(Ok(1), (value) => console.log(value)); // 1\n * console.log(result.ok); // true\n * ```\n * @public\n */\nexport const tap = <T, E>(\n  result: Result<T, E>,\n  fn: (value: T) => void,\n): Result<T, E> => {\n  if (result.ok) {\n    fn(result.value);\n  }\n  return result;\n};\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\n\n/**\n * Выполняет побочный эффект для значения `Err` и возвращает входной `Result`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Колбэк побочного эффекта для ветки ошибки.\n * @returns Неизмененный `Result`.\n * @since 0.1.0\n * @see {@link tap} - Executes a side effect for the success branch.\n * @example\n * ```ts\n * import { Err, tapErr } from '@resultsafe/core-fp-result';\n *\n * const result = tapErr(Err('boom'), (error) => console.log(error)); // boom\n * console.log(result.ok); // false\n * ```\n * @public\n */\nexport const tapErr = <T, E>(\n  result: Result<T, E>,\n  fn: (error: E) => void,\n): Result<T, E> => {\n  if (isErr(result)) {\n    fn(result.error);\n  }\n  return result;\n};\n\r\n\r\n","import { type Option } from '../shared-types.js';\nimport { type Result } from '../shared-types.js';\n\nimport { None, Some } from '../internal/option.js';\n\n/**\n * Преобразует `Result<Option<T>, E>` в `Option<Result<T, E>>`.\n *\n * @typeParam T - The success value type inside `Option`.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`, содержащий `Option`.\n * @returns Транспонированный `Option<Result<T, E>>`.\n * @since 0.1.0\n * @see {@link flatten} - Collapses nested `Result` values.\n * @example\n * ```ts\n * import { Ok, transpose } from '@resultsafe/core-fp-result';\n *\n * const value = transpose(Ok({ some: true, value: 2 }));\n * console.log(value.some); // true\n * ```\n * @public\n */\nexport const transpose = <T, E>(\n  result: Result<Option<T>, E>,\n): Option<Result<T, E>> => {\n  if (result.ok) {\n    return result.value.some === true\n      ? Some({ ok: true, value: result.value.value })\n      : None;\n  }\n  return Some({ ok: false, error: result.error });\n};\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\n\n/**\n * Возвращает успешное значение или выбрасывает исключение, если результат `Err`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @returns Payload успеха.\n * @throws Error - Выбрасывает исключение при вызове на `Err`.\n * @since 0.1.0\n * @see {@link unwrapOr} - Возвращает fallback вместо выброса исключения.\n * @example\n * ```ts\n * import { Ok, unwrap } from '@resultsafe/core-fp-result';\n *\n * const value = unwrap(Ok(9));\n * console.log(value); // 9\n * ```\n * @public\n */\nexport const unwrap = <T, E>(result: Result<T, E>): T => {\n  if (isOk(result)) {\n    return result.value;\n  }\n  throw new Error('Called unwrap on an Err value');\n};\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isErr } from '../guards/isErr.js';\n\n/**\n * Возвращает значение ошибки или выбрасывает исключение, если результат `Ok`.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @returns Payload ошибки.\n * @throws Error - Выбрасывает исключение при вызове на `Ok`.\n * @since 0.1.0\n * @see {@link unwrapOrElse} - Возвращает fallback успеха без выброса исключения.\n * @example\n * ```ts\n * import { Err, unwrapErr } from '@resultsafe/core-fp-result';\n *\n * const error = unwrapErr(Err('boom'));\n * console.log(error); // boom\n * ```\n * @public\n */\nexport const unwrapErr = <T, E>(result: Result<T, E>): E => {\n  if (isErr(result)) {\n    return result.error;\n  }\n  throw new Error('Called unwrapErr on an Ok value');\n};\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\nimport { isOk } from '../guards/isOk.js';\n\n/**\n * Возвращает успешное значение или переданный fallback по умолчанию.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param defaultValue - Fallback-значение для `Err`.\n * @returns Payload успеха или `defaultValue`.\n * @since 0.1.0\n * @see {@link unwrapOrElse} - Вычисляет fallback лениво.\n * @example\n * ```ts\n * import { Err, unwrapOr } from '@resultsafe/core-fp-result';\n *\n * const value = unwrapOr(Err('boom'), 0);\n * console.log(value); // 0\n * ```\n * @public\n */\nexport const unwrapOr = <T, E>(result: Result<T, E>, defaultValue: T): T =>\n  isOk(result) ? result.value : defaultValue;\n\r\n\r\n","import { type Result } from '../shared-types.js';\n\n/**\n * Возвращает успешное значение или вычисляет fallback из ошибки.\n *\n * @typeParam T - Тип успешного значения.\n * @typeParam E - Тип значения ошибки.\n * @param result - Исходный `Result`.\n * @param fn - Функция-поставщик fallback для `Err`.\n * @returns Payload успеха или вычисленный fallback.\n * @since 0.1.0\n * @see {@link unwrapOr} - Использует eager fallback-значение.\n * @example\n * ```ts\n * import { Err, unwrapOrElse } from '@resultsafe/core-fp-result';\n *\n * const value = unwrapOrElse(Err('fatal'), (error) => error.length);\n * console.log(value); // 5\n * ```\n * @public\n */\nexport const unwrapOrElse = <T, E>(\n  result: Result<T, E>,\n  fn: (error: E) => T,\n): T => {\n  if (result.ok) {\n    return result.value;\n  } else {\n    return fn(result.error);\n  }\n};\n\r\n\r\n","/**\n * Создает runtime type guard для варианта дискриминированного объединения.\n *\n * @typeParam K - The discriminant literal type.\n * @param variant - Значение дискриминанта для сопоставления.\n * @returns A predicate that checks `{ type: K }` shape.\n * @since 0.1.0\n * @see {@link isTypedVariantOf} - Расширяет проверку ключами payload.\n * @example\n * ```ts\n * import { isTypedVariant } from '@resultsafe/core-fp-result';\n *\n * const isCreated = isTypedVariant('created');\n * console.log(isCreated({ type: 'created' })); // true\n * ```\n * @public\n */\nexport const isTypedVariant =\n  <K extends string>(variant: K) =>\n  (value: unknown): value is { type: K } => {\n    if (typeof value !== 'object' || value === null) return false;\n    if (!('type' in value)) return false;\n\n    const obj = value as Record<string, unknown>;\n    return obj['type'] === variant;\n  };\n","/**\n * Создает runtime type guard для варианта с дополнительными ключами payload.\n *\n * @typeParam K - The discriminant literal type.\n * @typeParam T - The required payload record shape.\n * @param variant - Значение дискриминанта для сопоставления.\n * @returns A predicate that checks variant and payload key presence.\n * @since 0.1.0\n * @see {@link isTypedVariant} - Проверяет только дискриминант.\n * @example\n * ```ts\n * import { isTypedVariantOf } from '@resultsafe/core-fp-result';\n *\n * const isCreated = isTypedVariantOf<'created', { id: unknown }>('created');\n * console.log(isCreated({ type: 'created', id: 1 })); // true\n * ```\n * @public\n */\nexport const isTypedVariantOf =\n  <K extends string, T extends Record<string, unknown>>(variant: K) =>\n  (value: unknown): value is { type: K } & T => {\n    // Rust-style early returns with Option-like behavior\n    if (typeof value !== 'object' || value === null) return false;\n    if (!('type' in value)) return false;\n\n    const obj = value as Record<string, unknown>;\n    if (obj['type'] !== variant) return false;\n\n    // Type-safe key checking (like Rust's HashMap.contains_key)\n    const requiredKeys = Object.keys({} as T) as Array<keyof T>;\n    for (const key of requiredKeys) {\n      if (!(key in obj)) return false;\n    }\n\n    return true;\n  };\n","import type { Handler, Matcher, VariantOf } from './types/index.js';\n\n/**\n * Создает цепочный matcher для значения дискриминированного объединения.\n *\n * @typeParam T - Тип дискриминированного объединения.\n * @param value - Значение объединения для сопоставления.\n * @returns Fluent matcher с ветками `with` и `otherwise`.\n * @since 0.1.0\n * @see {@link matchVariantStrict} - Требует исчерпывающего сопоставления во время выполнения.\n * @example\n * ```ts\n * import { matchVariant } from '@resultsafe/core-fp-result';\n *\n * const out = matchVariant<{ type: 'ok'; value: number } | { type: 'err'; error: string }>({\n *   type: 'ok',\n *   value: 1,\n * })\n *   .with('ok', (v) => `ok:${v.value}`)\n *   .otherwise(() => 'fallback')\n *   .run();\n *\n * console.log(out); // ok:1\n * ```\n * @public\n */\nexport const matchVariant = <T extends VariantOf>(\n  value: T,\n): Matcher<T, unknown> => {\n  const handlers: readonly Handler<T['type'], T, unknown>[] = [];\n\n  const withHandler = <K extends T['type']>(\n    variant: K,\n    fn: (value: Extract<T, { type: K }>) => unknown,\n  ): Matcher<T, unknown> => {\n    const newHandlers = [...handlers, { variant, fn }] as const;\n\n    return {\n      with: <K2 extends T['type']>(\n        variant2: K2,\n        fn2: (value: Extract<T, { type: K2 }>) => unknown,\n      ): Matcher<T, unknown> => {\n        const newerHandlers = [\n          ...newHandlers,\n          { variant: variant2, fn: fn2 },\n        ] as const;\n\n        return {\n          with: withHandler,\n          otherwise: (fallback: (value: T) => unknown) => ({\n            run: (): unknown => {\n              for (const h of newerHandlers) {\n                if (value.type === h.variant) {\n                  const fn = h.fn as (input: T) => unknown;\n                  return fn(value);\n                }\n              }\n              return fallback(value);\n            },\n          }),\n        } as Matcher<T, unknown>;\n      },\n      otherwise: (fallback: (value: T) => unknown) => ({\n        run: (): unknown => {\n          for (const h of newHandlers) {\n            if (value.type === h.variant) {\n              const fn = h.fn as (input: T) => unknown;\n              return fn(value);\n            }\n          }\n          return fallback(value);\n        },\n      }),\n    } as Matcher<T, unknown>;\n  };\n\n  const matcher: Matcher<T, unknown> = {\n    with: withHandler,\n    otherwise: (fallback: (value: T) => unknown) => ({\n      run: (): unknown => {\n        /* v8 ignore start -- unreachable with current immutable root handler list */\n        for (const h of handlers) {\n          if (value.type === h.variant) {\n            const fn = h.fn as (input: T) => unknown;\n            return fn(value);\n          }\n        }\n        /* v8 ignore stop */\n        return fallback(value);\n      },\n    }),\n  };\n\n  return matcher;\n};\n","import type { Handler, MatchBuilder, VariantOf } from './types/index.js';\n\n/**\n * Создает строгий matcher, выбрасывающий исключение для необработанных вариантов.\n *\n * @typeParam T - Тип дискриминированного объединения.\n * @param value - Значение объединения для сопоставления.\n * @returns Строгий builder сопоставления, требующий явных обработчиков.\n * @throws Error - Выбрасывает исключение, если ни один зарегистрированный обработчик не соответствует `value.type`.\n * @since 0.1.0\n * @see {@link matchVariant} - Использует fallback-ветку вместо выброса исключения.\n * @example\n * ```ts\n * import { matchVariantStrict } from '@resultsafe/core-fp-result';\n *\n * const out = matchVariantStrict<{ type: 'ok'; value: number } | { type: 'err'; error: string }>({\n *   type: 'err',\n *   error: 'boom',\n * })\n *   .with('ok', (v) => `ok:${v.value}`)\n *   .with('err', (v) => `err:${v.error}`)\n *   .run();\n *\n * console.log(out); // err:boom\n * ```\n * @public\n */\nexport const matchVariantStrict = <T extends VariantOf>(\n  value: T,\n): MatchBuilder<T, unknown> => {\n  const handlers: readonly Handler<T['type'], T, unknown>[] = [];\n\n  const builder = <Handled extends T['type'] = never>(): MatchBuilder<\n    T,\n    unknown,\n    Handled\n  > => ({\n    with: <K extends Exclude<T['type'], Handled>>(\n      variant: K,\n      fn: (value: Extract<T, { type: K }>) => unknown,\n    ) => {\n      const newHandlers = [...handlers, { variant, fn }] as const;\n\n      return {\n        with: builder<Handled | K>().with,\n        run: (() => {\n          for (const h of newHandlers) {\n            if (value.type === h.variant) {\n              const fn = h.fn as (input: T) => unknown;\n              return fn(value);\n            }\n          }\n          throw new Error(\n            `Unmatched variant: ${String((value as { type: unknown }).type)}`,\n          );\n        }) as Handled extends T['type'] ? () => unknown : never,\n      } as MatchBuilder<T, unknown, Handled | K>;\n    },\n\n    run: (() => {\n      /* v8 ignore start -- unreachable with current immutable root handler list */\n      for (const h of handlers) {\n        if (value.type === h.variant) {\n          const fn = h.fn as (input: T) => unknown;\n          return fn(value);\n        }\n      }\n      /* v8 ignore stop */\n      throw new Error(\n        `Unmatched variant: ${String((value as { type: unknown }).type)}`,\n      );\n    }) as Handled extends T['type'] ? () => unknown : never,\n  });\n\n  return builder();\n};\n","/** Checks that an object owns a property key. @internal */\nexport const hasOwn = <K extends PropertyKey>(\n  obj: Record<string, unknown>,\n  key: K,\n): obj is Record<K, unknown> => Object.prototype.hasOwnProperty.call(obj, key);\n\n/** Checks that a value is a non-null object record. @internal */\nexport const isObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null;\n","import type {\n  AsyncValidatorFn,\n  PayloadKeys,\n  VariantConfig,\n} from '../shared-types.js';\n\nimport { hasOwn, isObject } from '../internal/object.js';\nimport type { UniversalAsyncRefinedResult } from './types/index.js';\n\n/** Resolves payload keys from variant configuration. @internal */\nconst getPayloadKeys = <C extends VariantConfig>(\n  config: C,\n): readonly PayloadKeys<C>[] => {\n  const p = config.payload;\n  if (p === 'never') return [];\n  return (Array.isArray(p) ? p : [p]) as readonly PayloadKeys<C>[];\n};\n\n/**\n * Создает асинхронный refiner варианта с асинхронными валидаторами payload.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @param variantMap - Карта, описывающая допустимые варианты и поля payload.\n * @returns A curried async refiner factory bound to `variantMap`.\n * @since 0.1.0\n * @see {@link refineAsyncResultU} - Непосредственный (не-curry) вариант helper.\n * @example\n * ```ts\n * import { refineAsyncResult } from '@resultsafe/core-fp-result';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const refineOk = refineAsyncResult(map)('ok')({\n *   value: async (x: unknown) => typeof x === 'number',\n * });\n *\n * console.log(await refineOk({ type: 'ok', value: 1 })); // { type: 'ok', value: 1 }\n * ```\n * @public\n */\nexport const refineAsyncResult =\n  <TMap extends Record<string, VariantConfig>>(variantMap: TMap) =>\n  <K extends keyof TMap & string>(variant: K) =>\n  <TValidators extends Partial<Record<PayloadKeys<TMap[K]>, AsyncValidatorFn>>>(\n    validators: TValidators,\n  ) =>\n  async (\n    value: unknown,\n  ): Promise<UniversalAsyncRefinedResult<K, TMap, TValidators> | null> => {\n    if (!isObject(value)) return null;\n    if (!hasOwn(value, 'type')) return null;\n\n    const t = value['type'];\n    if (t !== variant) return null;\n\n    const config = variantMap[variant];\n    if (!config) return null;\n\n    const keys = getPayloadKeys(config);\n    for (const key of keys) {\n      const check = validators?.[key];\n      if (!check) continue;\n\n      const field = value[key as keyof typeof value];\n      const isValid = await check(field); // ✅ Асинхронная валидация\n      if (!isValid) return null;\n    }\n\n    return value as UniversalAsyncRefinedResult<K, TMap, TValidators>;\n  };\n\n/**\n * Уточняет значение асинхронно в не-curry стиле вызова.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam K - Ключ целевого варианта.\n * @typeParam TValidators - Карта асинхронных валидаторов для полей payload.\n * @param value - Значение для валидации и уточнения.\n * @param variant - Ключ целевого варианта.\n * @param variantMap - Карта конфигурации вариантов.\n * @param validators - Асинхронные валидаторы payload.\n * @returns Промис с уточненным значением или `null`.\n * @remarks\n * This export is kept for compatibility. Prefer {@link refineAsyncResultU}\n * from `refineAsyncResultU.ts` как каноническую точку входа без curry.\n * @since 0.1.0\n * @example\n * ```ts\n * import { refineAsyncResultU } from '@resultsafe/core-fp-result/src/refiners/refineAsyncResult.js';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const out = await refineAsyncResultU({ type: 'ok', value: 1 }, 'ok', map, {\n *   value: async (x: unknown) => typeof x === 'number',\n * });\n *\n * console.log(out?.type); // ok\n * ```\n * @internal\n */\nexport const refineAsyncResultU = <\n  TMap extends Record<string, VariantConfig>,\n  K extends keyof TMap & string,\n  TValidators extends Partial<Record<PayloadKeys<TMap[K]>, AsyncValidatorFn>>,\n>(\n  value: unknown,\n  variant: K,\n  variantMap: TMap,\n  validators: TValidators,\n): Promise<UniversalAsyncRefinedResult<K, TMap, TValidators> | null> =>\n  refineAsyncResult(variantMap)(variant)(validators)(value);\n\r\n\r\n","import type {\n  AsyncValidatorFn,\n  PayloadKeys,\n  VariantConfig,\n} from '../shared-types.js';\n\nimport { hasOwn, isObject } from '../internal/object.js';\nimport type { UniversalAsyncRefinedResult } from './types/index.js';\n\n/** Resolves payload keys from variant configuration. @internal */\nconst getPayloadKeys = <C extends VariantConfig>(\n  config: C,\n): readonly PayloadKeys<C>[] => {\n  const p = config.payload;\n  if (p === 'never') return [];\n  return (Array.isArray(p) ? p : [p]) as readonly PayloadKeys<C>[];\n};\n\n/**\n * Уточняет значение асинхронно в не-curry стиле вызова.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam K - Ключ целевого варианта.\n * @typeParam TValidators - Карта асинхронных валидаторов для полей payload.\n * @param value - Значение для валидации и уточнения.\n * @param variant - Ключ целевого варианта.\n * @param variantMap - Карта конфигурации вариантов.\n * @param validators - Асинхронные валидаторы payload.\n * @returns Промис с уточненным значением или `null`.\n * @since 0.1.0\n * @see {@link refineAsyncResult} - Curry-конструктор асинхронного refiner.\n * @example\n * ```ts\n * import { refineAsyncResultU } from '@resultsafe/core-fp-result';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const out = await refineAsyncResultU({ type: 'ok', value: 1 }, 'ok', map, {\n *   value: async (x: unknown) => typeof x === 'number',\n * });\n *\n * console.log(out?.type); // ok\n * ```\n * @public\n */\nexport const refineAsyncResultU = <\n  TMap extends Record<string, VariantConfig>,\n  K extends keyof TMap & string,\n  TValidators extends Partial<Record<PayloadKeys<TMap[K]>, AsyncValidatorFn>>,\n>(\n  value: unknown,\n  variant: K,\n  variantMap: TMap,\n  validators: TValidators,\n): Promise<UniversalAsyncRefinedResult<K, TMap, TValidators> | null> => {\n  // Императивный стиль с early returns (как в Rust)\n  return (async () => {\n    // Rust-style early returns с Option-like поведением\n    if (!isObject(value)) return null;\n    if (!hasOwn(value, 'type')) return null;\n\n    const t = value['type'];\n    if (t !== variant) return null;\n\n    const config = variantMap[variant];\n    if (!config) return null;\n\n    // Payload validation с асинхронными валидаторами\n    const keys = getPayloadKeys(config);\n    for (const key of keys) {\n      const check = validators[key as keyof TValidators];\n      if (!check) continue;\n\n      const field = value[key as string];\n      // Type-safe async validation\n      const isValid = await (check as AsyncValidatorFn)(field);\n      if (!isValid) return null;\n    }\n\n    // Safe cast после всех проверок\n    return value as UniversalAsyncRefinedResult<K, TMap, TValidators>;\n  })();\n};\n\r\n\r\n","import type {\n  PayloadKeys,\n  VariantConfig,\n} from '../../shared-types.js';\n\n/**\n * Нормализует конфигурацию payload варианта в список ключей.\n *\n * @typeParam C - Тип конфигурации варианта.\n * @param config - Конфигурация варианта с определением payload.\n * @returns Ключи payload как readonly-массив.\n * @since 0.1.0\n * @example\n * ```ts\n * import { getPayloadKeys } from '@resultsafe/core-fp-result/src/refiners/utils/getPayloadKeys.js';\n *\n * const keys = getPayloadKeys({ payload: ['id', 'meta'] } as const);\n * console.log(keys.length); // 2\n * ```\n * @internal\n */\nexport const getPayloadKeys = <C extends VariantConfig>(\n  config: C,\n): readonly PayloadKeys<C>[] => {\n  const p = config.payload;\n  if (p === 'never') return [];\n  return (Array.isArray(p) ? p : [p]) as readonly PayloadKeys<C>[];\n};\n\r\n\r\n","import type {\n  PayloadKeys,\n  ValidatorFn,\n  VariantConfig,\n} from '../shared-types.js';\n\nimport { hasOwn, isObject } from '../internal/object.js';\nimport type { UniversalRefinedResult } from './types/index.js';\nimport { getPayloadKeys } from './utils/index.js';\n\n/**\n * Создает синхронный refiner варианта с валидаторами payload.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @param variantMap - Карта, описывающая допустимые варианты и поля payload.\n * @returns A curried refiner factory bound to `variantMap`.\n * @since 0.1.0\n * @see {@link refineResultU} - Непосредственный (не-curry) вариант helper.\n * @example\n * ```ts\n * import { refineResult } from '@resultsafe/core-fp-result';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const refineOk = refineResult(map)('ok')({\n *   value: (x: unknown): x is number => typeof x === 'number',\n * });\n *\n * console.log(refineOk({ type: 'ok', value: 1 })); // { type: 'ok', value: 1 }\n * ```\n * @public\n */\nexport const refineResult =\n  <TMap extends Record<string, VariantConfig>>(variantMap: TMap) =>\n  <K extends keyof TMap & string>(variant: K) =>\n  <TValidators extends Partial<Record<PayloadKeys<TMap[K]>, ValidatorFn>>>(\n    validators: TValidators,\n  ) =>\n  (value: unknown): UniversalRefinedResult<K, TMap, TValidators> | null => {\n    if (!isObject(value)) return null;\n    if (!hasOwn(value, 'type')) return null;\n\n    const t = value['type'];\n    if (t !== variant) return null;\n\n    const config = variantMap[variant];\n    if (!config) return null;\n\n    const keys = getPayloadKeys(config);\n    for (const key of keys) {\n      const check = validators?.[key];\n      if (!check) continue;\n\n      const field = value[key as keyof typeof value];\n      if (!check(field)) return null;\n    }\n\n    return value as UniversalRefinedResult<K, TMap, TValidators>;\n  };\n\n/**\n * Уточняет значение по карте вариантов в не-curry стиле вызова.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam K - Ключ целевого варианта.\n * @typeParam TValidators - Карта валидаторов для полей payload.\n * @param value - Значение для валидации и уточнения.\n * @param variant - Ключ целевого варианта.\n * @param variantMap - Карта конфигурации вариантов.\n * @param validators - Валидаторы payload для целевого варианта.\n * @returns Уточненное значение или `null`.\n * @remarks\n * Этот экспорт сохранен для совместимости. Предпочитайте {@link refineResultU} из\n * `refineResultU.ts` как каноническую точку входа без curry.\n * @since 0.1.0\n * @example\n * ```ts\n * import { refineResultU } from '@resultsafe/core-fp-result/src/refiners/refineResult.js';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const out = refineResultU({ type: 'ok', value: 1 }, 'ok', map, {\n *   value: (x: unknown): x is number => typeof x === 'number',\n * });\n *\n * console.log(out?.type); // ok\n * ```\n * @internal\n */\nexport const refineResultU = <\n  TMap extends Record<string, VariantConfig>,\n  K extends keyof TMap & string,\n  TValidators extends Partial<Record<PayloadKeys<TMap[K]>, ValidatorFn>>,\n>(\n  value: unknown,\n  variant: K,\n  variantMap: TMap,\n  validators: TValidators,\n): UniversalRefinedResult<K, TMap, TValidators> | null =>\n  refineResult(variantMap)(variant)(validators)(value);\n\r\n\r\n","import type {\n  PayloadKeys,\n  ValidatorFn,\n  VariantConfig,\n} from '../shared-types.js';\n\nimport { refineResult } from './refineResult.js';\nimport type { SyncRefinedResult } from './types/index.js';\n\n/**\n * Уточняет значение по карте вариантов в не-curry стиле вызова.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam K - Ключ целевого варианта.\n * @typeParam TValidators - Карта валидаторов для полей payload.\n * @param value - Значение для валидации и уточнения.\n * @param variant - Ключ целевого варианта.\n * @param variantMap - Карта конфигурации вариантов.\n * @param validators - Валидаторы payload для целевого варианта.\n * @returns Уточненное значение или `null`.\n * @since 0.1.0\n * @see {@link refineResult} - Curry-конструктор refiner.\n * @example\n * ```ts\n * import { refineResultU } from '@resultsafe/core-fp-result';\n *\n * const map = { ok: { payload: 'value' } } as const;\n * const out = refineResultU({ type: 'ok', value: 1 }, 'ok', map, {\n *   value: (x: unknown): x is number => typeof x === 'number',\n * });\n *\n * console.log(out?.type); // ok\n * ```\n * @public\n */\nexport const refineResultU = <\n  TMap extends Record<string, VariantConfig>,\n  K extends keyof TMap & string,\n  TValidators extends Partial<Record<PayloadKeys<TMap[K]>, ValidatorFn>>,\n>(\n  value: unknown,\n  variant: K,\n  variantMap: TMap,\n  validators: TValidators,\n): SyncRefinedResult<K, TMap, TValidators> | null =>\n  refineResult(variantMap)(variant)(validators)(value);\n\r\n\r\n","import type {\n  PayloadKeys,\n  ValidatorFn,\n  VariantConfig,\n} from '../shared-types.js';\n\nimport type { SyncRefinedResultUnion } from './types/SyncRefinedResultUnion.js';\nimport type { SyncValidatorMap } from './types/SyncValidatorMap.js';\n\n/**\n * Уточняет значение дискриминированного объединения по полной карте вариантов.\n *\n * @typeParam TMap - Тип карты конфигурации вариантов.\n * @typeParam TValidators - Тип карты валидаторов по вариантам.\n * @param value - Значение для валидации и уточнения.\n * @param variantMap - Полная карта конфигурации вариантов.\n * @param validators - Валидаторы, сгруппированные по ключу варианта.\n * @returns Уточненный элемент объединения или `null`.\n * @since 0.1.0\n * @see {@link refineResult} - Refines one concrete variant key.\n * @example\n * ```ts\n * import { refineVariantMap } from '@resultsafe/core-fp-result';\n *\n * const map = {\n *   created: { payload: 'id' },\n *   failed: { payload: 'reason' },\n * } as const;\n *\n * const out = refineVariantMap({ type: 'created', id: '1' }, map, {\n *   created: { id: (x: unknown): x is string => typeof x === 'string' },\n *   failed: { reason: (x: unknown): x is string => typeof x === 'string' },\n * });\n *\n * console.log(out?.type); // created\n * ```\n * @public\n */\nexport function refineVariantMap<\n  TMap extends Record<string, VariantConfig>,\n  TValidators extends SyncValidatorMap<TMap>,\n>(\n  value: unknown,\n  variantMap: TMap,\n  validators: TValidators,\n): SyncRefinedResultUnion<TMap, TValidators> | null {\n  if (typeof value !== 'object' || value === null || !('type' in value)) {\n    return null;\n  }\n\n  const rawType = (value as { type?: unknown }).type;\n  if (typeof rawType !== 'string' || !(rawType in variantMap)) return null;\n\n  // фиксируем конкретный ключ варианта\n  type K = Extract<keyof TMap, string>;\n  const k = rawType as K;\n\n  const config = variantMap[k];\n  if (!config) return null;\n\n  // ключи payload для конкретного K\n  const payload = config.payload;\n  const keys = (\n    payload === 'never' ? [] : Array.isArray(payload) ? payload : [payload]\n  ) as readonly PayloadKeys<TMap[typeof k]>[];\n\n  // валидаторы, согласованные с конкретным K\n  const vvs = validators[k] as\n    | Partial<Record<PayloadKeys<TMap[typeof k]>, ValidatorFn>>\n    | undefined;\n\n  if (vvs) {\n    const obj = value as Record<string, unknown>;\n    for (const key of keys) {\n      const check = vvs[key];\n      if (!check) continue;\n      if (!check(obj[key as string])) return null;\n    }\n  }\n\n  return value as SyncRefinedResultUnion<TMap, TValidators>;\n}\n\r\n\r\n"],"names":["fn","getPayloadKeys"],"mappings":"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"}

package/docs/_category_.json

@@ -0,0 +1,6 @@
+{
+  "label": "@resultsafe/core-fp-result",
+  "position": 1
+}
+
+

package/docs/api/README.md

@@ -0,0 +1,9 @@
+# API
+
+> [Back to package README](../../README.md)
+
+Содержание по модулям:
+- [Конструкторы](./constructors/index.md)
+- [Гарды](./guards/index.md)
+- [Методы](./methods/index.md)
+- [Рефайнеры](./refiners/index.md)

package/docs/api/constructors/Err.md

@@ -0,0 +1,58 @@
+> [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
+
+[**@resultsafe/core-fp-result v0.1.0**](../README.md)
+
+***
+
+[@resultsafe/core-fp-result](../README.md) / Err
+
+# Функция: Err()
+
+> **Err**\<`E`, `T`\>(`error`): `Result`\<`T`, `E`\>
+
+Создает ошибочное значение `Result` из переданного payload ошибки.
+
+## Параметры типа
+
+### E
+
+`E`
+
+Тип значения ошибки.
+
+### T
+
+`T` = `never`
+
+The success type for the resulting `Result`.
+
+## Параметры
+
+### error
+
+`E`
+
+Payload ошибки для обёртки.
+
+## Возвращает
+
+`Result`\<`T`, `E`\>
+
+A `Result` with `ok: false` and the provided `error`.
+
+## Начиная с версии
+
+0.1.0
+
+## См. также
+
+[Ok](./Ok.md) - Creates a successful `Result`.
+
+## Пример
+
+```ts
+import { Err } from '@resultsafe/core-fp-result';
+
+const result = Err<string, number>('boom');
+console.log(result.ok); // false
+```

package/docs/api/constructors/Ok.md

@@ -0,0 +1,58 @@
+> [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
+
+[**@resultsafe/core-fp-result v0.1.0**](../README.md)
+
+***
+
+[@resultsafe/core-fp-result](../README.md) / Ok
+
+# Функция: Ok()
+
+> **Ok**\<`T`, `E`\>(`value`): `Result`\<`T`, `E`\>
+
+Создает успешное значение `Result` из переданного payload.
+
+## Параметры типа
+
+### T
+
+`T`
+
+Тип успешного значения.
+
+### E
+
+`E` = `never`
+
+The error type for the resulting `Result`.
+
+## Параметры
+
+### value
+
+`T`
+
+Payload успеха для обёртки.
+
+## Возвращает
+
+`Result`\<`T`, `E`\>
+
+A `Result` with `ok: true` and the provided `value`.
+
+## Начиная с версии
+
+0.1.0
+
+## См. также
+
+[Err](./Err.md) - Creates an error `Result`.
+
+## Пример
+
+```ts
+import { Ok } from '@resultsafe/core-fp-result';
+
+const result = Ok<number, string>(42);
+console.log(result.ok); // true
+```

package/docs/api/constructors/index.md

@@ -0,0 +1,7 @@
+# Конструкторы
+
+> [Back to package README](../../../README.md) | [Back to API index](../index.md)
+
+Символы модуля:
+- [Err](./Err.md)
+- [Ok](./Ok.md)

package/docs/api/guards/index.md

@@ -0,0 +1,9 @@
+# Гарды
+
+> [Back to package README](../../../README.md) | [Back to API index](../index.md)
+
+Символы модуля:
+- [isErr](./isErr.md)
+- [isErrAnd](./isErrAnd.md)
+- [isOk](./isOk.md)
+- [isOkAnd](./isOkAnd.md)

package/docs/api/guards/isErr.md

@@ -0,0 +1,58 @@
+> [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
+
+[**@resultsafe/core-fp-result v0.1.0**](../README.md)
+
+***
+
+[@resultsafe/core-fp-result](../README.md) / isErr
+
+# Функция: isErr()
+
+> **isErr**\<`T`, `E`\>(`result`): `result is { ok: false; error: E }`
+
+Проверяет, находится ли `Result` в ветке ошибки.
+
+## Параметры типа
+
+### T
+
+`T`
+
+Тип успешного значения.
+
+### E
+
+`E`
+
+Тип значения ошибки.
+
+## Параметры
+
+### result
+
+`Result`\<`T`, `E`\>
+
+`Result` для проверки.
+
+## Возвращает
+
+`result is { ok: false; error: E }`
+
+`true` when `result.ok` equals `false`.
+
+## Начиная с версии
+
+0.1.0
+
+## См. также
+
+[isOk](./isOk.md) - Checks the success branch.
+
+## Пример
+
+```ts
+import { Err, isErr } from '@resultsafe/core-fp-result';
+
+const result = Err('boom');
+console.log(isErr(result)); // true
+```

package/docs/api/guards/isErrAnd.md

@@ -0,0 +1,64 @@
+> [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
+
+[**@resultsafe/core-fp-result v0.1.0**](../README.md)
+
+***
+
+[@resultsafe/core-fp-result](../README.md) / isErrAnd
+
+# Функция: isErrAnd()
+
+> **isErrAnd**\<`T`, `E`\>(`result`, `predicate`): `boolean`
+
+Проверяет, что `Result` завершился ошибкой и удовлетворяет предикату.
+
+## Параметры типа
+
+### T
+
+`T`
+
+Тип успешного значения.
+
+### E
+
+`E`
+
+Тип значения ошибки.
+
+## Параметры
+
+### result
+
+`Result`\<`T`, `E`\>
+
+`Result` для проверки.
+
+### predicate
+
+(`error`) => `boolean`
+
+Предикат, применяемый к значению ошибки.
+
+## Возвращает
+
+`boolean`
+
+`true` when the value is `Err` and the predicate returns `true`.
+
+## Начиная с версии
+
+0.1.0
+
+## См. также
+
+[isErr](./isErr.md) - Performs the base error check.
+
+## Пример
+
+```ts
+import { Err, isErrAnd } from '@resultsafe/core-fp-result';
+
+const result = Err({ code: 503 });
+console.log(isErrAnd(result, (error) => error.code >= 500)); // true
+```

package/docs/api/guards/isOk.md

@@ -0,0 +1,58 @@
+> [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
+
+[**@resultsafe/core-fp-result v0.1.0**](../README.md)
+
+***
+
+[@resultsafe/core-fp-result](../README.md) / isOk
+
+# Функция: isOk()
+
+> **isOk**\<`T`, `E`\>(`result`): `result is { ok: true; value: T }`
+
+Проверяет, находится ли `Result` в ветке успеха.
+
+## Параметры типа
+
+### T
+
+`T`
+
+Тип успешного значения.
+
+### E
+
+`E`
+
+Тип значения ошибки.
+
+## Параметры
+
+### result
+
+`Result`\<`T`, `E`\>
+
+`Result` для проверки.
+
+## Возвращает
+
+`result is { ok: true; value: T }`
+
+`true` when `result.ok` equals `true`.
+
+## Начиная с версии
+
+0.1.0
+
+## См. также
+
+[isErr](./isErr.md) - Checks the error branch.
+
+## Пример
+
+```ts
+import { Ok, isOk } from '@resultsafe/core-fp-result';
+
+const result = Ok(10);
+console.log(isOk(result)); // true
+```

package/docs/api/guards/isOkAnd.md

@@ -0,0 +1,64 @@
+> [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
+
+[**@resultsafe/core-fp-result v0.1.0**](../README.md)
+
+***
+
+[@resultsafe/core-fp-result](../README.md) / isOkAnd
+
+# Функция: isOkAnd()
+
+> **isOkAnd**\<`T`, `E`\>(`result`, `predicate`): `boolean`
+
+Проверяет, что `Result` успешен и удовлетворяет предикату.
+
+## Параметры типа
+
+### T
+
+`T`
+
+Тип успешного значения.
+
+### E
+
+`E`
+
+Тип значения ошибки.
+
+## Параметры
+
+### result
+
+`Result`\<`T`, `E`\>
+
+`Result` для проверки.
+
+### predicate
+
+(`value`) => `boolean`
+
+Предикат, применяемый к успешному значению.
+
+## Возвращает
+
+`boolean`
+
+`true` when the value is `Ok` and the predicate returns `true`.
+
+## Начиная с версии
+
+0.1.0
+
+## См. также
+
+[isOk](./isOk.md) - Performs the base success check.
+
+## Пример
+
+```ts
+import { Ok, isOkAnd } from '@resultsafe/core-fp-result';
+
+const result = Ok(8);
+console.log(isOkAnd(result, (value) => value % 2 === 0)); // true
+```

package/docs/api/index.md

@@ -0,0 +1,9 @@
+# API
+
+> [Back to package README](../../README.md)
+
+Содержание по модулям:
+- [Конструкторы](./constructors/index.md)
+- [Гарды](./guards/index.md)
+- [Методы](./methods/index.md)
+- [Рефайнеры](./refiners/index.md)

package/docs/api/methods/andThen.md

@@ -0,0 +1,73 @@
+> [Back to package README](../../../README.md) | [Back to API index](../index.md) | [Back to module](./index.md)
+
+[**@resultsafe/core-fp-result v0.1.0**](../README.md)
+
+***
+
+[@resultsafe/core-fp-result](../README.md) / andThen
+
+# Функция: andThen()
+
+> **andThen**\<`T`, `U`, `E`\>(`result`, `fn`): `Result`\<`U`, `E`\>
+
+Цепляет вычисление, которое возвращает другой `Result`.
+
+## Параметры типа
+
+### T
+
+`T`
+
+The input success type.
+
+### U
+
+`U`
+
+The output success type.
+
+### E
+
+`E`
+
+Общий тип ошибки.
+
+## Параметры
+
+### result
+
+`Result`\<`T`, `E`\>
+
+Исходный `Result`.
+
+### fn
+
+(`value`) => `Result`\<`U`, `E`\>
+
+Функция, применяемая, когда `result` имеет `Ok`.
+
+## Возвращает
+
+`Result`\<`U`, `E`\>
+
+Преобразованный `Result` или исходный `Err`.
+
+## Начиная с версии
+
+0.1.0
+
+## См. также
+
+[map](./map.md) - Преобразует только успешное значение.
+
+## Пример
+
+```ts
+import { Ok, Err, andThen } from '@resultsafe/core-fp-result';
+
+const parsed = andThen(Ok('12'), (value) => {
+  const n = Number(value);
+  return Number.isNaN(n) ? Err('invalid') : Ok(n);
+});
+console.log(parsed.ok); // true
+```