@jsonresume/schema 1.3.1 → 1.5.0

package/README.md

@@ -18,30 +18,33 @@ npm install --save @jsonresume/schema
 
 To use
 
+`validate(resume, callback)` calls back with `(errors, valid)`:
+
 ```js
-import resumeSchema from '@jsonresume/schema';
-resumeSchema.validate(
-  { basics: { name: "Thomas" } },
-  function (err, report) {
-    if (err) {
-      console.error("The resume was invalid:", err);
-      return;
-    }
-    console.log("Resume validated successfully:", report);
-  },
-  function (err) {
-    console.error("The resume was invalid:", err);
+const { validate } = require('@jsonresume/schema');
+
+validate({ basics: { name: 'Thomas' } }, (errors, valid) => {
+  if (!valid) {
+    console.error('The resume was invalid:', errors);
+    return;
   }
-);
+  console.log('Resume validated successfully');
+});
 ```
 
 Or against a full `resume.json`
 
 ```js
 const fs = require('fs');
-const resumeSchema = require('@jsonresume/schema');
-const resumeObject = JSON.parse(fs.readFileSync('./resume.json', 'utf8'));
-resumeSchema.validate(resumeObject);
+const { validate } = require('@jsonresume/schema');
+
+const resume = JSON.parse(fs.readFileSync('./resume.json', 'utf8'));
+validate(resume, (errors, valid) => {
+  if (!valid) {
+    console.error(errors);
+    process.exit(1);
+  }
+});
 ```
 
 The JSON Resume schema is available from:
