core-types-suretype
v3.2.0
Published
core-types ⬌ SureType validator conversion
Downloads
76,442
Maintainers
Readme
core-types-suretype
This package provides conversion functions between core-types
and suretype
.
You probably don't want to use this package directly, but rather typeconv
which uses this package to convert between TypeScript, JSON Schema, Open API, GraphQL and suretype.
This package converts either from core-types or JSON Schema, when converting to suretype validators. It also converts either to core-types or JSON Schema when converting from suretype.
When converting to and from JSON Schema (rather than core-types), the value constraints are maintained.
It can convert from TypeScript/JavaScript files exporting suretype validators, as long as they are require()
able (i.e. have all their dependencies installed).
See
Other conversion packages:
Contents
Usage
There are four conversion functions,
convertCoreTypesToSureType
, convertJsonSchemaToSureType
converts to suretype,
convertSureTypeToCoreTypes
, convertSureTypeToJsonSchema
converts from suretype.
These do all return a wrapped value, of the type ConversionResult
.
core-types to suretype
import { convertCoreTypesToSureType } from 'core-types-suretype'
let doc; // This core-types document comes from somewhere
const { data: tsSourceCode } = convertCoreTypesToSureType( doc, opts );
You can provide options as a second argument of the type (it's the same type used for converting from JSON Schema, hence the name):
interface JsonSchemaToSuretypeOptions
{
warn?: WarnFunction;
filename?: string;
sourceFilename?: string;
userPackage?: string;
userPackageUrl?: string;
noDisableLintHeader?: boolean;
noDescriptiveHeader?: boolean;
useUnknown?: boolean;
forwardSchema?: boolean;
inlineTypes?: boolean;
exportType?: boolean;
exportSchema?: boolean;
exportValidator?: boolean;
exportEnsurer?: boolean;
exportTypeGuard?: boolean;
unsupported?: 'ignore' | 'warn' | 'error';
}
These options are all optional.
warn
: A function callback to be used for warnings, defaults toconsole.warn
.filename
The filename to be written to.This is a hint, no file will be written by the conversion function.sourceFilename
: The name of the source file from which the core-types comes.userPackage
: The name of the package using this package.userPackageUrl
: The url to the package using this package.noDisableLintHeader
: Prevent writing the "disable linting" comment.noDescriptiveHeader
: Do no write a top-level descriptive comment about the auto-generated fileuseUnknown
: Useunknown
rather thanany
for any-types.forwardSchema
: Forward the JSON Schema, and create an untyped validator schema with the raw JSON Schema under the hood.inlineTypes
: Inline pretty typescript types aside validator codeexportType
: Export the deduced types (or the pretty types, depending on inlineTypes)exportSchema
: Export validator schemasexportValidator
: Export regular validatorsexportEnsurer
: Export 'ensurer' validatorsexportTypeGuard
: Export type guards (is* validators)unsupported
: What to do when detecting an unsupported typeignore
: Ignore (skip) typewarn
: Ignore type, but warn (default)error
: Throw an error
The warn
function is of type WarnFunction
from core-types
, meaning it takes a message as string, and an optional second argument of type CoreTypesErrorMeta
, also from core-types
.
JSON Schema to suretype
Converting from JSON Schema is almost the same as from core-types;
import { convertJsonSchemaToSureType } from 'core-types-suretype'
let jsonSchema; // This JSON Schema comes from somewhere
const { data: tsSourceCode } = convertJsonSchemaToSureType( jsonSchema, opts );
The opts
argument is the same as in convertCoreTypesToSureType
.
suretype to core-types
import { convertSureTypeToCoreTypes } from 'core-types-suretype'
let sourceCode; // This source code comes from somewhere
const { data: doc } = await convertSureTypeToCoreTypes( sourceCode, opts );
An optional second argument can be provided of the type (this is the same type used to convert to JSON Schema, hence the name):
interface SuretypeToJsonSchemaOptions
{
warn?: WarnFunction;
filename?: string;
sourceFilename?: string;
userPackage?: string;
userPackageUrl?: string;
refMethod?: 'no-refs' | 'provided' | 'ref-all';
nameConflict?: 'rename' | 'warn' | 'error';
}
warn
: The same warn function as in CoreTypesToGraphqlOptionsfilename
The filename to be written to.This is a hint, no file will be written by the conversion function.sourceFilename
: The name of the source file from which the core-types comes.userPackage
: The name of the package using this package.userPackageUrl
: The url to the package using this package.refMethod
: How to handle references to non-exported typesno-refs
: Don't ref anything. Inline all types to monolith types.provided
: Reference types that are explicitly provided.ref-all
: Ref all provided types and those with names, suretype()'d.
nameConflict
: What to do when detecting a name conflictrename
: Try to rename typewarn
: Ignore type, but warnerror
: Throw an error
suretype to JSON Schema
import { convertSureTypeToJsonSchema } from 'core-types-suretype'
let sourceCode; // This source code comes from somewhere
const { data: jsonSchema } = await convertSureTypeToJsonSchema( sourceCode, opts );
The optional opts
argument is the same as in convertSureTypeToCoreTypes
.