schema-markdown 1.0.3 → 1.1.0

package/README.md

@@ -85,8 +85,8 @@ try {
 
 ## Development
 
-This project is developed using [javascript-build](https://github.com/craigahobbs/javascript-build#readme). It was started
-using [javascript-template](https://github.com/craigahobbs/javascript-template#readme) as follows:
+schema-markdown is developed using [javascript-build](https://github.com/craigahobbs/javascript-build#readme)
+and it was started using [javascript-template](https://github.com/craigahobbs/javascript-template#readme):
 
 ```
 template-specialize javascript-template/template/ schema-markdown-js/ -k package schema-markdown -k name 'Craig A. Hobbs' -k email 'craigahobbs@gmail.com' -k github 'craigahobbs' -k noapp 1

package/lib/encode.js

@@ -0,0 +1,130 @@
+// Licensed under the MIT License
+// https://github.com/craigahobbs/schema-markdown-js/blob/main/LICENSE
+
+/** @module lib/encode */
+
+
+/**
+ * Encode an object as a query/hash string. Dictionaries, lists, and tuples are recursed. Each member key is expressed
+ * in fully-qualified form. List keys are the index into the list, and are in order.
+ *
+ * @param {Object} obj - The parameters object
+ * @returns {string}
+ */
+export function encodeQueryString(obj) {
+    return encodeQueryStringHelper(obj).join('&');
+}
+
+
+// Helper function for encodeQueryString
+function encodeQueryStringHelper(obj, memberFqn = null, keyValues = []) {
+    const objType = typeof obj;
+    if (Array.isArray(obj)) {
+        if (obj.length === 0) {
+            keyValues.push(memberFqn !== null ? `${memberFqn}=` : '');
+        } else {
+            for (let ix = 0; ix < obj.length; ix++) {
+                encodeQueryStringHelper(obj[ix], memberFqn !== null ? `${memberFqn}.${ix}` : `${ix}`, keyValues);
+            }
+        }
+    } else if (obj instanceof Date) {
+        const objEncoded = encodeURIComponent(obj.toISOString());
+        keyValues.push(memberFqn !== null ? `${memberFqn}=${objEncoded}` : `${objEncoded}`);
+    } else if (obj !== null && typeof obj === 'object') {
+        const keys = Object.keys(obj).sort();
+        if (keys.length === 0) {
+            keyValues.push(memberFqn !== null ? `${memberFqn}=` : '');
+        } else {
+            for (const key of keys) {
+                const keyEncoded = encodeQueryStringHelper(key);
+                encodeQueryStringHelper(obj[key], memberFqn !== null ? `${memberFqn}.${keyEncoded}` : `${keyEncoded}`, keyValues);
+            }
+        }
+    } else if (obj === null || objType === 'boolean' || objType === 'number') {
+        keyValues.push(memberFqn !== null ? `${memberFqn}=${obj}` : `${obj}`);
+    } else {
+        const objEncoded = encodeURIComponent(obj);
+        keyValues.push(memberFqn !== null ? `${memberFqn}=${objEncoded}` : `${objEncoded}`);
+    }
+    return keyValues;
+}
+
+
+/**
+ * Decode an object from a query/hash string. Each member key of the query string is expressed in fully-qualified
+ * form. List keys are the index into the list, must be in order.
+ *
+ * @param {string} paramStr - The parameters string
+ * @returns {Object}
+ */
+export function decodeQueryString(paramStr) {
+    // Decode the parameter string key/values
+    const result = [null];
+    const keyValues = paramStr.split('&');
+    keyValues.forEach((keyValue, ixKeyValue) => {
+        const [keyFqn, valueEncoded = null] = keyValue.split('=', 2);
+        if (valueEncoded === null) {
+            // Ignore hash IDs
+            if (ixKeyValue === keyValues.length - 1) {
+                return;
+            }
+            throw new Error(`Invalid key/value pair '${keyValue.slice(0, 100)}'`);
+        }
+        const value = decodeURIComponent(valueEncoded);
+
+        // Find/create the object on which to set the value
+        let parent = result;
+        let keyParent = 0;
+        const keys = keyFqn.split('.');
+        for (const keyEncoded of keys) {
+            let key = decodeURIComponent(keyEncoded);
+            let obj = parent[keyParent];
+
+            // Array key?  First "key" of an array must start with "0".
+            if (Array.isArray(obj) || (obj === null && key === '0')) {
+                // Create this key's container, if necessary
+                if (obj === null) {
+                    obj = [];
+                    parent[keyParent] = obj;
+                }
+
+                // Parse the key as an integer
+                if (isNaN(key)) {
+                    throw new Error(`Invalid array index '${key.slice(0, 100)}' in key '${keyFqn.slice(0, 100)}'`);
+                }
+                const keyOrig = key;
+                key = parseInt(key, 10);
+
+                // Append the value placeholder null
+                if (key === obj.length) {
+                    obj.push(null);
+                } else if (key < 0 || key > obj.length) {
+                    throw new Error(`Invalid array index '${keyOrig.slice(0, 100)}' in key '${keyFqn.slice(0, 100)}'`);
+                }
+            } else {
+                // Create this key's container, if necessary
+                if (obj === null) {
+                    obj = {};
+                    parent[keyParent] = obj;
+                }
+
+                // Create the index for this key
+                if (!(key in obj)) {
+                    obj[key] = null;
+                }
+            }
+
+            // Update the parent object and key
+            parent = obj;
+            keyParent = key;
+        }
+
+        // Set the value
+        if (parent[keyParent] !== null) {
+            throw new Error(`Duplicate key '${keyFqn.slice(0, 100)}'`);
+        }
+        parent[keyParent] = value;
+    });
+
+    return result[0] !== null ? result[0] : {};
+}

package/{src/schema-markdown → lib}/parser.js

@@ -1,6 +1,8 @@
 // Licensed under the MIT License
 // https://github.com/craigahobbs/schema-markdown-js/blob/main/LICENSE
 
+/** @module lib/parser */
+
 import {validateTypeModelTypesErrors} from './schemaUtil.js';
 
 /* eslint-disable prefer-template */

package/{src/schema-markdown → lib}/schema.js

@@ -1,6 +1,8 @@
 // Licensed under the MIT License
 // https://github.com/craigahobbs/schema-markdown-js/blob/main/LICENSE
 
+/** @module lib/schema */
+
 import {typeModel} from './typeModel.js';
 import {validateTypeModelTypesErrors} from './schemaUtil.js';
 
@@ -97,7 +99,7 @@ function getReferencedTypesHelper(types, type, referencedTypes) {
 /**
  * Schema Markdown type model validation error
  *
- * @property {?string} memberFqn - The list of error strings
+ * @property {?string} memberFqn - The fully qualified member name
  */
 export class ValidationError extends Error {
     /**
@@ -194,13 +196,13 @@ function validateTypeHelper(types, type, value, memberFqn) {
         } else if (builtin === 'date' || builtin === 'datetime') {
             // Convert string?
             if (typeof value === 'string') {
-                valueNew = new Date(value);
-                if (isNaN(valueNew)) {
-                    throwMemberError(type, value, memberFqn);
-                }
-
-                // Invalid date format?
-                if (!(rDate.test(value) || rDatetime.test(value))) {
+                // Valid date format?
+                if (rDate.test(value)) {
+                    const localDate = new Date(value);
+                    valueNew = new Date(localDate.getUTCFullYear(), localDate.getUTCMonth(), localDate.getUTCDate());
+                } else if (rDatetime.test(value)) {
+                    valueNew = new Date(value);
+                } else {
                     throwMemberError(type, value, memberFqn);
                 }
 

package/{src/schema-markdown → lib}/typeModel.js

@@ -1,6 +1,8 @@
 // Licensed under the MIT License
 // https://github.com/craigahobbs/schema-markdown-js/blob/main/LICENSE
 
+/** @module lib/typeModel */
+
 import {SchemaMarkdownParser} from './parser.js';
 
 
@@ -251,7 +253,9 @@ struct ActionURL
 `;
 
 
-// The Schema Markdown type model
+/**
+ * The Schema Markdown type model
+ */
 export const typeModel = {
     'title': 'The Schema Markdown Type Model',
     'types': (new SchemaMarkdownParser(typeModelSmd)).types

package/package.json

@@ -1,7 +1,7 @@
 {
     "type": "module",
     "name": "schema-markdown",
-    "version": "1.0.3",
+    "version": "1.1.0",
     "description": "Human-friendly schema definition language and schema validator",
     "keywords": [
         "schema",
@@ -18,17 +18,16 @@
         "url": "https://github.com/craigahobbs"
     },
     "files": [
-        "index.js",
-        "src/schema-markdown/**/*"
+        "lib/**/*"
     ],
     "scripts": {
-        "test": "ava -v 'src/tests/**/*.js'"
+        "test": "ava -v test/"
     },
     "devDependencies": {
-        "ava": "4.0.0-alpha.2",
-        "c8": "7.8.0",
-        "eslint": "7.32.0",
-        "jsdoc": "3.6.7",
-        "window": "4.2.7"
+        "ava": "^4.0.0-rc.1",
+        "c8": "~7.10",
+        "eslint": "~8.3",
+        "jsdoc": "~3.6",
+        "jsdom": "~18.1"
     }
 }

package/index.js

@@ -1,4 +0,0 @@
-// Licensed under the MIT License
-// https://github.com/craigahobbs/schema-markdown-js/blob/main/LICENSE
-
-export * from './src/schema-markdown/index.js';

package/src/schema-markdown/encode.js

@@ -1,129 +0,0 @@
-// Licensed under the MIT License
-// https://github.com/craigahobbs/schema-markdown-js/blob/main/LICENSE
-
-
-/**
- * Encode an object as a query/hash string. Dictionaries, lists, and tuples are recursed. Each member key is expressed
- * in fully-qualified form. List keys are the index into the list, and are in order.
- *
- * @param {Object} obj - The parameters object
- * @returns {string}
- */
-export function encodeQueryString(obj) {
-    return encodeQueryStringHelper(obj).join('&');
-}
-
-
-// Helper function for encodeQueryString
-function encodeQueryStringHelper(obj, memberFqn = null, keyValues = []) {
-    const objType = typeof obj;
-    if (Array.isArray(obj)) {
-        if (obj.length === 0) {
-            keyValues.push(memberFqn !== null ? `${memberFqn}=` : '');
-        } else {
-            for (let ix = 0; ix < obj.length; ix++) {
-                encodeQueryStringHelper(obj[ix], memberFqn !== null ? `${memberFqn}.${ix}` : `${ix}`, keyValues);
-            }
-        }
-    } else if (obj instanceof Date) {
-        const objEncoded = encodeURIComponent(obj.toISOString());
-        keyValues.push(memberFqn !== null ? `${memberFqn}=${objEncoded}` : `${objEncoded}`);
-    } else if (obj !== null && typeof obj === 'object') {
-        const keys = Object.keys(obj).sort();
-        if (keys.length === 0) {
-            keyValues.push(memberFqn !== null ? `${memberFqn}=` : '');
-        } else {
-            for (const key of keys) {
-                const keyEncoded = encodeQueryStringHelper(key);
-                encodeQueryStringHelper(obj[key], memberFqn !== null ? `${memberFqn}.${keyEncoded}` : `${keyEncoded}`, keyValues);
-            }
-        }
-    } else if (obj === null || objType === 'boolean' || objType === 'number') {
-        keyValues.push(memberFqn !== null ? `${memberFqn}=${obj}` : `${obj}`);
-    } else {
-        const objEncoded = encodeURIComponent(obj);
-        keyValues.push(memberFqn !== null ? `${memberFqn}=${objEncoded}` : `${objEncoded}`);
-    }
-    return keyValues;
-}
-
-
-/**
- * Decode an object from a query/hash string. Each member key of the query string is expressed in fully-qualified
- * form. List keys are the index into the list, must be in order.
- *
- * @param {string} paramStr - The parameters string
- * @returns {Object}
- */
-export function decodeQueryString(paramStr) {
-    // Decode the parameter string key/values
-    const result = [null];
-    paramStr.split('&').filter((keyValue) => keyValue.length).forEach(
-        (keyValue, ixKeyValue, keyValuesFiltered) => {
-            const [keyFqn, valueEncoded = null] = keyValue.split('=');
-            if (valueEncoded === null) {
-                // Ignore anchor tags
-                if (ixKeyValue === keyValuesFiltered.length - 1) {
-                    return;
-                }
-                throw new Error(`Invalid key/value pair '${keyValue.slice(0, 100)}'`);
-            }
-            const value = decodeURIComponent(valueEncoded);
-
-            // Find/create the object on which to set the value
-            let parent = result;
-            let keyParent = 0;
-            const keys = keyFqn.split('.');
-            for (const keyEncoded of keys) {
-                let key = decodeURIComponent(keyEncoded);
-                let obj = parent[keyParent];
-
-                // Array key?  First "key" of an array must start with "0".
-                if (Array.isArray(obj) || (obj === null && key === '0')) {
-                    // Create this key's container, if necessary
-                    if (obj === null) {
-                        obj = [];
-                        parent[keyParent] = obj;
-                    }
-
-                    // Parse the key as an integer
-                    if (isNaN(key)) {
-                        throw new Error(`Invalid array index '${key.slice(0, 100)}' in key '${keyFqn.slice(0, 100)}'`);
-                    }
-                    const keyOrig = key;
-                    key = parseInt(key, 10);
-
-                    // Append the value placeholder null
-                    if (key === obj.length) {
-                        obj.push(null);
-                    } else if (key < 0 || key > obj.length) {
-                        throw new Error(`Invalid array index '${keyOrig.slice(0, 100)}' in key '${keyFqn.slice(0, 100)}'`);
-                    }
-                } else {
-                    // Create this key's container, if necessary
-                    if (obj === null) {
-                        obj = {};
-                        parent[keyParent] = obj;
-                    }
-
-                    // Create the index for this key
-                    if (!(key in obj)) {
-                        obj[key] = null;
-                    }
-                }
-
-                // Update the parent object and key
-                parent = obj;
-                keyParent = key;
-            }
-
-            // Set the value
-            if (parent[keyParent] !== null) {
-                throw new Error(`Duplicate key '${keyFqn.slice(0, 100)}'`);
-            }
-            parent[keyParent] = value;
-        }
-    );
-
-    return result[0] !== null ? result[0] : {};
-}

package/src/schema-markdown/index.js

@@ -1,26 +0,0 @@
-// Licensed under the MIT License
-// https://github.com/craigahobbs/schema-markdown-js/blob/main/LICENSE
-
-export {
-    decodeQueryString,
-    encodeQueryString
-} from './encode.js';
-
-export {
-    SchemaMarkdownParser,
-    SchemaMarkdownParserError
-} from './parser.js';
-
-export {
-    ValidationError,
-    getEnumValues,
-    getReferencedTypes,
-    getStructMembers,
-    validateType,
-    validateTypeModel,
-    validateTypeModelTypes
-} from './schema.js';
-
-export {
-    typeModel
-} from './typeModel.js';