@usethink/shared-frontend 0.1.0

package/dist/api/device/runnerGenerate.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Runner 生成请求
+ */
+export interface RunnerGenerateRequest {
+    /** 设备 ID 列表（null/undefined 表示所有启用设备） */
+    deviceIds?: number[];
+    /** 命名空间（可选，如 "FactoryA.Line1.Plc01"） */
+    namespace?: string;
+    /** 配置格式: Json(默认) / Xml */
+    configFormat?: string;
+    /** 目标平台: Console / WindowsService / LinuxSystemd / WinForm */
+    platform?: string;
+    /** SKU 模式: Binary(免费exe) / Source(付费源码) */
+    sku?: string;
+    /** 运行时标识符: win-x64 / linux-x64 / osx-x64 */
+    runtimeIdentifier?: string;
+    /** 项目名（可选） */
+    projectName?: string;
+    /** Runner 本地/客户侧数据存储类型 */
+    dataStorageType?: string;
+    /** Runner 本地/客户侧数据存储连接串 */
+    dataStorageConnectionString?: string;
+    /** 是否启用断网续传 */
+    enableDataSync?: boolean;
+    /** DataSync 远端目标数据库类型 */
+    remoteTargetType?: string;
+    /** DataSync 远端目标数据库连接串 */
+    remoteTargetConnectionString?: string;
+}
+/**
+ * 任务状态枚举
+ */
+export type JobStatus = "Queued" | "Running" | "Succeeded" | "Failed" | "Cancelled" | "TimedOut";
+/**
+ * Runner 生成任务
+ */
+export interface RunnerJob {
+    /** 任务 ID (GUID) */
+    id: string;
+    /** 任务状态 */
+    status: JobStatus;
+    /** 用户 ID */
+    userId?: string;
+    /** 创建时间 (ISO 8601) */
+    createdAt: string;
+    /** 完成时间 (ISO 8601) */
+    completedAt?: string;
+    /** 进度百分比 0-100 */
+    progress: number;
+    /** 当前阶段描述 */
+    phase: string;
+    /** 错误信息（失败时） */
+    errorMessage?: string;
+    /** 是否有可下载结果 */
+    hasResult?: boolean;
+}
+/**
+ * 生成任务提交响应
+ */
+export interface GenerateResponse {
+    jobId: string;
+    message: string;
+    sseUrl?: string;
+    downloadUrl?: string;
+}
+/**
+ * SSE 事件数据（与后端 SerializeEvent 字段对齐）
+ */
+export interface SseEvent {
+    status: string;
+    progress: number;
+    phase: string;
+    errorMessage?: string;
+    timestamp: string;
+}
+/**
+ * 提交 Runner 生成任务
+ * POST /api/runner/generate
+ */
+export declare function generateRunner(request: RunnerGenerateRequest): Promise<GenerateResponse>;
+/**
+ * 获取任务列表（最近 50 条）
+ * GET /api/runner/jobs
+ */
+export declare function getRunnerJobs(): Promise<RunnerJob[]>;
+/**
+ * 获取任务状态
+ * GET /api/runner/jobs/{id}
+ */
+export declare function getRunnerJobStatus(id: string): Promise<RunnerJob>;
+/**
+ * 取消任务
+ * POST /api/runner/jobs/{id}/cancel
+ */
+export declare function cancelRunnerJob(id: string): Promise<{
+    status: string;
+    message: string;
+}>;
+/**
+ * 临时下载令牌响应
+ */
+export interface DownloadTokenResponse {
+    token: string;
+    expiresIn: number;
+    message: string;
+}
+/**
+ * 生成临时下载令牌
+ * POST /api/runner/jobs/{id}/download-token
+ * 需要 JWT 认证
+ */
+export declare function generateDownloadToken(id: string): Promise<DownloadTokenResponse>;
+/**
+ * 下载生成结果（使用临时令牌）
+ * GET /api/runner/jobs/{id}/download?token={token}
+ * @param id 任务 ID
+ * @param token 临时下载令牌
+ */
+export declare function downloadRunnerResultWithToken(id: string, token: string): void;
+/**
+ * 下载生成结果（自动获取令牌）
+ * @param id 任务 ID
+ */
+export declare function downloadRunnerResult(id: string): Promise<void>;
+/**
+ * 创建 SSE 连接，监听任务进度
+ * GET /api/runner/jobs/{id}/sse
+ * @returns EventSource 对象，调用方负责 close()
+ */
+export declare function createSseConnection(id: string, onMessage: (event: SseEvent) => void, onError: (error: Event) => void, onEnd: () => void): EventSource;
+/** 配置格式选项 */
+export declare const FORMAT_OPTIONS: readonly [{
+    readonly label: "JSON";
+    readonly value: "Json";
+}, {
+    readonly label: "XML";
+    readonly value: "Xml";
+}];
+/** 平台选项 */
+export declare const PLATFORM_OPTIONS: readonly [{
+    readonly label: "控制台 (Console)";
+    readonly value: "Console";
+}, {
+    readonly label: "Windows 服务";
+    readonly value: "WindowsService";
+}, {
+    readonly label: "Linux systemd";
+    readonly value: "LinuxSystemd";
+}, {
+    readonly label: "WinForms 桌面";
+    readonly value: "WinForm";
+}];
+/** SKU 选项 */
+export declare const SKU_OPTIONS: readonly [{
+    readonly label: "二进制 (免编译exe)";
+    readonly value: "Binary";
+}, {
+    readonly label: "源码 (含构建脚本)";
+    readonly value: "Source";
+}];
+/** 运行时标识符选项 */
+export declare const RID_OPTIONS: readonly [{
+    readonly label: "Windows x64";
+    readonly value: "win-x64";
+}, {
+    readonly label: "Windows x86";
+    readonly value: "win-x86";
+}, {
+    readonly label: "Linux x64";
+    readonly value: "linux-x64";
+}, {
+    readonly label: "Linux ARM64";
+    readonly value: "linux-arm64";
+}, {
+    readonly label: "Linux musl x64 (Alpine)";
+    readonly value: "linux-musl-x64";
+}, {
+    readonly label: "macOS x64";
+    readonly value: "osx-x64";
+}, {
+    readonly label: "macOS ARM64 (Apple Silicon)";
+    readonly value: "osx-arm64";
+}];
+/** Runner 数据存储选项 */
+export declare const DATA_STORAGE_OPTIONS: readonly [{
+    readonly label: "SQLite 本地库";
+    readonly value: "Sqlite";
+}, {
+    readonly label: "MySQL";
+    readonly value: "MySql";
+}, {
+    readonly label: "SQL Server";
+    readonly value: "SqlServer";
+}, {
+    readonly label: "PostgreSQL";
+    readonly value: "PostgreSQL";
+}, {
+    readonly label: "Oracle";
+    readonly value: "Oracle";
+}, {
+    readonly label: "不落库";
+    readonly value: "None";
+}];
+/** DataSync 远端目标库选项 */
+export declare const REMOTE_TARGET_OPTIONS: ({
+    readonly label: "SQLite 本地库";
+    readonly value: "Sqlite";
+} | {
+    readonly label: "MySQL";
+    readonly value: "MySql";
+} | {
+    readonly label: "SQL Server";
+    readonly value: "SqlServer";
+} | {
+    readonly label: "PostgreSQL";
+    readonly value: "PostgreSQL";
+} | {
+    readonly label: "Oracle";
+    readonly value: "Oracle";
+} | {
+    readonly label: "不落库";
+    readonly value: "None";
+})[];
+/** 任务状态显示映射 */
+export declare const JOB_STATUS_MAP: Record<JobStatus, {
+    color: string;
+    text: string;
+}>;
+/** 终态（不再变化的状态） */
+export declare const TERMINAL_STATUSES: JobStatus[];

