keepwork-sdk 1.0.0

package/dist-npm/types/src/user/SocialFriends.d.ts.map

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

package/dist-npm/types/src/user/UserWorks.d.ts

@@ -0,0 +1,187 @@
+/**
+ * UserWorks.ts — STEAM / 用户作品发布与作品集 API（完整 TypeScript 实现）
+ *
+ * 封装 coreservice 的 `/steam/*` 路由，使页面可上传作品资源、发布作品、
+ * 浏览公开作品、与他人作品互动（点赞/收藏/评论等）。
+ *
+ * @example
+ *   const asset = await keepwork.userWorks.uploadAsset(file);
+ *   await keepwork.userWorks.upload({ title: 'My Game', category: 'AI Game', grade: 'G5', ... });
+ *   const gallery = await keepwork.userWorks.list({ page: 1, pageSize: 20 });
+ */
+/** 上传进度信息 */
+export interface UploadProgress {
+    percent: number;
+    loaded: number;
+    total: number;
+}
+/** 上传进度回调 */
+export type UploadProgressCallback = (progress: UploadProgress) => void;
+/** 资源上传选项 */
+export interface UploadAssetOptions {
+    /** 用户文件夹下的相对 key */
+    key?: string;
+    /** key 前缀（默认 'works'） */
+    prefix?: string;
+    /** 显示文件名 */
+    filename?: string;
+    /** 进度回调 */
+    onProgress?: UploadProgressCallback;
+    /** 自定义上传端点 */
+    uploadUrl?: string;
+}
+/** 资源上传返回结果 */
+export interface UploadAssetResult {
+    key: string;
+    relativeKey: string;
+    url: string;
+    domain: string;
+    bucketName: string | undefined;
+    response: unknown;
+}
+/** 上传 token 信息 */
+interface UploadTokenInfo {
+    token?: string;
+    domain?: string;
+    bucketName?: string;
+    data?: {
+        token?: string;
+        domain?: string;
+        bucketName?: string;
+    };
+}
+/** 作品对象（发布/更新用，字段较松散） */
+export type WorkData = Record<string, unknown>;
+/** 列表查询选项 */
+export interface UserWorksListOptions {
+    page?: number;
+    pageSize?: number;
+    keyword?: string;
+    category?: string;
+    grade?: string;
+    sortBy?: 'hot' | 'latest' | 'rating';
+    status?: number | null;
+    [key: string]: unknown;
+}
+/** 添加评论选项 */
+export interface AddCommentOptions {
+    workId: string | number;
+    rating?: number;
+    content?: string;
+    dimensions?: unknown;
+}
+/** sdk 需提供的最小接口 */
+interface UserWorksSdk {
+    user?: {
+        username?: string;
+    };
+    getUserProfile(): Promise<{
+        username?: string;
+    } | null>;
+    get(path: string, params?: Record<string, unknown>): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+    delete(path: string): Promise<unknown>;
+}
+export default class UserWorks {
+    /** STEAM 项目路由使用的作品状态值。 */
+    static Status: Readonly<{
+        PENDING: 11;
+        APPROVED: 12;
+        REJECTED: 13;
+    }>;
+    sdk: UserWorksSdk;
+    constructor(sdk: unknown);
+    /** 去除空值参数。 */
+    private _compactParams;
+    /** 校验并 encode id。 */
+    private _requireId;
+    /** 取文件扩展名（含点）。 */
+    private _getFileExt;
+    /** 生成随机 id。 */
+    private _randomId;
+    /** 生成资源 key。 */
+    private _generateAssetKey;
+    /** 获取当前用户名（资源上传需要）。 */
+    private _getUsername;
+    /** 拼接公共 URL。 */
+    private _toPublicUrl;
+    /** 把 key 或 URL 归一化为存储 key。 */
+    private _normalizeAssetKey;
+    /** 底层七牛上传（XHR，支持进度）。 */
+    private _qiniuUpload;
+    /**
+     * 获取作品资源 key 的七牛上传 token（后端会把 key 限定在当前用户名下）。
+     */
+    getUploadToken(key: string): Promise<UploadTokenInfo>;
+    /**
+     * 上传作品封面/视频资源到 STEAM 七牛桶。
+     */
+    uploadAsset(file: File | Blob, opts?: UploadAssetOptions): Promise<UploadAssetResult>;
+    /**
+     * 按完整 key 或公共 URL 删除已上传的七牛资源。
+     */
+    deleteAsset(keyOrUrl: string): Promise<unknown>;
+    /** deleteAsset 别名。 */
+    removeAsset(keyOrUrl: string): Promise<unknown>;
+    /**
+     * 发布作品送审。必填：title, category, grade, description, background,
+     * innovation, videoType('video'|'url'), videoUrl。
+     */
+    upload(work: WorkData): Promise<unknown>;
+    /** upload 别名。 */
+    uploadWork(work: WorkData): Promise<unknown>;
+    /** upload 别名。 */
+    create(work: WorkData): Promise<unknown>;
+    /** 更新当前用户的某个作品。 */
+    update(id: string | number, updates?: WorkData): Promise<unknown>;
+    /** update 别名。 */
+    updateWork(id: string | number, updates?: WorkData): Promise<unknown>;
+    /** 删除当前用户的某个作品。 */
+    delete(id: string | number): Promise<unknown>;
+    /** delete 别名。 */
+    remove(id: string | number): Promise<unknown>;
+    /** delete 别名。 */
+    deleteWork(id: string | number): Promise<unknown>;
+    /** 浏览所有用户已审核通过的作品。 */
+    list(options?: UserWorksListOptions): Promise<unknown>;
+    /** list 别名。 */
+    browse(options?: UserWorksListOptions): Promise<unknown>;
+    /** list 别名。 */
+    getPublicWorks(options?: UserWorksListOptions): Promise<unknown>;
+    /** 列出当前用户拥有的作品。 */
+    my(options?: UserWorksListOptions): Promise<unknown>;
+    /** my 别名。 */
+    getMyWorks(options?: UserWorksListOptions): Promise<unknown>;
+    /** my 别名。 */
+    listMine(options?: UserWorksListOptions): Promise<unknown>;
+    /** 获取作品公开详情（后端会增加访问计数）。 */
+    get(id: string | number): Promise<unknown>;
+    /** get 别名。 */
+    getDetail(id: string | number): Promise<unknown>;
+    /** get 别名。 */
+    getWorkDetail(id: string | number): Promise<unknown>;
+    /** 获取当前用户作品汇总统计。 */
+    getStats(): Promise<unknown>;
+    /** getStats 别名。 */
+    getUserWorksStats(): Promise<unknown>;
+    like(id: string | number): Promise<unknown>;
+    unlike(id: string | number): Promise<unknown>;
+    getLikeStatus(id: string | number): Promise<unknown>;
+    favorite(id: string | number): Promise<unknown>;
+    unfavorite(id: string | number): Promise<unknown>;
+    getFavoriteStatus(id: string | number): Promise<unknown>;
+    /** 列出作品的顶层评论/评分。 */
+    listComments(workId: string | number, options?: UserWorksListOptions): Promise<unknown>;
+    /** listComments 别名。 */
+    getComments(workId: string | number, options?: UserWorksListOptions): Promise<unknown>;
+    /** 添加评论/评分。必填：workId, rating, content。 */
+    addComment({ workId, rating, content, dimensions }?: AddCommentOptions): Promise<unknown>;
+    deleteComment(workId: string | number, commentId: string | number): Promise<unknown>;
+    toggleCommentStatus(workId: string | number, disabled: boolean): Promise<unknown>;
+    getAIAnalysis(workId: string | number): Promise<unknown>;
+    triggerAIAnalysis(workId: string | number): Promise<unknown>;
+    generateLessonPlan(workId: string | number): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=UserWorks.d.ts.map

package/dist-npm/types/src/user/UserWorks.d.ts.map

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

package/dist-npm/types/src/utils/ImageUtils.d.ts

@@ -0,0 +1,107 @@
+/** 默认最大字节数（32 KB） */
+export declare const DEFAULT_MAX_BYTES: number;
+/** compressBase64Image / compressDataURI 的选项 */
+export interface CompressOptions {
+    /** 压缩目标上限（字节），默认 32 KB */
+    maxBytes?: number;
+    /** 源 MIME 类型（仅用于解码，默认 'image/png'） */
+    mimeType?: string;
+}
+/** prepareImageInputForProvider 的选项 */
+export interface PrepareImageOptions {
+    /** AI provider 名称（决定是否支持内联图片） */
+    provider?: string;
+    /** KeepworkSDK 实例（上传时用于获取 token） */
+    sdk?: {
+        token?: string | null;
+        getUserId?: () => Promise<string | null | undefined>;
+    };
+    /** 压缩字节上限 */
+    maxBytes?: number;
+    /** 上传时使用的文件名 */
+    fileName?: string;
+    /** 当 provider 不支持内联图片时是否自动上传，默认 true */
+    uploadWhenUnsupported?: boolean;
+}
+/** OpenAI 多模态 content 数组的单个元素 */
+export interface ContentItem {
+    type: string;
+    text?: string;
+    image_url?: {
+        url: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * 估算纯 base64 字符串对应的字节数（不含 data-URI 前缀）。
+ * 公式：`floor(len * 3/4) - padding`
+ */
+declare function base64ByteSize(base64: string): number;
+/**
+ * 拆分 data-URI，返回 `{ mimeType, base64 }`。
+ * 若输入无前缀，MIME 默认为 'image/png'。
+ */
+declare function splitDataURI(dataURI: string): {
+    mimeType: string;
+    base64: string;
+};
+/**
+ * 判断指定 AI provider 是否支持内联 base64 图片。
+ */
+declare function providerSupportsInlineImages(provider: string | undefined): boolean;
+/**
+ * 压缩纯 base64 图像（无 data-URI 前缀）至指定字节上限。
+ *
+ * 压缩策略（按顺序尝试）：
+ * 1. 逐步降低 JPEG 质量（0.8 → 0.6 → 0.4 → 0.2）
+ * 2. 若仍超限，将分辨率减半后重复步骤 1（最多迭代 6 次）
+ *
+ * @param inputBase64 - 纯 base64 字符串（无 data-URI 前缀）
+ * @param options     - 压缩选项
+ * @returns 压缩后的纯 base64（JPEG 格式）
+ */
+export declare function compressBase64Image(inputBase64: string, options?: CompressOptions): Promise<string>;
+/**
+ * 压缩 data-URI 格式图像字符串（如 `data:image/png;base64,...`）。
+ * 若已满足大小要求则原样返回。
+ *
+ * @param dataURI - 完整 data-URI 字符串
+ * @param options - 压缩选项
+ * @returns 压缩后的 data-URI（JPEG 格式）
+ */
+export declare function compressDataURI(dataURI: string, options?: CompressOptions): Promise<string>;
+/**
+ * 扫描 OpenAI 多模态 content 数组，压缩其中超限的内联 base64 图片。
+ * 非图片元素和非 data-URI 的 URL 直接透传，不修改。
+ *
+ * @param contentArray - OpenAI content 数组（`{ type, text?, image_url? }[]`）
+ * @param options      - 压缩选项
+ * @returns 压缩后的新数组（原数组不变）
+ */
+export declare function compressContentImages(contentArray: ContentItem[], options?: CompressOptions): Promise<ContentItem[]>;
+/**
+ * 为指定 AI provider 准备图像输入：
+ * - 若 provider 支持内联图片（Gemini/OpenAI/OpenRouter），压缩后内联返回
+ * - 否则压缩后上传到 Keepwork 临时 CDN，返回 CDN URL
+ * - `uploadWhenUnsupported=false` 时即使不支持也直接返回压缩后的 data-URI
+ *
+ * @param image   - 图像字符串或含 `url` / `image_url.url` 字段的对象
+ * @param options - provider、sdk、maxBytes 等选项
+ */
+export declare function prepareImageInputForProvider(image: string | ContentItem | Record<string, unknown>, options?: PrepareImageOptions): Promise<string | ContentItem | Record<string, unknown>>;
+/**
+ * 上传 base64 图像（或 data-URI）到 Keepwork 临时视觉 CDN。
+ *
+ * 流程（对应 Lua `FileTools.UpLoadVisionFile`）：
+ * 1. 从 `keepwork.shareBlock.getToken` 获取七牛 upload token
+ * 2. 将二进制内容上传到七牛
+ * 3. 返回公开 CDN URL
+ *
+ * @param base64OrDataURI - 纯 base64 或完整 data-URI
+ * @param options         - sdk、fileName、maxBytes 等选项
+ * @returns 公开 CDN URL（如 `https://tempvision.keepwork.com/<key>`）
+ */
+export declare function uploadTempVisionImage(base64OrDataURI: string, options?: PrepareImageOptions): Promise<string>;
+export { base64ByteSize, splitDataURI, providerSupportsInlineImages, };
+//# sourceMappingURL=ImageUtils.d.ts.map

package/dist-npm/types/src/utils/ImageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/ImageUtils.ts"],"names":[],"mappings":"AAgBA,qBAAqB;AACrB,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAI3C,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,GAAG,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;KAAE,CAAC;IACtF,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED;;;GAGG;AACH,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAI3E;AAED;;GAEG;AACH,iBAAS,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI3E;AAqCD;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAuFjB;AA6BD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,4BAA4B,GAC7B,CAAC"}

package/dist-npm/types/src/utils/SDKLogger.d.ts

@@ -0,0 +1,111 @@
+/**
+ * SDKLogger — KeepworkSDK 统一日志管理模块
+ *
+ * 通过模块级 console 代理对象，让宿主项目能够按模块粒度控制
+ * SDK 的日志输出，而无需修改任何现有的 console.log() 调用点。
+ *
+ * ## 使用方式（每个 SDK 源文件顶部）
+ * ```ts
+ * import SDKLogger from './SDKLogger';
+ * const console = SDKLogger.createModuleConsole('ModuleName');
+ * ```
+ * 之后文件内所有 `console.log/info/debug` 均受 SDKLogger 控制；
+ * `console.warn/error` 始终透传，不受影响。
+ *
+ * ## 宿主项目控制示例
+ * ```html
+ * <!-- SDK 加载前预配置 -->
+ * <script>window.__sdkLogConfig = { globalEnabled: false, modules: { AIChat: true } };</script>
+ *
+ * <!-- SDK 加载后动态控制 -->
+ * <script>
+ *   SDKLogger.setGlobalEnabled(false);
+ *   SDKLogger.setModuleEnabled('DigitalHuman', false);
+ *   SDKLogger.setOnlyEnabled(['AIChat', 'AgentRouter']);
+ * </script>
+ * ```
+ *
+ * ## 实现原理
+ * `createModuleConsole` 返回的代理对象对 `log/info/debug` 使用 getter，
+ * 每次访问时检查当前启用状态，返回原生绑定函数或 noop。
+ * 这样 DevTools 的调用栈源码链接和 Source Map 仍指向原始调用点。
+ */
+/** 受控方法：可被静默 */
+declare const _filteredMethods: readonly ["log", "info", "debug"];
+type FilteredMethod = (typeof _filteredMethods)[number];
+/** 透传方法：始终输出 */
+declare const _passthroughMethods: readonly ["warn", "error", "table", "dir", "group", "groupCollapsed", "groupEnd", "time", "timeEnd", "timeLog", "trace", "assert", "clear", "count", "countReset"];
+type PassthroughMethod = (typeof _passthroughMethods)[number];
+/**
+ * 模块 console 代理类型：
+ * - 受控方法（log/info/debug）：通过 getter 动态检查启用状态
+ * - 透传方法（warn/error 等）：始终指向原生方法
+ *
+ * 与 `Console` 接口的签名兼容，可安全遮蔽全局 `console`。
+ */
+export type ModuleConsole = Pick<Console, FilteredMethod | PassthroughMethod>;
+declare class SDKLogger {
+    /** 全局启用开关（默认开启，向后兼容） */
+    private static _globalEnabled;
+    /**
+     * 各模块的独立启用状态。
+     * - `true`：该模块已明确启用
+     * - `false`：该模块已明确禁用
+     * - 未设置（undefined）：视为启用（默认开）
+     */
+    private static _modules;
+    /**
+     * 检查指定模块的 log/info/debug 输出当前是否启用。
+     *
+     * 判断顺序：全局开关 → 模块开关（未设置视为 true）。
+     */
+    static isEnabled(moduleName: string): boolean;
+    /**
+     * 全局开关：启用或禁用所有模块的 log/info/debug 输出。
+     *
+     * @param enabled - true 启用，false 禁用全部
+     */
+    static setGlobalEnabled(enabled: boolean): void;
+    /**
+     * 按模块名单独控制日志输出。
+     *
+     * @param moduleName - 与 createModuleConsole 传入的名称一致
+     * @param enabled    - true 启用，false 禁用
+     */
+    static setModuleEnabled(moduleName: string, enabled: boolean): void;
+    /**
+     * 便捷方法：只启用指定模块，其余全部禁用。
+     * 适合调试时聚焦特定模块。
+     *
+     * @param names - 要保留输出的模块名数组
+     */
+    static setOnlyEnabled(names: string[]): void;
+    /**
+     * 返回所有已注册模块及其当前启用状态的快照。
+     * 可用于调试或在宿主页面展示日志控制面板。
+     */
+    static listModules(): Record<string, boolean>;
+    /**
+     * 为指定模块创建 console 代理对象。
+     *
+     * 返回的代理对象与 `console` 接口兼容，可直接在文件顶部用
+     * `const console = SDKLogger.createModuleConsole('X')` 遮蔽全局 console。
+     *
+     * - `log/info/debug`：通过 getter 惰性检查启用状态，每次调用前查询
+     * - `warn/error` 等：直接绑定原生方法，始终透传
+     * - DevTools 调用栈/Source Map 仍指向原始调用位置（因使用 .bind 而非包装函数）
+     *
+     * @param moduleName - 模块唯一标识（建议与类名或文件名一致）
+     * @returns 与 Console 兼容的代理对象
+     */
+    static createModuleConsole(moduleName: string): ModuleConsole;
+    /**
+     * 读取 window.__sdkLogConfig 预配置（如果存在）。
+     * 在模块求值时立即调用，支持宿主页面在 SDK 加载前配置日志行为。
+     *
+     * @internal
+     */
+    private static _applyPreConfig;
+}
+export default SDKLogger;
+//# sourceMappingURL=SDKLogger.d.ts.map

package/dist-npm/types/src/utils/SDKLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SDKLogger.d.ts","sourceRoot":"","sources":["../../../../src/utils/SDKLogger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AASH,gBAAgB;AAChB,QAAA,MAAM,gBAAgB,mCAAoC,CAAC;AAC3D,KAAK,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,gBAAgB;AAChB,QAAA,MAAM,mBAAmB,oKAIf,CAAC;AACX,KAAK,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAI9D;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAC;AAI9E,cAAM,SAAS;IACb,wBAAwB;IACxB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAQ;IAErC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+B;IAItD;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAM7C;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI/C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAInE;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAW5C;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ7C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IA0C7D;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CAa/B;AAKD,eAAe,SAAS,CAAC"}

package/dist-npm/types/src/utils/translation.d.ts

@@ -0,0 +1,95 @@
+/**
+ * translation.ts — KeepworkSDK 国际化模块（完整 TypeScript 实现）
+ *
+ * 以中文文本作为 key，外部 JSON 提供其他语言翻译；缺失翻译时回退中文。
+ * 语言解析顺序：URL 参数 `?lang=enUS` > localStorage `keepwork_ui_lang` > navigator.language。
+ * 完整 API 见 docs/translation.md。
+ */
+/** Translation 构造选项 */
+export interface TranslationOptions {
+    /** 语言代码 → JSON URL 的映射 */
+    localeFiles?: Record<string, string>;
+    /** 回退语言代码（默认 'zhCN'） */
+    defaultLang?: string;
+    /** 是否在构造时立即调用 init()（默认 false） */
+    autoInit?: boolean;
+}
+/** 翻译变量映射（用于 `{var}` 插值） */
+export type TranslationVars = Record<string, string | number>;
+/** 翻译表（扁平 key → 译文） */
+type TranslationMap = Record<string, string>;
+/**
+ * Translation — 可复用的 i18n 模块。
+ *
+ * 通常通过 `window.i18n` 访问共享实例（由 installI18nGlobals 安装）；
+ * 也可直接 `new Translation(options)` 创建独立实例。
+ */
+export default class Translation {
+    private _STORAGE_KEY;
+    private _localeFiles;
+    private _defaultLang;
+    private _currentLang;
+    private _translations;
+    private _isLoading;
+    private _loadPromise;
+    private _initPromise;
+    constructor(options?: TranslationOptions);
+    /**
+     * 检测系统语言并映射到支持的语言代码。
+     */
+    private _detectSystemLang;
+    /**
+     * 解析当前 UI 语言。优先级：URL 参数 > localStorage > 系统语言。
+     */
+    private _resolveCurrentLang;
+    /**
+     * 从 JSON 文件加载翻译。
+     * @param lang - 要加载的语言代码（默认当前语言）
+     */
+    loadTranslations(lang?: string): Promise<TranslationMap>;
+    /**
+     * 初始化 i18n：解析语言、加载翻译、应用 DOM 翻译。
+     */
+    init(): Promise<string>;
+    /**
+     * 翻译文本。构造时会 bind 为实例属性 this.t（可作为独立函数传递）。
+     * @param key  - 以中文文本作为 key
+     * @param vars - 用于替换 `{varName}` 的变量
+     */
+    t(key: string, vars?: TranslationVars): string;
+    /**
+     * 把翻译应用到所有带 data-i18n 属性的元素。
+     */
+    applyTranslations(): void;
+    /**
+     * 设置 UI 语言并重新加载翻译（会刷新页面以应用）。
+     */
+    setLang(lang: string): Promise<void>;
+    /** 获取当前语言代码。 */
+    getLang(): string;
+    /** 翻译是否已就绪。 */
+    isReady(): boolean;
+    /** 返回初始化完成的 Promise。 */
+    ready(): Promise<unknown>;
+    /**
+     * 合并额外翻译（不覆盖已有 key）。支持扁平或单层嵌套对象。
+     */
+    mergeTranslations(extra: Record<string, unknown>): void;
+    /**
+     * 注册更多语言文件路径（懒加载）。
+     */
+    addLocaleFiles(files: Record<string, string>): void;
+    /** [语言学习] 获取原生语言（= UI 语言）。 */
+    getNativeLanguage(): string;
+    /** [语言学习] 获取目标语言（单独存储）。 */
+    getTargetLanguage(): string;
+}
+/**
+ * 在 window 上安装向后兼容的全局变量（由 bundle 入口 index.ts 自动调用）：
+ * - `window.i18n`         — Translation 实例
+ * - `window.t(key,vars)`  — i18n.t() 快捷方式
+ * - `window.GetDisplayLanguage()` — 返回当前语言代码
+ */
+export declare function installI18nGlobals(instance: Translation): void;
+export {};
+//# sourceMappingURL=translation.d.ts.map

package/dist-npm/types/src/utils/translation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.d.ts","sourceRoot":"","sources":["../../../../src/utils/translation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,uBAAuB;AACvB,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,4BAA4B;AAC5B,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAE9D,uBAAuB;AACvB,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAQ7C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,YAAY,CAAyB;gBAEjC,OAAO,GAAE,kBAAuB;IAkB5C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;OAGG;IACG,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuC9D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAkB7B;;;;OAIG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM;IAgB9C;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAezB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1C,gBAAgB;IAChB,OAAO,IAAI,MAAM;IAIjB,eAAe;IACf,OAAO,IAAI,OAAO;IAIlB,wBAAwB;IACxB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAevD;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAInD,8BAA8B;IAC9B,iBAAiB,IAAI,MAAM;IAI3B,2BAA2B;IAC3B,iBAAiB,IAAI,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAU9D"}

package/dist-npm/types/src/wechat/WxAuth.d.ts

@@ -0,0 +1,126 @@
+/**
+ * WxAuth.ts — 微信网页授权登录模块（完整 TypeScript 实现）
+ *
+ * 提供微信 OAuth2.0 网页授权登录：环境检测、跳转授权、code 换 token、
+ * code 探测绑定状态、自动授权流程。依赖 WxUtils 工具函数。
+ */
+import { detectWxEnvironment } from './WxUtils';
+/** WxAuth 构造选项 */
+export interface WxAuthOptions {
+    /** 微信 App ID（默认 'wx7935c49369d421c1'） */
+    appId?: string;
+    /** 麦思星球微信 App ID */
+    maisiAppId?: string;
+    /** 授权 scope（'snsapi_base' / 'snsapi_userinfo'，默认后者） */
+    scope?: string;
+    /** 是否自动注册（默认 false） */
+    autoRegister?: boolean;
+    /** token Cookie 过期天数（默认 14） */
+    tokenCookieDays?: number;
+}
+/** authorize() 选项 */
+export interface WxAuthorizeOptions {
+    appId?: string;
+    redirectUri?: string;
+    scope?: string;
+    state?: string;
+    extraParams?: Record<string, string>;
+}
+/** codeToToken() 选项 */
+export interface CodeToTokenOptions {
+    appId?: string;
+    autoRegister?: boolean;
+    channel?: string;
+    onSuccess?: (response: unknown) => void;
+    onFail?: (error: Error) => void;
+    refreshPage?: boolean;
+}
+/** codeToToken() / codeToProbe() 返回结果 */
+export interface WxAuthResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    isMaisi?: boolean;
+}
+/** autoAuth() 选项 */
+export interface AutoAuthOptions extends WxAuthorizeOptions {
+    autoRegister?: boolean;
+    channel?: string;
+    onSuccess?: (response: unknown) => void;
+    onFail?: (error: Error) => void;
+    /** 是否仅在生产环境执行（默认 true） */
+    productionOnly?: boolean;
+    refreshPage?: boolean;
+}
+/** autoAuth() 返回结果 */
+export interface AutoAuthResult {
+    success: boolean;
+    reason?: string;
+    message?: string;
+    data?: unknown;
+    error?: string;
+    isMaisi?: boolean;
+}
+/** 当前配置 */
+export interface WxAuthConfig {
+    appId: string;
+    maisiAppId: string;
+    scope: string;
+    autoRegister: boolean;
+    isAuthFailed: boolean;
+}
+/** sdk 需提供的最小接口 */
+interface WxAuthSdk {
+    setToken(token: string): void;
+}
+export default class WxAuth {
+    sdk: WxAuthSdk | null;
+    appId: string;
+    maisiAppId: string;
+    scope: string;
+    autoRegister: boolean;
+    wxAuthUrl: string;
+    tokenCookieDays: number;
+    /** 授权失败状态标记，防止循环授权 */
+    isAuthFailed: boolean;
+    constructor(sdk: unknown, options?: WxAuthOptions);
+    /** 是否在微信浏览器中。 */
+    isWechatBrowser(): boolean;
+    /** 获取微信环境详细信息。 */
+    getEnvironment(): ReturnType<typeof detectWxEnvironment>;
+    /** 是否在 iframe 中。 */
+    isInIframe(): boolean;
+    /** 获取当前 URL 中的授权 code。 */
+    getCodeFromUrl(): string | null;
+    /** 检查当前是否已登录（有 token）。 */
+    isLoggedIn(): boolean;
+    /**
+     * 跳转到微信授权页面。
+     */
+    authorize(options?: WxAuthorizeOptions): void;
+    /**
+     * 使用授权 code 换取 token。
+     */
+    codeToToken(code: string, options?: CodeToTokenOptions): Promise<WxAuthResult>;
+    /**
+     * 使用授权 code「探测」是否已绑定账号（微信内公众号网页授权，不自动注册）。
+     * 已绑定返回用户信息+token；未绑定返回 { needBind, ticket, ... } 由调用方确认。
+     */
+    codeToProbe(code: string, options?: {
+        appId?: string;
+    }): Promise<WxAuthResult>;
+    /**
+     * 自动授权流程入口：检测环境/登录状态，自动发起授权或处理回调。
+     */
+    autoAuth(options?: AutoAuthOptions): Promise<AutoAuthResult>;
+    /** 重置授权失败状态（用户手动登录或重试授权时调用）。 */
+    resetAuthFailedState(): void;
+    /** 设置默认 App ID。 */
+    setAppId(appId: string): void;
+    /** 设置授权作用域。 */
+    setScope(scope: string): void;
+    /** 获取当前配置。 */
+    getConfig(): WxAuthConfig;
+}
+export {};
+//# sourceMappingURL=WxAuth.d.ts.map