@deeprespond/im-tauri 0.0.0-stage → 1.0.0-alpha

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import * as _deeprespond_im_web_platform from '@deeprespond/im-web/platform';
+import * as _deeprespond_im_web from '@deeprespond/im-web';
+export * from '@deeprespond/im-web';
+import { B as Bridge, e as DRTauriClient } from './types-CVlFmFSn.js';
+export { a as DREngine, b as DRTauriEngineClient, D as DRTauriEngineOptions, f as DesktopEventMethods, c as DesktopEvents, g as DesktopInfo, d as DesktopModule, h as DesktopNotification, i as DownloadParams, j as DownloadTask, E as EngineAlert, k as EngineState, N as NotificationClickEvent } from './types-CVlFmFSn.js';
+
+/** 本包的版本，必须与 Rust 插件 tauri-plugin-deeprespond-im 相同（《2.功能概述文档》第 13 节）。 */
+declare const TAURI_SDK_VERSION: string;
+
+/**
+ * 创建界面窗口的客户端（《3.接口设计》第 4 节）：对 App 来说就是 Web SDK 的 DRClient，另有 desktop 和 engineState。
+ * 只需要 AppKey：服务端地址等由引擎决定；读本地存储由插件的只读连接直接返回，其他调用都转给引擎。
+ */
+declare function createDRTauriClient(options: {
+    appKey: string;
+    logger?: {
+        level?: 'error' | 'warn' | 'info' | 'debug';
+        sink?: (entry: _deeprespond_im_web.LogEntry) => void;
+    };
+}, env?: {
+    bridge: Bridge;
+    overrides?: Partial<_deeprespond_im_web_platform.PlatformAdapter>;
+}): DRTauriClient;
+/**
+ * 接收拖入本窗口的文件（《3.接口设计》第 6 节）：插件在 Rust 中登记路径后才交给窗口，只交回可读的普通文件。
+ * 返回取消监听的函数。
+ */
+declare function onFilesDropped(handler: (paths: string[]) => void, env?: {
+    bridge: Bridge;
+}): () => void;
+
+export { DRTauriClient, TAURI_SDK_VERSION, createDRTauriClient, onFilesDropped };

package/dist/index.js