package/dist/api/device/tagHistory.d.ts

@@ -0,0 +1,142 @@
+/**
+ * 标签历史数据 DTO
+ */
+export interface TagHistoryDto {
+    id: number;
+    tag_id: number;
+    device_id: number;
+    tag_address: string;
+    biz_tag_name: string;
+    value_str: string | null;
+    value_num: number | null;
+    value_bool: boolean | null;
+    data_type: string;
+    collect_time: string;
+    quality_code: number;
+}
+/**
+ * 标签历史统计数据 DTO
+ */
+export interface TagHistoryStatisticsDto {
+    biz_tag_name: string;
+    count: number;
+    min_value: number | null;
+    max_value: number | null;
+    avg_value: number | null;
+    first_collect_time: string | null;
+    last_collect_time: string | null;
+}
+/**
+ * 历史数据查询参数
+ */
+export interface TagHistoryQueryParams {
+    tagId?: number;
+    bizTagName?: string;
+    deviceId?: number;
+    startTime?: string;
+    endTime?: string;
+    pageIndex?: number;
+    pageSize?: number;
+    descending?: boolean;
+}
+/**
+ * 分页查询结果
+ */
+export interface TagHistoryPageResult {
+    list: TagHistoryDto[];
+    total: number;
+    page_index: number;
+    page_size: number;
+}
+/**
+ * 查询标签历史数据
+ */
+export declare function queryTagHistory(params: TagHistoryQueryParams): Promise<TagHistoryPageResult>;
+/**
+ * 获取最新N条历史数据
+ */
+export declare function getLatestTagHistory(tagId: number, count?: number): Promise<TagHistoryDto[]>;
+/**
+ * 获取标签统计数据
+ */
+export declare function getTagHistoryStatistics(bizTagName: string, startTime?: string, endTime?: string): Promise<TagHistoryStatisticsDto>;
+/**
+ * 清理历史数据
+ * @param days 保留天数，删除该天数之前的数据
+ */
+export declare function cleanupTagHistory(days: number): Promise<{
+    deleted_count: number;
+}>;
+/**
+ * 强制刷新历史数据缓冲区
+ */
+export declare function flushTagHistoryBuffer(): Promise<any>;
+/**
+ * 获取缓冲区状态
+ */
+export declare function getTagHistoryBufferStatus(): Promise<{
+    pending_count: number;
+}>;
+/**
+ * 确保历史数据表存在
+ */
+export declare function ensureTagHistoryTable(): Promise<any>;
+/**
+ * 降采样数据点
+ */
+export interface DownSamplePoint {
+    timeBucket: string;
+    avgValue: number | null;
+    minValue: number | null;
+    maxValue: number | null;
+    sampleCount: number;
+}
+/**
+ * 查询标签历史降采样数据
+ * @param tagId 标签ID
+ * @param startTime 开始时间
+ * @param endTime 结束时间
+ * @param interval 时间窗口: 1m, 5m, 15m, 1h, 1d
+ */
+export declare function queryTagHistoryDownSample(tagId: number, startTime: string, endTime: string, interval?: string): Promise<DownSamplePoint[]>;
+/**
+ * 导出标签历史为 CSV（后端上限 10000 条）
+ * @returns Blob（text/csv）
+ */
+export declare function exportTagHistoryCsv(params: {
+    tagId?: number;
+    bizTagName?: string;
+    deviceId?: number;
+    startTime?: string;
+    endTime?: string;
+}): Promise<Blob>;
+/**
+ * 关联执行日志项
+ */
+export interface CorrelatedExeLogItem {
+    exeLogId: number;
+    exeId: number;
+    triggered: boolean;
+    triggerReason: string | null;
+    executionSuccess: boolean;
+    elapsedMs: number;
+    errorMessage: string | null;
+}
+/**
+ * 关联时间轴项
+ */
+export interface CorrelatedTimelineItem {
+    collectTime: string;
+    bizTagName: string;
+    valueStr: string | null;
+    valueNum: number | null;
+    qualityCode: number;
+    exeLogs: CorrelatedExeLogItem[];
+}
+/**
+ * 查询标签-执行关联数据
+ * @param tagId 标签ID
+ * @param startTime 开始时间
+ * @param endTime 结束时间
+ */
+export declare function getTagHistoryCorrelated(tagId: number, startTime: string, endTime: string): Promise<CorrelatedTimelineItem[]>;

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

