@longzai-intelligence-local-server/preload 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @longzai-intelligence-local-server/preload
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+桌面本地服务 Electron preload 组装助手包。以 `ipcRenderer` 原语直组状态查询、启动、停止与取址四方法，返回类型显式标注，由应用 preload 层经 electron 仓 core 包的 `exposeSafeAPI` 暴露给渲染层。`electron` 为必需 peer 依赖。
+
+## 导出面
+
+- `createLocalServerAPI`
+- `LocalServerPreloadAPI` 类型，渲染层以类型导入形态消费
+
+## 接入配方
+
+```ts
+import { createLocalServerAPI } from '@longzai-intelligence-local-server/preload';
+
+exposeSafeAPI({
+  globalKey: 'api',
+  api: { localServer: createLocalServerAPI() },
+  expose: contextBridge.exposeInMainWorld,
+});
+```
+
+渲染层经 `getUrl` 方法取真实基址，禁止硬编码本机端口。

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+import { ServerResult, ServerStatus, ServerUrl } from "@longzai-intelligence-local-server/core";
+/**
+ * 本地服务 preload API 形态
+ */
+type LocalServerPreloadAPI = {
+  /**
+   * 查询服务器状态
+   */
+  getStatus: () => Promise<ServerStatus>;
+  /**
+   * 启动本地服务器
+   */
+  start: () => Promise<ServerResult>;
+  /**
+   * 停止本地服务器
+   */
+  stop: () => Promise<ServerResult>;
+  /**
+   * 获取本地服务真实基址
+   */
+  getUrl: () => Promise<ServerUrl>;
+};
+/**
+ * 创建本地服务 preload API
+ *
+ * @returns 含状态查询、启停与取址四方法的 API 对象
+ */
+declare function createLocalServerAPI(): LocalServerPreloadAPI;
+export { LocalServerPreloadAPI, createLocalServerAPI };

package/dist/index.js

@@ -0,0 +1 @@
+import"./rolldown-runtime-BqT_7tdF.js";import{LOCAL_SERVER_CHANNELS as e}from"@longzai-intelligence-local-server/core";import{ipcRenderer as t}from"electron";function n(){return{getStatus:()=>t.invoke(e.GET_STATUS),start:()=>t.invoke(e.START),stop:()=>t.invoke(e.STOP),getUrl:()=>t.invoke(e.GET_URL)}}export{n as createLocalServerAPI};

package/dist/rolldown-runtime-BqT_7tdF.js

@@ -0,0 +1 @@
+import"node:module";export{};

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@longzai-intelligence-local-server/preload",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "Longzai Intelligence 桌面本地服务 Electron preload 组装助手包",
+  "keywords": [
+    "desktop",
+    "electron",
+    "ipc",
+    "local-server",
+    "longzai-intelligence",
+    "preload"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "dev": "lzi-builder --watch",
+    "clean": "lzi-dev-tools clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "lzi-lint lint",
+    "lint:fix": "lzi-lint fix",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json"
+  },
+  "dependencies": {
+    "@longzai-intelligence-local-server/core": "0.0.1"
+  },
+  "devDependencies": {
+    "@longzai-intelligence-testing/utils": "^0.0.3",
+    "@longzai-intelligence-vitest/config": "^0.0.12",
+    "electron": "^43",
+    "vitest": "^4.1.4"
+  },
+  "peerDependencies": {
+    "electron": "^41"
+  },
+  "packageManager": "bun@1.4.3"
+}