@plugin-light/shared 1.0.9 → 1.0.15

package/lib/email/index.d.ts

@@ -0,0 +1 @@
+export { type ImapConfig, type EmailMessage, type WatchEmailsOptions, type EmailWatcher, watchEmails, } from './watch-unread';

package/lib/email/watch-unread.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 方案二：IMAP IDLE 实时监听新邮件
+ *
+ * 通过 IMAP IDLE 命令保持长连接，实时监听收件箱中的新邮件到达。
+ * 适用于需要实时感知新邮件的场景，如：监听邮件后自动触发业务逻辑。
+ *
+ * 依赖安装：npm install imapflow mailparser
+ * 类型安装：npm install -D @types/mailparser
+ *
+ * 注意事项：
+ * 1. IDLE 连接可能因网络问题断开，内置自动重连机制
+ * 2. 部分邮箱服务器对 IDLE 连接有超时限制（通常 29 分钟），imapflow 会自动处理
+ * 3. 生产环境建议配合进程管理工具（如 pm2）使用
+ */
+/** 邮件连接配置 */
+export interface ImapConfig {
+    /** IMAP 服务器地址，例如 'imap.exmail.qq.com' */
+    host: string;
+    /** IMAP 端口，默认 993（STARTTLS）或 993（隐式 TLS） */
+    port?: number;
+    /** 是否使用隐式 TLS（端口 993），默认 false（使用 STARTTLS） */
+    secure?: boolean;
+    /** 邮箱账号 */
+    user: string;
+    /** 邮箱密码或应用专用密码/授权码 */
+    password: string;
+}
+/** 解析后的邮件结构 */
+export interface EmailMessage {
+    /** 邮件 UID */
+    uid: number;
+    /** 邮件主题 */
+    subject: string;
+    /** 发件人 */
+    from: string;
+    /** 收件人 */
+    to: string;
+    /** 邮件日期 */
+    date: Date | undefined;
+    /** 纯文本内容 */
+    text: string | undefined;
+    /** HTML 内容 */
+    html: string | false;
+    /** Markdown 内容（由 HTML 或纯文本转换而来） */
+    markdown: string;
+    /** 附件列表 */
+    attachments: Array<{
+        filename: string;
+        contentType: string;
+        size: number;
+    }>;
+}
+/** 邮件监听配置 */
+export interface WatchEmailsOptions extends ImapConfig {
+    /** 邮箱文件夹，默认 'INBOX' */
+    mailbox?: string;
+    /** 新邮件到达时的回调 */
+    onNewEmail: (email: EmailMessage) => void | Promise<void>;
+    /** 连接错误时的回调 */
+    onError?: (error: Error) => void;
+    /** 连接成功时的回调 */
+    onConnected?: () => void;
+    /** 断开连接时的回调 */
+    onDisconnected?: () => void;
+    /** 断线后自动重连，默认 true */
+    autoReconnect?: boolean;
+    /** 重连间隔（毫秒），默认 5000 */
+    reconnectInterval?: number;
+    /** 最大重连次数，默认 Infinity */
+    maxReconnectAttempts?: number;
+    /** 是否开启调试日志，默认 false */
+    debug?: boolean;
+}
+/** 邮件监听器实例，用于管理生命周期 */
+export interface EmailWatcher {
+    /** 停止监听并断开连接 */
+    stop: () => Promise<void>;
+    /** 当前是否已连接 */
+    isConnected: () => boolean;
+}
+/**
+ * 启动邮件监听（基于 IMAP IDLE）
+ *
+ * @example
+ * ```ts
+ * const watcher = await watchEmails({
+ *   host: 'imap.exmail.qq.com',
+ *   user: 'yourname@company.com',
+ *   password: 'your-app-password',
+ *   onNewEmail: (email) => {
+ *     console.log('📬 收到新邮件:', email.subject);
+ *     // 触发你的业务逻辑，比如推送到企微群
+ *   },
+ *   onError: (err) => {
+ *     console.error('监听出错:', err.message);
+ *   },
+ * });
+ *
+ * // 需要停止时
+ * // await watcher.stop();
+ * ```
+ */
+export declare function watchEmails(options: WatchEmailsOptions): Promise<EmailWatcher>;

package/lib/font-project/config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 字体项目 CDN 地址
+ */
+export declare const FONT_PROJECT_CDN = "https://image-1251917893.cos.ap-guangzhou.myqcloud.com/pmd-font/font-project.json";
+/**
+ * 字体项目 COS 基础配置
+ */
+export declare const FONT_PROJECT_COS_BASE: {
+    bucket: string;
+    region: string;
+};
+/**
+ * 字体项目 Webhook URL
+ */
+export declare const FONT_PROJECT_WEBHOOK_URL = "9f673531-788b-4780-be72-93b16a62e3eb";

