@liujitcn/kratos-admin-system 0.0.21 → 0.0.23

package/dist/package/declarations/src/rpc/system/admin/v1/code_gen.d.ts

@@ -1,30 +1,30 @@
 import type { Empty } from "../../../google/protobuf/empty";
 /** 代码生成任务状态 */
 export declare enum CodeGenTaskStatus {
-    /** CODE_GEN_TASK_STATUS_UNSPECIFIED - 未指定 */
+    /** CODE_GEN_TASK_STATUS_UNSPECIFIED - 未指定代码生成任务状态。 */
     CODE_GEN_TASK_STATUS_UNSPECIFIED = 0,
-    /** CODE_GEN_TASK_STATUS_PENDING - 等待执行 */
+    /** CODE_GEN_TASK_STATUS_PENDING - 等待执行。 */
     CODE_GEN_TASK_STATUS_PENDING = 1,
-    /** CODE_GEN_TASK_STATUS_RUNNING - 正在执行 */
+    /** CODE_GEN_TASK_STATUS_RUNNING - 正在执行。 */
     CODE_GEN_TASK_STATUS_RUNNING = 2,
-    /** CODE_GEN_TASK_STATUS_SUCCEEDED - 执行成功 */
+    /** CODE_GEN_TASK_STATUS_SUCCEEDED - 执行成功。 */
     CODE_GEN_TASK_STATUS_SUCCEEDED = 3,
-    /** CODE_GEN_TASK_STATUS_FAILED - 执行失败 */
+    /** CODE_GEN_TASK_STATUS_FAILED - 执行失败。 */
     CODE_GEN_TASK_STATUS_FAILED = 4
 }
 /** 代码生成步骤状态 */
 export declare enum CodeGenTaskStepStatus {
-    /** CODE_GEN_TASK_STEP_STATUS_UNSPECIFIED - 未指定 */
+    /** CODE_GEN_TASK_STEP_STATUS_UNSPECIFIED - 未指定代码生成步骤状态。 */
     CODE_GEN_TASK_STEP_STATUS_UNSPECIFIED = 0,
-    /** CODE_GEN_TASK_STEP_STATUS_PENDING - 等待执行 */
+    /** CODE_GEN_TASK_STEP_STATUS_PENDING - 等待执行。 */
     CODE_GEN_TASK_STEP_STATUS_PENDING = 1,
-    /** CODE_GEN_TASK_STEP_STATUS_RUNNING - 正在执行 */
+    /** CODE_GEN_TASK_STEP_STATUS_RUNNING - 正在执行。 */
     CODE_GEN_TASK_STEP_STATUS_RUNNING = 2,
-    /** CODE_GEN_TASK_STEP_STATUS_SUCCEEDED - 执行成功 */
+    /** CODE_GEN_TASK_STEP_STATUS_SUCCEEDED - 执行成功。 */
     CODE_GEN_TASK_STEP_STATUS_SUCCEEDED = 3,
-    /** CODE_GEN_TASK_STEP_STATUS_FAILED - 执行失败 */
+    /** CODE_GEN_TASK_STEP_STATUS_FAILED - 执行失败。 */
     CODE_GEN_TASK_STEP_STATUS_FAILED = 4,
-    /** CODE_GEN_TASK_STEP_STATUS_SKIPPED - 无需处理 */
+    /** CODE_GEN_TASK_STEP_STATUS_SKIPPED - 无需处理。 */
     CODE_GEN_TASK_STEP_STATUS_SKIPPED = 5
 }
 /** 查询代码生成任务条件 */

package/dist/package/declarations/src/rpc/system/admin/v1/code_gen_table.d.ts

@@ -1,6 +1,16 @@
 import type { Empty } from "../../../google/protobuf/empty";
-import type { CodeGenTableStatus } from "../../common/v1/enum";
 import type { CodeGenLocaleConfig } from "./base_translation";
