@qmuse/qmuse-cli 1.0.3-dev.0 → 1.0.3-dev.1

package/README.md

@@ -95,17 +95,9 @@ qmuse dev . --port 5173
 
 CLI 获取服务端解析的公开云配置，复用 Vite 的 `MUSE_RUNTIME_CONFIG_PATH` 注入机制。配置放在系统临时目录，退出时删除。Token 按需获取且不落盘，CLI 登录凭据不交给页面。数据库、文件和函数请求由浏览器通过用户 Session 直接访问云端，不使用管理 API Key 或 Dev Key。
 
-新版云服务资产已接入适配。旧项目在 `src/services/appwrite.ts` 的 `createQmuseAppwriteRuntime({ ... })` 参数中增加：
-
-```ts
-fetch: import.meta.env.DEV
-  ? (window as Window & {
-      __QMUSE_LOCAL_DEV__?: { fetch: typeof globalThis.fetch };
-    }).__QMUSE_LOCAL_DEV__?.fetch
-  : undefined,
-```
+CLI 的 Vite 插件在加载 `src/services/appwrite.ts` 时，通过语法解析为 Runtime 初始化自动注入本地 fetch，不写回项目文件。原版云服务资产和已下载的模板无需手工添加适配，也无需发布 qmuse-cloud 或修改 SDK。支持从 SDK 命名导入（含别名），在顶层使用对象参数初始化一次；不支持的写法在启动或热更新时明确报错。开发时 Runtime 的 fetch 由 CLI 接管，包括对象中已有的自定义 fetch。
 
-不修改 SDK。只有 `qmuse dev` 注入本地 fetch；普通 `npm run dev` 和线上运行继续使用默认行为。生产构建移除本地适配分支。服务端必须先部署 `/api/appwrite/local-dev/context` 和 `/api/appwrite/local-dev/mutation-events`；缺少接口时不会降级为模拟云服务。
+只有 `qmuse dev` 启用该插件；普通 `npm run dev` 和生产构建继续使用原始源码。服务端必须先部署 `/api/appwrite/local-dev/context` 和 `/api/appwrite/local-dev/mutation-events`，再发布并安装新版 CLI；缺少接口时不会降级为模拟云服务。
 
 页面改动热更新，Schema/函数改动继续执行 `qmuse import .`。导入更新本地绑定后，连接会重新获取配置并刷新页面。切换登录账号或应用绑定需重启连接；退出 CLI 不会自动撤销浏览器已经建立的 AppBase Session。SDK 的匿名降级行为保持不变，验收必须检查实际 Session 用户，不能只看页面是否显示。
 

package/dist/dev/index.js

@@ -9,6 +9,7 @@ import { loadConfig } from '../config.js';
 import { loadManagedProject } from '../import/project.js';
 import { browserRuntime, loadDevContext } from './context.js';
 import { localDevPlugin } from './plugin.js';
