push-stream-std

Repositories

2

Projects Packages

@push-stream-std/push-jsonl-parse (0.0.3)

Published 2026-07-19 21:14:15 +00:00 by Dvorak

Installation

Set up this registry in your project .npmrc file:

@push-stream-std:registry=https://hub.kl1.tenere.ai/api/packages/push-stream-std/npm/

To install the package using npm, run the following command:

npm install @push-stream-std/push-jsonl-parse@0.0.3

or add it to the package.json file:

"@push-stream-std/push-jsonl-parse": "0.0.3"

For more information on the npm registry, see the documentation.

About this package

push-jsonl-parse

Streaming JSONL parsing.

Published as @push-stream-std/push-jsonl-parse.

Synopsis

import { parseJsonl } from '@push-stream-std/push-jsonl-parse';
import { values } from '@push-stream-std/push-values';
import { collect } from '@push-stream-std/push-collect';

values(['{"id":1}\n{"id":2}\n', '{"id":3}\n'])
  .pipe(parseJsonl())
  .pipe(collect((err, results) => {
    console.log(results); // [{id: 1}, {id: 2}, {id: 3}]
  }));

Install

npm config set @push-stream-std:registry https://hub.kl1.tenere.ai/api/packages/push-stream-std/npm/
npm config set -- //hub.kl1.tenere.ai/api/packages/push-stream-std/npm/:_authToken "$PACKAGE_TOKEN"
npm install @push-stream-std/push-jsonl-parse

Description

A zero-dependency push-stream through operator that parses newline-delimited JSON (JSONL/NDJSON) with minimal overhead. Accumulates incoming string or Buffer chunks in an array (avoiding ConsString flatten/recreate cycles), only joining when a newline is detected. When the stream ends, any trailing partial line is parsed as a final JSON value if non-empty.

API

parseJsonl(options)

Creates a through stream that parses newline-delimited JSON from incoming data chunks.

Parameters:

• options.maxBuffer (number, default 0) — If greater than 0, the stream will abort with an error when the accumulated buffer exceeds this byte count before a newline is found.

Returns: A push-stream through.

Tests

npm test

Tests cover single and multi-line JSONL parsing, chunked inputs across multiple writes, trailing partial lines at end, empty lines, Buffered inputs (toString('utf8')), malformed JSON error handling, and maxBuffer enforcement.

Requirements

Node.js 18 or later. ESM only.

License

MIT

Dependencies

Dependencies

ID	Version
@streamparser/json	^0.0.22

Development Dependencies

ID	Version
fast-check	^3.15.0
ndjson	^2.0.0
stream-json	^1.9.1

Keywords

push-stream jsonl ndjson parse

Details

npm

2026-07-19 21:14:15 +00:00

0

MIT

4.8 KiB

Assets (1)

push-jsonl-parse-0.0.3.tgz 4.8 KiB

Versions (7) View all

0.0.11 2026-07-20

0.0.10 2026-07-20

0.0.9 2026-07-20

0.0.8 2026-07-20

0.0.7 2026-07-19