keepwork-sdk 1.0.0

package/dist-npm/types/src/ui/LoginWindow.d.ts

@@ -0,0 +1,163 @@
+/**
+ * LoginWindow - login modal for KeepworkSDK.
+ *
+ * Features:
+ * - Username/password login
+ * - Registration (username/password)
+ * - WeChat QR login on desktop
+ * - WeChat OAuth redirect login inside WeChat browser
+ * - Google OAuth login (opt-in via googleClientId option)
+ * - English / Chinese i18n (auto-detected from system language)
+ * - Mobile-responsive
+ *
+ * All UI, styles, and logic are self-contained in this file.
+ */
+type LoginStrings = Record<string, string>;
+/**
+ * 宽松的 DOM 元素类型：登录弹窗内的元素可能是 input/button/div，
+ * 这里用交叉类型统一暴露用到的属性（value/disabled/style/focus 等），
+ * 避免在每个 querySelector 处分别断言。运行时行为与原 JS 一致。
+ */
+type LWEl = HTMLInputElement & HTMLButtonElement & HTMLElement & HTMLIFrameElement;
+/** LoginWindow 依赖的 SDK 表面 */
+interface LWSdk {
+    wxAuth?: unknown;
+    login(...args: unknown[]): Promise<Record<string, unknown>>;
+    register?(...args: unknown[]): Promise<unknown>;
+    request?(...args: unknown[]): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<Record<string, unknown>>;
+    get(path: string, query?: unknown): Promise<Record<string, unknown>>;
+    setToken(token: unknown): void;
+    [key: string]: unknown;
+}
+export default class LoginWindow {
+    sdk: LWSdk;
+    _wxAuthInstance: unknown;
+    _overlay: HTMLElement | null;
+    _styleEl: HTMLStyleElement | null;
+    _wechatPollingTimer: ReturnType<typeof setInterval> | null;
+    _resetTimer: ReturnType<typeof setTimeout> | null;
+    _processedWechatCodes: Set<string>;
+    _googlePopup: Window | null;
+    _googlePollingTimer: ReturnType<typeof setInterval> | null;
+    _googleCodeHandled: boolean;
+    _googleMessageHandler: ((e: MessageEvent) => void) | null;
+    _googleSentState: string | null;
+    _viewportHandler: (() => void) | null;
+    _oauthBindCtx: Record<string, unknown> | null;
+    _lang?: string;
+    _strings?: LoginStrings;
+    _title?: string;
+    _platform?: unknown;
+    _machineCode?: unknown;
+    _resolve?: (v: Record<string, unknown>) => void;
+    _reject?: (e: Error) => void;
+    _wechatOptions?: Record<string, string>;
+    _googleOptions?: Record<string, unknown>;
+    [key: string]: unknown;
+    constructor(sdk: unknown);
+    /**
+     * Show the login window.
+     * @param {Object} options
+     * @param {string}  [options.title]          - Custom title
+     * @param {string}  [options.lang]           - 'zhCN' | 'enUS' (auto-detected if omitted)
+     * @param {boolean} [options.enableRegister=true] - Show register view
+     * @param {boolean} [options.enableWechat=true]   - Show WeChat login
+     * @param {string}  [options.wechatAppId]    - WeChat QR connect app id
+     * @param {string}  [options.wechatRedirectUri] - Redirect URI for WeChat QR connect
+     * @param {boolean} [options.enableGoogle]   - Show Google login button (requires googleClientId)
+     * @param {string}  [options.googleClientId] - Google OAuth client id (web). Required to enable Google login.
+     * @param {string}  [options.googleRedirectUri] - Redirect URI registered in Google Cloud Console
+     * @param {string}  [options.googleScope]    - OAuth scope (default: 'openid email profile')
+     * @param {string}  [options.googleState]    - OAuth state (default: 'login')
+     * @param {string}  [options.platform]       - Platform tag forwarded to backend
+     * @param {string}  [options.machineCode]    - Machine code forwarded to backend
+     * @returns {Promise<Object>} Resolves with login/register response on success, rejects on cancel
+     */
+    show(options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Close the login window if open.
+     */
+    close(): void;
+    _renderWechatQrPanel(t: (k: string) => string): string;
+    _renderSocialPanel(t: (k: string) => string, { showGoogle, showWechatRedirect, showPasswordEntry }?: {
+        showGoogle?: boolean;
+        showWechatRedirect?: boolean;
+        showPasswordEntry?: boolean;
+    }): string;
+    _switchView(overlay: HTMLElement, viewId: string): void;
+    _normalizeWechatOptions(options: Record<string, unknown>): Record<string, string>;
+    _getDefaultWechatRedirectUri(): string;
+    _getWechatAuthUrl(): string;
+    _startWechatPolling(overlay: HTMLElement): void;
+    _stopWechatPolling(): void;
+    _maybeHandleWechatCodeFromCurrentUrl(overlay: HTMLElement): void;
+    _handleWechatCode(code: string, state: string | null, overlay: HTMLElement): Promise<void>;
+    _isWechatCodeProcessed(code: string): boolean;
+    _markWechatCodeProcessed(code: string): void;
+    _clearWechatQueryFromCurrentUrl(): void;
+    /**
+     * Check if the current URL contains a WxAuth OAuth redirect code (wxauth=1).
+     * If found, handle the code exchange via WxAuth.codeToToken.
+     */
+    _maybeHandleWxAuthRedirectCode(overlay: HTMLElement): void;
+    /**
+     * Exchange a WxAuth OAuth code for a token using WxAuth.codeToToken.
+     */
+    _handleWxAuthRedirectCode(code: string, overlay: HTMLElement): Promise<void>;
+    _setWechatLoading(overlay: HTMLElement, isLoading: boolean): void;
+    _normalizeGoogleOptions(options: Record<string, unknown>): Record<string, unknown>;
+    _getGoogleAuthUrl(): string;
+    _buildGoogleState(): string;
+    _getGoogleReturnUrl(): string;
+    _decodeGoogleState(state: string | null): Record<string, unknown> | null;
+    _b64urlEncode(str: string): string;
+    _b64urlDecode(b64url: string): string;
+    _startGoogleLogin(overlay: HTMLElement): void;
+    _startGoogleMessageListener(overlay: HTMLElement): void;
+    _stopGoogleMessageListener(): void;
+    _openGooglePopup(url: string): Window | null;
+    _startGooglePolling(overlay: HTMLElement): void;
+    _stopGooglePolling(): void;
+    _closeGooglePopup(): void;
+    _maybeHandleGoogleCodeFromCurrentUrl(overlay: HTMLElement): void;
+    _handleGoogleCode(code: string, state: string | null, overlay: HTMLElement): Promise<void>;
+    _clearGoogleQueryFromCurrentUrl(): void;
+    _setGoogleError(overlay: HTMLElement, keyOrMessage: string): void;
+    _setWechatError(overlay: HTMLElement, keyOrMessage: string): void;
+    _bindPasswordReset(overlay: HTMLElement): void;
+    _startResetCountdown(btn: LWEl, seconds: number): void;
+    _clearResetTimer(): void;
+    _validatePhoneOrEmail(value: string): boolean;
+    _validateResetPassword(password: string): boolean;
+    _extractApiMessage(err: unknown): string;
+    _isCaptchaError(err: unknown, message: string): boolean;
+    _validateUsername(name: string): boolean;
+    /**
+     * 第三方登录探测发现未绑定账号时，进入「设置账号」视图：用户名预填后端建议，
+     * 密码本地生成一串明文显示，二者均可修改。
+     * @param {HTMLElement} overlay
+     * @param {Object} data - 探测返回 { ticket, suggestedUsername, provider, ... }
+     * @param {string} bindPath - 绑定接口路径
+     */
+    _showOauthSetup(overlay: HTMLElement, data: Record<string, unknown>, bindPath: string): void;
+    _doOauthBind(overlay: HTMLElement): Promise<void>;
+    _generatePassword(len?: number): string;
+    _finish(response: Record<string, unknown>): void;
+    /**
+     * Constrain the overlay to the visual viewport so the on-screen keyboard
+     * never hides the lower part of the form (e.g. the third-party login
+     * buttons). When the soft keyboard opens, the layout viewport stays the
+     * same size but the visual viewport shrinks; by pinning the overlay to the
+     * visual viewport the modal stays fully above the keyboard and its content
+     * (which has overflow-y: auto) can be scrolled to reach every button.
+     */
+    _setupViewportHandling(overlay: HTMLElement): void;
+    _teardownViewportHandling(): void;
+    _injectStyles(): void;
+    _destroy(): void;
+    _esc(str: unknown): string;
+    _escapeHTML(str: unknown): string;
+}
+export {};
+//# sourceMappingURL=LoginWindow.d.ts.map

package/dist-npm/types/src/ui/LoginWindow.d.ts.map

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

package/dist-npm/types/src/ui/ProfileWindow.d.ts

@@ -0,0 +1,75 @@
+/**
+ * ProfileWindow - Self-contained user profile modal for KeepworkSDK.
+ *
+ * Features:
+ * - Display username, phone (masked), email
+ * - Change password (old + new + confirm)
+ * - VIP / SVIP status display with expiration dates
+ * - Activation code input for VIP redemption
+ * - English / Chinese i18n (auto-detected from system language)
+ * - Mobile-responsive (full-screen on small viewports)
+ *
+ * All UI, styles, and logic are self-contained in this file.
+ */
+/** show() 选项 */
+export interface ProfileWindowShowOptions {
+    /** 自定义标题 */
+    title?: string;
+    /** 语言：'zhCN' | 'enUS'（省略时自动检测） */
+    lang?: 'zhCN' | 'enUS';
+    /** 是否显示修改密码区（默认 true） */
+    enablePassword?: boolean;
+    /** 是否显示 VIP 区与激活码（默认 true） */
+    enableVip?: boolean;
+}
+/** sdk 需提供的最小接口 */
+interface ProfileWindowSdk {
+    token?: string;
+    getUserProfile(options?: {
+        forceRefresh?: boolean;
+    }): Promise<Record<string, unknown>>;
+    getAuthHeaders(): Record<string, string>;
+    extractMainDomain(hostname: string): string;
+    put(path: string, body?: unknown): Promise<unknown>;
+    logout(): Promise<unknown>;
+    [key: string]: unknown;
+}
+export default class ProfileWindow {
+    sdk: ProfileWindowSdk;
+    private _overlay;
+    private _styleEl;
+    private _pwOverlay;
+    private _lang;
+    private _strings;
+    private _resolve;
+    constructor(sdk: unknown);
+    /**
+     * Show the profile window.
+     * @param {Object} options
+     * @param {string}  [options.title]               - Custom title
+     * @param {string}  [options.lang]                - 'zhCN' | 'enUS' (auto-detected if omitted)
+     * @param {boolean} [options.enablePassword=true] - Show change password section
+     * @param {boolean} [options.enableVip=true]      - Show VIP section with activation code
+     * @returns {Promise<void>} Resolves when the window is closed
+     */
+    show(options?: ProfileWindowShowOptions): Promise<unknown>;
+    /**
+     * Close the profile window if open
+     */
+    close(): void;
+    private _loadProfile;
+    private _bindNicknameEdit;
+    private _renderVipInfo;
+    private _loadTokenUsage;
+    private _bindVipActivation;
+    private _showPasswordPopup;
+    private _maskPhone;
+    private _formatNumber;
+    private _formatDate;
+    private _getTokenPlanUrl;
+    private _injectStyles;
+    private _destroy;
+    private _esc;
+}
+export {};
+//# sourceMappingURL=ProfileWindow.d.ts.map

package/dist-npm/types/src/ui/ProfileWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileWindow.d.ts","sourceRoot":"","sources":["../../../../src/ui/ProfileWindow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,gBAAgB;AAChB,MAAM,WAAW,wBAAwB;IACvC,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,yBAAyB;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAKD,mBAAmB;AACnB,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvF,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA0eD,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,GAAG,EAAE,gBAAgB,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAqC;gBAEzC,GAAG,EAAE,OAAO;IAUxB;;;;;;;;OAQG;IACH,IAAI,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,OAAO,CAAC;IAwH9D;;OAEG;IACH,KAAK,IAAI,IAAI;YAOC,YAAY;IAgD1B,OAAO,CAAC,iBAAiB;IAgEzB,OAAO,CAAC,cAAc;YA8BR,eAAe;IA4C7B,OAAO,CAAC,kBAAkB;IAmE1B,OAAO,CAAC,kBAAkB;IA8F1B,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,IAAI;CAKb"}

package/dist-npm/types/src/ui/VerifyHuman.d.ts

@@ -0,0 +1,23 @@
+/**
+ * VerifyHuman.ts — 纯客户端滑块验证码（"滑动验证"，完整 TypeScript 实现）
+ *
+ * 显示一个滑块拼图，用户需把滑块拖到轨道末端。这是轻量级机器人拦截，
+ * **不**替代服务端限流，但能提高自动化表单提交的门槛。
+ *
+ * @example
+ *   const ok = await VerifyHuman.verify({ lang: 'zhCN' });
+ *   // ok === true → 通过；reject → 用户取消
+ */
+/** verify() 选项 */
+export interface VerifyHumanOptions {
+    /** 语言：'zhCN' | 'enUS'（省略时自动检测） */
+    lang?: 'zhCN' | 'enUS';
+}
+export default class VerifyHuman {
+    /**
+     * 显示滑块验证码并返回 Promise。
+     * @returns 成功时 resolve(true)，用户取消时 reject。
+     */
+    static verify(options?: VerifyHumanOptions): Promise<true>;
+}
+//# sourceMappingURL=VerifyHuman.d.ts.map

package/dist-npm/types/src/ui/VerifyHuman.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VerifyHuman.d.ts","sourceRoot":"","sources":["../../../../src/ui/VerifyHuman.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,kBAAkB;AAClB,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAyJD,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;CAyI/D"}

package/dist-npm/types/src/ui/WorkspaceViewer.d.ts

@@ -0,0 +1,184 @@
+/**
+ * WorkspaceViewer.ts — 工作区文件浏览器 UI 组件（基于 Shadow DOM 的文件树）
+ *
+ * 支持工作区/挂载文件夹切换、文件预览/编辑、搜索、新建、打开/删除文件、原始视图等。
+ */
+/** WorkspaceViewer 构造选项 */
+export interface WorkspaceViewerOptions {
+    /** 挂载容器元素（必填） */
+    container?: HTMLElement;
+    /** KeepworkSDK 实例（默认 window.keepwork） */
+    sdk?: unknown;
+    /** 工作区名（默认 'workspace_default'） */
+    workspace?: string;
+    /** 可选挂载文件夹 */
+    mountFolder?: string;
+    /** 初始打开的文件 */
+    file?: string;
+    /** 隐藏顶栏 */
+    hideTopbar?: boolean;
+    /** 隐藏工具栏 */
+    hideToolbar?: boolean;
+    /** 紧凑布局 */
+    compact?: boolean;
+    /** 显示名映射 */
+    displayNameMap?: Record<string, string>;
+    /** 隐藏的页面根 */
+    hiddenPageRoots?: string[];
+    /** 只读模式 */
+    readOnly?: boolean;
+    /** 隐藏用户信息 */
+    hideUserInfo?: boolean;
+    /** 隐藏搜索 */
+    hideSearch?: boolean;
+    /** 隐藏新建文件 */
+    hideNewFile?: boolean;
+    /** 隐藏打开文件 */
+    hideOpenFile?: boolean;
+    /** 隐藏删除 */
+    hideDelete?: boolean;
+    /** 隐藏原始视图 */
+    hideRawView?: boolean;
+    /** 允许切换工作区 */
+    allowChangeWorkspace?: boolean;
+    /** 允许切换挂载文件夹 */
+    allowChangeMount?: boolean;
+    [key: string]: unknown;
+}
+/** PersonalPageStore（workspace-scoped）结构化接口 */
+interface WVStore {
+    mountedFolder?: unknown;
+    _remoteTreeCache?: unknown;
+    listDir(path: string, recursive?: boolean): Promise<string>;
+    readFile(path: string): Promise<string>;
+    loadPageData(key: string, sub: string | null, a: boolean, b: boolean): Promise<unknown>;
+    savePageData(key: string, sub: string, value: unknown, a: boolean, b: boolean): Promise<unknown>;
+    clearPageData(key: string): Promise<unknown>;
+    clearLocalDisk(key: string): Promise<unknown>;
+    grepSearch(query: string, isRegexp: boolean, fileFilter?: string): Promise<string>;
+    _readMountedFile(key: string): Promise<string | null>;
+    [key: string]: unknown;
+}
+/** WorkspaceViewer 依赖的 SDK 表面 */
+interface WVSdk {
+    token?: unknown;
+    personalPageStore: {
+        withWorkspace(workspace: string, mountFolder: string | null): WVStore;
+        [key: string]: unknown;
+    };
+    getUserProfile(opts: {
+        forceRefresh: boolean;
+    }): Promise<Record<string, unknown>>;
+    showLoginWindow(opts: {
+        title: string;
+    }): Promise<{
+        token?: unknown;
+    } | null>;
+    showProfileWindow(): unknown;
+    [key: string]: unknown;
+}
+/** 页面数据（含可选 content / _metadata / metadata 及任意字段） */
+type WVPageData = (Record<string, unknown> & {
+    content?: unknown;
+    _metadata?: unknown;
+    metadata?: unknown;
+}) | null | undefined;
+/** 内部状态 */
+interface WVState {
+    selectedFile: string | null;
+    viewMode: 'content' | 'raw' | 'edit';
+    fileItems: string[];
+    isMounted: boolean;
+    mountedPageSet: Set<string> | null;
+    selectedFolder: string | null;
+    expandedFolders: Set<string>;
+    folderChildren: Record<string, string[]>;
+    editPageData: {
+        content: string;
+    } | null;
+    absFiles: string[];
+}
+/** 解析后的选项（构造内部使用） */
+interface WVResolvedOptions {
+    workspace: string;
+    mountFolder: string;
+    file: string;
+    hideTopbar: boolean;
+    hideToolbar: boolean;
+    compact: boolean;
+    readOnly: boolean;
+    hideUserInfo: boolean;
+    hideSearch: boolean;
+    hideNewFile: boolean;
+    hideOpenFile: boolean;
+    hideDelete: boolean;
+    hideRawView: boolean;
+    allowChangeWorkspace: boolean;
+    allowChangeMount: boolean;
+}
+export declare class WorkspaceViewer {
+    sdk: WVSdk;
+    StorageUtil: unknown;
+    options: WVResolvedOptions;
+    currentWorkspace: string;
+    displayNameMap: Record<string, string>;
+    hiddenPageRoots: string[];
+    _state: WVState;
+    container: HTMLElement;
+    shadowRoot: ShadowRoot;
+    root: HTMLElement;
+    dom: Record<string, HTMLElement & Record<string, unknown>>;
+    _handlers: Record<string, EventListener>;
+    constructor(options?: WorkspaceViewerOptions);
+    _bindDom(): void;
+    _bindEvents(): void;
+    _applyFeatureFlags(): void;
+    _applyLayoutModes(): void;
+    _initBadges(): void;
+    _updateBadges(): void;
+    initLogin(): Promise<void>;
+    showUser(profile: Record<string, unknown> | null): void;
+    _promptChangeWorkspace(): void;
+    _promptChangeMount(): void;
+    _promptOpenFile(): Promise<void>;
+    switchWorkspace(workspace: string): Promise<void>;
+    setMountFolder(mountFolder: string): Promise<void>;
+    _getMountedStore(): WVStore;
+    _getLocalStore(): WVStore;
+    startWorkspace(): Promise<void>;
+    loadWorkspace(): Promise<void>;
+    renderFileList(): void;
+    renderItems(items: string[], container: HTMLElement, depth: number, parentPath: string): void;
+    toggleFolder(folderPath: string, el: HTMLElement, depth: number): Promise<void>;
+    selectFile(name: string): Promise<void>;
+    loadFileData(): Promise<WVPageData>;
+    _updateRevisionInfo(data: WVPageData): void;
+    renderContent(): Promise<void>;
+    renderEditView(): Promise<void>;
+    syncViewModeUI(): void;
+    setViewMode(mode: 'content' | 'raw' | 'edit'): void;
+    addAbsoluteFile(absPath: string): Promise<boolean>;
+    saveEdit(): Promise<void>;
+    runSearch(): Promise<void>;
+    createNewFile(): Promise<void>;
+    deleteSelected(): Promise<void>;
+    formatValue(v: unknown): string;
+    escapeHtml(s: string): string;
+    _getDisplayName(name: string, parentPath: string): string;
+    _filterVisibleEntries(entries: string[], parentPath: string): string[];
+    _isMarkdownFile(filePath: string): boolean;
+    _formatMarkdownContent(text: string): string;
+    _inlineFormat(text: string): string;
+    _isEditableFile(filePath: string | null): boolean;
+    _isMountedFile(filePath: string): boolean;
+    _getLoadedFileCount(): number;
+    _syncToolbar(): void;
+    refreshWorkspace(): Promise<void>;
+    _toggleFileTreeMobile(): void;
+    _collapseFileTreeMobile(): void;
+    _expandFileTreeMobile(): void;
+    destroy(): void;
+}
+export declare function createWorkspaceViewer(options: WorkspaceViewerOptions): WorkspaceViewer;
+export default WorkspaceViewer;
+//# sourceMappingURL=WorkspaceViewer.d.ts.map

package/dist-npm/types/src/ui/WorkspaceViewer.d.ts.map

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

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

@@ -0,0 +1,173 @@
+/**
+ * SocialFriends.ts — 好友 / 私聊房间 / 站内信 相关 API（完整 TypeScript 实现）
+ *
+ * 封装 coreservice 路由：好友申请、好友关系、黑名单、私聊房间创建/举报、
+ * 关注/粉丝查询、站内信（含奖励领取）、邮箱验证。内置请求限流与缓存。
+ *
+ * @example
+ *   await keepwork.socialFriends.applyFriend(123, 'I am Alice');
+ *   await keepwork.socialFriends.acceptApply(456);
+ *   const friends = await keepwork.socialFriends.list();
+ *   const room = await keepwork.socialFriends.createChatRoom(123);
+ */
+/** 通用选项对象 */
+export type SocialOptions = Record<string, unknown>;
+/** 好友标识：id 或包含 friendId/targetId/userId/id 的对象 */
+export type FriendRef = string | number | {
+    friendId?: string | number;
+    targetId?: string | number;
+    userId?: string | number;
+    id?: string | number;
+    [key: string]: unknown;
+};
+/** 限流错误（带额外字段） */
+export interface RateLimitError extends Error {
+    code: 'SOCIAL_RATE_LIMITED';
+    action: string;
+    rateLimitKey: string;
+    retryAfter: number;
+    retryAfterMs: number;
+}
+/** sdk 需提供的最小接口 */
+interface SocialFriendsSdk {
+    baseURL?: string;
+    getAuthHeaders(): Record<string, string>;
+    request(path: string, options?: {
+        method?: string;
+        body?: unknown;
+    }): Promise<unknown>;
+    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 SocialFriends {
+    static DefaultRateLimitMs: number;
+    /** 各操作的限流间隔（ms）。 */
+    static RateLimitMs: Readonly<Record<string, number>>;
+    /** 好友申请状态枚举。 */
+    static FriendApplyStatus: Readonly<Record<string, number>>;
+    /** 好友关系状态枚举。 */
+    static FriendshipStatus: Readonly<Record<string, number>>;
+    sdk: SocialFriendsSdk;
+    private _rateLimitState;
+    private _rateLimitCache;
+    private _fixedResponseCache;
+    constructor(sdk: unknown);
+    private _getRateLimitMs;
+    private _getRateLimitKey;
+    /** 稳定序列化（键排序），用于生成确定性缓存 key。 */
+    private _stableStringify;
+    /** 强制限流；超限抛 RateLimitError。返回限流 key。 */
+    private _enforceRateLimit;
+    /** 限流 + 缓存：超限时若有缓存则返回缓存。 */
+    private _cachedRateLimitedRequest;
+    /** 固定缓存：命中即返回，否则请求后按 shouldCache 决定是否缓存。 */
+    private _fixedCachedRequest;
+    private _clearCachedAction;
+    /** 清除站内信列表缓存。 */
+    clearMailListCache(): void;
+    /** 递归判断是否已领取奖励。 */
+    private _hasReceivedRewards;
+    /** 去除空值参数。 */
+    private _compactParams;
+    /** 把 core API 基地址改写为指定服务的端点。 */
+    private _getServiceEndpoint;
+    private _getPushManageEndpoint;
+    /** 向指定端点发起请求（相对路径走 sdk.request，绝对 URL 走 fetch）。 */
+    private _requestEndpoint;
+    private _requireId;
+    /** 从 id 或对象中提取好友 id。 */
+    private _normalizeFriendId;
+    /** 归一化申请状态（数字或枚举名）。 */
+    private _normalizeApplyStatus;
+    /** 申请添加好友。 */
+    applyFriend(friendOrOptions: FriendRef, remark?: string): Promise<unknown>;
+    apply(friendOrOptions: FriendRef, remark?: string): Promise<unknown>;
+    requestFriend(friendOrOptions: FriendRef, remark?: string): Promise<unknown>;
+    addFriend(friendOrOptions: FriendRef, remark?: string): Promise<unknown>;
+    /** 处理待处理的好友申请（status: 2/AGREE, 3/REFUSE, 4/BLOCK）。 */
+    processApply(applyId: string | number, status: string | number): Promise<unknown>;
+    acceptApply(applyId: string | number): Promise<unknown>;
+    rejectApply(applyId: string | number): Promise<unknown>;
+    refuseApply(applyId: string | number): Promise<unknown>;
+    blockApply(applyId: string | number): Promise<unknown>;
+    acceptFriendApply(applyId: string | number): Promise<unknown>;
+    rejectFriendApply(applyId: string | number): Promise<unknown>;
+    /** 列出发给当前用户的好友申请。 */
+    listApplies(options?: SocialOptions): Promise<unknown>;
+    getApply(options?: SocialOptions): Promise<unknown>;
+    getApplies(options?: SocialOptions): Promise<unknown>;
+    listApplications(options?: SocialOptions): Promise<unknown>;
+    /** 列出当前用户好友关系（含好友信息和在线状态）。 */
+    list(options?: SocialOptions): Promise<unknown>;
+    getFriendships(options?: SocialOptions): Promise<unknown>;
+    listFriends(options?: SocialOptions): Promise<unknown>;
+    /** 通过用户名搜索当前用户的 Keepwork 好友（旧 /users/friends 路由）。 */
+    searchFriends(options?: SocialOptions | string): Promise<unknown>;
+    getFriends(options?: SocialOptions | string): Promise<unknown>;
+    removeFriend(friendOrOptions: FriendRef): Promise<unknown>;
+    deleteFriend(friendOrOptions: FriendRef): Promise<unknown>;
+    delete(friendOrOptions: FriendRef): Promise<unknown>;
+    remove(friendOrOptions: FriendRef): Promise<unknown>;
+    updateFriend(friendOrOptions: FriendRef, comment?: string): Promise<unknown>;
+    updateRemark(friendOrOptions: FriendRef, comment?: string): Promise<unknown>;
+    setFriendComment(friendOrOptions: FriendRef, comment?: string): Promise<unknown>;
+    addToBlacklist(friendOrOptions: FriendRef): Promise<unknown>;
+    blockFriend(friendOrOptions: FriendRef): Promise<unknown>;
+    blacklist(friendOrOptions: FriendRef): Promise<unknown>;
+    removeFromBlacklist(friendOrOptions: FriendRef): Promise<unknown>;
+    unblockFriend(friendOrOptions: FriendRef): Promise<unknown>;
+    unblacklist(friendOrOptions: FriendRef): Promise<unknown>;
+    listBlacklist(options?: SocialOptions): Promise<unknown>;
+    getBlacklist(options?: SocialOptions): Promise<unknown>;
+    /** 更新在线状态（需 API-key 权限的内部路由）。 */
+    setOnlineStatus(userId: string | number, status: unknown): Promise<unknown>;
+    clearAllOnlineStatus(): Promise<unknown>;
+    getFollowing(options?: SocialOptions): Promise<unknown>;
+    getFollowers(options?: SocialOptions): Promise<unknown>;
+    /** 为当前用户和好友创建或获取私聊房间。 */
+    createChatRoom(targetOrOptions: FriendRef): Promise<unknown>;
+    openPrivateChat(targetOrOptions: FriendRef): Promise<unknown>;
+    createP2PChat(targetOrOptions: FriendRef): Promise<unknown>;
+    createPrivateChatRoom(targetOrOptions: FriendRef): Promise<unknown>;
+    /** 举报私聊违规内容。 */
+    reportChat(options?: SocialOptions): Promise<unknown>;
+    reportUser(reportUserId: string | number, content?: string): Promise<unknown>;
+    reportChatUser(reportUserId: string | number, content?: string): Promise<unknown>;
+    /** 通过 push-manage 发送站内信。 */
+    sendMail(options?: SocialOptions): Promise<unknown>;
+    /** 列出当前用户站内信。 */
+    listMails(options?: SocialOptions): Promise<unknown>;
+    getMails(options?: SocialOptions): Promise<unknown>;
+    listEmails(options?: SocialOptions): Promise<unknown>;
+    getEmails(options?: SocialOptions): Promise<unknown>;
+    deleteMail(mailOrOptions: SocialOptions | string | number | Array<string | number>): Promise<unknown>;
+    delEmail(mailOrOptions: SocialOptions | string | number | Array<string | number>): Promise<unknown>;
+    removeMail(mailOrOptions: SocialOptions | string | number | Array<string | number>): Promise<unknown>;
+    setMailRead(options?: SocialOptions | string | number | Array<string | number>): Promise<unknown>;
+    setEmailReaded(options?: SocialOptions): Promise<unknown>;
+    markMailRead(options?: SocialOptions): Promise<unknown>;
+    getMailReward(options?: SocialOptions): Promise<unknown>;
+    getEmailReward(options?: SocialOptions): Promise<unknown>;
+    claimMailReward(options?: SocialOptions): Promise<unknown>;
+    readMail(mailOrOptions: SocialOptions | string | number): Promise<unknown>;
+    readEmail(mailOrOptions: SocialOptions | string | number): Promise<unknown>;
+    openMail(mailOrOptions: SocialOptions | string | number): Promise<unknown>;
+    /** 请求 Keepwork 邮箱验证码。 */
+    sendEmailCaptcha(emailOrOptions: string | {
+        email?: string;
+    }): Promise<unknown>;
+    requestEmailCaptcha(emailOrOptions: string | {
+        email?: string;
+    }): Promise<unknown>;
+    getEmailCaptcha(emailOrOptions: string | {
+        email?: string;
+    }): Promise<unknown>;
+    /** 验证邮箱验证码并绑定/解绑当前用户邮箱。 */
+    verifyEmail(options?: SocialOptions): Promise<unknown>;
+    bindEmail(email: string, captcha: string): Promise<unknown>;
+    unbindEmail(email: string, captchaOrPassword?: string): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=SocialFriends.d.ts.map