@resultsafe/core-fp-result 0.1.6 → 0.1.8

package/dist/README.md

@@ -1,273 +0,0 @@
-# @resultsafe/core-fp-result
-<a id="top"></a>
-
-![ResultSafe Logo](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/assets/logo.svg)
-
-[![npm version](https://img.shields.io/npm/v/@resultsafe/core-fp-result.svg)](https://www.npmjs.com/package/@resultsafe/core-fp-result)
-[![npm downloads](https://img.shields.io/npm/dm/@resultsafe/core-fp-result.svg)](https://www.npmjs.com/package/@resultsafe/core-fp-result)
-[![license](https://img.shields.io/npm/l/@resultsafe/core-fp-result.svg)](./LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6.svg)](https://www.typescriptlang.org/)
-[![docs](https://img.shields.io/badge/docs-api-informational.svg)](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/README.md)
-[![build status](https://img.shields.io/badge/build-local%20verified-success.svg)](./package.json)
-[![monorepo](https://img.shields.io/badge/monorepo-resultsafe%2Fmonorepo-0A0A0A.svg)](https://github.com/resultsafe/monorepo)
-
-A Rust-inspired Result package for explicit, composable, and type-friendly APIs in TypeScript and JavaScript.
-
-**Language:** English | [Русский](https://unpkg.com/@resultsafe/core-fp-result@latest/README.ru.md)
-
-**Documentation:** [API index](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/README.md) · [Modules](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/modules.md)
-
----
-## Contents
-
-- [Why this package](#why-this-package)
-- [Monorepo context](#monorepo-context)
-- [Key features](#key-features)
-- [Package](#package)
-- [Installation](#installation)
-- [Quick start](#quick-start)
-- [Core API overview](#core-api-overview)
-- [Build and distribution formats](#build-and-distribution-formats)
-- [Monorepo and package structure](#monorepo-and-package-structure)
-- [When to use this project](#when-to-use-this-project)
-- [Documentation links](#documentation-links)
-- [License](#license)
-
----
-
-## Why this package
-
-`@resultsafe/core-fp-result` provides explicit success/error flows instead of hidden control paths and exception-first branching.
-
-Its core package, [`@resultsafe/core-fp-result`](https://www.npmjs.com/package/@resultsafe/core-fp-result), provides a Rust-inspired `Result` API for TypeScript and JavaScript with:
-
-- explicit `Ok` / `Err`
-- predictable functional composition
-- safe branching through guards and matching
-- disciplined extraction APIs
-- advanced refinement utilities for typed variants and strict matching
-
-The goal is not to imitate Rust mechanically, but to bring the same clarity of intent to Node.js libraries: explicit values, predictable branching, and APIs organized for long-term maintenance.
-
----
-
-## Monorepo context
-
-`@resultsafe/core-fp-result` is the TypeScript/JavaScript package inside the multilingual `resultsafe/monorepo`.
-
-The monorepo applies shared Rust-inspired design concepts across language-specific packages. TypeScript/JavaScript is the current production package track, while Python is planned as a separate package track with the same conceptual model.
-
----
-
-## Key features
-
-- Rust-inspired `Result` model for TypeScript and JavaScript.
-- Explicit constructors via `Ok` and `Err`.
-- Composable transformations with APIs such as `map`, `mapErr`, `andThen`, and `orElse`.
-- Safe branching through guards like `isOk`, `isErr`, `isOkAnd`, `isErrAnd`, and matching helpers.
-- Controlled extraction with `unwrap`, `unwrapOr`, `unwrapErr`, `expect`, and `expectErr`.
-- Advanced refinement layer for typed variants, strict matching, and result narrowing.
-- Coherent module structure instead of a flat utility dump.
-- Type output for TypeScript users for better DX and safer integrations.
-- Flexible distribution formats with Types, ESM, CJS, and UMD builds.
-
----
-
-## Package
-
-### `@resultsafe/core-fp-result`
-
-A focused Result library for explicit error handling and FP-style composition.
-
-It is designed for developers who want:
-
-- clear success/error modeling
-- predictable transformations
-- explicit branching and extraction
-- better readability in error-heavy flows
-- a structured Rust-inspired API surface in TypeScript/JavaScript
-
----
-
-## Installation
-
-### Package
-
-```bash
-pnpm add @resultsafe/core-fp-result
-
-# Alternative
-npm install @resultsafe/core-fp-result
-```
-
-### Monorepo
-
-```bash
-pnpm install
-```
-
----
-
-## Quick start
-
-A typical Result flow starts with explicit constructors and then composes through functions rather than implicit exception paths.
-
-```ts
-import {
-  Ok,
-  map,
-  unwrapOr,
-} from "@resultsafe/core-fp-result";
-
-const initial = Ok(21);
-const doubled = map(initial, (value) => value * 2);
-const finalValue = unwrapOr(doubled, 0);
-
-console.log(finalValue); // 42
-```
-
-### Basic `Ok` / `Err` example
-
-```ts
-import { Ok, Err, match } from "@resultsafe/core-fp-result";
-
-const parsePort = (input: string) => {
-  const port = Number(input);
-  return Number.isInteger(port) && port > 0
-    ? Ok(port)
-    : Err("Invalid port");
-};
-
-const result = parsePort("3000");
-const message = match(result, (value) => `Port: ${value}`, (error) => `Error: ${error}`);
-
-console.log(message);
-```
-
----
-
-## Core API overview
-
-### Constructors
-
-- `Ok`
-- `Err`
-
-### Guards
-
-- `isOk`
-- `isOkAnd`
-- `isErr`
-- `isErrAnd`
-
-### Methods
-
-- `andThen`
-- `err`
-- `expect`
-- `expectErr`
-- `flatten`
-- `inspect`
-- `inspectErr`
-- `map`
-- `mapErr`
-- `match`
-- `ok`
-- `orElse`
-- `tap`
-- `tapErr`
-- `transpose`
-- `unwrap`
-- `unwrapErr`
-- `unwrapOr`
-- `unwrapOrElse`
-
-### Refiners
-
-- `isTypedVariant`
-- `isTypedVariantOf`
-- `matchVariant`
-- `matchVariantStrict`
-- `refineAsyncResult`
-- `refineAsyncResultU`
-- `refineResult`
-- `refineResultU`
-- `refineVariantMap`
-
-### Type aliases
-
-- `Handler`
-- `MatchBuilder`
-- `Matcher`
-- `SyncRefinedResult`
-- `SyncRefinedResultUnion`
-- `SyncValidatorMap`
-- `UniversalAsyncRefinedResult`
-- `UniversalRefinedResult`
-- `VariantOf`
-
----
-
-## Build and distribution formats
-
-- Types: `build:types`
-- ESM: `build:esm`
-- CJS: `build:cjs`
-- UMD: `build:umd`
-
-This package ships typed declarations and multiple runtime module formats for broad compatibility.
-
----
-
-## Monorepo and package structure
-
-```txt
-src/
-  constructors/
-  guards/
-  methods/
-  refiners/
-    types/
-    utils/
-  internal/
-  index.ts
-```
-
----
-
-## When to use this project
-
-Use this project when you want:
-
-- explicit success/error modeling
-- predictable FP-style composition
-- visible control flow
-- stronger type-guided result handling in TypeScript
-- advanced refinement tools for typed variants and strict result matching
-
----
-
-## Documentation links
-
-- [API entry (README)](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/README.md)
-- [API entry (index)](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/index.md)
-- [Modules](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/modules.md)
-- [Constructors module](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/constructors/index.md)
-- [Guards module](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/guards/index.md)
-- [Methods module](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/methods/index.md)
-- [Refiners module](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/refiners/index.md)
-- [Type aliases module](https://github.com/resultsafe/monorepo/blob/main/packages/core/fp/result/docs/api/type-aliases/index.md)
-
----
-Back to top: [@resultsafe/core-fp-result](#top)
-
----
-## Author
-
-Denis Savasteev
-
----
-
-## License
-
-[MIT](./LICENSE)

package/dist/README.ru.md

@@ -1,278 +0,0 @@
-# @resultsafe/core-fp-result
-
-<a id="top"></a>
-
-[![npm version](https://img.shields.io/npm/v/@resultsafe/core-fp-result.svg)](https://www.npmjs.com/package/@resultsafe/core-fp-result)
-[![npm downloads](https://img.shields.io/npm/dm/@resultsafe/core-fp-result.svg)](https://www.npmjs.com/package/@resultsafe/core-fp-result)
-[![license](https://img.shields.io/npm/l/@resultsafe/core-fp-result.svg)](./LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6.svg)](https://www.typescriptlang.org/)
-[![docs](https://img.shields.io/badge/docs-api-informational.svg)](./docs/api/README.md)
-[![build status](https://img.shields.io/badge/build-local%20verified-success.svg)](./package.json)
-[![monorepo](https://img.shields.io/badge/monorepo-resultsafe%2Fmonorepo-0A0A0A.svg)](https://github.com/resultsafe/monorepo)
-
-Rust-inspired Result-пакет для явных, композиционных и типобезопасных API в TypeScript и JavaScript.
-
-**Язык:** [English](./README.md) | Русский
-
-**Документация:** [API index](./docs/api/README.md) · [Modules](./docs/api/modules.md)
-
----
-
-## Содержание
-
-- [@resultsafe/core-fp-result](#resultsafecore-fp-result)
-  - [Содержание](#содержание)
-  - [Зачем нужен этот пакет](#зачем-нужен-этот-пакет)
-  - [Контекст monorepo](#контекст-monorepo)
-  - [Ключевые возможности](#ключевые-возможности)
-  - [Пакет](#пакет)
-    - [`@resultsafe/core-fp-result`](#resultsafecore-fp-result-1)
-  - [Установка](#установка)
-    - [Пакет](#пакет-1)
-    - [Monorepo](#monorepo)
-  - [Быстрый старт](#быстрый-старт)
-    - [Базовый пример `Ok` / `Err`](#базовый-пример-ok--err)
-  - [Обзор основного API](#обзор-основного-api)
-    - [Constructors](#constructors)
-    - [Guards](#guards)
-    - [Methods](#methods)
-    - [Refiners](#refiners)
-    - [Type aliases](#type-aliases)
-  - [Форматы сборки и поставки](#форматы-сборки-и-поставки)
-  - [Структура monorepo и пакета](#структура-monorepo-и-пакета)
-  - [Когда использовать этот проект](#когда-использовать-этот-проект)
-  - [Ссылки на документацию](#ссылки-на-документацию)
-  - [License](#license)
-
----
-
-## Зачем нужен этот пакет
-
-`@resultsafe/core-fp-result` предоставляет явные success/error flow вместо скрытых путей управления и exception-first ветвления.
-
-Его основной пакет, [`@resultsafe/core-fp-result`](https://www.npmjs.com/package/@resultsafe/core-fp-result), предоставляет Rust-inspired `Result` API для TypeScript и JavaScript со следующими свойствами:
-
-- явные `Ok` / `Err`
-- предсказуемая функциональная композиция
-- безопасное ветвление через guards и matching
-- дисциплинированные API извлечения значений
-- продвинутые refinement utilities для typed variants и strict matching
-
-Цель проекта не в механическом копировании Rust, а в переносе той же ясности намерений в Node.js-библиотеки: явные значения, предсказуемое ветвление и API, организованные для долгосрочного сопровождения.
-
----
-
-## Контекст monorepo
-
-`@resultsafe/core-fp-result` — это пакет TypeScript/JavaScript внутри мультиязычного `resultsafe/monorepo`.
-
-Монорепозиторий переносит общие Rust-inspired концепции в отдельные language-specific пакеты. Текущий production-трек — TypeScript/JavaScript, а Python планируется как отдельный пакетный трек с той же концептуальной моделью.
-
----
-
-## Ключевые возможности
-
-- Rust-inspired модель `Result` для TypeScript и JavaScript.
-- Явные конструкторы через `Ok` и `Err`.
-- Композиционные трансформации через API, такие как `map`, `mapErr`, `andThen` и `orElse`.
-- Безопасное ветвление через guards `isOk`, `isErr`, `isOkAnd`, `isErrAnd` и matching helpers.
-- Контролируемое извлечение через `unwrap`, `unwrapOr`, `unwrapErr`, `expect` и `expectErr`.
-- Продвинутый слой refiners для typed variants, strict matching и сужения результатов.
-- Согласованная модульная структура вместо плоского набора утилит.
-- Type output для TypeScript-пользователей для лучшего DX и более безопасных интеграций.
-- Гибкие форматы поставки: Types, ESM, CJS и UMD.
-
----
-
-## Пакет
-
-### `@resultsafe/core-fp-result`
-
-Фокусированная Result-библиотека для явной обработки ошибок и FP-style композиции.
-
-Она рассчитана на разработчиков, которым нужны:
-
-- ясное моделирование успеха/ошибки
-- предсказуемые трансформации
-- явное ветвление и извлечение значений
-- лучшая читаемость в error-heavy flow
-- структурированная Rust-inspired API surface в TypeScript/JavaScript
-
----
-
-## Установка
-
-### Пакет
-
-```bash
-pnpm add @resultsafe/core-fp-result
-
-# Альтернатива
-npm install @resultsafe/core-fp-result
-```
-
-### Monorepo
-
-```bash
-pnpm install
-```
-
----
-
-## Быстрый старт
-
-Типичный Result flow начинается с явных конструкторов и затем компонуется через функции, а не через неявные пути исключений.
-
-```ts
-import { Ok, map, unwrapOr } from '@resultsafe/core-fp-result';
-
-const initial = Ok(21);
-const doubled = map(initial, (value) => value * 2);
-const finalValue = unwrapOr(doubled, 0);
-
-console.log(finalValue); // 42
-```
-
-### Базовый пример `Ok` / `Err`
-
-```ts
-import { Ok, Err, match } from '@resultsafe/core-fp-result';
-
-const parsePort = (input: string) => {
-  const port = Number(input);
-  return Number.isInteger(port) && port > 0 ? Ok(port) : Err('Invalid port');
-};
-
-const result = parsePort('3000');
-const message = match(
-  result,
-  (value) => `Port: ${value}`,
-  (error) => `Error: ${error}`,
-);
-
-console.log(message);
-```
-
----
-
-## Обзор основного API
-
-### Constructors
-
-- `Ok`
-- `Err`
-
-### Guards
-
-- `isOk`
-- `isOkAnd`
-- `isErr`
-- `isErrAnd`
-
-### Methods
-
-- `andThen`
-- `err`
-- `expect`
-- `expectErr`
-- `flatten`
-- `inspect`
-- `inspectErr`
-- `map`
-- `mapErr`
-- `match`
-- `ok`
-- `orElse`
-- `tap`
-- `tapErr`
-- `transpose`
-- `unwrap`
-- `unwrapErr`
-- `unwrapOr`
-- `unwrapOrElse`
-
-### Refiners
-
-- `isTypedVariant`
-- `isTypedVariantOf`
-- `matchVariant`
-- `matchVariantStrict`
-- `refineAsyncResult`
-- `refineAsyncResultU`
-- `refineResult`
-- `refineResultU`
-- `refineVariantMap`
-
-### Type aliases
-
-- `Handler`
-- `MatchBuilder`
-- `Matcher`
-- `SyncRefinedResult`
-- `SyncRefinedResultUnion`
-- `SyncValidatorMap`
-- `UniversalAsyncRefinedResult`
-- `UniversalRefinedResult`
-- `VariantOf`
-
----
-
-## Форматы сборки и поставки
-
-- Types: `build:types`
-- ESM: `build:esm`
-- CJS: `build:cjs`
-- UMD: `build:umd`
-
-Пакет публикует typed declarations и несколько runtime-форматов модулей для широкой совместимости.
-
----
-
-## Структура monorepo и пакета
-
-```txt
-src/
-  constructors/
-  guards/
-  methods/
-  refiners/
-    types/
-    utils/
-  internal/
-  index.ts
-```
-
----
-
-## Когда использовать этот проект
-
-Используйте проект, если вам нужны:
-
-- явное моделирование успеха/ошибки
-- предсказуемая FP-style композиция
-- видимый control flow
-- более сильная type-guided обработка результатов в TypeScript
-- продвинутые refinement tools для typed variants и строгого result matching
-
----
-
-## Ссылки на документацию
-
-- [API entry (README)](./docs/api/README.md)
-- [API entry (index)](./docs/api/index.md)
-- [Modules](./docs/api/modules.md)
-- [Constructors module](./docs/api/constructors/index.md)
-- [Guards module](./docs/api/guards/index.md)
-- [Methods module](./docs/api/methods/index.md)
-- [Refiners module](./docs/api/refiners/index.md)
-- [Type aliases module](./docs/api/type-aliases/index.md)
-
----
-
-Наверх: [@resultsafe/core-fp-result](#top)
-
----
-
-## License
-
-[MIT](./LICENSE)

package/dist/cjs/guards/isErrAnd.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"isErrAnd.js","sources":["../../../src/guards/isErrAnd.ts"],"sourcesContent":["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"],"names":["isErr"],"mappings":";;AAuBO,MAAM,WAAW,CACtB,QACA,cACYA,MAAAA,MAAM,MAAM,KAAK,UAAU,OAAO,KAAK;;"}

package/dist/cjs/guards/isOkAnd.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"isOkAnd.js","sources":["../../../src/guards/isOkAnd.ts"],"sourcesContent":["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"],"names":["isOk"],"mappings":";;AAuBO,MAAM,UAAU,CACrB,QACA,cACYA,KAAAA,KAAK,MAAM,KAAK,UAAU,OAAO,KAAK;;"}

package/dist/cjs/methods/andThen.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"andThen.js","sources":["../../../src/methods/andThen.ts"],"sourcesContent":["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"],"names":["isOk"],"mappings":";;AA2BO,MAAM,UAAU,CACrB,QACA,OACkBA,KAAAA,KAAK,MAAM,IAAI,GAAG,OAAO,KAAK,IAAK;;"}

package/dist/cjs/methods/err.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"err.js","sources":["../../../src/methods/err.ts"],"sourcesContent":["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"],"names":["isErr","Some","None"],"mappings":";;;AAwBO,MAAM,MAAM,CAAO,WACxBA,YAAM,MAAM,IAAIC,YAAK,OAAO,KAAK,IAAIC,OAAAA;;"}

package/dist/cjs/methods/expect.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"expect.js","sources":["../../../src/methods/expect.ts"],"sourcesContent":["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"],"names":["isOk"],"mappings":";;AAwBO,MAAM,SAAS,CAAO,QAAsB,QAAmB;AACpE,MAAIA,KAAAA,KAAK,MAAM,GAAG;AAChB,WAAO,OAAO;AAAA,EAChB;AACA,QAAM,IAAI,MAAM,GAAG;AACrB;;"}

package/dist/cjs/methods/expectErr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"expectErr.js","sources":["../../../src/methods/expectErr.ts"],"sourcesContent":["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"],"names":["isErr"],"mappings":";;AAwBO,MAAM,YAAY,CAAO,QAAsB,QAAmB;AACvE,MAAIA,MAAAA,MAAM,MAAM,GAAG;AACjB,WAAO,OAAO;AAAA,EAChB;AACA,QAAM,IAAI,MAAM,GAAG;AACrB;;"}

package/dist/cjs/methods/inspect.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inspect.js","sources":["../../../src/methods/inspect.ts"],"sourcesContent":["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"],"names":["isOk"],"mappings":";;AAuBO,MAAM,UAAU,CACrB,QACA,OACiB;AACjB,MAAIA,KAAAA,KAAK,MAAM,GAAG;AAChB,OAAG,OAAO,KAAK;AAAA,EACjB;AACA,SAAO;AACT;;"}

package/dist/cjs/methods/inspectErr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inspectErr.js","sources":["../../../src/methods/inspectErr.ts"],"sourcesContent":["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"],"names":["isErr"],"mappings":";;AAuBO,MAAM,aAAa,CACxB,QACA,OACiB;AACjB,MAAIA,MAAAA,MAAM,MAAM,GAAG;AACjB,OAAG,OAAO,KAAK;AAAA,EACjB;AACA,SAAO;AACT;;"}

package/dist/cjs/methods/map.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"map.js","sources":["../../../src/methods/map.ts"],"sourcesContent":["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"],"names":["isOk"],"mappings":";;AAwBO,MAAM,MAAM,CACjB,QACA,OAEAA,KAAAA,KAAK,MAAM,IACP,EAAE,IAAI,MAAM,OAAO,GAAG,OAAO,KAAK,MACjC;;"}

package/dist/cjs/methods/mapErr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mapErr.js","sources":["../../../src/methods/mapErr.ts"],"sourcesContent":["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"],"names":["isErr"],"mappings":";;AAwBO,MAAM,SAAS,CACpB,QACA,OAEAA,MAAAA,MAAM,MAAM,IACR,EAAE,IAAI,OAAO,OAAO,GAAG,OAAO,KAAK,MAClC;;"}

package/dist/cjs/methods/ok.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ok.js","sources":["../../../src/methods/ok.ts"],"sourcesContent":["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"],"names":["isOk","Some","None"],"mappings":";;;AAwBO,MAAM,KAAK,CAAO,WACvBA,UAAK,MAAM,IAAIC,YAAK,OAAO,KAAK,IAAIC,OAAAA;;"}

package/dist/cjs/methods/orElse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"orElse.js","sources":["../../../src/methods/orElse.ts"],"sourcesContent":["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"],"names":["isErr"],"mappings":";;AAwBO,MAAM,SAAS,CACpB,QACA,OAEAA,MAAAA,MAAM,MAAM,IAAI,GAAG,OAAO,KAAK,IAAK;;"}

package/dist/cjs/methods/tapErr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tapErr.js","sources":["../../../src/methods/tapErr.ts"],"sourcesContent":["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"],"names":["isErr"],"mappings":";;AAuBO,MAAM,SAAS,CACpB,QACA,OACiB;AACjB,MAAIA,MAAAA,MAAM,MAAM,GAAG;AACjB,OAAG,OAAO,KAAK;AAAA,EACjB;AACA,SAAO;AACT;;"}

package/dist/cjs/methods/transpose.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transpose.js","sources":["../../../src/methods/transpose.ts"],"sourcesContent":["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"],"names":["Some","None"],"mappings":";;AAuBO,MAAM,YAAY,CACvB,WACyB;AACzB,MAAI,OAAO,IAAI;AACb,WAAO,OAAO,MAAM,SAAS,OACzBA,OAAAA,KAAK,EAAE,IAAI,MAAM,OAAO,OAAO,MAAM,MAAA,CAAO,IAC5CC,OAAAA;AAAAA,EACN;AACA,SAAOD,OAAAA,KAAK,EAAE,IAAI,OAAO,OAAO,OAAO,OAAO;AAChD;;"}

package/dist/cjs/methods/unwrap.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"unwrap.js","sources":["../../../src/methods/unwrap.ts"],"sourcesContent":["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"],"names":["isOk"],"mappings":";;AAuBO,MAAM,SAAS,CAAO,WAA4B;AACvD,MAAIA,KAAAA,KAAK,MAAM,GAAG;AAChB,WAAO,OAAO;AAAA,EAChB;AACA,QAAM,IAAI,MAAM,+BAA+B;AACjD;;"}

package/dist/cjs/methods/unwrapErr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"unwrapErr.js","sources":["../../../src/methods/unwrapErr.ts"],"sourcesContent":["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"],"names":["isErr"],"mappings":";;AAuBO,MAAM,YAAY,CAAO,WAA4B;AAC1D,MAAIA,MAAAA,MAAM,MAAM,GAAG;AACjB,WAAO,OAAO;AAAA,EAChB;AACA,QAAM,IAAI,MAAM,iCAAiC;AACnD;;"}

package/dist/cjs/methods/unwrapOr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"unwrapOr.js","sources":["../../../src/methods/unwrapOr.ts"],"sourcesContent":["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"],"names":["isOk"],"mappings":";;AAuBO,MAAM,WAAW,CAAO,QAAsB,iBACnDA,KAAAA,KAAK,MAAM,IAAI,OAAO,QAAQ;;"}

package/dist/cjs/refiners/refineAsyncResult.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"refineAsyncResult.js","sources":["../../../src/refiners/refineAsyncResult.ts"],"sourcesContent":["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"],"names":["isObject","hasOwn"],"mappings":";;AAUA,MAAM,iBAAiB,CACrB,WAC8B;AAC9B,QAAM,IAAI,OAAO;AACjB,MAAI,MAAM,QAAS,QAAO,CAAA;AAC1B,SAAQ,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;AACnC;AAuBO,MAAM,oBACX,CAA6C,eAC7C,CAAgC,YAChC,CACE,eAEF,OACE,UACsE;AACtE,MAAI,CAACA,OAAAA,SAAS,KAAK,EAAG,QAAO;AAC7B,MAAI,CAACC,OAAAA,OAAO,OAAO,MAAM,EAAG,QAAO;AAEnC,QAAM,IAAI,MAAM,MAAM;AACtB,MAAI,MAAM,QAAS,QAAO;AAE1B,QAAM,SAAS,WAAW,OAAO;AACjC,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,OAAO,eAAe,MAAM;AAClC,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,aAAa,GAAG;AAC9B,QAAI,CAAC,MAAO;AAEZ,UAAM,QAAQ,MAAM,GAAyB;AAC7C,UAAM,UAAU,MAAM,MAAM,KAAK;AACjC,QAAI,CAAC,QAAS,QAAO;AAAA,EACvB;AAEA,SAAO;AACT;;"}