@bunizao/contracts 0.20.0 → 0.21.0

package/dist/analytics.d.ts

@@ -210,7 +210,7 @@ export declare const SITE_ANALYTICS_COLLECT_ENDPOINT: '/api/analytics/collect';
 export declare const SITE_ANALYTICS_REPORT_ENDPOINT: '/api/analytics/site';
 export declare const SITE_ANALYTICS_ENGAGED_DWELL_MS = 10000;
 export declare const SITE_ANALYTICS_SESSION_IDLE_MS: number;
-export declare const SITE_ANALYTICS_SURFACES: readonly ['home', 'legacy', 'not_found', 'blog_index', 'blog_tags', 'blog_tag', 'blog_post', 'mood_feed', 'mood_post', 'mood_embed', 'projects', 'message', 'privacy', 'subscribe_manage', 'reader', 'docs', 'components', 'other'];
+export declare const SITE_ANALYTICS_SURFACES: readonly ['home', 'legacy', 'not_found', 'blog_index', 'blog_tags', 'blog_tag', 'blog_post', 'mood_feed', 'mood_post', 'mood_embed', 'mood_year', 'projects', 'message', 'privacy', 'subscribe_manage', 'reader', 'docs', 'components', 'other'];
 export type SiteAnalyticsSurface = typeof SITE_ANALYTICS_SURFACES[number];
 export type SiteAnalyticsClickKind = 'link_internal' | 'link_outbound' | 'button' | 'panel';
 export type SiteAnalyticsTrafficClass = 'human' | 'bot' | 'owner';

package/dist/analytics.js

