@southwind-ai/shared 0.1.2 → 0.2.1

package/index.ts

@@ -4,8 +4,10 @@ export * from "./src/data-governance.js";
 export * from "./src/feature.js";
 export * from "./src/license.js";
 export * from "./src/license-catalog.js";
+export * from "./src/json.js";
 export * from "./src/migration.js";
 export * from "./src/migration-bundle-validation.js";
+export * from "./src/mcp.js";
 export * from "./src/module-configuration.js";
 export * from "./src/correlation.js";
 export * from "./src/notification.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/shared",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/src/audit.ts

@@ -145,11 +145,36 @@ export const AUDIT_ACTION_DEFINITIONS = [
     label: "通知发布",
     description: "发布站内通知。",
   },
+  {
+    key: "notification.schedule",
+    label: "通知定时发布",
+    description: "创建等待调度器发布的通知。",
+  },
+  {
+    key: "notification.preference.update",
+    label: "通知偏好更新",
+    description: "用户更新外部通知渠道和分类偏好。",
+  },
+  {
+    key: "notification.update",
+    label: "通知修改",
+    description: "修改已发布通知并保留版本历史。",
+  },
   {
     key: "notification.read",
     label: "通知已读",
     description: "用户阅读站内通知。",
   },
+  {
+    key: "notification.favorite",
+    label: "收藏通知",
+    description: "用户收藏可见的站内通知。",
+  },
+  {
+    key: "notification.unfavorite",
+    label: "取消收藏通知",
+    description: "用户取消收藏可见的站内通知。",
+  },
   {
     key: "notification.archive",
     label: "通知归档",

package/src/json.ts

@@ -0,0 +1,8 @@
+export type JsonPrimitive = string | number | boolean | null;
+
+export type JsonValue =
+  | JsonPrimitive
+  | JsonValue[]
+  | { [key: string]: JsonValue };
+
+export type JsonObject = { [key: string]: JsonValue };

package/src/mcp.ts

@@ -0,0 +1,7 @@
+export const MCP_ROUTE_PATH = "/mcp";
+export const MCP_API_PATH = `/api${MCP_ROUTE_PATH}`;
+
+export const MCP_SERVER_INFO = {
+  name: "windy-platform",
+  version: "0.1.0",
+} as const;

package/src/module-configuration.ts

@@ -5,8 +5,11 @@ export type ModuleConfigApplyStatus =
   | "applying"
   | "effective"
   | "failed"
+  | "pending-restart"
   | "superseded";
 
+export type ModuleConfigApplyMode = "live" | "restart";
+
 export interface ModuleConfigDiffEntry {
   path: string;
   before?: ModuleConfigValue;
@@ -18,6 +21,7 @@ export interface ModuleConfigFieldDescriptor {
   label: string;
   description: string;
   input: "boolean" | "integer" | "text";
+  applyMode?: ModuleConfigApplyMode;
   minimum?: number;
   maximum?: number;
 }
@@ -42,6 +46,7 @@ export interface ModuleConfigSummary {
   label: string;
   fields: ModuleConfigFieldDescriptor[];
   effectiveValues: ModuleConfigValues;
+  pendingValues?: ModuleConfigValues;
   effectiveSource: "environment" | "version";
   effectiveVersion?: number;
   latestVersion?: number;

package/src/notification.ts

@@ -1,7 +1,14 @@
 import type { ISODateTime } from "./primitives.js";
 import type { TargetRef } from "./workflow.js";
 
-export type NotificationStatus = "published" | "archived";
+export type NotificationStatus = "scheduled" | "published" | "archived";
+export type ExternalNotificationChannel = "email" | "sms";
+export type NotificationDeliveryStatus =
+  | "pending"
+  | "processing"
+  | "retrying"
+  | "delivered"
+  | "dead";
 
 export interface PlatformNotification {
   id: string;
@@ -11,6 +18,7 @@ export interface PlatformNotification {
   category: string;
   status: NotificationStatus;
   publishedAt: ISODateTime;
+  scheduledFor?: ISODateTime;
   createdAt: ISODateTime;
   createdBy: string;
   updatedAt: ISODateTime;
@@ -19,13 +27,29 @@ export interface PlatformNotification {
   archivedBy?: string;
   target?: TargetRef;
   recipientUserId?: string;
+  recipientUserIds?: string[];
   recipientRoleCodes?: string[];
+  recipientDepartmentIds?: string[];
+  includeChildDepartments?: boolean;
+  deliveryChannels?: ExternalNotificationChannel[];
   sourceKey?: string;
+  revision: number;
 }
 
 export interface NotificationInboxItem extends PlatformNotification {
   read: boolean;
   readAt?: ISODateTime;
+  favorite: boolean;
+  favoritedAt?: ISODateTime;
+}
+
+export type NotificationReadFilter = "read" | "unread";
+
+export interface NotificationInboxFilters {
+  q?: string;
+  category?: string;
+  read?: NotificationReadFilter;
+  favorite?: boolean;
 }
 
 export interface PublishNotificationInput {
@@ -35,12 +59,79 @@ export interface PublishNotificationInput {
   category: string;
   target?: TargetRef;
   recipientUserId?: string;
+  recipientUserIds?: string[];
   recipientRoleCodes?: string[];
+  recipientDepartmentIds?: string[];
+  includeChildDepartments?: boolean;
+  deliveryChannels?: ExternalNotificationChannel[];
+  scheduledFor?: ISODateTime;
   sourceKey?: string;
 }
 
+export interface NotificationPreference {
+  userId: string;
+  enabledChannels: ExternalNotificationChannel[];
+  disabledCategories: string[];
+  updatedAt?: ISODateTime;
+}
+
+export type UpdateNotificationPreferenceInput = Pick<
+  NotificationPreference,
+  "enabledChannels" | "disabledCategories"
+>;
+
+export interface NotificationAudienceOption {
+  id: string;
+  label: string;
+  code?: string;
+}
+
+export interface NotificationAudienceOptions {
+  users: NotificationAudienceOption[];
+  roles: NotificationAudienceOption[];
+  departments: NotificationAudienceOption[];
+}
+
+export interface NotificationDelivery {
+  id: string;
+  notificationId: string;
+  userId: string;
+  channel: ExternalNotificationChannel;
+  status: NotificationDeliveryStatus;
+  attemptCount: number;
+  nextAttemptAt: ISODateTime;
+  deliveredAt?: ISODateTime;
+  lastErrorCode?: string;
+  createdAt: ISODateTime;
+  updatedAt: ISODateTime;
+}
+
+export type UpdateNotificationInput = Pick<
+  PublishNotificationInput,
+  "title" | "summary" | "content" | "category"
+>;
+
+export interface NotificationRevision extends UpdateNotificationInput {
+  notificationId: string;
+  revision: number;
+  editedAt: ISODateTime;
+  editedBy: string;
+}
+
+export interface UpdateNotificationResult {
+  notification: PlatformNotification;
+  changed: boolean;
+}
+
 export interface MarkNotificationReadResult {
   success: true;
   alreadyRead: boolean;
   readAt: ISODateTime;
 }
+
+export interface SetNotificationFavoriteResult {
+  success: true;
+  favorite: boolean;
+  changed: boolean;
+  favoritedAt?: ISODateTime;
+}

package/src/password.ts

@@ -1,4 +1,9 @@
-export const PASSWORD_POLICY = {
+export interface PasswordPolicy {
+  minLength: number;
+  maxLength: number;
+}
+
+export const PASSWORD_POLICY: Readonly<PasswordPolicy> = {
   minLength: 12,
   maxLength: 128,
-} as const;
+};

package/src/platform-settings.ts

@@ -2,17 +2,35 @@ export interface PlatformBrandingSettings {
   softwareName: string;
   logoUrl?: string;
   description?: string;
+  /** Runtime display timezone. It is managed by platform.runtime, not branding storage. */
+  timeZone?: string;
 }
 
+export const WATERMARK_DENSITIES = ["low", "medium", "high"] as const;
+export type WatermarkDensity = (typeof WATERMARK_DENSITIES)[number];
+
+export const WATERMARK_CONTENT_FIELDS = [
+  "username",
+  "displayName",
+  "phone",
+  "email",
+  "custom",
+] as const;
+export type WatermarkContentField = (typeof WATERMARK_CONTENT_FIELDS)[number];
+
 export interface PlatformWatermarkPolicy {
   enabled: boolean;
   businessPagesEnabled: boolean;
+  density: WatermarkDensity;
+  contentFields: WatermarkContentField[];
   customContent: string;
 }
 
 export const DEFAULT_PLATFORM_WATERMARK_POLICY: Readonly<PlatformWatermarkPolicy> =
   {
     enabled: true,
-    businessPagesEnabled: false,
+    businessPagesEnabled: true,
+    density: "medium",
+    contentFields: ["username", "displayName"],
     customContent: "",
   };