@fudanda/client 2.20261024.1-beta.1 → 2.20261024.1-beta.2

package/dist/shared/platform/contracts/files.js

@@ -0,0 +1,137 @@
+import * as z from 'zod';
+import { dateRangeQuery, keywordQuery, paginated, paginationQuery, queryEnum } from '../../core/api-schemas.js';
+import { defineContract, fileField, multipart, op } from '../../core/contract.js';
+import { FILE_ACCESS_PURPOSES, FILE_STORAGE_PROVIDERS, FILE_TYPE_FILTERS, FILE_URL_STRATEGIES, FILE_VISIBILITIES, UPLOAD_SESSION_STATUSES, } from '../constants.js';
+import { completeChunkUploadSchema, initChunkUploadSchema } from '../validation.js';
+export const managedFileSchema = z.object({
+    id: z.uuid(),
+    storageConfigId: z.int(),
+    storageName: z.string(),
+    provider: z.enum(FILE_STORAGE_PROVIDERS),
+    originalName: z.string().meta({ example: 'avatar.png' }),
+    objectKey: z.string(),
+    size: z.int().meta({ example: 10240 }),
+    mimeType: z.string().nullable().optional(),
+    extension: z.string().nullable().optional(),
+    visibility: z.enum(FILE_VISIBILITIES).meta({ description: 'restricted 文件不可经通用 content 接口读取' }),
+    contentHash: z.string().nullable().optional().meta({ description: '内容 SHA-256（hex），未计算为 null' }),
+    url: z.string().meta({ description: '稳定代理路径 /api/files/{id}/content，可持久化', example: '/api/files/018f.../content' }),
+    directUrl: z.string().nullable().optional().meta({ description: 'public 策略的永久公开直链；仅渲染用，禁止持久化', example: 'https://cdn.example.com/2026/07/11/a.png' }),
+    uploaderName: z.string().nullable().optional().meta({ description: '上传人（列表 / 详情 / 目录浏览返回）' }),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+}).meta({ id: 'ManagedFile' });
+export const fileAccessUrlSchema = z.object({
+    url: z.string().meta({ example: 'https://bucket.oss-cn-hangzhou.aliyuncs.com/2026/07/11/a.png?Expires=...' }),
+    strategy: z.enum(FILE_URL_STRATEGIES),
+    expiresAt: z.string().nullable().meta({ description: '签名过期时间（YYYY-MM-DD HH:mm:ss）；public/proxy 为 null' }),
+}).meta({ id: 'FileAccessUrl' });
+export const folderEntrySchema = z.object({
+    name: z.string(),
+    path: z.string(),
+}).meta({ id: 'FolderEntry' });
+export const storageBrowseResultSchema = z.object({
+    folders: z.array(folderEntrySchema),
+    files: z.array(managedFileSchema),
+    currentPath: z.string(),
+    basePath: z.string(),
+}).meta({ id: 'StorageBrowseResult' });
+export const fileStatsSchema = z.object({
+    summary: z.object({
+        totalFiles: z.int(),
+        totalSize: z.int(),
+        imageCount: z.int(),
+        docCount: z.int(),
+        videoCount: z.int(),
+        audioCount: z.int(),
+        todayCount: z.int(),
+        thisMonthCount: z.int(),
+    }),
+    typeStats: z.array(z.object({ type: z.string(), label: z.string(), count: z.int(), size: z.int() })),
+    providerStats: z.array(z.object({ provider: z.string(), count: z.int(), size: z.int() })),
+    monthlyStats: z.array(z.object({ month: z.string(), count: z.int() })),
+    uploaderStats: z.array(z.object({ username: z.string(), count: z.int(), size: z.int() })),
+    sizeRangeStats: z.array(z.object({ range: z.string(), count: z.int() })),
+}).meta({ id: 'FileStats' });
+export const uploadSessionInitSchema = z.object({
+    uploadId: z.string(),
+    chunkSize: z.int(),
+    totalChunks: z.int(),
+    received: z.array(z.int()).meta({ description: '已接收的分片序号（从 0 计），用于断点续传' }),
+}).meta({ id: 'UploadSessionInit' });
+export const uploadChunkResultSchema = z.object({
+    index: z.int(),
+    receivedCount: z.int().meta({ description: '当前已接收的分片数；完整序号列表经 status 接口获取，避免万片级会话每片回传整表' }),
+}).meta({ id: 'UploadChunkResult' });
+export const uploadSessionStatusSchema = z.object({
+    uploadId: z.string(),
+    status: z.enum(UPLOAD_SESSION_STATUSES),
+    chunkSize: z.int(),
+    totalChunks: z.int(),
+    received: z.array(z.int()),
+}).meta({ id: 'UploadSessionStatus' });
+const FILE_ID_EXAMPLE = '018f6f8a-5f76-7d8c-9a1b-2c3d4e5f6789';
+export const fileIdParam = z.object({
+    id: z.uuid().meta({ description: '文件 ID', example: FILE_ID_EXAMPLE }),
+});
+const uploadIdParam = z.object({
+    uploadId: z.string().meta({ description: '分片上传会话 ID', example: '3f1c2b7e-9d4a-4c5b-8e6f-1a2b3c4d5e6f' }),
+});
+export const fileListQuery = paginationQuery.extend({
+    keyword: keywordQuery('文件名 / 对象键 / 文件服务'),
+    provider: queryEnum(FILE_STORAGE_PROVIDERS),
+    fileType: queryEnum(FILE_TYPE_FILTERS),
+    ...dateRangeQuery('上传时间'),
+});
+export const fileAccessUrlQuery = z.object({
+    purpose: queryEnum(FILE_ACCESS_PURPOSES),
+});
+export const storageBrowseQuery = z.object({
+    storageConfigId: z.coerce.number().int().positive().meta({ description: '存储配置 ID', example: 1 }),
+    path: z.string().optional().meta({ description: '相对存储根路径的目录，空表示根目录' }),
+});
+export const fileIdsBody = z.object({
+    ids: z.array(z.uuid()).min(1),
+});
+const batchDownloadBody = z.object({
+    ids: z.array(z.uuid()),
+});
+const uploadBody = multipart(z.object({
+    file: z.unknown().meta({ type: 'array', items: { type: 'string', format: 'binary' }, description: '文件，可多选' }),
+}));
+const uploadOneBody = multipart(z.object({
+    file: fileField(),
+}));
+export const uploadChunkBody = multipart(z.object({
+    uploadId: z.string(),
+    index: z.string().meta({ description: '分片序号（从 0 计）' }),
+    chunk: fileField('分片内容'),
+}));
+export const fileContract = defineContract('/api/files', {
+    content: op.get('/{id}/content', { params: fileIdParam, kind: 'file', public: true, summary: '公开访问文件内容' }),
+    accessUrl: op.get('/{id}/access-url', {
+        access: 'authenticated',
+        params: fileIdParam,
+        query: fileAccessUrlQuery,
+        response: fileAccessUrlSchema,
+        summary: '解析文件访问直链（按存储配置策略，presigned 每次签发新鲜 URL）',
+    }),
+    stats: op.get('/stats', { access: { permission: 'system:file:list' }, response: fileStatsSchema, summary: '文件统计分析' }),
+    uploadPolicy: op.get('/upload-policy', { access: { permission: 'system:file:upload' }, response: z.object({
+            uploadMaxSizeMb: z.int().min(0), chunkThresholdMb: z.int().min(1), chunkSizeMb: z.int().min(5),
+        }), summary: '读取当前文件上传策略' }),
+    list: op.get('/', { access: { permission: 'system:file:list' }, query: fileListQuery, response: paginated(managedFileSchema), summary: '文件分页列表' }),
+    browse: op.get('/browse', { access: { permission: 'system:file:list' }, query: storageBrowseQuery, response: storageBrowseResultSchema, summary: '按存储配置浏览文件目录' }),
+    uploadInit: op.post('/upload/init', { access: { permission: 'system:file:upload' }, audit: '初始化分片上传', body: initChunkUploadSchema, response: uploadSessionInitSchema, summary: '初始化分片上传' }),
+    uploadChunk: op.post('/upload/chunk', { access: { permission: 'system:file:upload' }, body: uploadChunkBody, response: uploadChunkResultSchema, summary: '上传单个分片' }),
+    uploadComplete: op.post('/upload/complete', { access: { permission: 'system:file:upload' }, audit: '完成分片上传', body: completeChunkUploadSchema, response: managedFileSchema, summary: '完成分片上传' }),
+    uploadStatus: op.get('/upload/{uploadId}/status', { access: 'authenticated', params: uploadIdParam, response: uploadSessionStatusSchema, summary: '查询分片上传进度' }),
+    uploadAbort: op.delete('/upload/{uploadId}', { access: { permission: 'system:file:upload' }, audit: '中止分片上传', params: uploadIdParam, summary: '中止分片上传' }),
+    detail: op.get('/{id}', { access: { permission: 'system:file:list' }, params: fileIdParam, response: managedFileSchema, summary: '获取文件详情' }),
+    upload: op.post('/upload', { access: { permission: 'system:file:upload' }, audit: { description: '上传文件', recordBody: false }, body: uploadBody, response: z.array(managedFileSchema), summary: '上传文件' }),
+    uploadOne: op.post('/upload-one', { access: { permission: 'system:file:upload' }, audit: { description: '上传单个文件', recordBody: false }, body: uploadOneBody, response: managedFileSchema, summary: '上传单个文件' }),
+    batchDownload: op.post('/batch-download', { access: { permission: 'system:file:list' }, body: batchDownloadBody, kind: 'file', summary: '批量下载文件（zip）' }),
+    removeBatch: op.delete('/batch', { access: { permission: 'system:file:delete' }, audit: { description: '批量删除文件', recordBody: false }, body: fileIdsBody, summary: '批量删除文件' }),
+    remove: op.delete('/{id}', { access: { permission: 'system:file:delete' }, audit: { description: '删除文件', recordBody: false }, params: fileIdParam, summary: '删除文件' }),
+}, { auditModule: '文件管理', tags: ['Files'] });
+//# sourceMappingURL=files.js.map

