Shinkansen generates JSON Schema valid documents from user submissions with <html /> forms.
Transmission transforms HTTP POST data into JSON Schema valid JSON documents (and back again).
It can also translate JSON Schema into Zashiki description format describing <html /> forms.
npm i -P shinkansen-transmissionYour schema should be dereferenced before it is transformed with Transmission (we recommend json-schema-ref-parser).
const document = fromHashToDocument(values, rootSchema)For applications accepting POST data.
The transformer walks the rootSchema and maps fields in values to another structure, which it returns.
-
valuesis a hash of keys and values -
rootSchemais a JSON Schema
The return value is an object valid according to the Schema.
POST data is generally represented as a hash of keys and values, where the values are all strings, or arrays containing strings. fromHashToDocument transforms that hash into a document.
{
type: 'object',
properties: {
company: {
type: 'object',
properties: {
name: {
type: 'string'
},
publisher: {
type: 'object',
properties: {
firstName: {
type: 'string'
},
lastName: {
type: 'string'
},
age: {
type: 'number'
}
}
}
}
},
active: {
type: 'boolean'
}
}
}An object.
{
'company-name': 'Marvel',
'company-publisher-firstName': 'Stan',
'company-publisher-lastName': 'Lee',
'company-publisher-age': '96',
active: 'true'
}An object.
{
company: {
name: 'Marvel',
publisher: {
firstName: 'Stan',
lastName: 'Lee',
age: 96
}
},
active: true
}const values = fromDocumentToHash(document, rootSchema)For applications accepting POST data.
The transformer walks the document and maps its fields to another structure, which it returns.
-
documentis an object valid according to the Schema -
rootSchemais a JSON Schema
The return value is a hash of keys and values, where the values are all strings, or arrays containing strings.
POST data is generally represented as a hash of keys and values, where the values are all strings, or arrays containing strings. fromDocumentToHash transforms a document into that hash.
An object.
{
company: {
name: 'Marvel',
publisher: {
firstName: 'Stan',
lastName: 'Lee',
age: 96
}
},
active: true
}{
type: 'object',
properties: {
company: {
type: 'object',
properties: {
name: {
type: 'string'
},
publisher: {
type: 'object',
properties: {
firstName: {
type: 'string'
},
lastName: {
type: 'string'
}
age: {
type: 'number'
}
}
}
}
},
active: {
type: 'boolean'
}
}
}A hash.
{
'company-name': 'Marvel',
'company-publisher-firstName': 'Stan',
'company-publisher-lastName': 'Lee',
'company-publisher-age': '96',
active: 'true'
}const zashiki = toZashiki(rootSchema, values, params)The transformer walks the rootSchema and maps fields in values and params to Zashiki description format, which it returns.
-
rootSchemais a JSON Schema -
valuesis a document valid according to the Schema -
paramsare any other parameters for the transformer
The return value is an object with the fields meta and elements.
As you might expect, meta contains fields about the Schema, while elements contains fields to be rendered as HTML. (Transmission doesn't express any opinion on what those elements are to be, but assumes that a field will be rendered as an HTML <form /> element or some component which behaves like one.)
{
meta: {
uri: String,
name: String,
type: String /* One of "object" "array" "string" "number" "boolean" "null" */,
schema: Object,
rootSchema: Object,
isRequired: Boolean,
defaultValue: /* Per `type` */,
value: /* Per `type` */,
},
elements: {
title: String,
description: String,
field: {
isRequired: Boolean,
value: /* Per `type` */,
name: String
}
}
}{
meta: {
uri: String,
name: String,
type: String /* One of "object" "array" "string" "number" "boolean" "null" */,
schema: Object,
rootSchema: Object,
isRequired: Boolean,
selectedItems: Array
},
elements: {
title: String,
description: String,
enum: {
isRequired: Boolean,
selectedItems: Array,
items: Array,
name: String
}
}
}{
meta: {
uri: String,
name: String,
type: String /* One of "object" "array" "string" "number" "boolean" "null" */,
schema: Object,
rootSchema: Object,
isRequired: Boolean,
selectedItems: Array,
},
elements: {
title: String,
description: String,
anyOf: {
isRequired: Boolean,
selectedItems: Array,
items: Array,
name: String
}
}
}{
meta: {
uri: String,
name: String,
type: String /* One of "object" "array" "string" "number" "boolean" "null" */,
schema: Object,
rootSchema: Object,
isRequired: Boolean,
selectedItems: Array,
},
elements: {
title: String,
description: String,
oneOf: {
required: Boolean,
selectedItems: Array,
items: Array,
name: String
}
}
}-
arrayorobject
{
meta: {
uri: String,
name: String,
type: String /* One of "object" "array" "string" "number" "boolean" "null" */,
schema: Object,
rootSchema: Object,
required: Boolean,
},
elements: {
title: String,
description: String,
fields: Array
}
}- Any other
{
meta: {
uri: String,
name: String,
type: String /* One of "object" "array" "string" "number" "boolean" "null" */,
schema: Object,
rootSchema: Object,
required: Boolean,
},
elements: {
title: String,
description: String,
field: Object
}
}