@sapphire/shapeshift
Advanced tools
@sapphire/shapeshift is a powerful validation library for JavaScript and TypeScript. It allows developers to define schemas for their data and validate it against these schemas. The library is designed to be highly flexible and easy to use, making it suitable for a wide range of applications.
Basic Validation
This feature allows you to define a schema and validate an object against it. In this example, the schema expects an object with a 'name' string and an 'age' number.
const { s } = require('@sapphire/shapeshift');
const schema = s.object({
name: s.string,
age: s.number
});
const data = { name: 'John', age: 30 };
const result = schema.parse(data);
console.log(result); // { name: 'John', age: 30 }Optional Fields
This feature allows you to define optional fields in your schema. In this example, the 'age' field is optional.
const { s } = require('@sapphire/shapeshift');
const schema = s.object({
name: s.string,
age: s.number.optional
});
const data = { name: 'John' };
const result = schema.parse(data);
console.log(result); // { name: 'John' }Array Validation
This feature allows you to validate arrays. In this example, the schema expects an array of strings.
const { s } = require('@sapphire/shapeshift');
const schema = s.array(s.string);
const data = ['apple', 'banana', 'cherry'];
const result = schema.parse(data);
console.log(result); // ['apple', 'banana', 'cherry']Nested Objects
This feature allows you to validate nested objects. In this example, the schema expects an object with a 'user' object that contains 'name' and 'age' fields.
const { s } = require('@sapphire/shapeshift');
const schema = s.object({
user: s.object({
name: s.string,
age: s.number
})
});
const data = { user: { name: 'John', age: 30 } };
const result = schema.parse(data);
console.log(result); // { user: { name: 'John', age: 30 } }Joi is a powerful schema description language and data validator for JavaScript. It allows you to create blueprints or schemas for JavaScript objects to ensure validation of key information. Compared to @sapphire/shapeshift, Joi is more established and widely used in the industry, offering a rich set of features and integrations.
Yup is a JavaScript schema builder for value parsing and validation. It is heavily inspired by Joi but is designed to work with modern JavaScript and TypeScript. Yup is known for its simplicity and ease of use, making it a popular choice for form validation in React applications. Compared to @sapphire/shapeshift, Yup offers a more modern API and better TypeScript support.
Zod is a TypeScript-first schema declaration and validation library. It aims to provide a simple and expressive way to define schemas and validate data. Zod is particularly well-suited for TypeScript projects, offering excellent type inference and integration. Compared to @sapphire/shapeshift, Zod provides a more TypeScript-centric approach and better type safety.
Shapeshift
Blazing fast input validation and transformation ⚡
.run(data: unknown): Result: given a validation, you can call this method to check whether or not the.parse(data: unknown): T: given a validations, you can call this method to check whether or not the input is valid..transform((value: T) => R): NopValidator: adds a constraint that modifies the input:.reshape((value: T) => Result | IConstraint): NopValidator: adds a constraint able to both validate.default(value: T | (() => T)): transform undefined into the given value or the callback's returned value:.optional: a convenience method that returns a union of the type with s.undefined()..nullable: a convenience method that returns a union of the type with s.nullable()..nullish: a convenience method that returns a union of the type with s.nullish()..array: a convenience method that returns an ArrayValidator with the type..or: a convenience method that returns an UnionValidator with the type. This method is also overridden in.when: Adjust the schema based on a sibling or sinbling children fields.
A very fast and lightweight input validation and transformation library for JavaScript.
Note: Shapeshift requires Node.js v14.0.0 or higher to work.
For complete usages, please dive into our documentation
Creating a simple string validation
import { s } from '@sapphire/shapeshift';
const myStringValidation = s.string();
// Parse
myStringValidation.parse('sapphire'); // => returns 'sapphire'
myStringValidation.parse(12); // throws ValidationError
Creating an object schema
import { s } from '@sapphire/shapeshift';
const user = s.object({
username: s.string()
});
user.parse({ username: 'Sapphire' });
import { s } from '@sapphire/shapeshift';
// Primitives
s.string();
s.number();
s.bigint();
s.boolean();
s.date();
// Empty Types
s.undefined();
s.null();
s.nullish(); // Accepts undefined | null
// Catch-all Types
s.any();
s.unknown();
// Never Type
s.never();
s.literal('sapphire');
s.literal(12);
s.literal(420n);
s.literal(true);
s.literal(new Date(1639278160000)); // s.date().equal(1639278160000);
Shapeshift includes a handful of string-specific validations:
s.string().lengthLessThan(5);
s.string().lengthLessThanOrEqual(5);
s.string().lengthGreaterThan(5);
s.string().lengthGreaterThanOrEqual(5);
s.string().lengthEqual(5);
s.string().lengthNotEqual(5);
s.string().email();
s.string().url();
s.string().uuid();
s.string().regex(regex);
s.string().ip();
s.string().ipv4();
s.string().ipv6();
s.string().phone();
Shapeshift includes a handful of number-specific validations:
s.number().greaterThan(5); // > 5
s.number().greaterThanOrEqual(5); // >= 5
s.number().lessThan(5); // < 5
s.number().lessThanOrEqual(5); // <= 5
s.number().equal(5); // === 5
s.number().notEqual(5); // !== 5
s.number().equal(NaN); // special case: Number.isNaN
s.number().notEqual(NaN); // special case: !Number.isNaN
s.number().int(); // value must be an integer
s.number().safeInt(); // value must be a safe integer
s.number().finite(); // value must be finite
s.number().positive(); // .greaterThanOrEqual(0)
s.number().negative(); // .lessThan(0)
s.number().divisibleBy(5); // Divisible by 5
And transformations:
s.number().abs(); // Transforms the number to an absolute number
s.number().sign(); // Gets the number's sign
s.number().trunc(); // Transforms the number to the result of `Math.trunc`
s.number().floor(); // Transforms the number to the result of `Math.floor`
s.number().fround(); // Transforms the number to the result of `Math.fround`
s.number().round(); // Transforms the number to the result of `Math.round`
s.number().ceil(); // Transforms the number to the result of `Math.ceil`
Shapeshift includes a handful of number-specific validations:
s.bigint().greaterThan(5n); // > 5n
s.bigint().greaterThanOrEqual(5n); // >= 5n
s.bigint().lessThan(5n); // < 5n
s.bigint().lessThanOrEqual(5n); // <= 5n
s.bigint().equal(5n); // === 5n
s.bigint().notEqual(5n); // !== 5n
s.bigint().positive(); // .greaterThanOrEqual(0n)
s.bigint().negative(); // .lessThan(0n)
s.bigint().divisibleBy(5n); // Divisible by 5n
And transformations:
s.bigint().abs(); // Transforms the bigint to an absolute bigint
s.bigint().intN(5); // Clamps to a bigint to a signed bigint with 5 digits, see BigInt.asIntN
s.bigint().uintN(5); // Clamps to a bigint to an unsigned bigint with 5 digits, see BigInt.asUintN
Shapeshift includes a few boolean-specific validations:
s.boolean().true(); // value must be true
s.boolean().false(); // value must be false
s.boolean().equal(true); // s.boolean().true()
s.boolean().equal(false); // s.boolean().false()
s.boolean().notEqual(true); // s.boolean().false()
s.boolean().notEqual(false); // s.boolean().true()
const stringArray = s.array(s.string());
const stringArray = s.string().array();
Shapeshift includes a handful of array-specific validations:
s.string().array().lengthLessThan(5); // Must have less than 5 elements
s.string().array().lengthLessThanOrEqual(5); // Must have 5 or less elements
s.string().array().lengthGreaterThan(5); // Must have more than 5 elements
s.string().array().lengthGreaterThanOrEqual(5); // Must have 5 or more elements
s.string().array().lengthEqual(5); // Must have exactly 5 elements
s.string().array().lengthNotEqual(5); // Must not have exactly 5 elements
s.string().array().lengthRange(0, 4); // Must have at least 0 elements and less than 4 elements (in math, that is [0, 4))
s.string().array().lengthRangeInclusive(0, 4); // Must have at least 0 elements and at most 4 elements (in math, that is [0, 4])
s.string().array().lengthRangeExclusive(0, 4); // Must have more than 0 element and less than 4 elements (in math, that is (0, 4))
s.string().array().unique(); // All elements must be unique. Deep equality is used to check for uniqueness.
Note: All
.lengthmethods define tuple types with the given amount of elements. For example,s.string().array().lengthGreaterThanOrEqual(2)'s inferred type is[string, string, ...string[]]
Unlike arrays, tuples have a fixed number of elements and each element can have a different type:
const dish = s.tuple([
s.string(), // Dish's name
s.number().int(), // Table's number
s.date() // Date the dish was ready for delivery
]);
dish.parse(['Iberian ham', 10, new Date()]);
Shapeshift includes a built-in method for composing OR types:
const stringOrNumber = s.union([s.string(), s.number()]);
stringOrNumber.parse('Sapphire'); // => 'Sapphire'
stringOrNumber.parse(42); // => 42
stringOrNumber.parse({}); // => throws CombinedError
Enums are a convenience method that aliases s.union([s.literal(a), s.literal(b), ...]):
s.enum(['Red', 'Green', 'Blue']);
// s.union([s.literal('Red'), s.literal('Green'), s.literal('Blue')]);
const map = s.map(s.string(), s.number());
// Map<string, number>
const set = s.set(s.number());
// Set<number>
You can use s.instance(Class) to check that the input is an instance of a class. This is useful to validate inputs
against classes:
class User {
public constructor(public name: string) {}
}
const userInstanceValidation = s.instance(User);
userInstanceValidation.parse(new User('Sapphire')); // => User { name: 'Sapphire' }
userInstanceValidation.parse('oops'); // => throws ValidatorError
Record validations are similar to objects, but validate Record<string, T> types. Keep in mind this does not check for
the keys, and cannot support validation for specific ones:
const tags = s.record(s.string());
tags.parse({ foo: 'bar', hello: 'world' }); // => { foo: 'bar', hello: 'world' }
tags.parse({ foo: 42 }); // => throws CombinedError
tags.parse('Hello'); // => throws ValidateError
const typedArray = s.typedArray();
const int16Array = s.int16Array();
const uint16Array = s.uint16Array();
const uint8ClampedArray = s.uint8ClampedArray();
const int16Array = s.int16Array();
const uint16Array = s.uint16Array();
const int32Array = s.int32Array();
const uint32Array = s.uint32Array();
const float32Array = s.float32Array();
const float64Array = s.float64Array();
const bigInt64Array = s.bigInt64Array();
const bigUint64Array = s.bigUint64Array();
Shapeshift includes a handful of validations specific to typed arrays.
s.typedArray().lengthLessThan(5); // Length must be less than 5
s.typedArray().lengthLessThanOrEqual(5); // Length must be 5 or less
s.typedArray().lengthGreaterThan(5); // Length must be more than 5
s.typedArray().lengthGreaterThanOrEqual(5); // Length must be 5 or more
s.typedArray().lengthEqual(5); // Length must be exactly 5
s.typedArray().lengthNotEqual(5); // Length must not be 5
s.typedArray().lengthRange(0, 4); // Length L must satisfy 0 <= L < 4
s.typedArray().lengthRangeInclusive(0, 4); // Length L must satisfy 0 <= L <= 4
s.typedArray().lengthRangeExclusive(0, 4); // Length L must satisfy 0 < L < 4
Note that all of these methods have analogous methods for working with the typed array's byte length,
s.typedArray().byteLengthX() - for instance, s.typedArray().byteLengthLessThan(5) is the same as
s.typedArray().lengthLessThan(5) but for the array's byte length.
// Properties are required by default:
const animal = s.object({
name: s.string(),
age: s.number()
});
For object validation Shapeshift exports 2 utility types that can be used to extract interfaces from schemas and define the structure of a schema as an interface beforehand respectively.
You can use the InferType type to extract the interface from a schema, for example:
import { InferType, s } from '@sapphire/shapeshift';
const schema = s.object({
foo: s.string(),
bar: s.number(),
baz: s.boolean(),
qux: s.bigint(),
quux: s.date()
});
type Inferredtype = InferType<typeof schema>;
// Expected type:
type Inferredtype = {
foo: string;
bar: number;
baz: boolean;
qux: bigint;
quux: Date;
};
You can use the SchemaOf type to define the structure of a schema before defining the actual schema, for example:
import { s, SchemaOf } from '@sapphire/shapeshift';
interface IIngredient {
ingredientId: string | undefined;
name: string | undefined;
}
interface IInstruction {
instructionId: string | undefined;
message: string | undefined;
}
interface IRecipe {
recipeId: string | undefined;
title: string;
description: string;
instructions: IInstruction[];
ingredients: IIngredient[];
}
type InstructionSchemaType = SchemaOf<IInstruction>;
// Expected Type: ObjectValidator<IInstruction>
type IngredientSchemaType = SchemaOf<IIngredient>;
// Expected Type: ObjectValidator<IIngredient>
type RecipeSchemaType = SchemaOf<IRecipe>;
// Expected Type: ObjectValidator<IRecipe>
const instructionSchema: InstructionSchemaType = s.object({
instructionId: s.string().optional(),
message: s.string()
});
const ingredientSchema: IngredientSchemaType = s.object({
ingredientId: s.string().optional(),
name: s.string()
});
const recipeSchema: RecipeSchemaType = s.object({
recipeId: s.string().optional(),
title: s.string(),
description: s.string(),
instructions: s.array(instructionSchema),
ingredients: s.array(ingredientSchema)
});
.extend:You can add additional fields using either an object or an ObjectValidator, in this case, you will get a new object validator with the merged properties:
const animal = s.object({
name: s.string().optional(),
age: s.number()
});
const pet = animal.extend({
owner: s.string().nullish()
});
const pet = animal.extend(
s.object({
owner: s.string().nullish()
})
);
If both schemas share keys, an error will be thrown. Please use
.omiton the first object if you desire this behaviour.
.pick / .omit:Inspired by TypeScript's built-in Pick and Omit utility types, all object schemas have the aforementioned methods
that return a modifier version:
const pkg = s.object({
name: s.string(),
description: s.string(),
dependencies: s.string().array()
});
const justTheName = pkg.pick(['name']);
// s.object({ name: s.string() });
const noDependencies = pkg.omit(['dependencies']);
// s.object({ name: s.string(), description: s.string() });
.partialInspired by TypeScript's built-in Partial utility type, all object schemas have the aforementioned method that makes
all properties optional:
const user = s.object({
username: s.string(),
password: s.string()
}).partial;
Which is the same as doing:
const user = s.object({
username: s.string().optional(),
password: s.string().optional()
});
.requiredInspired by TypeScript's built-in Required utility type, all object schemas have the aforementioned method that makes
all properties required:
const user = s.object({
username: s.string().optional(),
password: s.string().optional()
}).required;
Which is the same as doing:
const user = s.object({
username: s.string(),
password: s.string()
});
By default, Shapeshift will not include keys that are not defined by the schema during parsing:
const person = s.object({
framework: s.string()
});
person.parse({
framework: 'Sapphire',
awesome: true
});
// => { name: 'Sapphire' }
.strictYou can disallow unknown keys with .strict. If the input includes any unknown keys, an error will be thrown.
const person = s.object({
framework: s.string()
}).strict;
person.parse({
framework: 'Sapphire',
awesome: true
});
// => throws ValidationError
.ignoreYou can use the .ignore getter to reset an object schema to the default behaviour (ignoring unrecognized keys).
.passthroughYou can use the .passthrough getter to make the validator add the unrecognized properties the shape does not have,
from the input.
All validations in Shapeshift contain certain methods.
.run(data: unknown): Result<T, Error>: given a validation, you can call this method to check whether or not theinput is valid. If it is, a Result with success: true and a deep-cloned value will be returned with the given
constraints and transformations. Otherwise, a Result with success: false and an error is returned.
.parse(data: unknown): T: given a validations, you can call this method to check whether or not the input is valid.If it is, a deep-cloned value will be returned with the given constraints and transformations. Otherwise, an error is thrown.
.transform<R>((value: T) => R): NopValidator<R>: adds a constraint that modifies the input:import { s } from '@sapphire/shapeshift';
const getLength = s.string().transform((value) => value.length);
getLength.parse('Hello There'); // => 11
:warning:
.transform's functions must not throw. If a validation error is desired to be thrown,.reshapeinstead.
.reshape<R>((value: T) => Result<R, Error> | IConstraint): NopValidator<R>: adds a constraint able to both validateimport { s, Result } from '@sapphire/shapeshift';
const getLength = s.string().reshape((value) => Result.ok(value.length));
getLength.parse('Hello There'); // => 11
:warning:
.reshape's functions must not throw. If a validation error is desired to be thrown, useResult.err(error)instead.
.default(value: T | (() => T)): transform undefined into the given value or the callback's returned value:const name = s.string().default('Sapphire');
name.parse('Hello'); // => 'Hello'
name.parse(undefined); // => 'Sapphire'
const number = s.number().default(Math.random);
number.parse(12); // => 12
number.parse(undefined); // => 0.989911985608602
number.parse(undefined); // => 0.3224350185068794
:warning: The default values are not validated.
.optional: a convenience method that returns a union of the type with s.undefined().s.string().optional(); // s.union(s.string(), s.undefined())
.nullable: a convenience method that returns a union of the type with s.nullable().s.string().nullable(); // s.union(s.string(), s.nullable())
.nullish: a convenience method that returns a union of the type with s.nullish().s.string().nullish(); // s.union(s.string(), s.nullish())
.array: a convenience method that returns an ArrayValidator with the type.s.string().array(); // s.array(s.string())
.or: a convenience method that returns an UnionValidator with the type. This method is also overridden ins.string().or(s.number());
// => s.union(s.string(), s.number())
s.object({ name: s.string() }).or(s.string(), s.number());
// => s.union(s.object({ name: s.string() }), s.string(), s.number())
.when: Adjust the schema based on a sibling or sinbling children fields.For using when you provide an object literal where the key is is undefined, a value, or a matcher function; then
provides the schema when is resolves truthy, and otherwise provides the schema when is resolves falsey.
isWhen is is not provided (=== undefined) it is strictly resolved as Boolean(value) wherein value is the current
value of the referenced sibling. Note that if multiple siblings are referenced then all the values of the array need to
resolve truthy for the is to resolve truthy.
When is is a primitive literal it is strictly compared (===) to the current value.
If you want to use a different form of equality you can provide a function like: is: (value) => value === true.
key (first) parameterFor resolving the key parameter to its respective value we use lodash/get. This means
that every way that Lodash supports resolving a key to its respective value is also supported by Shapeshift. This
includes:
'name' or 1.'name.first' (representative of a nested object structure of
{ 'name': { 'first': 'Sapphire' } } => resolves to Sapphire).'name[0]' (representative of an array structure of
{ 'name': ['Sapphire', 'Framework'] } => resolves to Sapphire).'name[1].first' (representative of a nested object
structure of { 'name': [{ 'first': 'Sapphire' }, { 'first': 'Framework' }] } => resolves to Framework).Let's start with a basic example:
const whenPredicate = s.object({
booleanLike: s.boolean(),
numberLike: s.number().when('booleanLike', {
then: (schema) => schema.greaterThanOrEqual(5),
otherwise: (schema) => schema.lessThanOrEqual(5)
})
});
whenPredicate.parse({ booleanLike: true, numberLike: 6 });
// => { booleanLike: true, numberLike: 6 }
whenPredicate.parse({ booleanLike: true, numberLike: 4 });
// => ExpectedConstraintError('s.number().greaterThanOrEqual', 'Invalid number value', 4, 'expected >= 5')
whenPredicate.parse({ booleanLike: false, numberLike: 4 });
// => { booleanLike: false, numberLike: 4 }
The provided key can also be an array of sibling children:
const whenPredicate = s.object({
booleanLike: s.boolean(),
stringLike: s.string(),
numberLike: s.number().when(['booleanLike', 'stringLike'], {
is: ([booleanLikeValue, stringLikeValue]) => booleanLikeValue === true && stringLikeValue === 'foobar',
then: (schema) => schema.greaterThanOrEqual(5),
otherwise: (schema) => schema.lessThanOrEqual(5)
})
});
whenPredicate.parse({ booleanLike: true, stringLike: 'foobar', numberLike: 6 });
// => { booleanLike: true, numberLike: 6 }
whenPredicate.parse({ booleanLike: true, stringLike: 'barfoo', numberLike: 4 });
// => ExpectedConstraintError('s.number().greaterThanOrEqual', 'Invalid number value', 4, 'expected >= 5')
whenPredicate.parse({ booleanLike: false, stringLike: 'foobar' numberLike: 4 });
// => ExpectedConstraintError('s.number().greaterThanOrEqual', 'Invalid number value', 4, 'expected >= 5')
At times, you might want to have a consistent code base with validation, but would like to keep validation to the strict
necessities instead of the in-depth constraints available in shapeshift. By calling setGlobalValidationEnabled you can
disable validation at a global level, and by calling setValidationEnabled you can disable validation on a
per-validator level.
When setting the validation enabled status per-validator, you can also set it to
nullto use the global setting.
import { setGlobalValidationEnabled } from '@sapphire/shapeshift';
setGlobalValidationEnabled(false);
import { s } from '@sapphire/shapeshift';
const predicate = s.string().lengthGreaterThan(5).setValidationEnabled(false);
Sapphire Community is and always will be open source, even if we don't get donations. That being said, we know there are amazing people who may still want to donate just to show their appreciation. Thank you very much in advance!
We accept donations through Open Collective, Ko-fi, Paypal, Patreon and GitHub Sponsorships. You can use the buttons below to donate through your method of choice.
| Donate With | Address |
|---|---|
| Open Collective | Click Here |
| Ko-fi | Click Here |
| Patreon | Click Here |
| PayPal | Click Here |
Please make sure to read the Contributing Guide before making a pull request.
Thank you to all the people who already contributed to Sapphire!
4.0.0 - (2024-05-20)
() to your code for it to work again.PickDefined utility type has been removed.PickUndefinedMakeOptional utility type has been removed.NonNullObject utility type has been removed.s.any is now s.any() to allow for custom options as argument.s.array(T).lengthEqual is now s.array(T).lengthEqual() to allow for custom options as argument.s.array(T).lengthGreaterThan is now s.array(T).lengthGreaterThan() to allow for custom options as argument.s.array(T).lengthGreaterThanOrEqual is now s.array(T).lengthGreaterThanOrEqual() to allow for custom options as argument.s.array(T).lengthLessThan is now s.array(T).lengthLessThan() to allow for custom options as argument.s.array(T).lengthLessThanOrEqual is now s.array(T).lengthLessThanOrEqual() to allow for custom options as argument.s.array(T).lengthNotEqual is now s.array(T).lengthNotEqual() to allow for custom options as argument.s.array(T).lengthRange is now s.array(T).lengthRange() to allow for custom options as argument.s.array(T).lengthRangeExclusive is now s.array(T).lengthRangeExclusive() to allow for custom options as argument.s.array(T).lengthRangeInclusive is now s.array(T).lengthRangeInclusive() to allow for custom options as argument.s.array(T).unique is now s.array(T).unique() to allow for custom options as argument.s.array is now s.array() to allow for custom options as argument.s.bigint.divisibleBy is now s.bigint().divisibleBy() to allow for custom options as argument.s.bigint.equal is now s.bigint().equal() to allow for custom options as argument.s.bigint.greaterThan is now s.bigint().greaterThan() to allow for custom options as argument.s.bigint.greaterThanOrEqual is now s.bigint().greaterThanOrEqual() to allow for custom options as argument.s.bigint.lessThan is now s.bigint().lessThan() to allow for custom options as argument.s.bigint.lessThanOrEqual is now s.bigint().lessThanOrEqual() to allow for custom options as argument.s.bigint.notEqual is now s.bigint().notEqual() to allow for custom options as argument.s.bigint().abs is now s.bigint().abs() to allow for custom options as second argument.s.bigint().negative is now s.bigint().negative() to allow for custom options as second argument.s.bigint().positive is now s.bigint().positive() to allow for custom options as second argument.s.bigint is now s.bigint() to allow for custom options as argument.s.bigInt64Array is now s.bigInt64Array() to allow for custom options as argument.s.bigUint64Array is now s.bigUint64Array() to allow for custom options as argument.s.boolean.false is now s.boolean().false() to allow for custom options as second argument.s.boolean.true is now s.boolean().true() to allow for custom options as second argument.s.boolean is now s.boolean() to allow for custom options as argument.s.default(...) now gets a second parameter to allow for custom options as argument.s.default(...).default(...) now gets a second parameter to allow for custom options as argument.s.date.equal is now s.date().equal() to allow for custom options as argument.s.date.greaterThan is now s.date().greaterThan() to allow for custom options as argument.s.date.greaterThanOrEqual is now s.date().greaterThanOrEqual() to allow for custom options as argument.s.date.invalid is now s.date().invalid() to allow for custom options as argument.s.date.lessThan is now s.date().lessThan() to allow for custom options as argument.s.date.lessThanOrEqual is now s.date().lessThanOrEqual() to allow for custom options as argument.s.date.notEqual is now s.date().notEqual() to allow for custom options as argument.s.date.valid is now s.date().valid() to allow for custom options as argument.s.date is now s.date() to allow for custom options as argument.s.enum(1, 2, 3) is now s.enum([1, 2, 3]) to allow for custom options as second argument.s.float32Array is now s.float32Array() to allow for custom options as argument.s.float64Array is now s.float64Array() to allow for custom options as argument.s.int16Array is now s.int16Array() to allow for custom options as argument.s.int32Array is now s.int32Array() to allow for custom options as argument.s.int8Array is now s.int8Array() to allow for custom options as argument.s.never is now s.never() to allow for custom options as argument.s.null is now s.null() to allow for custom options as argument.s.nullable is now s.nullable() to allow for custom options as argument.s.nullish is now s.nullish() to allow for custom options as argument.s.nullish is now s.nullish() to allow for custom options as argument.s.number.abs is now s.number().abs() to allow for custom options as argument.s.number.ceil is now s.number().ceil() to allow for custom options as argument.s.number.divisibleBy is now s.number().divisibleBy() to allow for custom options as argument.s.number.equal is now s.number().equal() to allow for custom options as argument.s.number.finite is now s.number().finite() to allow for custom options as argument.s.number.floor is now s.number().floor() to allow for custom options as argument.s.number.fround is now s.number().fround() to allow for custom options as argument.s.number.greaterThan is now s.number().greaterThan() to allow for custom options as argument.s.number.greaterThanOrEqual is now s.number().greaterThanOrEqual() to allow for custom options as argument.s.number.int is now s.number().int() to allow for custom options as argument.s.number.lessThan is now s.number().lessThan() to allow for custom options as argument.s.number.lessThanOrEqual is now s.number().lessThanOrEqual() to allow for custom options as argument.s.number.negative is now s.number().negative() to allow for custom options as argument.s.number.notEqual is now s.number().notEqual() to allow for custom options as argument.s.number.positive is now s.number().positive() to allow for custom options as argument.s.number.round is now s.number().round() to allow for custom options as argument.s.number.safeInt is now s.number().safeInt() to allow for custom options as argument.s.number.sign is now s.number().sign() to allow for custom options as argument.s.number.trunc is now s.number().trunc() to allow for custom options as argument.s.number is now s.number() to allow for custom options as argument.s.object.ignore is now s.object().ignore() to allow for custom options as argument.s.object.partial is now s.object().partial() to allow for custom options as argument.s.object.passthrough is now s.object().passthrough() to allow for custom options as argument.s.object.required is now s.object().required() to allow for custom options as argument.s.object.strict is now s.object().strict() to allow for custom options as argument.s.optional is now s.optional() to allow for custom options as argument.s.required(...) now gets a second parameter to allow for custom options as argument.s.set is now s.set() to allow for custom options as argument.s.string.date is now s.string().date() to allow for custom options as argument.s.string.email is now s.string().email() to allow for custom options as argument.s.string.ipv4 is now s.string().ipv4() to allow for custom options as argument.s.string.ipv6 is now s.string().ipv6() to allow for custom options as argument.s.string().ip is now s.string().ip() to allow for custom options as argument.s.string().lengthEqual is now s.string().lengthEqual() to allow for custom options as argument.s.string().lengthGreaterThan is now s.string().lengthGreaterThan() to allow for custom options as argument.s.string().lengthGreaterThanOrEqual is now s.string().lengthGreaterThanOrEqual() to allow for custom options as argument.s.string().lengthLessThan is now s.string().lengthLessThan() to allow for custom options as argument.s.string().lengthLessThanOrEqual is now s.string().lengthLessThanOrEqual() to allow for custom options as argument.s.string().lengthNotEqual is now s.string().lengthNotEqual() to allow for custom options as argument.s.string().phone is now s.string().phone() to allow for custom options as argument.s.string().regex is now s.string().regex() to allow for custom options as argument.s.string().url is now s.string().url() to allow for custom options as argument.s.string is now s.string() to allow for custom options as argument.s.tuple(1, 2, 3) is now s.tuple([1, 2, 3]) to allow for custom options as second argument.s.typedArray(T).byteLengthEqual is now s.typedArray(T).byteLengthEqual() to allow for custom options as argument.s.typedArray(T).byteLengthGreaterThan is now s.typedArray(T).byteLengthGreaterThan() to allow for custom options as argument.s.typedArray(T).byteLengthGreaterThanOrEqual is now s.typedArray(T).byteLengthGreaterThanOrEqual() to allow for custom options as argument.s.typedArray(T).byteLengthLessThan is now s.typedArray(T).byteLengthLessThan() to allow for custom options as argument.s.typedArray(T).byteLengthLessThanOrEqual is now s.typedArray(T).byteLengthLessThanOrEqual() to allow for custom options as argument.s.typedArray(T).byteLengthNotEqual is now s.typedArray(T).byteLengthNotEqual() to allow for custom options as argument.s.typedArray(T).byteLengthRange is now s.typedArray(T).byteLengthRange() to allow for custom options as argument.s.typedArray(T).byteLengthRangeExclusive is now s.typedArray(T).byteLengthRangeExclusive() to allow for custom options as argument.s.typedArray(T).byteLengthRangeInclusive is now s.typedArray(T).byteLengthRangeInclusive() to allow for custom options as argument.s.typedArray(T).lengthEqual is now s.typedArray(T).lengthEqual() to allow for custom options as argument.s.typedArray(T).lengthGreaterThan is now s.typedArray(T).lengthGreaterThan() to allow for custom options as argument.s.typedArray(T).lengthGreaterThanOrEqual is now s.typedArray(T).lengthGreaterThanOrEqual() to allow for custom options as argument.s.typedArray(T).lengthLessThan is now s.typedArray(T).lengthLessThan() to allow for custom options as argument.s.typedArray(T).lengthLessThanOrEqual is now s.typedArray(T).lengthLessThanOrEqual() to allow for custom options as argument.s.typedArray(T).lengthNotEqual is now s.typedArray(T).lengthNotEqual() to allow for custom options as argument.s.typedArray(T).lengthRange is now s.typedArray(T).lengthRange() to allow for custom options as argument.s.typedArray(T).lengthRangeExclusive is now s.typedArray(T).lengthRangeExclusive() to allow for custom options as argument.s.typedArray(T).lengthRangeInclusive is now s.typedArray(T).lengthRangeInclusive() to allow for custom options as argument.s.uint16Array is now s.uint16Array() to allow for custom options as argument.s.uint32Array is now s.uint32Array() to allow for custom options as argument.s.uint8Array is now s.uint8Array() to allow for custom options as argument.s.uint8ClampedArray is now s.uint8ClampedArray() to allow for custom options as argument.s.undefined is now s.undefined() to allow for custom options as argument.s.union(1, 2, 3).required is now s.union(1, 2, 3).required() to allow for custom options as argument.s.union(1, 2, 3) is now s.union([1, 2, 3]) to allow for custom options as second argument.s.unknown is now s.unknown() to allow for custom options as argument.uniqueArray is now a function (instead of a constant) to allow for custom options as argument.dateInvalid is now a function (instead of a constant) to allow for custom options as argument.dateValid is now a function (instead of a constant) to allow for custom options as argument.numberFinite is now a function (instead of a constant) to allow for custom options as argument.numberInt is now a function (instead of a constant) to allow for custom options as argument.numberNaN is now a function (instead of a constant) to allow for custom options as argument.numberNotNaN is now a function (instead of a constant) to allow for custom options as argument.numberSafeInt is now a function (instead of a constant) to allow for custom options as argument.FAQs
Blazing fast input validation and transformation ⚡
The npm package @sapphire/shapeshift receives a total of 178,142 weekly downloads. As such, @sapphire/shapeshift popularity was classified as popular.
We found that @sapphire/shapeshift demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.