package/dist/shared/platform/contracts/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/platform/contracts/files.ts"],"names":[],"mappings":"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"}

package/dist/shared/platform/contracts/global-search.d.ts

@@ -0,0 +1,199 @@
+import * as z from 'zod';
+import { type CanonicalEntityType } from '../entity-catalog.js';
+export declare const globalSearchTypes: readonly ["user", "member", "order", "workflow", "file", "iot-device", "iot-alarm", "cms-content", "wiki-document", "announcement", "chat-message", "biz-leave", "report-dashboard", "report-dataset", "ai-knowledge-base", "async-task", "operation-log", "exception-log"];
+export declare const globalSearchEntityTypes: Readonly<Record<GlobalSearchType, CanonicalEntityType>>;
+export declare function canonicalEntityTypeForSearchType(type: GlobalSearchType): CanonicalEntityType;
+export declare const globalSearchRoutePrefixes: readonly ['/system/', '/member/', '/payment/', '/workflow/', '/drive/', '/iot/', '/alerts/', '/cms/', '/wiki/', '/system/announcements', '/chat', '/biz/', '/report/', '/ai/', '/system/task-center', '/system/operation-logs', '/system/exception-logs'];
+export declare const globalSearchTypeSchema: z.ZodEnum<{
+    "ai-knowledge-base": "ai-knowledge-base";
+    announcement: "announcement";
+    "async-task": "async-task";
+    "biz-leave": "biz-leave";
+    "chat-message": "chat-message";
+    "cms-content": "cms-content";
+    "exception-log": "exception-log";
+    file: "file";
+    "iot-alarm": "iot-alarm";
+    "iot-device": "iot-device";
+    member: "member";
+    "operation-log": "operation-log";
+    order: "order";
+    "report-dashboard": "report-dashboard";
+    "report-dataset": "report-dataset";
+    user: "user";
+    "wiki-document": "wiki-document";
+    workflow: "workflow";
+}>;
+export type GlobalSearchType = z.infer<typeof globalSearchTypeSchema>;
+export declare const globalSearchHighlightSchema: z.ZodObject<{
+    field: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const globalSearchResultSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        "ai-knowledge-base": "ai-knowledge-base";
+        announcement: "announcement";
+        "async-task": "async-task";
+        "biz-leave": "biz-leave";
+        "chat-message": "chat-message";
+        "cms-content": "cms-content";
+        "exception-log": "exception-log";
+        file: "file";
+        "iot-alarm": "iot-alarm";
+        "iot-device": "iot-device";
+        member: "member";
+        "operation-log": "operation-log";
+        order: "order";
+        "report-dashboard": "report-dashboard";
+        "report-dataset": "report-dataset";
+        user: "user";
+        "wiki-document": "wiki-document";
+        workflow: "workflow";
+    }>;
+    id: z.ZodString;
+    title: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    route: z.ZodString;
+    highlights: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
+    actions: z.ZodOptional<z.ZodObject<{
+        view: z.ZodDefault<z.ZodBoolean>;
+        download: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GlobalSearchResult = z.infer<typeof globalSearchResultSchema>;
+export declare const globalSearchQuery: z.ZodObject<{
+    q: z.ZodString;
+    types: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const globalSearchResponseSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            "ai-knowledge-base": "ai-knowledge-base";
+            announcement: "announcement";
+            "async-task": "async-task";
+            "biz-leave": "biz-leave";
+            "chat-message": "chat-message";
+            "cms-content": "cms-content";
+            "exception-log": "exception-log";
+            file: "file";
+            "iot-alarm": "iot-alarm";
+            "iot-device": "iot-device";
+            member: "member";
+            "operation-log": "operation-log";
+            order: "order";
+            "report-dashboard": "report-dashboard";
+            "report-dataset": "report-dataset";
+            user: "user";
+            "wiki-document": "wiki-document";
+            workflow: "workflow";
+        }>;
+        id: z.ZodString;
+        title: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        route: z.ZodString;
+        highlights: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodObject<{
+            view: z.ZodDefault<z.ZodBoolean>;
+            download: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    partial: z.ZodBoolean;
+    failedTypes: z.ZodArray<z.ZodEnum<{
+        "ai-knowledge-base": "ai-knowledge-base";
+        announcement: "announcement";
+        "async-task": "async-task";
+        "biz-leave": "biz-leave";
+        "chat-message": "chat-message";
+        "cms-content": "cms-content";
+        "exception-log": "exception-log";
+        file: "file";
+        "iot-alarm": "iot-alarm";
+        "iot-device": "iot-device";
+        member: "member";
+        "operation-log": "operation-log";
+        order: "order";
+        "report-dashboard": "report-dashboard";
+        "report-dataset": "report-dataset";
+        user: "user";
+        "wiki-document": "wiki-document";
+        workflow: "workflow";
+    }>>;
+}, z.core.$strip>;
+export type GlobalSearchResponse = z.infer<typeof globalSearchResponseSchema>;
+export declare const globalSearchContract: import("../../core/contract.js").Contract<{
+    readonly search: import("../../core/contract.js").UnboundOperation<"get", "/", undefined, z.ZodObject<{
+        q: z.ZodString;
+        types: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, undefined, z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                "ai-knowledge-base": "ai-knowledge-base";
+                announcement: "announcement";
+                "async-task": "async-task";
+                "biz-leave": "biz-leave";
+                "chat-message": "chat-message";
+                "cms-content": "cms-content";
+                "exception-log": "exception-log";
+                file: "file";
+                "iot-alarm": "iot-alarm";
+                "iot-device": "iot-device";
+                member: "member";
+                "operation-log": "operation-log";
+                order: "order";
+                "report-dashboard": "report-dashboard";
+                "report-dataset": "report-dataset";
+                user: "user";
+                "wiki-document": "wiki-document";
+                workflow: "workflow";
+            }>;
+            id: z.ZodString;
+            title: z.ZodString;
+            subtitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            route: z.ZodString;
+            highlights: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strip>>>;
+            actions: z.ZodOptional<z.ZodObject<{
+                view: z.ZodDefault<z.ZodBoolean>;
+                download: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        partial: z.ZodBoolean;
+        failedTypes: z.ZodArray<z.ZodEnum<{
+            "ai-knowledge-base": "ai-knowledge-base";
+            announcement: "announcement";
+            "async-task": "async-task";
+            "biz-leave": "biz-leave";
+            "chat-message": "chat-message";
+            "cms-content": "cms-content";
+            "exception-log": "exception-log";
+            file: "file";
+            "iot-alarm": "iot-alarm";
+            "iot-device": "iot-device";
+            member: "member";
+            "operation-log": "operation-log";
+            order: "order";
+            "report-dashboard": "report-dashboard";
+            "report-dataset": "report-dataset";
+            user: "user";
+            "wiki-document": "wiki-document";
+            workflow: "workflow";
+        }>>;
+    }, z.core.$strip>, "json", undefined>;
+}>;
+//# sourceMappingURL=global-search.d.ts.map

package/dist/shared/platform/contracts/global-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-search.d.ts","sourceRoot":"","sources":["../../../src/platform/contracts/global-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAA4B,KAAK,mBAAmB,EAAmB,MAAM,mBAAmB,CAAC;AAGxG,eAAO,MAAM,iBAAiB,6QAmBY,CAAC;AAO3C,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAA4B,CAAC;AAEzH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,gBAAgB,GAAG,mBAAmB,CAE5F;AAGD,eAAO,MAAM,yBAAyB,YACpC,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,SAAS,EACT,OAAO,EACP,UAAU,EACV,OAAO,EACP,QAAQ,EACR,uBAAuB,EACvB,OAAO,EACP,OAAO,EACP,UAAU,EACV,MAAM,EACN,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,CAChB,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;EAA6D,CAAC;AACjG,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,2BAA2B;;;iBAGA,CAAC;AAEzC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcA,CAAC;AACtC,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;iBAMM,CAAC;AAErC,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKA,CAAC;AACxC,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOH,CAAC"}

package/dist/shared/platform/contracts/global-search.js

@@ -0,0 +1,84 @@
+import * as z from 'zod';
+import { defineContract, op } from '../../core/contract.js';
+import { SEARCH_TYPE_ENTITY_TYPES } from '../entity-catalog.js';
+export const globalSearchTypes = [
+    'user',
+    'member',
+    'order',
+    'workflow',
+    'file',
+    'iot-device',
+    'iot-alarm',
+    'cms-content',
+    'wiki-document',
+    'announcement',
+    'chat-message',
+    'biz-leave',
+    'report-dashboard',
+    'report-dataset',
+    'ai-knowledge-base',
+    'async-task',
+    'operation-log',
+    'exception-log',
+];
+export const globalSearchEntityTypes = SEARCH_TYPE_ENTITY_TYPES;
+export function canonicalEntityTypeForSearchType(type) {
+    return globalSearchEntityTypes[type];
+}
+export const globalSearchRoutePrefixes = [
+    '/system/',
+    '/member/',
+    '/payment/',
+    '/workflow/',
+    '/drive/',
+    '/iot/',
+    '/alerts/',
+    '/cms/',
+    '/wiki/',
+    '/system/announcements',
+    '/chat',
+    '/biz/',
+    '/report/',
+    '/ai/',
+    '/system/task-center',
+    '/system/operation-logs',
+    '/system/exception-logs',
+];
+export const globalSearchTypeSchema = z.enum(globalSearchTypes).meta({ id: 'GlobalSearchType' });
+export const globalSearchHighlightSchema = z.object({
+    field: z.string(),
+    text: z.string(),
+}).meta({ id: 'GlobalSearchHighlight' });
+export const globalSearchResultSchema = z.object({
+    type: globalSearchTypeSchema,
+    id: z.string(),
+    title: z.string(),
+    subtitle: z.string().nullable().optional(),
+    description: z.string().nullable().optional(),
+    icon: z.string().nullable().optional(),
+    route: z.string(),
+    highlights: z.array(globalSearchHighlightSchema).default([]),
+    actions: z.object({
+        view: z.boolean().default(true),
+        download: z.boolean().default(false),
+    }).optional(),
+}).meta({ id: 'GlobalSearchResult' });
+export const globalSearchQuery = z.object({
+    q: z.string().trim().min(1).max(100),
+    types: z.string().optional(),
+    limit: z.coerce.number().int().min(1).max(50).default(5),
+}).meta({ id: 'GlobalSearchQuery' });
+export const globalSearchResponseSchema = z.object({
+    results: z.array(globalSearchResultSchema),
+    partial: z.boolean(),
+    failedTypes: z.array(globalSearchTypeSchema),
+}).meta({ id: 'GlobalSearchResponse' });
+export const globalSearchContract = defineContract('/api/platform/search', {
+    search: op.get('/', {
+        access: 'authenticated',
+        query: globalSearchQuery,
+        response: globalSearchResponseSchema,
+        summary: '顶部统一搜索',
+    }),
+}, { tags: ['GlobalSearch'] });
+//# sourceMappingURL=global-search.js.map

package/dist/shared/platform/contracts/global-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-search.js","sourceRoot":"","sources":["../../../src/platform/contracts/global-search.ts"],"names":[],"mappings":"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"}

package/dist/shared/platform/contracts/health.d.ts

@@ -0,0 +1,43 @@
+import * as z from 'zod';
+export declare const HEALTH_STATUSES: readonly ['ok', 'degraded'];
+export type HealthStatus = (typeof HEALTH_STATUSES)[number];
+export declare const HEALTH_CHECK_RESULTS: readonly ['ok', 'degraded', 'error'];
+export type HealthCheckResult = (typeof HEALTH_CHECK_RESULTS)[number];
+export declare const healthSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        degraded: "degraded";
+        ok: "ok";
+    }>;
+    version: z.ZodString;
+    uptimeSeconds: z.ZodInt;
+    roles: z.ZodArray<z.ZodEnum<{
+        api: "api";
+        worker: "worker";
+    }>>;
+    checks: z.ZodRecord<z.ZodString, z.ZodEnum<{
+        degraded: "degraded";
+        error: "error";
+        ok: "ok";
+    }>>;
+}, z.core.$strip>;
+export type Health = z.infer<typeof healthSchema>;
+export declare const healthContract: import("../../core/contract.js").Contract<{
+    readonly check: import("../../core/contract.js").UnboundOperation<"get", "/", undefined, undefined, undefined, z.ZodObject<{
+        status: z.ZodEnum<{
+            degraded: "degraded";
+            ok: "ok";
+        }>;
+        version: z.ZodString;
+        uptimeSeconds: z.ZodInt;
+        roles: z.ZodArray<z.ZodEnum<{
+            api: "api";
+            worker: "worker";
+        }>>;
+        checks: z.ZodRecord<z.ZodString, z.ZodEnum<{
+            degraded: "degraded";
+            error: "error";
+            ok: "ok";
+        }>>;
+    }, z.core.$strip>, "json", undefined>;
+}>;
+//# sourceMappingURL=health.d.ts.map

