@oj-module/runtime 0.1.15 → 0.1.17

package/dist/api/notify/index.d.ts

@@ -0,0 +1,17 @@
+import type { NoticeCategory, NoticeItem, PushBroadcastInput, PushInput } from "@oj-module/runtime/notify";
+export type { NoticeCategory, NoticeItem, PushBroadcastInput, PushInput, };
+/**
+ * 跨模块通知发射原语（前端侧 facade）。委托给已注册 notificationsApi provider 的
+ * 发射方法（经 HTTP 落到后端通知模块）。后端模块请改用 `api/src/_shared/notify`
+ * （直接 db 写入两表）——那是真正的服务端原语。
+ *
+ * 语义：原语不做任何业务判断（不判空间/角色/可见性），收件人过滤是发送方责任。
+ */
+export declare const notify: {
+    /** 给指定用户推一条按人通知，返回命名空间 id "u:<id>" */
+    push(input: PushInput): Promise<string>;
+    /** 广播一条通知（全员可见，一行存储），返回命名空间 id "b:<id>" */
+    pushBroadcast(input: PushBroadcastInput): Promise<string>;
+    /** 删除通知：按人项校验归属（非本人删自己）；广播项仅删本人回执 */
+    del(id: string, userId: string | number): Promise<void>;
+};

package/dist/index.d.ts

@@ -10,6 +10,7 @@
  * 由宿主的 importmap 提供，模块应直接 import 它们，不要从 runtime 转出。
  */
 import "./styles/index.css";
+export { notify } from "./api/notify";
 export * from "./api/system/menu";
 export * from "./api/system/role";
 export * from "./api/user";
@@ -45,5 +46,6 @@ export { getAllExpandedKeys } from "./utils/get-all-expanded-keys";
 export { getAppInfo } from "./utils/get-app-info";
 export { getRedirectPath } from "./utils/get-redirect-path";
 export * from "./utils/tree";
+export type { NoticeCategory, NoticeItem, PushBroadcastInput, PushInput, } from "@oj-module/runtime/notify";
 export { ErrorBoundary } from "react-error-boundary";
 export { z } from "zod";

package/dist/layout/widgets/notification/types.d.ts

@@ -1,9 +1,20 @@
+import type { NoticeCategory } from "@oj-module/runtime/notify";
 export interface NotificationItem {
-    /** 必填——单条已读/清空等写操作的前提（G4，破坏性变更，发版说明标注） */
-    id: string | number;
+    /**
+     * 必填——单条已读/清空等写操作的前提（G4）。现为命名空间串：
+     * "u:<id>" 按人（私信/@我），"b:<id>" 广播（通知/公告）。破坏性变更：由
+     * string|number 改为 string，发版说明标注（写操作须透传命名空间 id）。
+     */
+    id: string;
+    /** 数据来源：user=按人项，broadcast=广播项 */
+    scope: "user" | "broadcast";
     avatar: string;
     date: string;
     isRead?: boolean;
     message: string;
     title: string;
+    /** 深链：前端点击跳转 */
+    link?: string;
+    /** 消息类别：notice=通知/广播，pm=私信，mention=@我（占位） */
+    category?: NoticeCategory;
 }

package/dist/notify/index.d.ts

@@ -0,0 +1 @@
+export * from "./types.ts";

package/dist/notify/index.js

@@ -0,0 +1,7 @@
+// `@oj-module/runtime/notify` 物理子路径入口（与 contract 子路径同构）。
+//
+// 仅导出共享契约类型 —— 服务端原语不在 runtime 内，而是落在各 oj 工程的
+// api/src/_shared/notify（oj 后端按物理目录解析裸 specifier 且钳制在 api 项目根内，
+// 不能 import 本项目外的包；详见 packages/README 或设计文档 §4.3）。前端经此 facade
+// 取类型；后端直接 import 本地 _shared/notify 的实现。
+export * from "./types.js";

