shinkansen-transmission
v2.2.156
Published
Shinkansen Transmission
Downloads
1,603
Readme
shinkansen-transmission
Shinkansen generates JSON Schema valid documents from user submissions with <html /> forms.
Transmission
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.
Installation
npm i -P shinkansen-transmissionYour schema should be dereferenced before it is transformed with Transmission (we recommend json-schema-ref-parser).
fromHashToDocument
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 valuesrootSchemais 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.
rootSchema
{
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'
}
}
}values
An object.
{
'company-name': 'Marvel',
'company-publisher-firstName': 'Stan',
'company-publisher-lastName': 'Lee',
'company-publisher-age': '96',
active: 'true'
}document
An object.
{
company: {
name: 'Marvel',
publisher: {
firstName: 'Stan',
lastName: 'Lee',
age: 96
}
},
active: true
}fromDocumentToHash
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 SchemarootSchemais 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.
document
An object.
{
company: {
name: 'Marvel',
publisher: {
firstName: 'Stan',
lastName: 'Lee',
age: 96
}
},
active: true
}rootSchema
{
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'
}
}
}values
A hash.
{
'company-name': 'Marvel',
'company-publisher-firstName': 'Stan',
'company-publisher-lastName': 'Lee',
'company-publisher-age': '96',
active: 'true'
}toZashiki
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 Schemavaluesis a document valid according to the Schemaparamsare 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.)
Transformed structure
{
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
}
}
}enum
{
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
}
}
}anyOf
{
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
}
}
}oneOf
{
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
}
}
}allOf
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
}
}