package/dist/shared/platform/contracts/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/platform/contracts/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAMzB,eAAO,MAAM,eAAe,YAAI,IAAI,EAAE,UAAU,CAAU,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAG5D,eAAO,MAAM,oBAAoB,YAAI,IAAI,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAEzE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;iBAUA,CAAC;AAE1B,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAOL,CAAC"}

package/dist/shared/platform/contracts/health.js

@@ -0,0 +1,24 @@
+import * as z from 'zod';
+import { defineContract, op } from '../../core/contract.js';
+import { PROCESS_ROLES } from '../constants.js';
+export const HEALTH_STATUSES = ['ok', 'degraded'];
+export const HEALTH_CHECK_RESULTS = ['ok', 'degraded', 'error'];
+export const healthSchema = z.object({
+    status: z.enum(HEALTH_STATUSES).meta({ example: 'ok' }),
+    version: z.string().meta({ example: '2.17.0' }),
+    uptimeSeconds: z.int().meta({ example: 12345 }),
+    roles: z.array(z.enum(PROCESS_ROLES)).meta({ example: ['api'] }),
+    checks: z.record(z.string(), z.enum(HEALTH_CHECK_RESULTS)).meta({
+        description: '`workers`：仅 api 角色输出，近期无活跃 worker 心跳时为 degraded（作业会排队但无人执行）',
+        example: { database: 'ok', redis: 'ok', invalidationBus: 'ok', workers: 'ok' },
+    }),
+}).meta({ id: 'Health' });
+export const healthContract = defineContract('/api/health', {
+    check: op.get('/', {
+        response: healthSchema,
+        public: true,
+        summary: '健康检查',
+        description: '检查数据库与 Redis 连通状态，返回服务运行信息。',
+    }),
+}, { tags: ['服务状态'] });
+//# sourceMappingURL=health.js.map