@@ -50,6 +53,28 @@ The JSON Resume schema is available from:
 require('@jsonresume/schema').schema;
 ```
 
+### Extending with `custom`
+
+Data with no standard field can go in an optional `custom` object, allowed at
+the root, in `basics`, and on every entry of every section. Its contents are
+free-form; namespace keys by tool to avoid collisions:
+
+```json
+{
+  "work": [
+    {
+      "name": "Tech Corp",
+      "position": "Senior Developer",
+      "custom": { "myAts": { "teamSize": 12, "directReports": 5 } }
+    }
+  ]
+}
+```
+
+Themes don't render `custom`, and tools that read and write resumes should
+preserve it unchanged. Unknown top-level properties are also still allowed
+(`additionalProperties: true`); `custom` gives that data a predictable home.
+
 ### Contribute
 
 We encourage anyone who's interested in participating in the formation of this standard to join the discussions [here on GitHub](https://github.com/jsonresume/jsonresume.org/issues). Also feel free to fork this project and submit new ideas to add to the JSON Resume Schema standard. To make sure all formatting is kept in check, please install the [EditorConfig plugin](http://editorconfig.org/) for your editor of choice.

package/examples/career-changer.resume.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://raw.githubusercontent.com/jsonresume/resume-schema/v1.0.0/schema.json",
+  "$schema": "https://raw.githubusercontent.com/jsonresume/jsonresume.org/master/packages/schema/schema.json",
   "basics": {
     "name": "Daniel Reyes",
     "label": "Junior Data Analyst (former Restaurant Manager)",

package/examples/new-grad.resume.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://raw.githubusercontent.com/jsonresume/resume-schema/v1.0.0/schema.json",
+  "$schema": "https://raw.githubusercontent.com/jsonresume/jsonresume.org/master/packages/schema/schema.json",
   "basics": {
     "name": "Maya Okonkwo",
     "label": "Computer Science Graduate",

package/examples/senior-engineer.resume.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://raw.githubusercontent.com/jsonresume/resume-schema/v1.0.0/schema.json",
+  "$schema": "https://raw.githubusercontent.com/jsonresume/jsonresume.org/master/packages/schema/schema.json",
   "basics": {
     "name": "Dr. Lena Vasquez",
     "label": "Staff Software Engineer, Distributed Systems",

package/job-schema.json

@@ -1,5 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/jsonresume/jsonresume.org/master/packages/schema/job-schema.json",
   "additionalProperties": true,
   "definitions": {
     "iso8601": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsonresume/schema",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "JSON Resume Schema",
   "private": false,
   "main": "validator.js",

package/sample.resume.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://raw.githubusercontent.com/jsonresume/resume-schema/v1.0.0/schema.json",
+  "$schema": "https://raw.githubusercontent.com/jsonresume/jsonresume.org/master/packages/schema/schema.json",
   "basics": {
     "name": "Richard Hendriks",
     "label": "Programmer",
@@ -28,6 +28,7 @@
       }
     ]
   },
+  "objective": "Lead engineering for a compression-first storage platform.",
   "work": [
     {
       "name": "Pied Piper",
@@ -42,7 +43,8 @@
         "Build an algorithm for artist to detect if their music was violating copy right infringement laws",
         "Successfully won Techcrunch Disrupt",
         "Optimized an algorithm that holds the current world record for Weisman Scores"
-      ]
+      ],
+      "keywords": ["Compression", "C++", "Distributed Systems"]
     }
   ],
   "volunteer": [
@@ -65,7 +67,8 @@
       "startDate": "2011-06-01",
       "endDate": "2014-01-01",
       "score": "4.0",
-      "courses": ["DB1101 - Basic SQL", "CS2011 - Java Introduction"]
+      "courses": ["DB1101 - Basic SQL", "CS2011 - Java Introduction"],
+      "summary": "Senior project on lossless compression for streaming media."
     }
   ],
   "awards": [
@@ -76,13 +79,25 @@
       "summary": "There is no spoon."
     }
   ],
+  "certificates": [
+    {
+      "name": "AWS Certified Solutions Architect – Associate",
+      "date": "2014-06-01",
+      "expiryDate": "2017-06-01",
+      "issuer": "Amazon Web Services",
+      "url": "https://certificates.example.com/aws/rhendriks",
+      "credentialId": "AWS-ASA-12345",
+      "summary": "Designing distributed systems on AWS."
+    }
+  ],
   "publications": [
     {
       "name": "Video compression for 3d media",
       "publisher": "Hooli",
       "releaseDate": "2014-10-01",
       "url": "http://en.wikipedia.org/wiki/Silicon_Valley_(TV_series)",
-      "summary": "Innovative middle-out compression algorithm that changes the way we store data."
+      "summary": "Innovative middle-out compression algorithm that changes the way we store data.",
+      "type": "article"
     }
   ],
   "skills": [
@@ -134,8 +149,8 @@
     }
   ],
   "meta": {
-    "canonical": "https://raw.githubusercontent.com/jsonresume/resume-schema/v1.0.0/sample.resume.json",
-    "version": "v1.0.0",
-    "lastModified": "2017-12-24T15:53:00"
+    "canonical": "https://raw.githubusercontent.com/jsonresume/jsonresume.org/master/packages/schema/sample.resume.json",
+    "version": "v1.3.1",
+    "lastModified": "2026-10-22T00:00:00"
   }
 }

package/schema.json

@@ -1,12 +1,43 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "http://example.com/example.json",
+  "$id": "https://raw.githubusercontent.com/jsonresume/jsonresume.org/master/packages/schema/schema.json",
   "additionalProperties": true,
   "definitions": {
     "iso8601": {
       "type": "string",
-      "description": "Similar to the standard date type, but each section after the year is optional. e.g. 2014-06-29 or 2023-04",
-      "pattern": "^([1-2][0-9]{3}-[0-1][0-9]-[0-3][0-9]|[1-2][0-9]{3}-[0-1][0-9]|[1-2][0-9]{3})$"
+      "description": "Similar to the standard date type, but each section after the year is optional. e.g. 2014-06-29 or 2023-04. Every date is optional; omit endDate for a current position or ongoing entry (#309).",
+      "pattern": "^([1-2][0-9]{3}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])|[1-2][0-9]{3}-(0[1-9]|1[0-2])|[1-2][0-9]{3})$"
+    },
+    "custom": {
+      "type": "object",
+      "description": "Tool- or author-specific data that has no standard field yet (#316). Keys are free-form; namespace them by tool (e.g. \"myTool\": { ... }) to avoid collisions. Themes are not expected to render it, and tools should preserve it unchanged when reading and writing resumes.",
+      "additionalProperties": true
+    },
+    "location": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "address": {
+          "type": "string",
+          "description": "To add multiple address lines, use \n. For example, 1234 Glücklichkeit Straße\nHinterhaus 5. Etage li."
+        },
+        "postalCode": {
+          "type": "string",
+          "description": "e.g. 12345"
+        },
+        "city": {
+          "type": "string",
+          "description": "e.g. Teststadt"
+        },
+        "countryCode": {
+          "type": "string",
+          "description": "code as per ISO-3166-1 ALPHA-2, e.g. US, AU, IN"
+        },
+        "region": {
+          "type": "string",
+          "description": "The general region where you live. Can be a US state, or a province, for instance."
+        }
+      }
     }
   },
   "properties": {
@@ -26,6 +57,10 @@
           "type": "string",
           "description": "e.g. Web Developer"
         },
+        "pronouns": {
+          "type": "string",
+          "description": "e.g. she/her, they/them (#312)"
+        },
         "image": {
           "type": "string",
           "description": "URL (as per RFC 3986) to a image in JPEG or PNG format"
@@ -49,28 +84,7 @@
           "description": "Write a short 2-3 sentence biography about yourself"
         },
         "location": {
-          "type": "object",
-          "additionalProperties": true,
-          "properties": {
-            "address": {
-              "type": "string",
-              "description": "To add multiple address lines, use \n. For example, 1234 Glücklichkeit Straße\nHinterhaus 5. Etage li."
-            },
-            "postalCode": {
-              "type": "string"
-            },
-            "city": {
-              "type": "string"
-            },
-            "countryCode": {
-              "type": "string",
-              "description": "code as per ISO-3166-1 ALPHA-2, e.g. US, AU, IN"
-            },
-            "region": {
-              "type": "string",
-              "description": "The general region where you live. Can be a US state, or a province, for instance."
-            }
-          }
+          "$ref": "#/definitions/location"
         },
         "profiles": {
           "type": "array",
@@ -94,9 +108,16 @@
               }
             }
           }
+        },
+        "custom": {
+          "$ref": "#/definitions/custom"
         }
       }
     },
+    "objective": {
+      "type": "string",
+      "description": "Forward-looking career goal, e.g. 'Seeking a senior backend role in climate tech'. Distinct from basics.summary, which describes background (#317)"
+    },
     "work": {
       "type": "array",
       "items": {
@@ -108,8 +129,15 @@
             "description": "e.g. Facebook"
           },
           "location": {
-            "type": "string",
-            "description": "e.g. Menlo Park, CA"
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "Free text, e.g. Menlo Park, CA"
+              },
+              {
+                "$ref": "#/definitions/location"
+              }
+            ]
           },
           "description": {
             "type": "string",
@@ -141,6 +169,17 @@
               "type": "string",
               "description": "e.g. Increased profits by 20% from 2011-2012 through viral advertising"
             }
+          },
+          "keywords": {
+            "type": "array",
+            "description": "Skills, tools or technologies used in this role (#293)",
+            "items": {
+              "type": "string",
+              "description": "e.g. React"
+            }
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -155,6 +194,17 @@
             "type": "string",
             "description": "e.g. Facebook"
           },
+          "location": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "Free text, e.g. Berlin, DE"
+              },
+              {
+                "$ref": "#/definitions/location"
+              }
+            ]
+          },
           "position": {
             "type": "string",
             "description": "e.g. Software Engineer"
@@ -181,6 +231,9 @@
               "type": "string",
               "description": "e.g. Increased profits by 20% from 2011-2012 through viral advertising"
             }
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -195,6 +248,17 @@
             "type": "string",
             "description": "e.g. Massachusetts Institute of Technology"
           },
+          "location": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "Free text, e.g. Cambridge, MA"
+              },
+              {
+                "$ref": "#/definitions/location"
+              }
+            ]
+          },
           "url": {
             "type": "string",
             "description": "e.g. http://facebook.example.com",
@@ -225,6 +289,13 @@
               "type": "string",
               "description": "e.g. H1302 - Introduction to American history"
             }
+          },
+          "summary": {
+            "type": "string",
+            "description": "Thesis topic, honours, notable projects or other context (#292)"
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -250,6 +321,9 @@
           "summary": {
             "type": "string",
             "description": "e.g. Received for my work with Quantum Physics"
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -273,9 +347,23 @@
             "description": "e.g. http://example.com",
             "format": "uri"
           },
+          "credentialId": {
+            "type": "string",
+            "description": "Credential or licence number used to verify the certificate, e.g. a licence number or a certification ID (#590)"
+          },
           "issuer": {
             "type": "string",
             "description": "e.g. CNCF"
+          },
+          "expiryDate": {
+            "$ref": "#/definitions/iso8601"
+          },
+          "summary": {
+            "type": "string",
+            "description": "What the certificate covers (#590)"
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -306,6 +394,13 @@
           "summary": {
             "type": "string",
             "description": "Short summary of publication. e.g. Discussion of the World Wide Web, HTTP, HTML."
+          },
+          "type": {
+            "type": "string",
+            "description": "e.g. 'article', 'book', 'patent', 'thesis', 'talk' (#295)"
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -332,6 +427,9 @@
               "type": "string",
               "description": "e.g. HTML"
             }
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -350,6 +448,9 @@
           "fluency": {
             "type": "string",
             "description": "e.g. Fluent, Beginner"
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -370,6 +471,9 @@
               "type": "string",
               "description": "e.g. Friedrich Nietzsche"
             }
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -388,6 +492,9 @@
           "reference": {
             "type": "string",
             "description": "e.g. Joe blogs was a great employee, who turned up to work at least once a week. He exceeded my expectations when it came to doing nothing."
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -449,6 +556,9 @@
           "type": {
             "type": "string",
             "description": " e.g. 'volunteering', 'presentation', 'talk', 'application', 'conference'"
+          },
+          "custom": {
+            "$ref": "#/definitions/custom"
           }
         }
       }
@@ -472,6 +582,9 @@
           "description": "Using ISO 8601 with YYYY-MM-DDThh:mm:ss"
         }
       }
+    },
+    "custom": {
+      "$ref": "#/definitions/custom"
     }
   },
   "title": "Resume Schema",

package/validator.js

@@ -4,6 +4,19 @@ const jobSchema = require('./job-schema');
 const Validator = require('jsonschema').Validator;
 
 function validate(resumeJson, callback) {
+  // jsonschema treats an absent instance as valid, which hides failed reads
+  // and parses upstream
+  if (
+    resumeJson === null ||
+    typeof resumeJson !== 'object' ||
+    Array.isArray(resumeJson)
+  ) {
+    return callback(
+      [{ property: 'instance', message: 'resume must be a JSON object' }],
+      false
+    );
+  }
+
   const v = new Validator();
 
   const validation = v.validate(resumeJson, schema);