@takuhon/core 0.4.0 → 0.5.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // takuhon.schema.json
 var takuhon_schema_default = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
-  $id: "https://takuhon.example/schemas/0.2.0/takuhon.schema.json",
+  $id: "https://takuhon.example/schemas/0.4.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",
@@ -89,6 +89,16 @@ var takuhon_schema_default = {
       maxItems: 50,
       items: { $ref: "#/$defs/Patent" }
     },
+    testScores: {
+      type: "array",
+      maxItems: 30,
+      items: { $ref: "#/$defs/TestScore" }
+    },
+    recommendations: {
+      type: "array",
+      maxItems: 50,
+      items: { $ref: "#/$defs/Recommendation" }
+    },
     contact: { $ref: "#/$defs/Contact" },
     settings: { $ref: "#/$defs/Settings" },
     meta: { $ref: "#/$defs/Meta" }
@@ -401,7 +411,7 @@ var takuhon_schema_default = {
     MetaPrivacy: {
       type: "object",
       additionalProperties: true,
-      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/export) ignore these flags. Privacy-by-default: omitting the object or individual flags is equivalent to true.",
+      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: {
           type: "boolean",
@@ -605,6 +615,74 @@ var takuhon_schema_default = {
         },
         order: { type: "integer", minimum: 0 }
       }
+    },
+    TestScore: {
+      type: "object",
+      additionalProperties: true,
+      required: ["id", "title", "score", "date"],
+      properties: {
+        id: { $ref: "#/$defs/Slug" },
+        title: { $ref: "#/$defs/LocalizedTitle" },
+        score: {
+          type: "string",
+          minLength: 1,
+          maxLength: 50,
+          description: "Free-form score string (e.g. '112 / 120', '330', 'N1 Pass', or a percentile). The validator does not interpret its contents."
+        },
+        date: { $ref: "#/$defs/YearMonth" },
+        relatedEducationId: {
+          $ref: "#/$defs/Slug",
+          description: "Optional reference to an education[].id (e.g. for a university course exam)."
+        },
+        description: { $ref: "#/$defs/LocalizedBody" },
+        url: { $ref: "#/$defs/Url" },
+        order: { type: "integer", minimum: 0 }
+      }
+    },
+    Recommendation: {
+      type: "object",
+      additionalProperties: true,
+      required: ["id", "body", "author"],
+      properties: {
+        id: { $ref: "#/$defs/Slug" },
+        body: { $ref: "#/$defs/LocalizedBody" },
+        author: { $ref: "#/$defs/RecommendationAuthor" },
+        relationship: {
+          $ref: "#/$defs/LocalizedTitle",
+          description: "How the recommender relates to the profile owner (e.g. 'managed directly', 'worked together')."
+        },
+        date: { $ref: "#/$defs/YearMonth" },
+        relatedCareerId: {
+          $ref: "#/$defs/Slug",
+          description: "Optional reference to a careers[].id (the position the recommendation pertains to)."
+        },
+        relatedEducationId: {
+          $ref: "#/$defs/Slug",
+          description: "Optional reference to an education[].id (e.g. a recommendation from a professor)."
+        },
+        order: { type: "integer", minimum: 0 }
+      }
+    },
+    RecommendationAuthor: {
+      type: "object",
+      additionalProperties: true,
+      required: ["name"],
+      properties: {
+        name: {
+          type: "string",
+          minLength: 1,
+          maxLength: 100,
+          description: "Recommender's name, in its original script. Owner-curated; takuhon does not verify it."
+        },
+        headline: {
+          $ref: "#/$defs/LocalizedTitle",
+          description: "Recommender's title / role / organization at the time of the recommendation."
+        },
+        url: {
+          $ref: "#/$defs/Url",
+          description: "Link to the recommender's profile, for external verification by the reader."
+        }
+      }
     }
   }
 };
@@ -615,7 +693,7 @@ var schema = takuhon_schema_default;
 // src/validate.ts
 import Ajv2020 from "ajv/dist/2020.js";
 import addFormats from "ajv-formats";
