# max-mapper/mississippi

A collection of useful stream utility modules for writing better code using streams

Repository: https://github.com/max-mapper/mississippi
Canonical: https://ross.abutalabs.com/products/mississippi
Language: JavaScript
License: BSD-2-Clause
License Family: permissive
Last push: 2020-06-06T14:18:37+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4051, "days_push": 2279, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1086, forks 37 (observed 2026-08-28T04:03:32.076638+00:00)

## What it is
mississippi is a Node.js library bundling useful stream utility modules (pipe, each, pipeline, duplex, through, from, to, concat, finished, parallel) to make working with streams easier. It emphasizes correct error handling, speed, and composability, while each utility is also available as an individual npm module.

## Use cases
- pipe streams together with proper error propagation and cleanup
- iterate over stream data chunk by chunk with a callback
- build a multi-stage transform stream pipeline
- concatenate all data from a stream into a single buffer
- run async tasks over stream data with limited parallelism
- create readable, writable, and duplex streams from simple functions

## When to choose
- you write Node.js stream code and want reliable error handling that plain .pipe() lacks
- you want a curated set of composable stream helpers instead of hand-rolling them
- you're on an older Node version without stream.pipeline built in

## When to avoid
- you're on modern Node.js and can use built-in stream.pipeline and stream.finished
- you prefer web streams or async iterators over classic Node streams
- you need actively developed features - the project is in maintenance mode

## Facets
- artifact type: library
- maturity: maintenance
- function: streaming, error-handling, concurrency, developer-tools
- domain: developer-tools, backend
- platform: -
- tags: node-streams, stream-utilities, pipeline, pump, through-streams, nodejs, javascript

## Member repositories
- max-mapper/mississippi (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:32.076638+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:49:32.260494+00:00, confidence not recorded.
  - readme: https://github.com/max-mapper/mississippi (fetched 2026-08-28T04:03:32.076638+00:00, sha 6358d814d9f3)
- Data as of 2026-08-30T08:39:29.467469+00:00.