zod-non-empty-array

Make zod compatible with fp-ts non-empty constructs.

Installation

1npm install zod-non-empty-array

Requirements

• Node.js v.16+

Quick start

1import { z as zod } from 'zod';
2import { identity } from 'fp-ts/lib/function';
3import * as NonEmptyArray from 'fp-ts/NonEmptyArray';
4import { transformNonEmptyArray } from 'zod-non-empty-array';
5
6// create zod schema
7const schema = zod.object({
8  id: zod.number().int().positive(),
9  title: zod.string(),
10  authors: zod
11    .array(zod.string())
12    // must have at least one author
13    .transform(transformNonEmptyArray),
14});
15
16type Article = zod.infer<typeof schema>;
17
18// parse some invalid value
19const article = schema.parse({
20  id: 1,
21  title: 'A case-study of the use of fp-ts in a real-world project',
22  authors: ['John Doe', 'Jane Doe'],
23});
24
25// article.authors is now compatible with fp-ts
26const principalAuthor = pipe(article.authors, NonEmptyArray.head);

Motivation

Zod already supports non-empty array validation. However, the generated type is incompatible with fp-ts.

Specifically, fp-ts defines NonEmptyArray as follows...

1interface NonEmptyArray<T> extends Array<T> {
2  0: T;
3}

While, zod defines NonEmptyArray as follows...

1type ZodNonEmptyArray<T> = [T, ...T[]];

This incompatibility makes it difficult to integrate zod with fp-ts.

The zod-non-empty-array library addresses the incompatibility issue by exposing zod transformers that return fp-ts constructs. Instead of zod.array(...).nonempty() use zod.array(...).transform(transformNonEmptyArray).

API

• transformNonEmptyArray
• transformReadonlyNonEmptyArray

Contribute

Source code contributions are most welcome. Please open a PR, ensure the linter is satisfied and all tests pass.

We are hiring

Causaly is building the world's largest biomedical knowledge platform, using technologies such as TypeScript, React and Node.js. Find out more about our openings at https://apply.workable.com/causaly/.

License

MIT