@@ -25,6 +25,7 @@ var SITE_ANALYTICS_SURFACES = [
   "mood_feed",
   "mood_post",
   "mood_embed",
+  "mood_year",
   "projects",
   "message",
   "privacy",

package/dist/index.d.ts

@@ -2,7 +2,6 @@ export * from './analytics';
 export * from './admin';
 export * from './comments';
 export * from './content';
-export * from './desk';
 export * from './instagram';
 export * from './listening';
 export * from './messages';

package/dist/index.js

@@ -25,6 +25,7 @@ var SITE_ANALYTICS_SURFACES = [
   "mood_feed",
   "mood_post",
   "mood_embed",
+  "mood_year",
   "projects",
   "message",
   "privacy",
@@ -144,12 +145,6 @@ function parsePostLocaleTag(tagName) {
   }
   return canonicalSlug ? { locale, canonicalSlug } : { locale };
 }
-// src/desk.ts
-var DESK_MAC_STATES = ["on", "locked", "sleeping", "paused"];
-var DESK_REPORT_VERSION = 1;
-var DESK_PRESENCE_STATES = ["awake", "idle", "asleep", "offline"];
-var DESK_SKIES = ["clear", "cloudy", "fog", "drizzle", "rain", "snow", "storm"];
-var DESK_LIVE_FULL_CLOSE_CODE = 1013;
 // src/messages.ts
 var MESSAGE_LOCALES = ["zh", "en"];
 var MESSAGE_MIN_BODY_LENGTH = 2;
@@ -159,6 +154,26 @@ var MESSAGE_STATES = ["new", "read", "replied", "archived", "spam"];
 // src/mood.ts
 var MOOD_SENTIMENT_LABELS = ["joy", "calm", "melancholy", "anger", "anxiety", "neutral"];
 var MOOD_AI_MODELS = ["gpt-5.5", "gpt-5", "claude-sonnet-4.6"];
+var MOOD_TOPICS = [
+  { id: "food-drink", zh: "饮食", en: "Food & Drink" },
+  { id: "shopping-style", zh: "消费穿搭", en: "Shopping & Style" },
+  { id: "money-finance", zh: "金融理财", en: "Money & Finance" },
+  { id: "study-school", zh: "学业", en: "Study & School" },
+  { id: "devices", zh: "数码设备", en: "Devices" },
+  { id: "apps-services", zh: "软件服务", en: "Apps & Services" },
+  { id: "ai", zh: "人工智能", en: "AI" },
+  { id: "coding", zh: "编程开发", en: "Coding & Dev" },
+  { id: "music", zh: "音乐", en: "Music" },
+  { id: "media-entertainment", zh: "影视游戏", en: "Media & Games" },
+  { id: "internet-culture", zh: "网络文化", en: "Internet Culture" },
+  { id: "friends", zh: "朋友社交", en: "Friends & Social" },
+  { id: "romance", zh: "恋爱情感", en: "Romance" },
+  { id: "self-feelings", zh: "自我心境", en: "Self & Feelings" },
+  { id: "reflections", zh: "感悟观点", en: "Reflections & Views" },
+  { id: "health-sleep", zh: "健康睡眠", en: "Health & Sleep" },
+  { id: "travel", zh: "出行旅行", en: "Travel & Transport" },
+  { id: "daily-life", zh: "日常生活", en: "Daily Life" }
+];
 var MOOD_COMMENT_ORIGINS = ["telegram", "web"];
 // src/notify.ts
 var NOTIFY_CHANNELS = ["mood", "blog", "privacy", "announcement"];
@@ -178,13 +193,6 @@ var MOOD_SEARCH_PATH = "/v2/mood/search";
 var MOOD_IMAGE_PROXY_BASE_PATH = "/v2/images";
 var MOOD_MEDIA_PROXY_BASE_PATH = "/v2/media";
 var LISTENING_PATH = "/v2/listening";
-var DESK_PATH = "/v2/desk";
-var DESK_LIVE_PATH = "/v2/desk/live";
-var DESK_REPORT_PATH = "/v2/desk/report";
-var DESK_ICONS_PATH = "/v2/desk/icons";
-function deskIconPath(hash) {
-  return `${DESK_ICONS_PATH}/${hash}`;
-}
 var INSTAGRAM_PROFILE_PATH = "/v2/instagram";
 var INSTAGRAM_AVATAR_PATH = "/v2/instagram/avatar";
 var COMMENTS_PATH = "/v2/comments";
@@ -297,15 +305,6 @@ export {
   CONTENT_DOCUMENT_SOURCES,
   DEFAULT_COMMENT_POLICY,
   DEFAULT_REACTION_EMOJI,
-  DESK_ICONS_PATH,
-  DESK_LIVE_FULL_CLOSE_CODE,
-  DESK_LIVE_PATH,
-  DESK_MAC_STATES,
-  DESK_PATH,
-  DESK_PRESENCE_STATES,
-  DESK_REPORT_PATH,
-  DESK_REPORT_VERSION,
-  DESK_SKIES,
   EVENT_STATUSES,
   GHOST_WEBHOOK_PATH,
   HEALTH_PATH,
@@ -339,6 +338,7 @@ export {
   MOOD_PUBLIC_FEED_PATH,
   MOOD_SEARCH_PATH,
   MOOD_SENTIMENT_LABELS,
+  MOOD_TOPICS,
   MUSICKIT_TOKEN_PATH,
   NEWSLETTER_ANALYTICS_CLICK_ENDPOINT,
   NEWSLETTER_ANALYTICS_OPEN_ENDPOINT,
@@ -394,7 +394,6 @@ export {
   avatarClass,
   commentAnchorToken,
   commentPolicyFromTags,
-  deskIconPath,
   isAvatarSeed,
   parsePostLocaleTag,
   seedInClass,

package/dist/mood.d.ts

@@ -12,6 +12,82 @@ export declare const MOOD_SENTIMENT_LABELS: readonly ['joy', 'calm', 'melancholy
 export declare const MOOD_AI_MODELS: readonly ['gpt-5.5', 'gpt-5', 'claude-sonnet-4.6'];
 export type MoodSentimentLabel = (typeof MOOD_SENTIMENT_LABELS)[number];
 export type MoodAiModel = string;
+/** The fixed topic list of the per-post AI pass, with display labels. An id
+    is stable: renaming one splits its yearly history. */
+export declare const MOOD_TOPICS: readonly [{
+    readonly id: 'food-drink';
+    readonly zh: '饮食';
+    readonly en: 'Food & Drink';
+}, {
+    readonly id: 'shopping-style';
+    readonly zh: '消费穿搭';
+    readonly en: 'Shopping & Style';
+}, {
+    readonly id: 'money-finance';
+    readonly zh: '金融理财';
+    readonly en: 'Money & Finance';
+}, {
+    readonly id: 'study-school';
+    readonly zh: '学业';
+    readonly en: 'Study & School';
+}, {
+    readonly id: 'devices';
+    readonly zh: '数码设备';
+    readonly en: 'Devices';
+}, {
+    readonly id: 'apps-services';
+    readonly zh: '软件服务';
+    readonly en: 'Apps & Services';
+}, {
+    readonly id: 'ai';
+    readonly zh: '人工智能';
+    readonly en: 'AI';
+}, {
+    readonly id: 'coding';
+    readonly zh: '编程开发';
+    readonly en: 'Coding & Dev';
+}, {
+    readonly id: 'music';
+    readonly zh: '音乐';
+    readonly en: 'Music';
+}, {
+    readonly id: 'media-entertainment';
+    readonly zh: '影视游戏';
+    readonly en: 'Media & Games';
+}, {
+    readonly id: 'internet-culture';
+    readonly zh: '网络文化';
+    readonly en: 'Internet Culture';
+}, {
+    readonly id: 'friends';
+    readonly zh: '朋友社交';
+    readonly en: 'Friends & Social';
+}, {
+    readonly id: 'romance';
+    readonly zh: '恋爱情感';
+    readonly en: 'Romance';
+}, {
+    readonly id: 'self-feelings';
+    readonly zh: '自我心境';
+    readonly en: 'Self & Feelings';
+}, {
+    readonly id: 'reflections';
+    readonly zh: '感悟观点';
+    readonly en: 'Reflections & Views';
+}, {
+    readonly id: 'health-sleep';
+    readonly zh: '健康睡眠';
+    readonly en: 'Health & Sleep';
+}, {
+    readonly id: 'travel';
+    readonly zh: '出行旅行';
+    readonly en: 'Travel & Transport';
+}, {
+    readonly id: 'daily-life';
+    readonly zh: '日常生活';
+    readonly en: 'Daily Life';
+}];
+export type MoodTopicId = (typeof MOOD_TOPICS)[number]['id'];
 export interface MoodSentiment {
     label: MoodSentimentLabel;
     score: number;
@@ -42,6 +118,42 @@ export interface MoodStatsSnapshot {
     };
     generatedAt: string;
 }
+/** One local day (the owner's Melbourne clock) of the owner's own posts. */
+export interface MoodYearDay {
+    /** YYYY-MM-DD. */
+    date: string;
+    posts: number;
+    /** Mean sentiment score of the day's analysed posts that carry a feeling
+        (score not 0), -1 (cold) to 1 (warm), two decimals; null when none does. */
+    temperature: number | null;
+}
+export interface MoodYearTopic {
+    /** A MoodTopicId, kept as string: a snapshot can outlive a vocabulary change. */
+    topic: string;
+    count: number;
+}
+export interface MoodYearWord {
+    word: string;
+    count: 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. */
+export interface MoodYear {
+    year: number;
+    /** Every year with posts, ascending. */
+    years: number[];
+    posts: number;
+    /** Posts the AI pass has read; sentiment, topics and words cover only these. */
+    analyzed: number;
+    /** Days with at least one post, ascending; empty days are absent. */
+    days: MoodYearDay[];
+    sentiment: Record<MoodSentimentLabel, number>;
+    /** Most frequent first. */
+    topics: MoodYearTopic[];
+    /** Word-cloud keywords, most frequent first, at most 120. */
+    words: MoodYearWord[];
+    generatedAt: string;
+}
 export interface MoodAiConfig {
     primary: MoodAiModel;
     fallback: MoodAiModel;
@@ -68,6 +180,7 @@ export interface MoodIngestHealth {
     coverage: {
         sentiment: MoodCoverageSummary;
         tags: MoodCoverageSummary;
+        topics: MoodCoverageSummary;
     };
     replyIntegrity: {
         edges: number;
@@ -83,6 +196,7 @@ export interface MoodSearchResult {
     datetime: string;
     snippet: string;
     tags: string[];
+    topics: string[];
     sentiment_label: MoodSentimentLabel | null;
 }
 export interface MoodSearchResponse {

package/dist/mood.js

@@ -1,9 +1,30 @@
 // src/mood.ts
 var MOOD_SENTIMENT_LABELS = ["joy", "calm", "melancholy", "anger", "anxiety", "neutral"];
 var MOOD_AI_MODELS = ["gpt-5.5", "gpt-5", "claude-sonnet-4.6"];
+var MOOD_TOPICS = [
+  { id: "food-drink", zh: "饮食", en: "Food & Drink" },
+  { id: "shopping-style", zh: "消费穿搭", en: "Shopping & Style" },
+  { id: "money-finance", zh: "金融理财", en: "Money & Finance" },
+  { id: "study-school", zh: "学业", en: "Study & School" },
+  { id: "devices", zh: "数码设备", en: "Devices" },
+  { id: "apps-services", zh: "软件服务", en: "Apps & Services" },
+  { id: "ai", zh: "人工智能", en: "AI" },
+  { id: "coding", zh: "编程开发", en: "Coding & Dev" },
+  { id: "music", zh: "音乐", en: "Music" },
+  { id: "media-entertainment", zh: "影视游戏", en: "Media & Games" },
+  { id: "internet-culture", zh: "网络文化", en: "Internet Culture" },
+  { id: "friends", zh: "朋友社交", en: "Friends & Social" },
+  { id: "romance", zh: "恋爱情感", en: "Romance" },
+  { id: "self-feelings", zh: "自我心境", en: "Self & Feelings" },
+  { id: "reflections", zh: "感悟观点", en: "Reflections & Views" },
+  { id: "health-sleep", zh: "健康睡眠", en: "Health & Sleep" },
+  { id: "travel", zh: "出行旅行", en: "Travel & Transport" },
+  { id: "daily-life", zh: "日常生活", en: "Daily Life" }
+];
 var MOOD_COMMENT_ORIGINS = ["telegram", "web"];
 export {
   MOOD_AI_MODELS,
   MOOD_COMMENT_ORIGINS,
-  MOOD_SENTIMENT_LABELS
+  MOOD_SENTIMENT_LABELS,
+  MOOD_TOPICS
 };

package/dist/routes.d.ts

@@ -12,13 +12,6 @@ export declare const MOOD_SEARCH_PATH: '/v2/mood/search';
 export declare const MOOD_IMAGE_PROXY_BASE_PATH: '/v2/images';
 export declare const MOOD_MEDIA_PROXY_BASE_PATH: '/v2/media';
 export declare const LISTENING_PATH: '/v2/listening';
-export declare const DESK_PATH: '/v2/desk';
-/** WebSocket upgrade; the server pushes DeskLive messages. */
-export declare const DESK_LIVE_PATH: '/v2/desk/live';
-export declare const DESK_REPORT_PATH: '/v2/desk/report';
-/** PUT (owner-signed) and GET an app icon PNG by its sha256: `${DESK_ICONS_PATH}/<hash>`. */
-export declare const DESK_ICONS_PATH: '/v2/desk/icons';
-export declare function deskIconPath(hash: string): string;
 export declare const INSTAGRAM_PROFILE_PATH: '/v2/instagram';
 export declare const INSTAGRAM_AVATAR_PATH: '/v2/instagram/avatar';
 export declare const COMMENTS_PATH: '/v2/comments';

package/dist/routes.js

@@ -13,13 +13,6 @@ var MOOD_SEARCH_PATH = "/v2/mood/search";
 var MOOD_IMAGE_PROXY_BASE_PATH = "/v2/images";
 var MOOD_MEDIA_PROXY_BASE_PATH = "/v2/media";
 var LISTENING_PATH = "/v2/listening";
-var DESK_PATH = "/v2/desk";
-var DESK_LIVE_PATH = "/v2/desk/live";
-var DESK_REPORT_PATH = "/v2/desk/report";
-var DESK_ICONS_PATH = "/v2/desk/icons";
-function deskIconPath(hash) {
-  return `${DESK_ICONS_PATH}/${hash}`;
-}
 var INSTAGRAM_PROFILE_PATH = "/v2/instagram";
 var INSTAGRAM_AVATAR_PATH = "/v2/instagram/avatar";
 var COMMENTS_PATH = "/v2/comments";
@@ -52,10 +45,6 @@ export {
   API_PREFIX,
   COMMENTS_PATH,
   COMMENT_PATH_PREFIX,
-  DESK_ICONS_PATH,
-  DESK_LIVE_PATH,
-  DESK_PATH,
-  DESK_REPORT_PATH,
   GHOST_WEBHOOK_PATH,
   HEALTH_PATH,
   INSTAGRAM_AVATAR_PATH,
@@ -92,6 +81,5 @@ export {
   READER_PREFERENCES_PATH,
   READER_RESEND_PATH,
   READER_VERIFY_PATH,
-  TELEGRAM_WEBHOOK_PATH,
-  deskIconPath
+  TELEGRAM_WEBHOOK_PATH
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunizao/contracts",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Shared TypeScript contracts for buxx.me services and clients.",
   "type": "module",
   "sideEffects": false,
@@ -48,11 +48,6 @@
       "import": "./dist/content.js",
       "default": "./dist/content.js"
     },
-    "./desk": {
-      "types": "./dist/desk.d.ts",
-      "import": "./dist/desk.js",
-      "default": "./dist/desk.js"
-    },
     "./instagram": {
       "types": "./dist/instagram.d.ts",
       "import": "./dist/instagram.js",

package/dist/desk.d.ts

@@ -1,78 +0,0 @@
-/** Mac power state as the reporter sees it. */
-export declare const DESK_MAC_STATES: readonly ['on', 'locked', 'sleeping', 'paused'];
-export type DeskMacState = (typeof DESK_MAC_STATES)[number];
-/**
- * An app on the desk. `label` is at most 24 letters, digits, spaces and dots;
- * site-api turns anything else into "something else". `icon` is the
- * lowercase hex sha256 of a PNG (at most 128 px a side) already uploaded to
- * deskIconPath(icon), or null.
- */
-export interface DeskApp {
-    label: string;
-    icon: string | null;
-}
-/** Report body version the reporter sends; site-api rejects any other. */
-export declare const DESK_REPORT_VERSION = 1;
-/**
- * Body of the owner-only, HMAC-signed POST to DESK_REPORT_PATH. The server
- * ignores a report whose sentAt is not newer than the stored one, and
- * computes expiry from its own clock plus ttl.
- */
-export interface DeskReport {
-    v: typeof DESK_REPORT_VERSION;
-    /** Reporter clock, epoch milliseconds. Only used for ordering. */
-    sentAt: number;
-    mac: DeskMacState;
-    /** Seconds since the last keyboard or pointer input. */
-    idleSeconds: number;
-    /** True while an app holds a display-sleep assertion (video, a call). */
-    screenHeld: boolean;
-    /** Apps in use, most active first; `other` for an unlisted one. Never window titles or bundle ids. */
-    apps: DeskApp[];
-    /** IANA zone of the Mac, e.g. Australia/Melbourne. */
-    timeZone: string;
-    /** Seconds this report stays valid without a successor. */
-    ttl: number;
-}
-export declare const DESK_PRESENCE_STATES: readonly ['awake', 'idle', 'asleep', 'offline'];
-export type DeskPresenceState = (typeof DESK_PRESENCE_STATES)[number];
-export declare const DESK_SKIES: readonly ['clear', 'cloudy', 'fog', 'drizzle', 'rain', 'snow', 'storm'];
-export type Sky = (typeof DESK_SKIES)[number];
-export interface DeskPresence {
-    state: DeskPresenceState;
-    /** Empty unless awake or idle; an unlisted app reads "something else" with no icon. */
-    apps: DeskApp[];
-    /** Seconds of lease left when computed; null when offline or asleep. */
-    validFor: number | null;
-}
-export interface DeskPlace {
-    /** IANA zone the clock shows; the last pushed zone, or the default. */
-    timeZone: string;
-    /** City named by the zone; null when the zone names none (e.g. UTC). */
-    city: string | null;
-}
-export interface DeskWeather {
-    /** Degrees Celsius, rounded. */
-    temperature: number;
-    sky: Sky;
-    /** Daylight at the place right now. */
-    day: boolean;
-}
-/** Response of GET DESK_PATH. Fields are only ever added. */
-export interface DeskNow {
-    presence: DeskPresence;
-    place: DeskPlace;
-    /** Null when the weather source is unavailable. */
-    weather: DeskWeather | null;
-}
-/** Close code the live socket uses when it is full; poll instead. */
-export declare const DESK_LIVE_FULL_CLOSE_CODE = 1013;
-/**
- * Message the live socket at DESK_LIVE_PATH sends on connect and whenever
- * presence or place changes. Weather is not pushed; read it from DESK_PATH.
- * The socket answers the text `ping` with `pong`. Fields are only ever added.
- */
-export interface DeskLive {
-    presence: DeskPresence;
-    place: DeskPlace;
-}

package/dist/desk.js

@@ -1,13 +0,0 @@
-// src/desk.ts
-var DESK_MAC_STATES = ["on", "locked", "sleeping", "paused"];
-var DESK_REPORT_VERSION = 1;
-var DESK_PRESENCE_STATES = ["awake", "idle", "asleep", "offline"];
-var DESK_SKIES = ["clear", "cloudy", "fog", "drizzle", "rain", "snow", "storm"];
-var DESK_LIVE_FULL_CLOSE_CODE = 1013;
-export {
-  DESK_LIVE_FULL_CLOSE_CODE,
-  DESK_MAC_STATES,
-  DESK_PRESENCE_STATES,
-  DESK_REPORT_VERSION,
-  DESK_SKIES
-};