@bunizao/contracts 0.12.0 → 0.13.0

package/dist/admin.d.ts

@@ -1,6 +1,6 @@
 import type { ClientFingerprint, CommentAuthAtWrite, CommentClaimMethod, CommentsMode, CommentStatus, CommentSurface, Interaction } from './comments';
 import type { MessageLocale, MessageState } from './messages';
-import type { DeliveryMode, NotifyAuditEventType, NotifyChannel, SubscriberRecord, SubscriberStatus } from './notify';
+import type { DeliveryMode, NotifyAuditEventType, NotifyChannel, SubscriberRecord, SubscriberStatus, SubscriptionSource } from './notify';
 export interface SubscriberChannelCount {
     total: number;
     pendingCount: number;
@@ -24,6 +24,8 @@ export interface SubscriberListResult {
     activeCount: number;
     unsubscribedCount: number;
     channelCounts?: SubscriberChannelCounts;
+    /** Acquisition counts, kept separate from the subscribed channels. */
+    acquisitionCounts?: Record<SubscriptionSource | 'unknown', SubscriberChannelCount>;
 }
 export interface AuditEntry {
     id: number;

package/dist/index.js

@@ -131,6 +131,7 @@ var MOOD_AI_MODELS = ["gpt-5.5", "gpt-5", "claude-sonnet-4.6"];
 var MOOD_COMMENT_ORIGINS = ["telegram", "web"];
 // src/notify.ts
 var NOTIFY_CHANNELS = ["mood", "blog", "privacy", "announcement"];
+var SUBSCRIPTION_SOURCES = ["desk", "blog", "mood"];
 // src/routes.ts
 var API_PREFIX = "/api";
 var HEALTH_PATH = "/health";
@@ -319,6 +320,7 @@ export {
   READER_RESEND_PATH,
   READER_VERIFY_OUTCOMES,
   READER_VERIFY_PATH,
+  SUBSCRIPTION_SOURCES,
   TELEGRAM_OPS_BASE_PATH,
   TELEGRAM_OPS_BROADCASTS_PATH,
   TELEGRAM_OPS_BROADCAST_CHANNELS,

package/dist/listening.d.ts

@@ -1,3 +1,18 @@
+/** Site playback totals in a rolling seven-day window, not Apple Music history. */
+export interface ListeningStats {
+    generatedAt: string;
+    window: {
+        from: string;
+        to: string;
+    };
+    totals: {
+        plays: number;
+    };
+    topArtist: {
+        name: string;
+        plays: number;
+    } | null;
+}
 export interface ListeningAccent {
     hue: number;
     chromaLight: number;

package/dist/notify.d.ts

@@ -4,6 +4,16 @@ export type DeliveryMode = 'immediate' | 'every_5h' | 'daily';
 export type NotifyChannel = 'mood' | 'blog' | 'privacy' | 'announcement';
 export type NotifyAuditEventType = 'subscribe_requested' | 'subscription_confirmed' | 'unsubscribed' | 'email_change_requested' | 'email_changed' | 'admin_create' | 'admin_update' | 'admin_delete' | 'admin_resend_confirm' | 'broadcast_sent';
 export declare const NOTIFY_CHANNELS: readonly NotifyChannel[];
+export declare const SUBSCRIPTION_SOURCES: readonly ['desk', 'blog', 'mood'];
+export type SubscriptionSource = (typeof SUBSCRIPTION_SOURCES)[number];
+/** Public counts of active, confirmed, deliverable email subscriptions. */
+export interface SubscriberCounts {
+    generatedAt: string;
+    channels: {
+        blog: number;
+        mood: number;
+    };
+}
 /** Optional risk evidence preserves compatibility with existing clients. */
 export interface SubscribeRequest extends ClientEvidence {
     email: string;
@@ -14,6 +24,8 @@ export interface SubscribeRequest extends ClientEvidence {
     dailyHour?: number;
     website?: string;
     dwellToken?: string;
+    /** First subscription surface. Unknown values are ignored by the server. */
+    source?: SubscriptionSource;
 }
 export interface SubscriberRecord {
     email: string;
@@ -32,6 +44,8 @@ export interface SubscriberRecord {
     updatedAt: string;
     confirmedAt?: string;
     lastConfirmSentAt?: string;
+    /** First recorded subscription surface; absent for historical subscribers. */
+    source?: SubscriptionSource;
 }
 export interface RetryRecord {
     postId: string;

package/dist/notify.js

@@ -1,5 +1,7 @@
 // src/notify.ts
 var NOTIFY_CHANNELS = ["mood", "blog", "privacy", "announcement"];
+var SUBSCRIPTION_SOURCES = ["desk", "blog", "mood"];
 export {
-  NOTIFY_CHANNELS
+  NOTIFY_CHANNELS,
+  SUBSCRIPTION_SOURCES
 };

package/package.json

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