+/** 代码生成表状态。 */
+export declare enum CodeGenTableStatus {
+    /** CODE_GEN_TABLE_STATUS_UNSPECIFIED - 未指定代码生成表状态。 */
+    CODE_GEN_TABLE_STATUS_UNSPECIFIED = 0,
+    /** CODE_GEN_TABLE_STATUS_DRAFT - 草稿。 */
+    CODE_GEN_TABLE_STATUS_DRAFT = 1,
+    /** CODE_GEN_TABLE_STATUS_GENERATED - 已生成。 */
+    CODE_GEN_TABLE_STATUS_GENERATED = 2,
+    /** CODE_GEN_TABLE_STATUS_DISABLED - 停用。 */
+    CODE_GEN_TABLE_STATUS_DISABLED = 3
+}
 /** 代码生成表配置分页查询条件 */
 export interface PageCodeGenTableRequest {
     /** 业务表名 */

package/dist/package/declarations/src/rpc/system/admin/v1/common.d.ts

@@ -0,0 +1,13 @@
+/** 菜单类型。 */
+export declare enum BaseMenuType {
+    /** BASE_MENU_TYPE_UNSPECIFIED - 未指定菜单类型。 */
+    BASE_MENU_TYPE_UNSPECIFIED = 0,
+    /** BASE_MENU_TYPE_FOLDER - 目录。 */
+    BASE_MENU_TYPE_FOLDER = 1,
+    /** BASE_MENU_TYPE_MENU - 菜单。 */
+    BASE_MENU_TYPE_MENU = 2,
+    /** BASE_MENU_TYPE_BUTTON - 按钮。 */
+    BASE_MENU_TYPE_BUTTON = 3,
+    /** BASE_MENU_TYPE_EXT_LINK - 外部链接。 */
+    BASE_MENU_TYPE_EXT_LINK = 4
+}

package/dist/package/declarations/src/rpc/system/admin/v1/ops_monitoring.d.ts

@@ -0,0 +1,222 @@
+/** 运行信息查询条件。 */
+export interface GetOpsRuntimeRequest {
+}
+/** 流量查询条件。 */
+export interface GetOpsTrafficRequest {
+    /** 统计窗口，单位分钟 */
+    window_minutes: number;
+}
+/** 服务状态查询条件。 */
+export interface GetOpsServicesRequest {
+}
+/** 存储状态查询条件。 */
+export interface GetOpsStorageRequest {
+}
+/** 接口查询条件。 */
+export interface GetOpsEndpointsRequest {
+    /** 统计窗口，单位分钟 */
+    window_minutes: number;
+}
+/** 实例查询条件。 */
+export interface GetOpsNodesRequest {
+}
+/** 告警查询条件。 */
+export interface GetOpsAlertsRequest {
+    /** 统计窗口，单位分钟 */
+    window_minutes: number;
+}
+/** 流量响应。 */
+export interface OpsTrafficResponse {
+    /** 采集时间，RFC3339格式 */
+    collected_at: string;
+    /** 统计窗口，单位分钟 */
+    window_minutes: number;
+    /** 请求流量摘要 */
+    traffic: OpsTraffic | undefined;
+    /** 请求流量趋势 */
+    points: OpsTrafficPoint[];
+}
+/** 服务状态响应。 */
+export interface OpsServicesResponse {
+    /** 采集时间，RFC3339格式 */
+    collected_at: string;
+    /** 服务依赖状态 */
+    services: OpsServiceStatus[];
+}
+/** 存储状态响应。 */
+export interface OpsStorageResponse {
+    /** 采集时间，RFC3339格式 */
+    collected_at: string;
+    /** 数据存储状态 */
+    storage: OpsStorage[];
+}
+/** 接口摘要响应。 */
+export interface OpsEndpointsResponse {
+    /** 采集时间，RFC3339格式 */
+    collected_at: string;
+    /** 统计窗口，单位分钟 */
+    window_minutes: number;
+    /** 接口请求摘要 */
+    endpoints: OpsEndpoint[];
+}
+/** 实例状态响应。 */
+export interface OpsNodesResponse {
+    /** 采集时间，RFC3339格式 */
+    collected_at: string;
+    /** 实例资源状态 */
+    nodes: OpsNode[];
+}
+/** 告警响应。 */
+export interface OpsAlertsResponse {
+    /** 采集时间，RFC3339格式 */
+    collected_at: string;
+    /** 统计窗口，单位分钟 */
+    window_minutes: number;
+    /** 近期告警事件 */
+    alerts: OpsAlert[];
+}
+/** 当前进程运行信息。 */
+export interface OpsRuntime {
+    /** 服务名称 */
+    service_name: string;
+    /** 服务版本 */
+    version: string;
+    /** 主机名 */
+    hostname: string;
+    /** 运行环境 */
+    environment: string;
+    /** Go运行时版本 */
+    go_version: string;
+    /** 操作系统 */
+    os: string;
+    /** 系统架构 */
+    arch: string;
+    /** 启动时间，RFC3339格式 */
+    start_time: string;
+    /** 运行时长，单位秒 */
+    uptime_seconds: number;
+    /** 当前协程数量 */
+    goroutines: number;
+    /** 当前堆内存，单位字节 */
+    memory_alloc_bytes: number;
+    /** 进程向系统申请的内存，单位字节 */
+    memory_sys_bytes: number;
+}
+/** 请求流量摘要。 */
+export interface OpsTraffic {
+    /** 每秒请求数 */
+    qps: number;
+    /** P95响应延迟，单位毫秒 */
+    p95_latency_ms: number;
+    /** 错误率，百分比 */
+    error_rate: number;
+    /** 可用性，百分比 */
+    availability: number;
+    /** 窗口内请求数 */
+    request_count: number;
+}
+/** 请求流量趋势点。 */
+export interface OpsTrafficPoint {
+    /** 时间点，RFC3339格式 */
+    at: string;
+    /** 时间点每秒请求数 */
+    qps: number;
+    /** 时间点P95延迟，单位毫秒 */
+    p95_latency_ms: number;
+    /** QPS柱状图比例 */
+    qps_percent: number;
+    /** 延迟柱状图比例 */
+    latency_percent: number;
+}
+/** 服务或外部依赖状态。 */
+export interface OpsServiceStatus {
+    /** 服务名称 */
+    name: string;
+    /** 服务地址 */
+    address: string;
+    /** 状态：正常、未配置或异常 */
+    status: string;
+    /** 状态说明 */
+    message: string;
+    /** 探测耗时，单位毫秒 */
+    latency_ms: number;
+}
+/** 数据存储状态。 */
+export interface OpsStorage {
+    /** 存储名称 */
+    name: string;
+    /** 存储简称 */
+    short_name: string;
+    /** 存储地址 */
+    address: string;
+    /** 状态：正常、未配置或异常 */
+    status: string;
+    /** 存储指标 */
+    metrics: OpsMetric[];
+    /** 容量指标名称 */
+    capacity_label: string;
+    /** 容量使用百分比 */
+    capacity: number;
+}
+/** 存储或实例指标。 */
+export interface OpsMetric {
+    /** 指标名称 */
+    label: string;
+    /** 指标值 */
+    value: string;
+}
+/** 接口请求摘要。 */
+export interface OpsEndpoint {
+    /** 接口路径 */
+    route: string;
+    /** 每秒请求数 */
+    qps: number;
+    /** P95响应延迟，单位毫秒 */
+    p95_latency_ms: number;
+    /** 错误率，百分比 */
+    error_rate: number;
+    /** 接口状态 */
+    status: string;
+}
+/** 实例资源状态。 */
+export interface OpsNode {
+    /** 实例名称 */
+    name: string;
+    /** 实例资源指标 */
+    metrics: OpsNodeMetric[];
+}
+/** 实例资源指标。 */
+export interface OpsNodeMetric {
+    /** 指标名称 */
+    label: string;
+    /** 指标使用百分比 */
+    value: number;
+}
+/** 告警事件。 */
+export interface OpsAlert {
+    /** 告警标题 */
+    title: string;
+    /** 告警详情 */
+    detail: string;
+    /** 告警时间，RFC3339格式 */
+    at: string;
+    /** 告警状态 */
+    status: string;
+}
+/** 运维监控服务。 */
+export interface OpsMonitoringService {
+    /** 查询当前进程运行信息。 */
+    GetOpsRuntime(request: GetOpsRuntimeRequest): Promise<OpsRuntime>;
+    /** 查询请求流量与延迟趋势。 */
+    GetOpsTraffic(request: GetOpsTrafficRequest): Promise<OpsTrafficResponse>;
+    /** 查询服务和外部依赖状态。 */
+    GetOpsServices(request: GetOpsServicesRequest): Promise<OpsServicesResponse>;
+    /** 查询数据库和缓存状态。 */
+    GetOpsStorage(request: GetOpsStorageRequest): Promise<OpsStorageResponse>;
+    /** 查询接口请求摘要。 */
+    GetOpsEndpoints(request: GetOpsEndpointsRequest): Promise<OpsEndpointsResponse>;
+    /** 查询实例资源状态。 */
+    GetOpsNodes(request: GetOpsNodesRequest): Promise<OpsNodesResponse>;
+    /** 查询窗口内告警事件。 */
+    GetOpsAlerts(request: GetOpsAlertsRequest): Promise<OpsAlertsResponse>;
+}

package/dist/package/declarations/src/views/tool/ops-monitoring/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/src/api/base/ai_message.ts

@@ -22,7 +22,7 @@ export type AiMessageStreamOptions = {
 
 /** 从 direct stream 错误响应中提取后端业务提示。 */
 async function resolveStreamErrorMessage(response: Response): Promise<string> {
-  const fallbackMessage = t("system.ai.requestFailedWithStatus", { status: response.status });
+  const fallbackMessage = t("system.ai.request_failed_with_status", { status: response.status });
   const contentType = response.headers.get("Content-Type") ?? "";
   if (contentType.includes("application/json")) {
     try {
@@ -60,7 +60,7 @@ export async function SendAiMessageStream(request: SendAiMessageRequest, options
   // direct stream 不经过 axios 响应拦截器，需要在这里补齐登录失效处理。
   if (response.status === 401 || response.status === 403) {
     handleAuthExpired();
-    throw new Error(t("core.auth.sessionExpired"));
+    throw new Error(t("core.auth.session_expired"));
   }
   if (!response.ok) {
     throw new Error(await resolveStreamErrorMessage(response));

package/dist/package/src/api/system/base_language.ts

@@ -1,5 +1,4 @@
 import service from "@liujitcn/kratos-admin-core/request";
-import { defLanguageService } from "@liujitcn/kratos-admin-core";
 import { readonly, shallowRef } from "vue";
 import {
 	type BaseLanguage,
@@ -12,10 +11,10 @@ import {
   type OptionBaseLanguageResponse,
   type PageBaseLanguageRequest,
   type PageBaseLanguageResponse,
+  type SetBaseLanguagePrimaryRequest,
   type SetBaseLanguageStatusRequest,
   type UpdateBaseLanguageRequest
 } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_language";
-import { Status } from "@liujitcn/kratos-admin-system/rpc/common/v1/enum";
 import type { Empty } from "@liujitcn/kratos-admin-system/rpc/google/protobuf/empty";
 
 const BASE_LANGUAGE_URL = "/v1/admin/base/language";
@@ -82,6 +81,15 @@ export class BaseLanguageServiceImpl implements BaseLanguageService {
       data: request
     });
   }
+
+  /** 设置主语言。 */
+  SetBaseLanguagePrimary(request: SetBaseLanguagePrimaryRequest): Promise<Empty> {
+    return service<SetBaseLanguagePrimaryRequest, Empty>({
+      url: `${BASE_LANGUAGE_URL}/${request.id}/primary`,
+      method: "put",
+      data: request
+    });
+  }
 }
 
 export const defBaseLanguageService = new BaseLanguageServiceImpl();
@@ -97,20 +105,10 @@ export async function loadEnabledBaseLanguages(force = false): Promise<BaseLangu
   if (enabledBaseLanguagesRequest) return enabledBaseLanguagesRequest;
   if (!force && enabledBaseLanguages.value.length) return enabledBaseLanguages.value;
 
-  enabledBaseLanguagesRequest = defLanguageService
-    .GetLanguage({})
+  enabledBaseLanguagesRequest = defBaseLanguageService
+    .OptionBaseLanguage({ enabled_only: true })
     .then(response => {
-      const languages = (response.languages ?? []).map(item => ({
-        id: 0,
-        language_code: item.language_code,
-        language_name: item.language_name,
-        native_name: item.native_name,
-        sort: item.sort,
-        is_primary: item.language_code === response.primary_language_code,
-        status: Status.ENABLE,
-        created_at: "",
-        updated_at: ""
-      }));
+      const languages = response.base_languages ?? [];
       enabledBaseLanguages.value = languages;
       return languages;
     })

package/dist/package/src/api/system/base_translation.ts

@@ -1,22 +1,33 @@
 import service from "@liujitcn/kratos-admin-core/request";
+import type { Empty } from "@liujitcn/kratos-admin-system/rpc/google/protobuf/empty";
 import type {
   BaseTranslationService,
-  GenerateTranslationDraftRequest,
-  GenerateTranslationDraftResponse
+  DraftBaseTranslationRequest,
+  DraftBaseTranslationResponse,
+  UpdateBaseTranslationRequest
 } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_translation";
 
 const BASE_TRANSLATION_URL = "/v1/admin/base/translation";
 
-/** BaseTranslationServiceImpl Admin 动态翻译草稿服务。 */
+/** BaseTranslationServiceImpl Admin 单条动态翻译服务。 */
 export class BaseTranslationServiceImpl implements BaseTranslationService {
-  /** GenerateTranslationDraft 为已保存资源生成机器翻译草稿。 */
-  GenerateTranslationDraft(request: GenerateTranslationDraftRequest): Promise<GenerateTranslationDraftResponse> {
-    return service<GenerateTranslationDraftRequest, GenerateTranslationDraftResponse>({
+  /** DraftBaseTranslation 翻译请求中的单个文本。 */
+  DraftBaseTranslation(request: DraftBaseTranslationRequest): Promise<DraftBaseTranslationResponse> {
+    return service<DraftBaseTranslationRequest, DraftBaseTranslationResponse>({
       url: `${BASE_TRANSLATION_URL}/draft`,
       method: "post",
       data: request
     });
   }
+
+  /** UpdateBaseTranslation 修改或新增单条翻译信息。 */
+  UpdateBaseTranslation(request: UpdateBaseTranslationRequest): Promise<Empty> {
+    return service<UpdateBaseTranslationRequest, Empty>({
+      url: BASE_TRANSLATION_URL,
+      method: "put",
+      data: request
+    });
+  }
 }
 
 export const defBaseTranslationService = new BaseTranslationServiceImpl();

package/dist/package/src/api/system/ops_monitoring.ts

@@ -0,0 +1,88 @@
+import service from "@liujitcn/kratos-admin-core/request";
+import type {
+  GetOpsAlertsRequest,
+  GetOpsEndpointsRequest,
+  GetOpsNodesRequest,
+  GetOpsRuntimeRequest,
+  GetOpsServicesRequest,
+  GetOpsStorageRequest,
+  GetOpsTrafficRequest,
+  OpsAlertsResponse,
+  OpsEndpointsResponse,
+  OpsNodesResponse,
+  OpsRuntime,
+  OpsServicesResponse,
+  OpsStorageResponse,
+  OpsTrafficResponse,
+  OpsMonitoringService
+} from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/ops_monitoring";
+
+const OPS_MONITORING_URL = "/v1/admin/ops-monitoring";
+
+/** Admin运维监控服务。 */
+export class OpsMonitoringServiceImpl implements OpsMonitoringService {
+  /** 查询当前进程运行信息。 */
+  GetOpsRuntime(request: GetOpsRuntimeRequest): Promise<OpsRuntime> {
+    return service<GetOpsRuntimeRequest, OpsRuntime>({
+      url: `${OPS_MONITORING_URL}/runtime`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询请求流量与延迟趋势。 */
+  GetOpsTraffic(request: GetOpsTrafficRequest): Promise<OpsTrafficResponse> {
+    return service<GetOpsTrafficRequest, OpsTrafficResponse>({
+      url: `${OPS_MONITORING_URL}/traffic`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询服务和外部依赖状态。 */
+  GetOpsServices(request: GetOpsServicesRequest): Promise<OpsServicesResponse> {
+    return service<GetOpsServicesRequest, OpsServicesResponse>({
+      url: `${OPS_MONITORING_URL}/services`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询数据库和缓存状态。 */
+  GetOpsStorage(request: GetOpsStorageRequest): Promise<OpsStorageResponse> {
+    return service<GetOpsStorageRequest, OpsStorageResponse>({
+      url: `${OPS_MONITORING_URL}/storage`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询接口请求摘要。 */
+  GetOpsEndpoints(request: GetOpsEndpointsRequest): Promise<OpsEndpointsResponse> {
+    return service<GetOpsEndpointsRequest, OpsEndpointsResponse>({
+      url: `${OPS_MONITORING_URL}/endpoints`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询实例资源状态。 */
+  GetOpsNodes(request: GetOpsNodesRequest): Promise<OpsNodesResponse> {
+    return service<GetOpsNodesRequest, OpsNodesResponse>({
+      url: `${OPS_MONITORING_URL}/nodes`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询窗口内告警事件。 */
+  GetOpsAlerts(request: GetOpsAlertsRequest): Promise<OpsAlertsResponse> {
+    return service<GetOpsAlertsRequest, OpsAlertsResponse>({
+      url: `${OPS_MONITORING_URL}/alerts`,
+      method: "get",
+      params: request
+    });
+  }
+}
+
+export const defOpsMonitoringService = new OpsMonitoringServiceImpl();

package/dist/package/src/api/system/ops_monitoring_sse.ts

@@ -0,0 +1,49 @@
+import { subscribeSseEvent, type SseStop } from "../base/sse";
+import type {
+  OpsNodesResponse,
+  OpsServicesResponse,
+  OpsStorageResponse,
+  OpsTrafficResponse
+} from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/ops_monitoring";
+
+const OPS_MONITORING_SSE_STREAM = "system.admin.ops-monitoring";
+const OPS_MONITORING_SSE_TRAFFIC = "ops.traffic";
+const OPS_MONITORING_SSE_SERVICES = "ops.services";
+const OPS_MONITORING_SSE_STORAGE = "ops.storage";
+const OPS_MONITORING_SSE_NODES = "ops.nodes";
+
+/** 运维监控 SSE 取消订阅函数。 */
+export type OpsMonitoringSseStop = SseStop;
+
+/** 订阅运维监控流量实时事件。 */
+export function subscribeOpsMonitoringTraffic(handler: (payload: OpsTrafficResponse) => void): SseStop {
+  return subscribeOpsMonitoringEvent(OPS_MONITORING_SSE_TRAFFIC, parsePayload<OpsTrafficResponse>, handler);
+}
+
+/** 订阅运维监控服务实时事件。 */
+export function subscribeOpsMonitoringServices(handler: (payload: OpsServicesResponse) => void): SseStop {
+  return subscribeOpsMonitoringEvent(OPS_MONITORING_SSE_SERVICES, parsePayload<OpsServicesResponse>, handler);
+}
+
+/** 订阅运维监控存储实时事件。 */
+export function subscribeOpsMonitoringStorage(handler: (payload: OpsStorageResponse) => void): SseStop {
+  return subscribeOpsMonitoringEvent(OPS_MONITORING_SSE_STORAGE, parsePayload<OpsStorageResponse>, handler);
+}
+
+/** 订阅运维监控实例实时事件。 */
+export function subscribeOpsMonitoringNodes(handler: (payload: OpsNodesResponse) => void): SseStop {
+  return subscribeOpsMonitoringEvent(OPS_MONITORING_SSE_NODES, parsePayload<OpsNodesResponse>, handler);
+}
+
+function subscribeOpsMonitoringEvent<T>(event: string, parser: (raw: string) => T | null, handler: (payload: T) => void): SseStop {
+  return subscribeSseEvent({ stream: OPS_MONITORING_SSE_STREAM }, event, parser, handler);
+}
+
+function parsePayload<T>(raw: string): T | null {
+  if (!raw) return null;
+  try {
+    return JSON.parse(raw) as T;
+  } catch {
+    return null;
+  }
+}