@@ -0,0 +1,123 @@
+/**
+ * ProtocolGateway 网关管理 API 模块
+ *
+ * 对应后端 API:
+ * - GET    /Gateway/outputs            - 获取所有输出插件状态
+ * - GET    /Gateway/outputs/{name}     - 获取单个输出插件状态
+ * - POST   /Gateway/outputs            - 注册输出插件
+ * - DELETE /Gateway/outputs/{name}     - 移除输出插件
+ * - PATCH  /Gateway/outputs/{name}/start - 启动输出插件
+ * - PATCH  /Gateway/outputs/{name}/stop  - 停止输出插件
+ * - GET    /Gateway/metrics            - 获取网关转发指标
+ * - GET    /Gateway/dead-letters       - 获取死信队列
+ * - DELETE /Gateway/dead-letters       - 清空死信队列
+ * - POST   /Gateway/dead-letters/retry - 死信重试
+ * - POST   /Gateway/circuit-breaker/{name}/reset - 重置断路器
+ * - POST   /Gateway/test              - 测试发送消息
+ * - POST   /Gateway/publish           - 发布消息到 Pipeline
+ * - GET    /Gateway/status            - 获取网关运行状态
+ */
+import type { RequestOptions } from '@/utils/request';
+/** 输出插件状态 */
+export interface OutputPluginStatus {
+    name: string;
+    protocolType: string;
+    isEnabled: boolean;
+    isRunning: boolean;
+    lastError?: string;
+    messagesProcessed: number;
+    messagesFailed: number;
+    lastActivityAt?: string;
+}
+/** 注册输出插件请求（字段名与后端 RegisterOutputRequest 对齐） */
+export interface RegisterOutputRequest {
+    pluginName: string;
+    protocolType: string;
+    config: Record<string, string>;
+    autoStart?: boolean;
+}
+/** 测试发送请求 */
+export interface TestSendRequest {
+    outputName: string;
+    testPayload?: string;
+    timeoutMs?: number;
+}
+/** 测试发送结果 */
+export interface TestSendResult {
+    success: boolean;
+    durationMs: number;
+    errorMessage?: string;
+}
+/** 发布消息请求 */
+export interface PublishMessageRequest {
+    topic?: string;
+    jsonPayload?: string;
+    textPayload?: string;
+    hexPayload?: string;
+    metadata?: Record<string, string>;
+}
+/** 死信信息 */
+export interface DeadLetterInfo {
+    id: string;
+    outputName: string;
+    topic: string;
+    payload: string;
+    failureReason: string;
+    failedAt: string;
+    retryCount: number;
+}
+/** 网关指标快照 */
+export interface GatewayMetricsSnapshot {
+    totalProcessed: number;
+    totalFailed: number;
+    totalDropped: number;
+    avgLatencyMs: number;
+    deadLetterCount: number;
+    outputMetrics: Record<string, OutputMetrics>;
+}
+/** 单个输出插件指标 */
+export interface OutputMetrics {
+    processed: number;
+    failed: number;
+    dropped: number;
+    avgLatencyMs: number;
+    circuitBreakerState: string;
+    lastSendAt?: string;
+}
+/** 网关运行状态 */
+export interface GatewayStatus {
+    isRunning: boolean;
+}
+/** 获取所有输出插件状态 */
+export declare function getOutputPlugins(options?: RequestOptions): Promise<OutputPluginStatus[]>;
+/** 获取单个输出插件状态 */
+export declare function getOutputPlugin(name: string, options?: RequestOptions): Promise<OutputPluginStatus>;
+/** 注册输出插件 */
+export declare function registerOutput(request: RegisterOutputRequest, options?: RequestOptions): Promise<{
+    pluginName: string;
+    protocolType: string;
+}>;
+/** 移除输出插件 */
+export declare function unregisterOutput(name: string, options?: RequestOptions): Promise<any>;
+/** 启动输出插件 */
+export declare function startOutput(name: string, options?: RequestOptions): Promise<any>;
+/** 停止输出插件 */
+export declare function stopOutput(name: string, options?: RequestOptions): Promise<any>;
+/** 获取网关转发指标 */
+export declare function getGatewayMetrics(options?: RequestOptions): Promise<GatewayMetricsSnapshot>;
+/** 获取死信队列 */
+export declare function getDeadLetters(limit?: number, options?: RequestOptions): Promise<DeadLetterInfo[]>;
+/** 清空死信队列 */
+export declare function clearDeadLetters(options?: RequestOptions): Promise<any>;
+/** 死信重试 */
+export declare function retryDeadLetters(options?: RequestOptions): Promise<{
+    retried: number;
+}>;
+/** 重置断路器 */
+export declare function resetCircuitBreaker(name: string, options?: RequestOptions): Promise<any>;
+/** 测试发送消息 */
+export declare function testSend(request: TestSendRequest, options?: RequestOptions): Promise<TestSendResult>;
+/** 发布消息到 Pipeline */
+export declare function publishMessage(request: PublishMessageRequest, options?: RequestOptions): Promise<void>;
+/** 获取网关运行状态 */
+export declare function getGatewayStatus(options?: RequestOptions): Promise<GatewayStatus>;

