@takuhon/core 0.25.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takuhon/core",
-  "version": "0.25.0",
+  "version": "1.1.0",
   "description": "JSON Schema, validation, normalization, locale resolution, and JSON-LD generation for takuhon",
   "license": "Apache-2.0",
   "author": "Takuhon contributors",

package/takuhon.schema.json

@@ -1,21 +1,11 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://takuhon.example/schemas/0.7.0/takuhon.schema.json",
+  "$id": "https://takuhon.example/schemas/1.1.0/takuhon.schema.json",
   "title": "Takuhon Profile",
   "description": "Portable profile data format consumed by @takuhon/core. The canonical contract for profile content authored as takuhon.json.",
   "type": "object",
   "additionalProperties": false,
-  "required": [
-    "schemaVersion",
-    "profile",
-    "links",
-    "careers",
-    "projects",
-    "skills",
-    "contact",
-    "settings",
-    "meta"
-  ],
+  "required": ["schemaVersion", "profile", "contact", "settings", "meta"],
   "properties": {
     "schemaVersion": {
       "type": "string",
@@ -157,9 +147,10 @@
       "additionalProperties": {
         "type": "string",
         "minLength": 1,
-        "maxLength": 200
+        "maxLength": 200,
+        "pattern": "\\S"
       },
-      "description": "Map of BCP-47 locale tag to short title-like string (max 200 chars per value)."
+      "description": "Map of BCP-47 locale tag to short title-like string (max 200 chars per value). Each value must contain at least one non-whitespace character."
     },
     "LocalizedBody": {
       "type": "object",
@@ -171,9 +162,10 @@
       "additionalProperties": {
         "type": "string",
         "minLength": 1,
-        "maxLength": 5000
+        "maxLength": 5000,
+        "pattern": "\\S"
       },
-      "description": "Map of BCP-47 locale tag to body-length string (max 5000 chars per value)."
+      "description": "Map of BCP-47 locale tag to body-length string (max 5000 chars per value). Each value must contain at least one non-whitespace character."
     },
     "LinkType": {
       "type": "string",
@@ -198,7 +190,7 @@
     },
     "Profile": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["displayName"],
       "properties": {
         "displayName": { "$ref": "#/$defs/LocalizedTitle" },
@@ -210,7 +202,7 @@
     },
     "Avatar": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["url"],
       "properties": {
         "url": {
@@ -224,7 +216,7 @@
     },
     "Address": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "properties": {
         "country": { "$ref": "#/$defs/Iso3166Alpha2" },
         "region": { "type": "string", "maxLength": 100 },
@@ -261,7 +253,7 @@
     },
     "Career": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "organization", "role", "startDate"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -281,7 +273,7 @@
     },
     "Project": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "title"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -305,7 +297,7 @@
     },
     "Skill": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "label"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -322,7 +314,7 @@
     },
     "Contact": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "properties": {
         "email": { "$ref": "#/$defs/Email" },
         "showEmail": { "type": "boolean", "default": false },
@@ -331,7 +323,7 @@
     },
     "Settings": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["defaultLocale", "availableLocales"],
       "properties": {
         "defaultLocale": { "$ref": "#/$defs/LocaleTag" },
@@ -370,7 +362,38 @@
           "description": "Opt-in flag for first-party analytics. Default is false to keep takuhon privacy-respecting by default."
         },
         "activity": { "$ref": "#/$defs/ActivitySettings" },
-        "publicVisibility": { "$ref": "#/$defs/PublicVisibility" }
+        "publicVisibility": { "$ref": "#/$defs/PublicVisibility" },
+        "contact": { "$ref": "#/$defs/ContactSettings" }
+      }
+    },
+    "ContactSettings": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Opt-in contact form configuration (added in 1.1.0). Only public values live here; the Turnstile site key is safe to embed in the page. The Turnstile secret, the recipient address, and the From label are provisioned out of band as environment configuration and are never stored in takuhon.json. Adapters that support the form mount the widget and a POST endpoint when 'enabled' is true.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Master switch. When false (the default), no contact form is mounted even if a site key is present."
+        },
+        "turnstileSiteKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "description": "Public Cloudflare Turnstile site key, safe to embed in the page. Without it the widget is not mounted."
+        },
+        "endpoint": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2048,
+          "description": "Override the POST endpoint the widget submits to. Defaults to /api/contact on the same origin."
+        },
+        "subjectPrefix": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "description": "Subject prefix for the delivered email, e.g. '[example.com contact]'."
+        }
       }
     },
     "PublicVisibility": {
@@ -498,7 +521,7 @@
     },
     "Meta": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["contentLicense"],
       "properties": {
         "createdAt": { "$ref": "#/$defs/IsoDateTime" },
@@ -543,7 +566,7 @@
     },
     "MetaPrivacy": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "description": "Opt-out flags that strip personally identifying fields from public API output (GET /api/profile, /api/jsonld, /takuhon.json). Admin endpoints (PUT /api/admin/*, GET /api/admin/export) ignore these flags. Privacy-by-default: omitting the object or individual flags is equivalent to true.",
       "properties": {
         "hideCredentialIds": {
@@ -560,7 +583,7 @@
     },
     "Certification": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "title", "issuingOrganization", "issueDate"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -584,7 +607,7 @@
     },
     "Membership": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "organization", "startDate"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -604,7 +627,7 @@
     },
     "Volunteering": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "organization", "role", "startDate"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -624,7 +647,7 @@
     },
     "Honor": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "title", "issuer", "date"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -639,7 +662,7 @@
     },
     "Education": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "institution", "startDate"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -666,7 +689,7 @@
     },
     "Publication": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "title", "date"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -693,7 +716,7 @@
     },
     "Language": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "language", "proficiency"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -710,7 +733,7 @@
     },
     "Course": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "title"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -730,7 +753,7 @@
     },
     "Patent": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "title", "patentNumber", "status"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -760,7 +783,7 @@
     },
     "TestScore": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "title", "score", "date"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -784,7 +807,7 @@
     },
     "Recommendation": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["id", "body", "author"],
       "properties": {
         "id": { "$ref": "#/$defs/Slug" },
@@ -809,7 +832,7 @@
     },
     "RecommendationAuthor": {
       "type": "object",
-      "additionalProperties": true,
+      "additionalProperties": false,
       "required": ["name"],
       "properties": {
         "name": {