heartraite 1.0.199 → 1.0.200

package/dist/types/matchmaking.types.d.ts

@@ -1,8 +1,27 @@
 import { LikeType } from "../enum";
 import { UserProfile } from "./user.types";
+export type CategoryInsight = {
+    /** Matches a `CompatibilityCategory.categoryId` (values | personality | communication | lifestyle | love). */
+    categoryId: string;
+    /** Match-specific, LLM-generated insight for this category, in the generation locale. */
+    text: string;
+};
 export type CompatibilitySummary = {
     summary: string;
     highlights: string[];
+    /**
+     * Per-category, match-specific insight text — one entry per compatibility
+     * category, grounded in that category's score. Optional so records
+     * generated before this field still parse; consumers fall back to the
+     * static per-category description when an entry is missing.
+     */
+    categoryInsights?: CategoryInsight[];
+    /**
+     * Schema version of the generated summary. Absent on records generated
+     * before `categoryInsights` existed; lets callers tell text-less legacy
+     * summaries apart from freshly generated ones.
+     */
+    version?: number;
 };
 export type MatchAttributes = {
     distance?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "heartraite",
-  "version": "1.0.199",
+  "version": "1.0.200",
   "description": "Heartraite npm package for common functionality",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/types/matchmaking.types.ts

@@ -1,9 +1,29 @@
 import { LikeType } from "../enum";
 import { UserProfile } from "./user.types";
 
+export type CategoryInsight = {
+  /** Matches a `CompatibilityCategory.categoryId` (values | personality | communication | lifestyle | love). */
+  categoryId: string;
+  /** Match-specific, LLM-generated insight for this category, in the generation locale. */
+  text: string;
+};
+
 export type CompatibilitySummary = {
   summary: string;
   highlights: string[];
+  /**
+   * Per-category, match-specific insight text — one entry per compatibility
+   * category, grounded in that category's score. Optional so records
+   * generated before this field still parse; consumers fall back to the
+   * static per-category description when an entry is missing.
+   */
+  categoryInsights?: CategoryInsight[];
+  /**
+   * Schema version of the generated summary. Absent on records generated
+   * before `categoryInsights` existed; lets callers tell text-less legacy
+   * summaries apart from freshly generated ones.
+   */
+  version?: number;
 };
 
 export type MatchAttributes = {