@@ -0,0 +1,93 @@
+import { currentLabel, unsupported, ENGINE_LABEL, Bridge, makeLogger, Desktop, createTauriPlatform, osFromUserAgent, clickEvent, invalidState } from './chunk-DMEEI2YZ.js';
+export { TAURI_SDK_VERSION } from './chunk-DMEEI2YZ.js';
+import { DRError, createDRClient } from '@deeprespond/im-web';
+export * from '@deeprespond/im-web';
+
+function createDRTauriClient(options, env) {
+  const label = env ? env.bridge.label : currentLabel();
+  if (label === null) throw unsupported("not_tauri", "createDRTauriClient 只能在 Tauri 应用的窗口中调用");
+  if (label === ENGINE_LABEL) throw unsupported("not_ui_window", "引擎页中用 createDRTauriEngine");
+  if (!options || typeof options.appKey !== "string" || !/^[^#\s]+#[^#\s]+$/.test(options.appKey)) {
+    throw new DRError({ code: "local_validation", message: "appKey", details: { reason: "invalid_format", field: "appKey" }, source: "local" });
+  }
+  const bridge = env?.bridge ?? Bridge.get();
+  const logger = makeLogger(bridge, options.logger);
+  const warn = (message, err) => logger.sink({ level: "warn", time: Date.now(), module: "tauri", message, code: err instanceof DRError ? err.code : void 0, reason: err instanceof DRError ? err.reason : void 0 });
+  let client;
+  let engineState = "starting";
+  let bridgeError = null;
+  const desktop = new Desktop(bridge, () => client);
+  const tp = createTauriPlatform({
+    role: "follower",
+    appKey: options.appKey,
+    bridge,
+    onWarn: warn,
+    extend: () => ({
+      desktop: { value: desktop, enumerable: true },
+      engineState: { get: () => engineState, enumerable: true }
+    })
+  });
+  if (env?.overrides) Object.assign(tp.platform, env.overrides);
+  tp.platform.fatalError = () => bridgeError ? { code: bridgeError.code, details: bridgeError.details } : null;
+  tp.platform.leaderUnavailable = () => {
+    if (bridgeError) return { code: bridgeError.code, details: bridgeError.details };
+    if (bridge.info?.another_instance) return { code: "invalid_state", details: { reason: "another_instance" } };
+    return { code: "engine_unavailable", details: { reason: engineState === "ready" ? "starting" : engineState } };
+  };
+  client = createDRClient({
+    appKey: options.appKey,
+    // 界面窗口不直接访问服务端（全部转给引擎），只为满足选项的格式
+    apiUrl: "http://engine.invalid",
+    platform: osFromUserAgent(typeof navigator !== "undefined" ? navigator.userAgent : ""),
+    logger,
+    platformAdapter: tp.platform
+  });
+  const host = tp.host();
+  const setState = (state, appKeys) => {
+    const next = state === "ready" && Array.isArray(appKeys) && !appKeys.includes(options.appKey) ? "starting" : state;
+    if (next === engineState) return;
+    engineState = next;
+    tp.setEngineState(next);
+    if (next === "restarting" || next === "failed") host.forgetLeader();
+    if (next === "restarting" || next === "failed") void client.channels.current?.leave().catch(() => {
+    });
+    host.emit("engine.stateChanged", { state: next });
+  };
+  let eventSeen = false;
+  void bridge.ready.then(
+    (info) => {
+      if (!eventSeen) setState(info.engine_state, info.app_keys);
+      if (info.another_instance) setState("failed", []);
+      if (info.launch_click) host.emit("desktop.notificationClicked", clickEvent(bridge, { t: "notification_click", ...info.launch_click, launched: true }));
+    },
+    (err) => {
+      bridgeError = err instanceof DRError ? err : invalidState("plugin");
+      warn("与插件的连接失败", err);
+      setState("failed", []);
+    }
+  );
+  bridge.on("engine", (event) => {
+    eventSeen = true;
+    setState(event.state, event.app_keys);
+  });
+  bridge.on("notification_click", (event) => host.emit("desktop.notificationClicked", clickEvent(bridge, event)));
+  bridge.on("exit", () => {
+    void client.channels.current?.leave().catch(() => {
+    });
+  });
+  bridge.on("resume", () => {
+    void client.channels.current?.refresh().catch(() => {
+    });
+  });
+  return client;
+}
+function onFilesDropped(handler, env) {
+  if (!env && currentLabel() === null) throw unsupported("not_tauri", "onFilesDropped 只能在 Tauri 应用的窗口中调用");
+  return (env?.bridge ?? Bridge.get()).on("files_dropped", (event) => {
+    if (Array.isArray(event.paths)) handler(event.paths.filter((p) => typeof p === "string"));
+  });
+}
+
+export { createDRTauriClient, onFilesDropped };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { DRError, createDRClient, type DRClient } from '@deeprespond/im-web';\nimport { createTauriPlatform, osFromUserAgent } from './adapter';\nimport { Bridge, ENGINE_LABEL, currentLabel, type EngineState } from './adapter/ipc';\nimport { clickEvent, invalidState, makeLogger, unsupported } from './common';\nimport { Desktop } from './desktop/module';\nimport type { DRTauriClient } from './types';\n\nexport * from '@deeprespond/im-web';\nexport type { DesktopModule, DesktopNotification, DownloadParams, DownloadTask, DesktopInfo, DRTauriClient, DRTauriEngineClient, DesktopEventMethods, EngineState, NotificationClickEvent, DesktopEvents, EngineAlert, DRTauriEngineOptions, DREngine } from './types';\nexport { TAURI_SDK_VERSION } from './version';\n\n/**\n * 创建界面窗口的客户端（《3.接口设计》第 4 节）：对 App 来说就是 Web SDK 的 DRClient，另有 desktop 和 engineState。\n * 只需要 AppKey：服务端地址等由引擎决定；读本地存储由插件的只读连接直接返回，其他调用都转给引擎。\n */\nexport function createDRTauriClient(options: { appKey: string; logger?: { level?: 'error' | 'warn' | 'info' | 'debug'; sink?: (entry: import('@deeprespond/im-web').LogEntry) => void } }, env?: { bridge: Bridge; overrides?: Partial<import('@deeprespond/im-web/platform').PlatformAdapter> }): DRTauriClient {\n  const label = env ? env.bridge.label : currentLabel();\n  if (label === null) throw unsupported('not_tauri', 'createDRTauriClient 只能在 Tauri 应用的窗口中调用');\n  if (label === ENGINE_LABEL) throw unsupported('not_ui_window', '引擎页中用 createDRTauriEngine');\n  if (!options || typeof options.appKey !== 'string' || !/^[^#\\s]+#[^#\\s]+$/.test(options.appKey)) {\n    throw new DRError({ code: 'local_validation', message: 'appKey', details: { reason: 'invalid_format', field: 'appKey' }, source: 'local' });\n  }\n  const bridge = env?.bridge ?? Bridge.get();\n  const logger = makeLogger(bridge, options.logger);\n  const warn = (message: string, err?: unknown) =>\n    logger.sink({ level: 'warn', time: Date.now(), module: 'tauri', message, code: err instanceof DRError ? err.code : undefined, reason: err instanceof DRError ? err.reason : undefined });\n  let client!: DRClient;\n  let engineState: EngineState = 'starting';\n  let bridgeError: DRError | null = null;\n  const desktop = new Desktop(bridge, () => client);\n  const tp = createTauriPlatform({\n    role: 'follower',\n    appKey: options.appKey,\n    bridge,\n    onWarn: warn,\n    extend: () => ({\n      desktop: { value: desktop, enumerable: true },\n      engineState: { get: () => engineState, enumerable: true },\n    }),\n  });\n  if (env?.overrides) Object.assign(tp.platform, env.overrides);\n  // 界面窗口不等插件的初始化（登录状态要同步可用），版本不同等致命错误在之后的调用中报告\n  tp.platform.fatalError = () => (bridgeError ? { code: bridgeError.code, details: bridgeError.details } : null);\n  // 转发的调用在引擎不可用时的错误：版本不同、另一个进程、引擎启动中或重建中（《3.接口设计》第 7 节）\n  tp.platform.leaderUnavailable = () => {\n    if (bridgeError) return { code: bridgeError.code, details: bridgeError.details };\n    if (bridge.info?.another_instance) return { code: 'invalid_state', details: { reason: 'another_instance' } };\n    return { code: 'engine_unavailable', details: { reason: engineState === 'ready' ? 'starting' : engineState } };\n  };\n  client = createDRClient({\n    appKey: options.appKey,\n    // 界面窗口不直接访问服务端（全部转给引擎），只为满足选项的格式\n    apiUrl: 'http://engine.invalid',\n    platform: osFromUserAgent(typeof navigator !== 'undefined' ? navigator.userAgent : ''),\n    logger,\n    platformAdapter: tp.platform,\n  });\n  const host = tp.host();\n  const setState = (state: EngineState, appKeys: unknown) => {\n    // 引擎就绪但还没有创建这个 AppKey 的客户端：仍为 starting\n    const next: EngineState = state === 'ready' && Array.isArray(appKeys) && !appKeys.includes(options.appKey) ? 'starting' : state;\n    if (next === engineState) return;\n    engineState = next;\n    tp.setEngineState(next);\n    if (next === 'restarting' || next === 'failed') host.forgetLeader();\n    if (next === 'restarting' || next === 'failed') void client.channels.current?.leave().catch(() => {});\n    host.emit('engine.stateChanged', { state: next });\n  };\n  // hello 的结果是那一刻的快照：之后经 Channel 到达的 engine 事件更新（事件可能先于 hello 的结果到达，不能被旧快照覆盖）\n  let eventSeen = false;\n  void bridge.ready.then(\n    (info) => {\n      if (!eventSeen) setState(info.engine_state, info.app_keys);\n      if (info.another_instance) setState('failed', []);\n      if (info.launch_click) host.emit('desktop.notificationClicked', clickEvent(bridge, { t: 'notification_click', ...info.launch_click, launched: true }));\n    },\n    (err) => {\n      bridgeError = err instanceof DRError ? err : invalidState('plugin');\n      warn('与插件的连接失败', err);\n      setState('failed', []);\n    },\n  );\n  bridge.on('engine', (event) => {\n    eventSeen = true;\n    setState(event.state as EngineState, event.app_keys);\n  });\n  bridge.on('notification_click', (event) => host.emit('desktop.notificationClicked', clickEvent(bridge, event)));\n  bridge.on('exit', () => { void client.channels.current?.leave().catch(() => {}); });\n  bridge.on('resume', () => { void client.channels.current?.refresh().catch(() => {}); });\n  return client as unknown as DRTauriClient;\n}\n\n/**\n * 接收拖入本窗口的文件（《3.接口设计》第 6 节）：插件在 Rust 中登记路径后才交给窗口，只交回可读的普通文件。\n * 返回取消监听的函数。\n */\nexport function onFilesDropped(handler: (paths: string[]) => void, env?: { bridge: Bridge }): () => void {\n  if (!env && currentLabel() === null) throw unsupported('not_tauri', 'onFilesDropped 只能在 Tauri 应用的窗口中调用');\n  return (env?.bridge ?? Bridge.get()).on('files_dropped', (event) => {\n    if (Array.isArray(event.paths)) handler(event.paths.filter((p): p is string => typeof p === 'string'));\n  });\n}\n"]}

package/dist/types-CVlFmFSn.d.ts

@@ -0,0 +1,277 @@
+import { DRClient, DREvents, MessageView, NotifyDecision, CallHandle, TicketContext, DRClientOptions } from '@deeprespond/im-web';
+
+/** hello 的结果：本页面在插件中的身份、系统信息和引擎状态。 */
+interface HelloInfo {
+    instance: number;
+    label: string;
+    engine: boolean;
+    plugin_version: string;
+    protocol: number;
+    os: 'windows' | 'macos' | 'linux';
+    os_version: string;
+    arch: string;
+    computer_name: string;
+    webview_version: string;
+    device_id: string;
+    data_dir: string;
+    temp_dir: string;
+    another_instance: boolean;
+    engine_state: EngineState$1;
+    app_keys: string[];
+    launch_click: Record<string, unknown> | null;
+    main_window: string;
+    log_file?: boolean;
+    window: {
+        visible: boolean;
+        focused: boolean;
+        minimized: boolean;
+        screen_locked: boolean;
+    } | null;
+}
+type EngineState$1 = 'starting' | 'ready' | 'restarting' | 'failed';
+/** 插件经 Channel 交来的事件（《4.实现与测试》第 4 节）。 */
+interface PluginEvent {
+    t: string;
+    [key: string]: unknown;
+}
+type Listener = (event: PluginEvent) => void;
+/** 调用插件的方式（测试中换成假的插件）。 */
+interface Transport {
+    invoke<T>(cmd: string, args?: unknown, options?: {
+        headers: Record<string, string>;
+    }): Promise<T>;
+    /** 建立事件通道：返回交给 hello 的参数值。 */
+    channel(onEvent: (event: PluginEvent) => void): unknown;
+}
+/**
+ * 与插件的连接（每个页面一个）：第一个命令 hello 交来 Channel，插件之后的事件都经它按顺序到达。
+ * 版本检查：JavaScript 包与插件的版本、协议不同的以 unsupported（version_mismatch）拒绝（《2.功能概述文档》第 13 节）。
+ */
+declare class Bridge {
+    #private;
+    static get(): Bridge;
+    /** 测试用：指定本页面的连接（假的插件）。 */
+    static use(bridge: Bridge | null): void;
+    readonly label: string;
+    readonly isEngine: boolean;
+    readonly ready: Promise<HelloInfo>;
+    constructor(label: string, transport?: Transport);
+    /** hello 之后的信息；之前为 null。 */
+    get info(): HelloInfo | null;
+    /** 调用插件命令（等 hello 完成）。 */
+    call<T>(command: string, args?: Record<string, unknown>): Promise<T>;
+    /** 原始字节的请求体（Blob 落盘），参数放在请求头中。 */
+    callRaw<T>(command: string, body: Uint8Array, headers: Record<string, string>): Promise<T>;
+    on(type: string, listener: Listener): () => void;
+}
+
+/** 桌面模块（《3.接口设计》第 5 节）：界面窗口的客户端和引擎（engine.client）都有。 */
+interface DesktopModule {
+    /** 显示系统通知（manual 模式下使用；auto 模式下也可以显示 App 自己的通知）。id 不能以 dr: 开头。 */
+    notify(n: DesktopNotification): Promise<void>;
+    clearNotifications(p?: {
+        conversation_id?: string;
+    }): Promise<void>;
+    /** macOS 为系统授权；Windows 读取用户或组策略是否关闭了本应用的通知；Linux 总是 granted。 */
+    notificationPermission(): Promise<'granted' | 'denied' | 'default'>;
+    requestNotificationPermission(): Promise<'granted' | 'denied'>;
+    /** badge 为 manual 时使用；null 清除。 */
+    setBadge(count: number | null): Promise<void>;
+    /** critical：Windows 持续闪烁、macOS 持续跳动直到获得焦点。 */
+    requestAttention(p?: {
+        critical?: boolean;
+    }): Promise<void>;
+    /** 托盘图标闪烁的辅助：trayId 为 App 创建托盘时的 ID，icons 为应用资源中的图标路径；null 停止。 */
+    trayBlink(p: {
+        trayId: string;
+        icons: [string, string];
+        intervalMs?: number;
+    } | null): Promise<void>;
+    /** 系统的打开对话框；返回的路径登记为允许读取，取消时为空数组。 */
+    pickFiles(p?: {
+        multiple?: boolean;
+        filters?: Array<{
+            name: string;
+            extensions: string[];
+        }>;
+    }): Promise<string[]>;
+    /** 系统的保存对话框，返回的路径登记为允许写入。 */
+    pickSavePath(p?: {
+        defaultName?: string;
+    }): Promise<string | null>;
+    /** 允许读取的路径的预览地址（drim-file 协议），用于 <img>、<video>。 */
+    fileUrl(path: string): string;
+    download(source: string | {
+        message: MessageView;
+    }, p?: DownloadParams): DownloadTask;
+    /** 可执行和脚本类文件以 permission_denied（executable_file）失败。 */
+    openPath(path: string): Promise<void>;
+    revealPath(path: string): Promise<void>;
+    /** 返回压缩包的路径。 */
+    exportDiagnostics(p?: {
+        saveTo?: string;
+    }): Promise<string>;
+    readonly info: DesktopInfo;
+}
+interface DesktopNotification {
+    /** 同一 id 替换旧通知；SDK 自动显示的通知以 dr: 开头，App 的 id 不能以 dr: 开头。 */
+    id?: string;
+    title: string;
+    body: string;
+    /** 点击时随事件交回。 */
+    conversation_id?: string;
+    seq?: number;
+    /** 点击时原样交回，最多 1 KB。 */
+    data?: Record<string, string>;
+    sound?: boolean;
+    /** 最多 2 个；Linux 视通知服务而定。 */
+    actions?: Array<{
+        id: string;
+        title: string;
+    }>;
+}
+interface DownloadParams {
+    /** 目录或完整路径；默认系统的“下载”目录。 */
+    saveTo?: string;
+    /** 默认 rename。 */
+    conflict?: 'rename' | 'overwrite';
+    onProgress?: (loaded: number, total: number | null) => void;
+    signal?: AbortSignal;
+}
+interface DownloadTask extends Promise<{
+    path: string;
+    size: number;
+}> {
+    cancel(): void;
+}
+interface DesktopInfo {
+    os: 'windows' | 'macos' | 'linux';
+    os_version: string;
+    webview_version: string;
+    sdk_version: string;
+    /** 同 calls.supported。 */
+    calls_supported: boolean;
+}
+type EngineState = 'starting' | 'ready' | 'restarting' | 'failed';
+/** 带桌面事件类型的 on、once：桌面事件的载荷有确切的类型，其他事件同 Web SDK。 */
+interface DesktopEventMethods {
+    on<E extends keyof DesktopEvents>(event: E, listener: (payload: DesktopEvents[E]) => void): () => void;
+    on<E extends keyof DREvents & string>(event: E, listener: (payload: DREvents[E]) => void): () => void;
+    once<E extends keyof DesktopEvents>(event: E, listener: (payload: DesktopEvents[E]) => void): () => void;
+    once<E extends keyof DREvents & string>(event: E, listener: (payload: DREvents[E]) => void): () => void;
+}
+/** 界面窗口的客户端（《3.接口设计》第 4 节）。 */
+interface DRTauriClient extends DRClient, DesktopEventMethods {
+    readonly desktop: DesktopModule;
+    readonly engineState: EngineState;
+    on: DesktopEventMethods['on'];
+    once: DesktopEventMethods['once'];
+}
+/** 引擎客户端（引擎页中的 engine.client）。 */
+interface DRTauriEngineClient extends DRClient, DesktopEventMethods {
+    readonly desktop: DesktopModule;
+    on: DesktopEventMethods['on'];
+    once: DesktopEventMethods['once'];
+}
+/** 通知或通知上的按钮被点击（desktop.notificationClicked）。 */
+interface NotificationClickEvent {
+    id: string;
+    conversation_id?: string;
+    seq?: number;
+    kind: 'message' | 'notice' | 'call' | 'session' | 'custom';
+    action?: string;
+    data?: Record<string, string>;
+    /** 应用是被这次点击启动的。 */
+    launched: boolean;
+    /** 先认领的窗口调用，表示已处理（插件不再调用 Rust 的处理函数，也不显示主窗口）。 */
+    claim(): void;
+}
+/** 桌面相关的事件（《3.接口设计》第 8 节），在 client.on 中使用。 */
+interface DesktopEvents {
+    'engine.stateChanged': {
+        state: EngineState;
+    };
+    'desktop.notificationClicked': NotificationClickEvent;
+    'desktop.unreadChanged': {
+        total: number;
+        badge: number;
+    };
+    'desktop.systemResumed': {
+        slept_ms: number;
+    };
+    'desktop.networkChanged': {
+        online: boolean;
+    };
+    'window.roleChanged': {
+        isLeader: boolean;
+        isAlertTab: boolean;
+    };
+}
+/** 引擎提醒（auto 模式的通知文字、manual 模式交给 App 的提醒）。 */
+type EngineAlert = {
+    kind: 'message';
+    message: MessageView;
+    notify: NotifyDecision;
+} | {
+    kind: 'notice';
+    type: 'friend_request' | 'group_request';
+    title: string;
+    body: string;
+    user?: string;
+    group_id?: string;
+};
+interface DRTauriEngineOptions {
+    appKey: string;
+    apiUrl: string;
+    wsUrl?: string;
+    /** 默认取计算机名。 */
+    deviceName?: string;
+    appVersion?: string;
+    ticketProvider?: (ctx: TicketContext) => Promise<string>;
+    /** 需要插件的 sqlcipher 特性。 */
+    encryptDatabase?: boolean;
+    autoMarkRead?: boolean;
+    conversationWindow?: number;
+    userCacheTtlMs?: number;
+    /** 默认 48、209715200。 */
+    outbox?: {
+        maxAgeHours?: number;
+        persistAttachmentMaxBytes?: number;
+    };
+    /** 上传前的处理：图片的压缩参数，或 App 自己的处理（路径文件只在设置了 preprocess 时才读入内存交给它）。 */
+    media?: DRClientOptions['media'];
+    notifications?: {
+        /** 默认 auto（《2.功能概述文档》第 8.2 节）。 */
+        mode?: 'auto' | 'manual';
+        /** 默认 true。 */
+        sound?: boolean;
+        /** 好友申请、入群申请等是否提醒，默认 true。 */
+        notices?: boolean;
+        /** 没有界面窗口时的来电，默认 auto。 */
+        calls?: 'auto' | 'manual';
+        /** 来电铃声的资源路径（引擎页可以访问的地址），默认用 SDK 内置的。 */
+        ringtone?: string;
+        /** 自定义 auto 模式通知的文字（如其他语言）；返回 null 表示这条不提醒。 */
+        format?: (alert: EngineAlert) => {
+            title: string;
+            body: string;
+        } | null;
+    };
+    /** 默认 auto。 */
+    badge?: 'auto' | 'manual';
+    /** 默认 false。 */
+    badgeIncludesMuted?: boolean;
+    /** 默认 true。 */
+    attention?: boolean;
+    logger?: DRClientOptions['logger'];
+}
+interface DREngine {
+    /** 引擎客户端，引擎页中可以直接使用。 */
+    readonly client: DRTauriEngineClient;
+    /** manual 模式下处理提醒（只在负责提醒的是引擎时调用）。 */
+    onAlert(handler: (alert: EngineAlert) => void | Promise<void>): () => void;
+    /** calls 为 manual 时处理没有界面窗口时的来电。 */
+    onIncomingCall(handler: (call: CallHandle) => void | Promise<void>): () => void;
+}
+
+export { Bridge as B, type DRTauriEngineOptions as D, type EngineAlert as E, type NotificationClickEvent as N, type DREngine as a, type DRTauriEngineClient as b, type DesktopEvents as c, type DesktopModule as d, type DRTauriClient as e, type DesktopEventMethods as f, type DesktopInfo as g, type DesktopNotification as h, type DownloadParams as i, type DownloadTask as j, type EngineState as k };

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@deeprespond/im-tauri",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-alpha",
+  "description": "深应智能 IM 的 Tauri SDK：Web SDK 的核心加 Rust 插件（tauri-plugin-deeprespond-im）",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./engine": {
+      "types": "./dist/engine.d.ts",
+      "import": "./dist/engine.js"
+    },
+    "./templates/engine.html": "./src/templates/engine.html"
+  },
+  "files": [
+    "dist",
+    "src/templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@deeprespond/im-web": "~1.0.0-alpha",
+    "@tauri-apps/api": "^2.12.0"
+  },
+  "devDependencies": {
+    "@deeprespond/im-web": "link:../web",
+    "@tauri-apps/api": "^2.12.1",
+    "@types/node": "^20.19.43",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}

package/src/templates/engine.html

@@ -0,0 +1,20 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <title>deeprespond-im-engine</title>
+  </head>
+  <body>
+    <!--
+      引擎页模板（《sdk-tauri/3.接口设计》第 3 节）：复制到前端项目，加入打包配置的入口（如 Vite 的 build.rollupOptions.input），
+      在 Rust 中以 engine_url("engine.html") 指向它。引擎页不显示，只创建引擎客户端，不引入 App 的界面框架。
+      im-config.js 导出 { appKey, apiUrl }；需要定制提醒、来电的，在这里注册 engine.onAlert、engine.onIncomingCall。
+    -->
+    <script type="module">
+      import { createDRTauriEngine } from '@deeprespond/im-tauri/engine';
+      import config from './im-config.js';
+
+      createDRTauriEngine({ ...config });
+    </script>
+  </body>
+</html>