+import { injectLocalRuntimeFetch } from './transform.js';
 export async function startDevelopment(options) {
     const root = await realpath(path.resolve(options.root));
     const require = createRequire(path.join(root, 'package.json'));
@@ -23,9 +24,7 @@ export async function startDevelopment(options) {
     if (!project?.target)
         throw new Error('请先执行 qmuse import . 并等待云服务 READY，再启动本地联调');
     const serviceFile = await readFile(path.join(root, 'src/services/appwrite.ts'), 'utf8').catch(() => '');
-    if (!serviceFile.includes('__QMUSE_LOCAL_DEV__')) {
-        throw new Error('项目尚未接入本地适配：请按最新版云服务资产在 src/services/appwrite.ts 的 Runtime options 中传入本地 fetch（见 qmuse-cli README）');
-    }
+    injectLocalRuntimeFetch(serviceFile, path.join(root, 'src/services/appwrite.ts'));
     const context = await loadDevContext(root, options.cfg, options.environment);
     const directory = await mkdtemp(path.join(tmpdir(), 'qmuse-local-dev-'));
     const runtimePath = path.join(directory, 'runtime.json');

package/dist/dev/plugin.js

@@ -1,4 +1,6 @@
 import { randomBytes, timingSafeEqual } from 'node:crypto';
+import path from 'node:path';
+import { injectLocalRuntimeFetch } from './transform.js';
 const PREFIX = '/__qmuse/local-dev/';
 const TOKEN_HEADER = 'x-qmuse-local-connection';
 const BODY_LIMIT = 64 * 1024;
@@ -56,10 +58,19 @@ export function bridgeSource(context, connection) {
 export function localDevPlugin(options) {
     const connection = randomBytes(32).toString('hex');
     let server;
+    let servicePath;
     return {
         name: 'qmuse-local-dev',
         apply: 'serve',
         enforce: 'pre',
+        configResolved(config) {
+            servicePath = path.resolve(config.root, 'src/services/appwrite.ts');
+        },
+        transform(code, id) {
+            if (id.split('?')[0] !== servicePath)
+                return;
+            return injectLocalRuntimeFetch(code, servicePath);
+        },
         configureServer(vite) {
             server = vite;
             server.middlewares.use((req, res, next) => {

package/dist/dev/transform.js

@@ -0,0 +1,38 @@
+import ts from 'typescript';
+import MagicString from 'magic-string';
+export function injectLocalRuntimeFetch(code, id) {
+    const source = ts.createSourceFile(id, code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const names = new Set();
+    for (const statement of source.statements) {
+        if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier) ||
+            statement.moduleSpecifier.text !== '@qmuse/appwrite-runtime-sdk' || statement.importClause?.isTypeOnly)
+            continue;
+        const bindings = statement.importClause?.namedBindings;
+        if (!bindings || !ts.isNamedImports(bindings))
+            continue;
+        for (const binding of bindings.elements) {
+            if (!binding.isTypeOnly && (binding.propertyName ?? binding.name).text === 'createQmuseAppwriteRuntime') {
+                names.add(binding.name.text);
+            }
+        }
+    }
+    const calls = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && names.has(node.expression.text))
+            calls.push(node);
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    const call = calls[0];
+    const argument = call?.arguments[0];
+    // Restrict injection to the official asset's top-level initializer, avoiding shadowed bindings.
+    if (calls.length !== 1 || !call || call.arguments.length !== 1 || !argument || !ts.isObjectLiteralExpression(argument) ||
+        !ts.isVariableDeclaration(call.parent) || !ts.isVariableDeclarationList(call.parent.parent) ||
+        !ts.isVariableStatement(call.parent.parent.parent) || call.parent.parent.parent.parent !== source) {
+        throw new Error('无法注入本地云适配：src/services/appwrite.ts 需要从 @qmuse/appwrite-runtime-sdk 命名导入 createQmuseAppwriteRuntime，并在顶层用对象参数初始化一次；请对齐官方云服务资产');
+    }
+    const result = new MagicString(code);
+    result.prependLeft(argument.getStart(source), '{ ...(');
+    result.appendLeft(argument.end, '), fetch: window.__QMUSE_LOCAL_DEV__.fetch }');
+    return { code: result.toString(), map: result.generateMap({ source: id, includeContent: true, hires: true }) };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qmuse/qmuse-cli",
-  "version": "1.0.3-dev.0",
+  "version": "1.0.3-dev.1",
   "description": "将本地 React 项目安全导入 QMuse 的命令行客户端",
   "type": "module",
   "bin": {
@@ -21,6 +21,8 @@
   "dependencies": {
     "@napi-rs/keyring": "2.0.0",
     "ignore": "^7.0.8",
+    "magic-string": "^0.30.17",
+    "typescript": "^5.9.3",
     "yazl": "^3.3.1"
   },
   "files": [
@@ -35,7 +37,6 @@
     "@types/node": "^22.10.0",
     "@types/yazl": "^3.3.1",
     "tsx": "^4.19.2",
-    "typescript": "^5.9.3",
     "vite": "7.3.6"
   },
   "license": "MIT",