@bunizao/contracts 0.21.0 → 0.22.0

package/dist/index.js

@@ -174,6 +174,18 @@ var MOOD_TOPICS = [
   { id: "travel", zh: "出行旅行", en: "Travel & Transport" },
   { id: "daily-life", zh: "日常生活", en: "Daily Life" }
 ];
+var MOOD_TOPIC_GROUPS = [
+  { id: "ai", zh: "AI", en: "AI", topics: ["ai"] },
+  { id: "tech", zh: "数码与折腾", en: "Tech & Tinkering", topics: ["devices", "apps-services", "coding"] },
+  { id: "study", zh: "学习", en: "Study", topics: ["study-school"] },
+  { id: "food", zh: "吃喝", en: "Food & Drink", topics: ["food-drink"] },
+  { id: "money", zh: "钱与消费", en: "Money & Shopping", topics: ["money-finance", "shopping-style"] },
+  { id: "people", zh: "朋友与感情", en: "Friends & Love", topics: ["friends", "romance"] },
+  { id: "feelings", zh: "心情与想法", en: "Feelings & Thoughts", topics: ["self-feelings", "reflections"] },
+  { id: "health", zh: "身体与睡眠", en: "Health & Sleep", topics: ["health-sleep"] },
+  { id: "media", zh: "音乐与娱乐", en: "Music & Media", topics: ["music", "media-entertainment", "internet-culture"] },
+  { id: "life", zh: "生活与出行", en: "Daily Life & Travel", topics: ["daily-life", "travel"] }
+];
 var MOOD_COMMENT_ORIGINS = ["telegram", "web"];
 // src/notify.ts
 var NOTIFY_CHANNELS = ["mood", "blog", "privacy", "announcement"];