-var SUPPORTED_SCHEMA_VERSIONS = ["0.1.0", "0.2.0"];
+var SUPPORTED_SCHEMA_VERSIONS = ["0.1.0", "0.2.0", "0.3.0", "0.4.0"];
 var ajv = new Ajv2020({
   allErrors: true,
   strict: true
@@ -682,7 +760,9 @@ var COERCED_ARRAY_KEYS = [
   "publications",
   "languages",
   "courses",
-  "patents"
+  "patents",
+  "testScores",
+  "recommendations"
 ];
 function coerceMissingArrays(data) {
   const bag = data;
@@ -808,6 +888,17 @@ function normalize(data) {
     cleanOptionalLocalized(p, "description");
   }
   out.patents = stableSortByOrder(out.patents);
+  for (const t of out.testScores) {
+    cleanRequiredLocalized(t.title);
+    cleanOptionalLocalized(t, "description");
+  }
+  out.testScores = stableSortByOrder(out.testScores);
+  for (const r of out.recommendations) {
+    cleanRequiredLocalized(r.body);
+    cleanOptionalLocalized(r, "relationship");
+    cleanOptionalLocalized(r.author, "headline");
+  }
+  out.recommendations = stableSortByOrder(out.recommendations);
   return out;
 }
 function normalizeProfile(profile) {
@@ -859,7 +950,9 @@ var NORMALIZED_ARRAYS = [
   "publications",
   "languages",
   "courses",
-  "patents"
+  "patents",
+  "testScores",
+  "recommendations"
 ];
 
 // src/locale-tag.ts
@@ -907,6 +1000,8 @@ function resolveLocale(data, locale, fallbackLocale) {
     languages: data.languages.map((l) => resolveLanguage(l, candidates)),
     courses: data.courses.map((c) => resolveCourse(c, candidates)),
     patents: data.patents.map((p) => resolvePatent(p, candidates)),
+    testScores: data.testScores.map((t) => resolveTestScore(t, candidates)),
+    recommendations: data.recommendations.map((r) => resolveRecommendation(r, candidates)),
     contact: data.contact,
     settings: data.settings,
     meta: data.meta,
@@ -1172,6 +1267,47 @@ function resolvePatent(patent, candidates) {
   if (patent.order !== void 0) out.order = patent.order;
   return out;
 }
+function resolveTestScore(testScore, candidates) {
+  const out = {
+    id: testScore.id,
+    title: pickLocalized(testScore.title, candidates) ?? "",
+    score: testScore.score,
+    date: testScore.date
+  };
+  const description = pickLocalized(testScore.description, candidates);
+  if (description !== void 0) out.description = description;
+  if (testScore.relatedEducationId !== void 0) {
+    out.relatedEducationId = testScore.relatedEducationId;
+  }
+  if (testScore.url !== void 0) out.url = testScore.url;
+  if (testScore.order !== void 0) out.order = testScore.order;
+  return out;
+}
+function resolveRecommendation(recommendation, candidates) {
+  const out = {
+    id: recommendation.id,
+    body: pickLocalized(recommendation.body, candidates) ?? "",
+    author: resolveRecommendationAuthor(recommendation.author, candidates)
+  };
+  const relationship = pickLocalized(recommendation.relationship, candidates);
+  if (relationship !== void 0) out.relationship = relationship;
+  if (recommendation.date !== void 0) out.date = recommendation.date;
+  if (recommendation.relatedCareerId !== void 0) {
+    out.relatedCareerId = recommendation.relatedCareerId;
+  }
+  if (recommendation.relatedEducationId !== void 0) {
+    out.relatedEducationId = recommendation.relatedEducationId;
+  }
+  if (recommendation.order !== void 0) out.order = recommendation.order;
+  return out;
+}
+function resolveRecommendationAuthor(author, candidates) {
+  const out = { name: author.name };
+  const headline = pickLocalized(author.headline, candidates);
+  if (headline !== void 0) out.headline = headline;
+  if (author.url !== void 0) out.url = author.url;
+  return out;
+}
 
 // src/jsonld.ts
 var SAMEAS_IDENTITY_TYPES = /* @__PURE__ */ new Set([
@@ -1572,8 +1708,40 @@ var v0_1_0_to_v0_2_0 = {
   }
 };
 
+// src/migrations/v0.2.0-to-v0.3.0.ts
+var v0_2_0_to_v0_3_0 = {
+  from: "0.2.0",
+  to: "0.3.0",
+  migrate(data) {
+    const partial = data;
+    return {
+      ...data,
+      schemaVersion: "0.3.0",
+      testScores: partial.testScores ?? []
+    };
+  }
+};
+
+// src/migrations/v0.3.0-to-v0.4.0.ts
+var v0_3_0_to_v0_4_0 = {
+  from: "0.3.0",
+  to: "0.4.0",
+  migrate(data) {
+    const partial = data;
+    return {
+      ...data,
+      schemaVersion: "0.4.0",
+      recommendations: partial.recommendations ?? []
+    };
+  }
+};
+
 // src/migrations/index.ts
-var migrations = [v0_1_0_to_v0_2_0];
+var migrations = [
+  v0_1_0_to_v0_2_0,
+  v0_2_0_to_v0_3_0,
+  v0_3_0_to_v0_4_0
+];
 
 // src/migrate.ts
 var MigrationError = class extends Error {
@@ -1621,7 +1789,7 @@ var ConflictError = class extends StorageError {
 };
 
 // src/index.ts
-var SCHEMA_VERSION = "0.2.0";
+var SCHEMA_VERSION = "0.4.0";
 export {
   ConflictError,
   ImportError,