package/dist/api/http.d.ts

@@ -0,0 +1,54 @@
+import { type RequestOptions } from '@/utils/request';
+/**
+ * 封装常用的http请求
+ */
+declare const http: {
+    /**
+     * HTTP GET
+     * @param url 请求url
+     * @param params 参数
+     * @param options 其他配置
+     * @returns
+     */
+    get<T = any>(url: string, params?: object | null, options?: RequestOptions): Promise<T>;
+    /**
+     * HTTP POST
+     * @param url 请求url
+     * @param data 参数
+     * @param options 其他配置
+     * @returns
+     */
+    post<T_1 = any>(url: string, data: object, options?: RequestOptions): Promise<T_1>;
+    /**
+     * HTTP POST, 把参数添加到url中
+     * @param url 请求url
+     * @param data 参数
+     * @param options 其他配置
+     * @returns
+     */
+    postStr<T_2 = any>(url: string, data: object, options?: RequestOptions): Promise<T_2>;
+    /**
+     * HTTP DELETE
+     * @param url 请求url
+     * @param params 参数
+     * @returns
+     */
+    delete<T_3 = any>(url: string, params: object): Promise<T_3>;
+    /**
+     * HTTP PUT
+     * @param url 请求url
+     * @param data 参数
+     * @param options 其他配置
+     * @returns
+     */
+    put<T_4 = any>(url: string, data: object, options?: RequestOptions): Promise<T_4>;
+    /**
+     * HTTP PATCH
+     * @param url 请求url
+     * @param data 参数
+     * @param options 其他配置
+     * @returns
+     */
+    patch<T_5 = any>(url: string, data: object, options?: RequestOptions): Promise<T_5>;
+};
+export { http };

