effect Core Package

The effect package is the heart of the Effect framework, providing robust primitives for managing side effects, ensuring type safety, and supporting concurrency in your TypeScript applications.

Requirements

• TypeScript 5.4 or Newer: Ensure you are using a compatible TypeScript version.

• Strict Type-Checking: The strict flag must be enabled in your tsconfig.json. For example:

  {
    "compilerOptions": {
      "strict": true
      // ...other options
    }
  }

Installation

Install the core package using your preferred package manager. For example, with npm:

npm install effect

Documentation

• Website: For detailed information and usage examples, visit the Effect website.

• API Reference: For a complete API reference of the core package effect, see the Effect API documentation.

Overview of Effect Modules

The effect package provides a collection of modules designed for functional programming in TypeScript. Below is a brief overview of the core modules:

| Module | Description | | -------- | -------------------------------------------------------------------------------------------------------------------------- | | Effect | The core abstraction for managing side effects, concurrency, and error handling in a structured way. | | Context | A lightweight dependency injection mechanism that enables passing services through computations without direct references. | | Layer | A system for managing dependencies, allowing for modular and composable resource allocation. | | Fiber | Lightweight virtual threads with resource-safe cancellation capabilities, enabling many features in Effect. | | Stream | A powerful abstraction for handling asynchronous, event-driven data processing. | | Schedule | A module for defining retry and repeat policies with composable schedules. | | Scope | Manages the lifecycle of resources, ensuring proper acquisition and release. | | Schema | A powerful library for defining, validating, and transforming structured data with type-safe encoding and decoding. |

For a comparison between effect/Schema and zod, see Schema vs Zod.