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

package/README.md

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# @longzai-intelligence-local-server/core
 
-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.
+桌面本地服务 IPC 契约核心包。承载四通道名常量、zod schema 与推断类型，main 与 preload 与 renderer 与服务端四端均可引入，运行时依赖仅 `zod`。
+
+## 导出面
+
+- 通道常量：`LOCAL_SERVER_CHANNELS` 及 `LOCAL_SERVER_GET_STATUS`、`LOCAL_SERVER_START`、`LOCAL_SERVER_STOP`、`LOCAL_SERVER_GET_URL` 四单项
+- zod schema：`serverStatusSchema`、`serverResultSchema`、`serverUrlSchema` 与四个空参数 schema
+- 类型：`ServerStatus`、`ServerResult`、`ServerUrl`、`LocalServerIPCAPI`
+
+## 契约边界
+
+通道名继承产品群桌面族存量契约的短横线形态，如 `local-server:get-status`，作为零成本切换边界不得变更。`LocalServerIPCAPI` 以类型形态引用 electron 仓 core 包的 `IPCMethodDefinition`，构建期擦除，不带入任何运行时依赖。

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+import * as z from "zod";
+import { IPCMethodDefinition } from "@longzai-intelligence-electron/core";
+/**
+ * 本地服务 IPC 通道常量
+ *
+ * 通道名继承自产品群桌面族存量契约即 `local-server:get-status` 等短横线形态，
+ * 作为零成本切换边界保持不变，新增取址通道一处
+ */
+/**
+ * 获取服务器状态通道
+ */
+declare const LOCAL_SERVER_GET_STATUS: 'local-server:get-status';
+/**
+ * 启动本地服务器通道
+ */
+declare const LOCAL_SERVER_START: 'local-server:start';
+/**
+ * 停止本地服务器通道
+ */
+declare const LOCAL_SERVER_STOP: 'local-server:stop';
+/**
+ * 获取本地服务真实基址通道
+ *
+ * 渲染层经此通道取监听零口后的真实地址，替代硬编码本机端口
+ */
+declare const LOCAL_SERVER_GET_URL: 'local-server:get-url';
+/**
+ * 本地服务通道常量集合
+ */
+declare const LOCAL_SERVER_CHANNELS: {
+  readonly GET_STATUS: "local-server:get-status";
+  readonly START: "local-server:start";
+  readonly STOP: "local-server:stop";
+  readonly GET_URL: "local-server:get-url";
+};
+/**
+ * 服务器状态 schema
+ */
+declare const serverStatusSchema: z.ZodEnum<{
+  error: "error";
+  running: "running";
+  starting: "starting";
+  stopped: "stopped";
+}>;
+/**
+ * 启停结果 schema
+ */
+declare const serverResultSchema: z.ZodObject<{
+  success: z.ZodBoolean;
+  error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * 本地服务基址 schema，服务未就绪时为 null
+ */
+declare const serverUrlSchema: z.ZodNullable<z.ZodString>;
+/**
+ * 状态查询参数 schema
+ */
+declare const serverStatusParamsSchema: z.ZodReadonly<z.ZodObject<{}, z.core.$strip>>;
+/**
+ * 启动参数 schema
+ */
+declare const startServerParamsSchema: z.ZodReadonly<z.ZodObject<{}, z.core.$strip>>;
+/**
+ * 停止参数 schema
+ */
+declare const stopServerParamsSchema: z.ZodReadonly<z.ZodObject<{}, z.core.$strip>>;
+/**
+ * 取址参数 schema
+ */
+declare const getServerUrlParamsSchema: z.ZodReadonly<z.ZodObject<{}, z.core.$strip>>;
+/**
+ * 服务器状态
+ */
+type ServerStatus = z.infer<typeof serverStatusSchema>;
+/**
+ * 启停结果
+ */
+type ServerResult = z.infer<typeof serverResultSchema>;
+/**
+ * 本地服务基址，服务未就绪时为 null
+ */
+type ServerUrl = z.infer<typeof serverUrlSchema>;
+/**
+ * 本地服务 IPC API 定义
+ *
+ * 方法名与通道常量的映射见 preload 入口的组装助手
+ */
+type LocalServerIPCAPI = {
+  /**
+   * 查询服务器状态
+   */
+  getStatus: IPCMethodDefinition<readonly [], ServerStatus>;
+  /**
+   * 启动本地服务器
+   */
+  start: IPCMethodDefinition<readonly [], ServerResult>;
+  /**
+   * 停止本地服务器
+   */
+  stop: IPCMethodDefinition<readonly [], ServerResult>;
+  /**
+   * 获取本地服务真实基址
+   */
+  getUrl: IPCMethodDefinition<readonly [], ServerUrl>;
+};
+export { LOCAL_SERVER_CHANNELS, LOCAL_SERVER_GET_STATUS, LOCAL_SERVER_GET_URL, LOCAL_SERVER_START, LOCAL_SERVER_STOP, type LocalServerIPCAPI, type ServerResult, type ServerStatus, type ServerUrl, getServerUrlParamsSchema, serverResultSchema, serverStatusParamsSchema, serverStatusSchema, serverUrlSchema, startServerParamsSchema, stopServerParamsSchema };

package/dist/index.js

@@ -0,0 +1 @@
+import"./rolldown-runtime-BqT_7tdF.js";import*as e from"zod";const t=`local-server:get-status`,n=`local-server:start`,r=`local-server:stop`,i=`local-server:get-url`,a={GET_STATUS:t,START:n,STOP:r,GET_URL:i},o=e.enum([`running`,`stopped`,`starting`,`error`]),s=e.object({success:e.boolean(),error:e.string().optional()}),c=e.string().nullable(),l=e.object({}).readonly(),u=e.object({}).readonly(),d=e.object({}).readonly(),f=e.object({}).readonly();export{a as LOCAL_SERVER_CHANNELS,t as LOCAL_SERVER_GET_STATUS,i as LOCAL_SERVER_GET_URL,n as LOCAL_SERVER_START,r as LOCAL_SERVER_STOP,f as getServerUrlParamsSchema,s as serverResultSchema,l as serverStatusParamsSchema,o as serverStatusSchema,c as serverUrlSchema,u as startServerParamsSchema,d as stopServerParamsSchema};

package/dist/rolldown-runtime-BqT_7tdF.js

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

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@longzai-intelligence-local-server/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "Longzai Intelligence 桌面本地服务通道常量与 zod 契约核心包",
+  "keywords": [
+    "core",
+    "desktop",
+    "ipc",
+    "local-server",
+    "longzai-intelligence",
+    "zod"
+  ],
+  "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": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@longzai-intelligence-electron/core": "^0.0.4",
+    "@longzai-intelligence-testing/utils": "^0.0.3",
+    "@longzai-intelligence-vitest/config": "^0.0.12",
+    "vitest": "^4.1.4"
+  },
+  "packageManager": "bun@1.4.3"
+}