@resultsafe/core-fp-result 0.1.6 → 0.1.7

package/README.md

@@ -7,7 +7,7 @@
 [![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)
+[![docs](https://img.shields.io/badge/docs-api-informational.svg)](https://unpkg.com/@resultsafe/core-fp-result@latest/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)
 
@@ -15,7 +15,7 @@ A Rust-inspired Result package for explicit, composable, and type-friendly APIs
 
 **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)
+**Documentation:** [API index](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/README.md) · [Modules](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/modules.md)
 
 ---
 ## Contents
@@ -249,14 +249,14 @@ Use this project when you want:
 
 ## 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)
+- [API entry (README)](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/README.md)
+- [API entry (index)](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/index.md)
+- [Modules](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/modules.md)
+- [Constructors module](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/constructors/index.md)
+- [Guards module](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/guards/index.md)
+- [Methods module](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/methods/index.md)
+- [Refiners module](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/refiners/index.md)
+- [Type aliases module](https://unpkg.com/@resultsafe/core-fp-result@latest/docs/api/type-aliases/index.md)
 
 ---
 Back to top: [@resultsafe/core-fp-result](#top)

package/package.json

@@ -1,68 +1,34 @@
 {
   "name": "@resultsafe/core-fp-result",
-  "version": "0.1.6",
-  "author": "Denis Savasteev",
-  "license": "MIT",
+  "version": "0.1.7",
   "type": "module",
   "sideEffects": false,
-  "publishConfig": {
-    "access": "public",
-    "provenance": true,
-    "tag": "latest"
-  },
-  "engines": {
-    "node": ">=20.10.0",
-    "pnpm": ">=10.0.0"
-  },
-  "scripts": {
-    "clean:dist": "rimraf dist .tsbuildinfo",
-    "build:types": "tsc -b ./config/tsconfig.build.types.json --force",
-    "build:esm": "vite build --config ./config/vite.config.build.esm.ts",
-    "build:cjs": "vite build --config ./config/vite.config.build.cjs.ts && node ./__scripts__/build/write-cjs-package-json.mjs",
-    "build:umd": "vite build --config ./config/vite.config.build.umd.ts",
-    "prepare:dist:publish": "node ./__scripts__/build/prepare-dist-publish.mjs",
-    "check:release:artifacts": "node ./__scripts__/build/validate-release-artifacts.mjs",
-    "check:release:pack": "npm pack --dry-run ./dist",
-    "build:all": "pnpm run clean:dist && pnpm run build:esm && pnpm run build:cjs && pnpm run build:umd && pnpm run build:types",
-    "build:release": "pnpm run build:all && pnpm run prepare:dist:publish",
-    "verify:release": "pnpm run build:release && pnpm run check:release:artifacts && pnpm run test && pnpm run check:release:pack",
-    "docs:api:clean": "rimraf docs/api",
-    "docs:api:generate": "typedoc --options typedoc.json --out docs/api",
-    "docs:api:mirror": "node ./__scripts__/docs/mirror-typedoc-api.mjs",
-    "docs:api": "pnpm run docs:api:generate && pnpm run docs:api:mirror",
-    "docs:api:check": "typedoc --options typedoc.json --emit none",
-    "docs:api:all": "pnpm run docs:api:clean && pnpm run docs:api && pnpm run docs:api:check && pnpm run test",
-    "test": "vitest run --config ./config/vitest.config.ts",
-    "test:coverage": "vitest run --config ./config/vitest.config.ts --coverage",
-    "lint": "eslint . --ext .ts,.tsx --config config/eslint.config.mjs",
-    "lint:fix": "eslint . --ext .ts,.tsx --config config/eslint.config.mjs --fix",
-    "prepublishOnly": "pnpm run verify:release",
-    "npm:publish:dry": "pnpm run verify:release && npm publish ./dist --dry-run --access public",
-    "npm:publish:public": "npm publish ./dist --access public --provenance"
-  },
-  "main": "dist/cjs/index.js",
-  "module": "dist/esm/index.js",
-  "browser": "dist/umd/resultsafe-monorepo-core-fp-result.umd.js",
-  "types": "dist/types/index.d.ts",
+  "main": "./cjs/index.js",
+  "module": "./esm/index.js",
+  "browser": "./umd/resultsafe-monorepo-core-fp-result.umd.js",
+  "types": "./types/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js"
+      "types": "./types/index.d.ts",
+      "import": "./esm/index.js",
+      "require": "./cjs/index.js"
     },
     "./Ok": {
-      "types": "./dist/types/constructors/Ok.d.ts",
-      "import": "./dist/esm/constructors/Ok.js",
-      "require": "./dist/cjs/constructors/Ok.js"
+      "types": "./types/constructors/Ok.d.ts",
+      "import": "./esm/constructors/Ok.js",
+      "require": "./cjs/constructors/Ok.js"
     },
     "./Err": {
-      "types": "./dist/types/constructors/Err.d.ts",
-      "import": "./dist/esm/constructors/Err.js",
-      "require": "./dist/cjs/constructors/Err.js"
+      "types": "./types/constructors/Err.d.ts",
+      "import": "./esm/constructors/Err.js",
+      "require": "./cjs/constructors/Err.js"
     }
   },
   "files": [
-    "dist",
+    "cjs",
+    "esm",
+    "types",
+    "umd",
     "docs",
     "README.md",
     "README.ru.md",

package/dist/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 resultsafe contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

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)