@@ -339,6 +351,7 @@ export {
   MOOD_SEARCH_PATH,
   MOOD_SENTIMENT_LABELS,
   MOOD_TOPICS,
+  MOOD_TOPIC_GROUPS,
   MUSICKIT_TOKEN_PATH,
   NEWSLETTER_ANALYTICS_CLICK_ENDPOINT,
   NEWSLETTER_ANALYTICS_OPEN_ENDPOINT,

package/dist/mood.d.ts

@@ -88,6 +88,61 @@ export declare const MOOD_TOPICS: readonly [{
     readonly en: 'Daily Life';
 }];
 export type MoodTopicId = (typeof MOOD_TOPICS)[number]['id'];
+/** How the yearly view counts topics: eighteen bars are too fine to read a
+    year by, so it shows these ten. Posts keep their MOOD_TOPICS ids; every id
+    sits in exactly one group. */
+export declare const MOOD_TOPIC_GROUPS: readonly [{
+    readonly id: 'ai';
+    readonly zh: 'AI';
+    readonly en: 'AI';
+    readonly topics: readonly ["ai"];
+}, {
+    readonly id: 'tech';
+    readonly zh: '数码与折腾';
+    readonly en: 'Tech & Tinkering';
+    readonly topics: readonly ["devices", "apps-services", "coding"];
+}, {
+    readonly id: 'study';
+    readonly zh: '学习';
+    readonly en: 'Study';
+    readonly topics: readonly ["study-school"];
+}, {
+    readonly id: 'food';
+    readonly zh: '吃喝';
+    readonly en: 'Food & Drink';
+    readonly topics: readonly ["food-drink"];
+}, {
+    readonly id: 'money';
+    readonly zh: '钱与消费';
+    readonly en: 'Money & Shopping';
+    readonly topics: readonly ["money-finance", "shopping-style"];
+}, {
+    readonly id: 'people';
+    readonly zh: '朋友与感情';
+    readonly en: 'Friends & Love';
+    readonly topics: readonly ["friends", "romance"];
+}, {
+    readonly id: 'feelings';
+    readonly zh: '心情与想法';
+    readonly en: 'Feelings & Thoughts';
+    readonly topics: readonly ["self-feelings", "reflections"];
+}, {
+    readonly id: 'health';
+    readonly zh: '身体与睡眠';
+    readonly en: 'Health & Sleep';
+    readonly topics: readonly ["health-sleep"];
+}, {
+    readonly id: 'media';
+    readonly zh: '音乐与娱乐';
+    readonly en: 'Music & Media';
+    readonly topics: readonly ["music", "media-entertainment", "internet-culture"];
+}, {
+    readonly id: 'life';
+    readonly zh: '生活与出行';
+    readonly en: 'Daily Life & Travel';
+    readonly topics: readonly ["daily-life", "travel"];
+}];
+export type MoodTopicGroupId = (typeof MOOD_TOPIC_GROUPS)[number]['id'];
 export interface MoodSentiment {
     label: MoodSentimentLabel;
     score: number;
@@ -128,13 +183,19 @@ export interface MoodYearDay {
     temperature: number | null;
 }
 export interface MoodYearTopic {
-    /** A MoodTopicId, kept as string: a snapshot can outlive a vocabulary change. */
-    topic: string;
+    /** A MoodTopicGroupId, kept as string: a snapshot can outlive a vocabulary change. */
+    group: string;
+    /** Analysed posts with at least one topic in the group. */
     count: number;
 }
 export interface MoodYearWord {
+    /** The spelling the year used most. */
     word: string;
+    /** Posts that name it. */
     count: number;
+    /** Message ids of the newest posts that name it, newest first, at most
+        five: where the word came from. */
+    posts: number[];
 }
 /** One calendar year of the owner's own words. Forwards are left out: they
     are someone else's mood. Built once a day into KV, never per request. */
@@ -148,9 +209,10 @@ export interface MoodYear {
     /** Days with at least one post, ascending; empty days are absent. */
     days: MoodYearDay[];
     sentiment: Record<MoodSentimentLabel, number>;
-    /** Most frequent first. */
+    /** Topic groups, most frequent first. */
     topics: MoodYearTopic[];
-    /** Word-cloud keywords, most frequent first, at most 120. */
+    /** Word-cloud keywords used on at least two days, most distinctive first,
+        at most 120. */
     words: MoodYearWord[];
     generatedAt: string;
 }

package/dist/mood.js

@@ -21,10 +21,23 @@ var MOOD_TOPICS = [
   { id: "travel", zh: "出行旅行", en: "Travel & Transport" },
   { id: "daily-life", zh: "日常生活", en: "Daily Life" }
 ];
+var MOOD_TOPIC_GROUPS = [
+  { id: "ai", zh: "AI", en: "AI", topics: ["ai"] },
+  { id: "tech", zh: "数码与折腾", en: "Tech & Tinkering", topics: ["devices", "apps-services", "coding"] },
+  { id: "study", zh: "学习", en: "Study", topics: ["study-school"] },
+  { id: "food", zh: "吃喝", en: "Food & Drink", topics: ["food-drink"] },
+  { id: "money", zh: "钱与消费", en: "Money & Shopping", topics: ["money-finance", "shopping-style"] },
+  { id: "people", zh: "朋友与感情", en: "Friends & Love", topics: ["friends", "romance"] },
+  { id: "feelings", zh: "心情与想法", en: "Feelings & Thoughts", topics: ["self-feelings", "reflections"] },
+  { id: "health", zh: "身体与睡眠", en: "Health & Sleep", topics: ["health-sleep"] },
+  { id: "media", zh: "音乐与娱乐", en: "Music & Media", topics: ["music", "media-entertainment", "internet-culture"] },
+  { id: "life", zh: "生活与出行", en: "Daily Life & Travel", topics: ["daily-life", "travel"] }
+];
 var MOOD_COMMENT_ORIGINS = ["telegram", "web"];
 export {
   MOOD_AI_MODELS,
   MOOD_COMMENT_ORIGINS,
   MOOD_SENTIMENT_LABELS,
-  MOOD_TOPICS
+  MOOD_TOPICS,
+  MOOD_TOPIC_GROUPS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunizao/contracts",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Shared TypeScript contracts for buxx.me services and clients.",
   "type": "module",
   "sideEffects": false,