package/dist/api/http.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../utils/request.js"),u={get(e,t,s){return r.request(e,{method:"GET",params:t,...s||{}})},post(e,t,s){return r.request(e,{method:"POST",data:t,showSuccessMsg:!0,...s||{}})},postStr(e,t,s){return r.request(e,{method:"POST",data:t,showSuccessMsg:!0,isJoinParamsToUrl:!0,...s||{}})},delete(e,t){return r.request(e,{method:"DELETE",params:t,successMsg:"删除成功!"})},put(e,t,s){return r.request(e,{method:"PUT",data:t,showSuccessMsg:!0,...s||{}})},patch(e,t,s){return r.request(e,{method:"PATCH",data:t,showSuccessMsg:!0,...s||{}})}};exports.http=u;

package/dist/api/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * API 模块入口
+ * 导出所有 API 相关类型和函数
+ *
+ * 模块分类说明：
+ * - 核心 API：所有系统必须支持（device、iotSim、login、sys/user 基础功能）
+ * - 可选 API：仅 TMom.Api 完整版支持（base、modeling、product、process、sys/menu-role-org）
+ *
+ * 使用说明：
+ * - web_mini 连接 TMom.Device.Runtime.Host，仅需使用核心 API
+ * - web 连接 TMom.Api，可使用全部 API
+ */
+export * from "./http";
+export * from "./saveRefreshTime";
+export * from "./device";
+export * from "./iotSim";
+export * from "./login";
+export * from "./base";
+export * from "./modeling";
+export * from "./product";
+export * from "./process";
+export * from "./sys";
+export * from "./dev";
+export * from "./codeFirst";
+export * from "./values";
+export * from "./cache";