package/lib/font-project/font-project.d.ts

@@ -0,0 +1,75 @@
+import { type CosConfig } from '../image/index';
+/**
+ * 字体项目配置接口
+ */
+export interface FontProject {
+    /** 项目中文名称 */
+    projectNameZN: string;
+    /** 项目英文名称 */
+    projectName: string;
+    /** 字体文件名 */
+    fontFileName: string;
+    /** 验证文本 */
+    validationText: string;
+    /** CDN 地址 */
+    cdn: string;
+    /** 标签列表 */
+    tags?: string[];
+    /** 创建者 */
+    creator?: string;
+    /** 创建时间戳 */
+    createTime?: number;
+    /** 更新时间戳 */
+    updateTime: number;
+}
+/**
+ * 字体项目数据集合
+ */
+export interface FontProjectsData {
+    [key: string]: FontProject;
+}
+/**
+ * 创建/更新字体项目的选项
+ */
+export interface CreateFontProjectOptions {
+    /** 项目中文名称 */
+    projectNameZN?: string;
+    /** 项目英文名称 */
+    projectName?: string;
+    /** 字体文件名 */
+    fontFileName?: string;
+    /** 验证文本 */
+    validationText?: string;
+    /** CDN 地址 */
+    cdn?: string;
+    /** COS 配置 */
+    cos: CosConfig;
+    /** 是否为创建操作 */
+    isCreate?: boolean;
+    /** 操作员名称 */
+    staffName?: string;
+    /** 标签列表 */
+    tags?: string[];
+}
+/**
+ * 创建字体项目的结果
+ */
+export interface CreateFontProjectResult {
+    /** 是否为创建操作 */
+    isCreate?: boolean;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 获取所有字体项目配置
+ * @returns 包含字体项目数据的 Promise
+ */
+export declare function genFontProjects(): Promise<{
+    data: FontProjectsData;
+}>;
+/**
+ * 创建或更新字体项目
+ * @param options - 创建/更新选项
+ * @returns 操作结果
+ */
+export declare function createFontProjectOrUpdate({ projectNameZN, projectName, fontFileName, validationText, cdn, cos, staffName, isCreate, tags, }: CreateFontProjectOptions): Promise<CreateFontProjectResult>;

package/lib/font-project/index.d.ts

@@ -0,0 +1,2 @@
+export { FONT_PROJECT_CDN, FONT_PROJECT_COS_BASE, FONT_PROJECT_WEBHOOK_URL, } from './config';
+export { genFontProjects, createFontProjectOrUpdate, type CreateFontProjectResult, type CreateFontProjectOptions, type FontProject, type FontProjectsData, } from './font-project';

package/lib/icon-project/config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 图标项目 CDN 地址
+ */
+export declare const ICON_PROJECT_CDN = "https://image-1251917893.cos.ap-guangzhou.myqcloud.com/pmd-icon/icon-project.json";
+/**
+ * COS 基础配置
+ */
+export declare const COS_BASE: {
+    bucket: string;
+    region: string;
+};
+/**
+ * 图标项目流水线配置
+ */
+export declare const ICON_PROJECT_PIPELINE_CONFIG: {
+    mainRemotePipelineId: string;
+    mainPipelineId: string;
+    createDirRemotePipelineId: string;
+};
+/**
+ * 图标项目 Webhook URL
+ */
+export declare const ICON_PROJECT_WEBHOOK_URL = "331402f8-c274-4b99-a302-4404759ca25a";

package/lib/icon-project/icon-project.d.ts

@@ -0,0 +1,83 @@
+import { type CosConfig } from '../image/image';
+/**
+ * 图标项目配置接口
+ */
+export interface IconProject {
+    /** 项目中文名称 */
+    projectNameZN: string;
+    /** 项目英文名称 */
+    projectName: string;
+    /** Figma 文件 ID */
+    figmaFileId: string;
+    /** Figma 节点 ID */
+    figmaNodeId: string;
+    /** Iconfont 前缀 */
+    iconfontPrefix: string;
+    /** Iconfont 字体族名 */
+    iconfontFamily: string;
+    /** CDN 地址 */
+    cdn: string;
+    /** 标签列表 */
+    tags?: string[];
+    /** 创建者 */
+    creator?: string;
+    /** 创建时间戳 */
+    createTime?: number;
+    /** 更新时间戳 */
+    updateTime: number;
+}
+/**
+ * 图标项目数据集合
+ */
+export interface IconProjectsData {
+    [key: string]: IconProject;
+}
+/**
+ * 创建/更新图标项目的选项
+ */
+export interface CreateIconProjectOptions {
+    /** 项目中文名称 */
+    projectNameZN?: string;
+    /** 项目英文名称 */
+    projectName?: string;
+    /** Figma 文件 ID */
+    figmaFileId?: string;
+    /** Figma 节点 ID */
+    figmaNodeId?: string;
+    /** Iconfont 前缀 */
+    iconfontPrefix?: string;
+    /** Iconfont 字体族名 */
+    iconfontFamily?: string;
+    /** CDN 地址 */
+    cdn?: string;
+    /** COS 配置 */
+    cos: CosConfig;
+    /** 操作员名称 */
+    staffName?: string;
+    /** 是否为创建操作 */
+    isCreate?: boolean;
+    /** 标签列表 */
+    tags?: string[];
+}
+/**
+ * 创建图标项目的结果
+ */
+export interface CreateIconProjectResult {
+    /** 是否为创建操作 */
+    isCreate?: boolean;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 获取所有图标项目配置
+ * @returns 包含图标项目数据的 Promise
+ */
+export declare function genIconProjects(): Promise<{
+    data: IconProjectsData;
+}>;
+/**
+ * 创建或更新图标项目
+ * @param options - 创建/更新选项
+ * @returns 操作结果
+ */
+export declare function createIconProjectOrUpdate({ projectNameZN, projectName, figmaFileId, figmaNodeId, iconfontPrefix, iconfontFamily, cdn, cos, staffName, isCreate, tags, }: CreateIconProjectOptions): Promise<CreateIconProjectResult>;

package/lib/icon-project/index.d.ts

@@ -0,0 +1,2 @@
+export { ICON_PROJECT_WEBHOOK_URL, ICON_PROJECT_PIPELINE_CONFIG, COS_BASE, ICON_PROJECT_CDN, } from './config';
+export { genIconProjects, createIconProjectOrUpdate, type IconProject, type IconProjectsData, type CreateIconProjectOptions, type CreateIconProjectResult, } from './icon-project';

package/lib/image/config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CDN 配置接口
+ */
+export interface CdnConfig {
+    /** CDN 域名 */
+    cdnDomain: string;
+    /** COS 域名 */
+    cosDomain: string;
+    /** 密钥 ID */
+    secretId: string | undefined;
+    /** 密钥 Key */
+    secretKey: string | undefined;
+    /** COS Bucket 名称 */
+    cosBucketName: string;
+    /** COS App ID */
+    cosAppId: string;
+    /** COS 基础域名 */
+    cosBaseDomain: string;
+}
+/**
+ * COS 同步到 Git 的远程流水线 ID
+ */
+export declare const COS_TO_GIT_REMOTE_PIPELINE_ID = "df18b1dc954e49c98271c531a0f40812";

package/lib/image/image.d.ts

@@ -0,0 +1,67 @@
+/**
+ * COS 配置接口
+ */
+export interface CosConfig {
+    secretId?: string;
+    secretKey?: string;
+    bucket: string;
+    region: string;
+    cosPrefix?: string;
+    maxSize?: number;
+}
+/**
+ * 图片记录接口
+ */
+export interface ImageRecord {
+    url: string;
+    parsedUrl: string;
+    [key: string]: any;
+}
+/**
+ * 获取上传图片的文件路径
+ * @param cdn - CDN 域名
+ * @returns 格式化的文件路径，包含年月信息
+ */
+export declare function getUploadImageFilePath(cdn: string): string;
+/**
+ * 获取上传 COS 配置
+ * @param cdn - CDN 域名
+ * @returns COS 配置对象，如果 CDN 无效则返回空对象
+ */
+export declare function getUploadCosConfig(cdn: string): CosConfig | Record<string, never>;
+/**
+ * 解析图片记录，将 COS URL 转换为 CDN URL
+ * @param image - 图片记录对象
+ * @returns 解析后的图片记录，包含 parsedUrl
+ */
+export declare const parseImage: (image: ImageRecord) => ImageRecord;
+/**
+ * 将 COS URL 转换为 CDN URL
+ * 支持 https://、http://、//、纯域名 等多种链接格式
+ * @param inUrl - 输入的 URL
+ * @returns 转换后的 CDN URL
+ * @example
+ * toCdnUrl('https://xxx.cos.ap-guangzhou.myqcloud.com/path/to/file')
+ * toCdnUrl('//xxx.cos.ap-guangzhou.myqcloud.com/path/to/file')
+ * toCdnUrl('http://xxx.cos.ap-guangzhou.myqcloud.com/path/to/file')
+ * toCdnUrl('xxx.cos.ap-guangzhou.myqcloud.com/path/to/file')
+ * toCdnUrl('xxx.cos.ap-guangzhou.myqcloud.com')
+ */
+export declare function toCdnUrl(inUrl: string): string;
+/**
+ * 将 COS URL 转换为 CDN URL
+ * @deprecated 请使用 toCdnUrl 代替
+ * @param inUrl - 输入的 URL
+ * @returns 转换后的 CDN URL
+ */
+export declare const getOneCdnUrl: typeof toCdnUrl;
+/**
+ * 中国大陆 CDN 列表
+ */
+export declare const MAINLAND_CDN_LIST: string[];
+/**
+ * 根据 CDN 获取推送 URL 缓存区域
+ * @param cdn - CDN 域名
+ * @returns 缓存区域，中国大陆返回 'mainland'，否则返回 'overseas'
+ */
+export declare const getPushUrlCacheArea: (cdn: string) => string;

package/lib/image/index.d.ts

@@ -0,0 +1,3 @@
+export { getUploadImageFilePath, getUploadCosConfig, parseImage, toCdnUrl, getOneCdnUrl, MAINLAND_CDN_LIST, getPushUrlCacheArea, type CosConfig, type ImageRecord, } from './image';
+export { uploadFilesCore, } from './upload-core';
+export { COS_TO_GIT_REMOTE_PIPELINE_ID, } from './config';

package/lib/image/upload-core.d.ts

@@ -0,0 +1,83 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { CosConfig } from './image';
+/**
+ * 上传文件接口
+ */
+interface UploadFile {
+    /** 文件大小 */
+    size: number;
+    /** MIME 类型 */
+    mimetype: string;
+    /** 原始文件名 */
+    originalname?: string;
+    /** 文件路径 */
+    path?: string;
+    /** 文件缓冲区 */
+    buffer?: Buffer;
+}
+/**
+ * 上传文件核心选项
+ */
+interface UploadFileCoreOptions {
+    /** 上传的文件 */
+    file: UploadFile;
+    /** 原始文件名 */
+    originName: string;
+    /** 是否使用原始文件名 */
+    useOriginFilename: string;
+    /** 新文件 Key */
+    newFileKey: string;
+    /** 操作员名称 */
+    staffName: string;
+    /** 解析后的目录 */
+    parsedDir: string;
+    /** 上传文件标识 */
+    uploadFile: string;
+    /** CDN 域名 */
+    cdn: string;
+    /** COS 配置 */
+    cos: CosConfig;
+    /** 上传回调函数 */
+    uploadCallBack: () => Promise<{
+        r: number;
+        msg: string;
+        err?: any;
+    } | undefined>;
+    /** 是否来自 MCP */
+    fromMcp?: boolean;
+    /** MCP 数据库实例 */
+    mcpDB?: any;
+    /** MCP 名称 */
+    mcpName?: string;
+    /** MCP 版本 */
+    mcpVersion?: string;
+    /** 图片数据库实例 */
+    imageDB: any;
+    /** 操作记录工具 */
+    operationTool: any;
+}
+/**
+ * 上传结果接口
+ */
+interface UploadResult {
+    /** 返回码 */
+    r: number;
+    /** 消息 */
+    msg: string;
+    /** COS URL */
+    url?: string;
+    /** CDN URL */
+    cdnUrl?: string;
+    /** 错误信息 */
+    err?: any;
+    /** 原始文件名 */
+    originalname?: string;
+}
+/**
+ * 文件上传核心处理函数
+ * @param options - 上传选项
+ * @returns 上传结果
+ */
+export declare function uploadFilesCore({ file, originName, useOriginFilename, newFileKey, staffName, parsedDir, uploadFile, cdn, cos, uploadCallBack, fromMcp, mcpDB, mcpName, mcpVersion, imageDB, operationTool, }: UploadFileCoreOptions): Promise<UploadResult>;
+export {};

package/lib/index.d.ts

@@ -7,19 +7,27 @@ export * from './context';
 export * from './cross-game-style';
 export * from './css';
 export * from './deps';
+export * from './email';
 export * from './eslint-rules';
 export * from './find-dependencies';
+export * from './font-project';
 export * from './gen-version';
 export * from './h5';
 export * from './helper';
+export * from './icon-project';
 export * from './ifdef';
+export * from './image';
 export * from './inject-dynamic-style';
+export * from './landun';
 export * from './loader-file';
 export * from './loader-log';
 export * from './loader-options';
+export * from './mcp';
+export * from './mp-ci';
 export * from './node-module-file';
 export * from './npm-publish';
 export * from './pipeline';
+export * from './pipeline-npm-publish';
 export * from './platform';
 export * from './project-name';
 export * from './replace-manifest';
@@ -27,5 +35,7 @@ export * from './replace-vue-directive';
 export * from './repo';
 export * from './root';
 export * from './sub-project';
+export * from './tinypng';
 export * from './uni-env';
 export * from './v-lazy';
+export * from './white-user';