package/dist/shared/platform/contracts/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/platform/contracts/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,UAAU,CAAU,CAAC;AAK3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAIzE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/C,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAE/C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IAChE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,WAAW,EAAE,6DAA6D;QAC1E,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;KAC/E,CAAC;CACH,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAM1B,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC,aAAa,EAAE;IAC1D,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE;QACjB,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,6BAA6B;KAC3C,CAAC;CACH,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/dist/shared/platform/contracts/index.d.ts

@@ -0,0 +1,25 @@
+export * from './business-files.js';
+export * from './cache.js';
+export * from './cron-jobs.js';
+export * from './data-mask.js';
+export * from './entity-relations.js';
+export * from './entity-timeline.js';
+export * from './dicts.js';
+export * from './exception-logs.js';
+export * from './file-storage-configs.js';
+export * from './files.js';
+export * from './health.js';
+export * from './global-search.js';
+export * from './ip-access-logs.js';
+export * from './monitor.js';
+export * from './monitor-alerts.js';
+export * from './sql-monitor.js';
+export * from './operation-logs.js';
+export * from './rate-limit.js';
+export * from './regions.js';
+export * from './system-scheduler.js';
+export * from './tags.js';
+export * from './trace.js';
+export * from './user-feedbacks.js';
+export * from './entity-watches.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/platform/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AAEjC,cAAc,kBAAkB,CAAC"}

package/dist/shared/platform/contracts/index.js

@@ -0,0 +1,25 @@
+export * from './business-files.js';
+export * from './cache.js';
+export * from './cron-jobs.js';
+export * from './data-mask.js';
+export * from './entity-relations.js';
+export * from './entity-timeline.js';
+export * from './dicts.js';
+export * from './exception-logs.js';
+export * from './file-storage-configs.js';
+export * from './files.js';
+export * from './health.js';
+export * from './global-search.js';
+export * from './ip-access-logs.js';
+export * from './monitor.js';
+export * from './monitor-alerts.js';
+export * from './sql-monitor.js';
+export * from './operation-logs.js';
+export * from './rate-limit.js';
+export * from './regions.js';
+export * from './system-scheduler.js';
+export * from './tags.js';
+export * from './trace.js';
+export * from './user-feedbacks.js';
+export * from './entity-watches.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/platform/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/platform/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AAEjC,cAAc,kBAAkB,CAAC"}