package/dist/notify/types.d.ts

@@ -0,0 +1,31 @@
+/** 消息类别：notice=通知/广播，pm=私信（按人），mention=@我（占位） */
+export type NoticeCategory = "notice" | "pm" | "mention";
+/** 铃展示项。id 为命名空间串："u:<id>" 按人 / "b:<id>" 广播 */
+export interface NoticeItem {
+    id: string;
+    scope: "user" | "broadcast";
+    avatar: string;
+    date: string;
+    isRead?: boolean;
+    message: string;
+    title: string;
+    link?: string;
+    category?: NoticeCategory;
+}
+/** 给指定用户推一条按人通知 */
+export interface PushInput {
+    userId: string | number;
+    title: string;
+    message: string;
+    link?: string;
+    avatar?: string;
+    category?: NoticeCategory;
+}
+/** 广播一条通知（全员可见，一行存储） */
+export interface PushBroadcastInput {
+    title: string;
+    message: string;
+    link?: string;
+    avatar?: string;
+    category?: NoticeCategory;
+}

package/dist/notify/types.js

@@ -0,0 +1,3 @@
+// 跨模块通知原语的公共类型（runtime 契约层）。后端模块 import 这些类型 +
+// api/src/_shared/notify（db 实现）；前端模块经 @oj-module/runtime 的 notify facade。
+export {};

package/dist/runtime.js

@@ -122,6 +122,36 @@ function unregisterApiProviders(moduleName) {
 var systemCurrent, notificationsCurrent, uploadCurrent, routesCurrent;
 var init_api_provider = __esmMin((() => {}));
 //#endregion
+//#region src/api/notify/index.ts
+init_api_provider();
+var NOT_REGISTERED = "NotificationsBackendNotRegistered";
+function requirePushProvider() {
+	const p = getNotificationsApiProvider();
+	if (!p || typeof p.push !== "function" || typeof p.pushBroadcast !== "function" || typeof p.del !== "function") throw new Error(`[notify] ${NOT_REGISTERED}：未注册 notificationsApi provider 的发射方法（push/pushBroadcast/del）。`);
+	return p;
+}
+/**
+* 跨模块通知发射原语（前端侧 facade）。委托给已注册 notificationsApi provider 的
+* 发射方法（经 HTTP 落到后端通知模块）。后端模块请改用 `api/src/_shared/notify`
+* （直接 db 写入两表）——那是真正的服务端原语。
+*
+* 语义：原语不做任何业务判断（不判空间/角色/可见性），收件人过滤是发送方责任。
+*/
+var notify = {
+	/** 给指定用户推一条按人通知，返回命名空间 id "u:<id>" */
+	push(input) {
+		return requirePushProvider().push(input);
+	},
+	/** 广播一条通知（全员可见，一行存储），返回命名空间 id "b:<id>" */
+	pushBroadcast(input) {
+		return requirePushProvider().pushBroadcast(input);
+	},
+	/** 删除通知：按人项校验归属（非本人删自己）；广播项仅删本人回执 */
+	del(id, userId) {
+		return requirePushProvider().del(id, userId);
+	}
+};
+//#endregion
 //#region src/router/extra-info/route-path.ts
 /**
 * 判断 pathname 是否为登录页（basename 感知，P0）。
@@ -225,10 +255,10 @@ function getAppInfo() {
 	return {
 		"pkg": {
 			"name": "@oj-module/runtime",
-			"version": "0.1.15",
+			"version": "0.1.17",
 			"license": "MIT"
 		},
-		"lastBuildTime": "2026-10-12 19:08:32"
+		"lastBuildTime": "2026-10-13 22:01:51"
 	};
 }
 var init_get_app_info = __esmMin((() => {}));
@@ -4429,6 +4459,7 @@ var init_notification = __esmMin((() => {
 		const handleClick = (item) => {
 			if (readOnly) return;
 			onEventChange && onEventChange("read", item);
+			if (item.link) window.open(item.link, "_blank", "noopener");
 		};
 		dot = useMemo(() => {
 			return !!notifications?.filter((item) => !item?.isRead).length;
@@ -27416,4 +27447,4 @@ init_ri();
 init_menu_icons();
 init_tree();
 //#endregion
-export { AccessControl, AccessControlRoles, AntdApp, BasicButton, BasicContent, BasicTable, EmbeddedIcon, ErrorBoundary, ExternalIcon, FormAvatarItem, FormTreeItem, Iframe, LayoutCenterIcon, LayoutEffects, LayoutLeftIcon, LayoutRightIcon, MixedNavigationIcon, OutsidePageIcon, PageError, ProfileCardIcon, RiAccountCircleLine, RiContrastFill, RiFullscreenExitLine, RiFullscreenLine, RiMailCheckLine, RiMoonIcon, RiReactjsLine, RiSunIcon, RiUserSettingsLine, ServerErrorIcon, SideNavigationIcon, TopNavigationIcon, TwoColumnNavigationIcon, accessControlCodes, defineModule, fetchAddMenuItem, fetchAddRoleItem, fetchAsyncRoutes, fetchDeleteMenuItem, fetchDeleteRoleItem, fetchLogin, fetchLogout, fetchMenuByRoleId, fetchMenuList, fetchRefreshToken, fetchRoleList, fetchRoleMenu, fetchUpdateMenuItem, fetchUpdateRoleItem, fetchUserInfo, filterTree, getAllExpandedKeys, getAppInfo, getBooleanOptions, getModule, getModules, getRedirectPath, getRegisteredApiPrefix, getRegisteredStore, getRoutes, getYesNoOptions, handleTree, loadAll, mapTree, menuIcons, permissionPrefix, setupI18n, traverseTreeValues, unloadModule, useAccess, useAuthStore, usePreferences, useSlotNodes, useTabsStore, useUserStore, external_exports as z };
+export { AccessControl, AccessControlRoles, AntdApp, BasicButton, BasicContent, BasicTable, EmbeddedIcon, ErrorBoundary, ExternalIcon, FormAvatarItem, FormTreeItem, Iframe, LayoutCenterIcon, LayoutEffects, LayoutLeftIcon, LayoutRightIcon, MixedNavigationIcon, OutsidePageIcon, PageError, ProfileCardIcon, RiAccountCircleLine, RiContrastFill, RiFullscreenExitLine, RiFullscreenLine, RiMailCheckLine, RiMoonIcon, RiReactjsLine, RiSunIcon, RiUserSettingsLine, ServerErrorIcon, SideNavigationIcon, TopNavigationIcon, TwoColumnNavigationIcon, accessControlCodes, defineModule, fetchAddMenuItem, fetchAddRoleItem, fetchAsyncRoutes, fetchDeleteMenuItem, fetchDeleteRoleItem, fetchLogin, fetchLogout, fetchMenuByRoleId, fetchMenuList, fetchRefreshToken, fetchRoleList, fetchRoleMenu, fetchUpdateMenuItem, fetchUpdateRoleItem, fetchUserInfo, filterTree, getAllExpandedKeys, getAppInfo, getBooleanOptions, getModule, getModules, getRedirectPath, getRegisteredApiPrefix, getRegisteredStore, getRoutes, getYesNoOptions, handleTree, loadAll, mapTree, menuIcons, notify, permissionPrefix, setupI18n, traverseTreeValues, unloadModule, useAccess, useAuthStore, usePreferences, useSlotNodes, useTabsStore, useUserStore, external_exports as z };

package/dist/store/api-provider.d.ts

@@ -1,3 +1,4 @@
+import type { PushBroadcastInput, PushInput } from "@oj-module/runtime/notify";
 import type { MenuItemType } from "../api/system/menu/types";
 import type { FetchAddRoleItemBody, FetchAddRoleItemData, FetchDeleteRoleItemBody, FetchDeleteRoleItemData, FetchMenuByRoleIdData, FetchMenuByRoleIdQuery, FetchRoleListData, FetchRoleListQuery, FetchRoleMenuData, FetchUpdateRoleItemBody, FetchUpdateRoleItemData } from "../api/system/role/client/api";
 import type { NotificationItem } from "../layout/widgets/notification/types";
@@ -26,14 +27,31 @@ export interface SystemApiProvider {
 }
 /**
  * 通知 provider（D9 + G4）：模块经 ctx.register.notificationsApi 接管通知。
- * 四方法全必填——「接管通知 API」是全量接管（读 + 三个写），不做部分托管；
- * 老 bundle 只有 fetchNotifications 的版本漂移由消费点运行时防御（评审 P2-7）。
+ *
+ * 定位澄清（Part A）：这是「铃的数据通道」——消费端（读 + 三个写），供前端通知铃
+ * 接管内置通知 API。**单一 provider 槽位、先到先得是「一个铃 / 一套端点」的事实，
+ * 不是模块竞争通知归属的特权**（与 authProvider 同规则：消费位独占合理）。
+ * 框架从未提供「给某用户发通知」的原语——跨模块发射请走 notify 发射方法（见下）
+ * 或后端 api/src/_shared/notify，而非各模块自建私有表抢这一个数据源。
+ *
+ * 消费端四方法全必填——「接管通知 API」是全量接管，不做部分托管；老 bundle 只有
+ * fetchNotifications 的版本漂移由消费点运行时防御（评审 P2-7）。
+ *
+ * 发射端三方法（跨模块原语）：显式 userId，前端 provider 经 HTTP 落到后端通知模块；
+ * 后端模块请直接用 api/src/_shared/notify（db 直写，绕开 HTTP）。原语不做任何业务
+ * 判断（不判空间/角色/可见性），收件人过滤是发送方责任。
  */
 export interface NotificationsApiProvider {
     fetchNotifications: () => Promise<NotificationItem[]>;
     markRead: (id: string | number) => Promise<void>;
     markAllRead: () => Promise<void>;
     clearAll: () => Promise<void>;
+    /** 给指定用户推按人通知，返回命名空间 id "u:<id>" */
+    push: (input: PushInput) => Promise<string>;
+    /** 广播通知（全员可见，一行存储），返回命名空间 id "b:<id>" */
+    pushBroadcast: (input: PushBroadcastInput) => Promise<string>;
+    /** 删通知：按人项校验归属；广播项仅删本人回执 */
+    del: (id: string, userId: string | number) => Promise<void>;
 }
 /** 上传 provider（D9）：模块经 ctx.register.uploadApi 接管头像/附件上传端点 */
 export interface UploadApiProvider {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oj-module/runtime",
   "type": "module",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "React Antd Admin 框架运行时，供模块工程消费",
   "license": "MIT",
   "imports": {
@@ -19,6 +19,10 @@
     "./contract/errors": {
       "types": "./dist/contract/errors.d.ts",
       "default": "./dist/contract/errors.js"
+    },
+    "./notify": {
+      "types": "./dist/notify/index.d.ts",
+      "default": "./dist/notify/index.js"
     }
   },
   "files": [
@@ -64,6 +68,6 @@
     "unplugin-icons": "^23.0.1"
   },
   "scripts": {
-    "build": "vite build && tsc -p tsconfig.contract.json && tsc -p tsconfig.dts.json && node scripts/rewrite-dts-specifiers.mjs && node scripts/inline-css.mjs"
+    "build": "vite build && tsc -p tsconfig.contract.json && tsc -p tsconfig.notify.json && tsc -p tsconfig.dts.json && node scripts/rewrite-dts-specifiers.mjs && node scripts/inline-css.mjs"
   }
 }