@qmuse/qmuse-cli 1.0.9 → 1.0.10

package/dist/app/data.js

@@ -0,0 +1,104 @@
+/**
+ * 数据域（C13）：AppwriteDataController/NocodeController 现有契约。
+ * formId 即清单中的 tableId；permission 为表单鉴权。
+ */
+import { apiCall } from '../client.js';
+export function queryAppMetadata(appId, devAppVersionId, cfg) {
+    return apiCall('POST', '/api/appwrite/queryAppMetadataMap', { appId, devAppVersionId }, cfg);
+}
+export function listRecords(appId, formId, query = {}, cfg) {
+    return apiCall('POST', '/api/appwrite/queryFormRecordList', { appId, formId, ...query }, cfg);
+}
+export function getRecord(appId, formId, code, cfg) {
+    return apiCall('POST', '/api/appwrite/queryFormRecordByCode', { appId, formId, code }, cfg);
+}
+export function createRecord(appId, formId, parameters, cfg) {
+    return apiCall('POST', '/api/appwrite/createFormRecord', { appId, formId, parameters }, cfg);
+}
+export function updateRecord(appId, formId, parameters, cfg) {
+    return apiCall('POST', '/api/appwrite/updateFormRecord', { appId, formId, parameters }, cfg);
+}
+export function deleteRecord(appId, formId, code, cfg) {
+    return apiCall('POST', '/api/appwrite/deleteFormRecordByCode', { appId, formId, code }, cfg);
+}
+export function queryFormAuth(appId, formId, cfg) {
+    return apiCall('POST', '/api/appwrite/queryFormAuthByFormId', { appId, formId }, cfg);
+}
+export function syncFormAuth(appId, formId, permissions, cfg) {
+    return apiCall('POST', '/api/appwrite/syncFormAuthList', { appId, formId, permissions }, cfg);
+}
+/**
+ * C13.08/09：记录写失败的参数级诊断（仅失败后调用，成功路径零开销）。
+ * 依据平台现有表元数据比对 parameters：缺失必填、只读/系统字段、未知字段。
+ * 服务器对缺必填只回“系统异常”，这里把可操作的字段级原因补出来。
+ */
+export async function diagnoseRecordParams(appId, formId, parameters, cfg) {
+    const { listAppVersions } = await import('./version.js');
+    const versions = await listAppVersions(appId, cfg);
+    const versionId = versions.data?.list?.[0]?.id;
+    if (!versionId)
+        return [];
+    const meta = await queryAppMetadata(appId, versionId, cfg);
+    if (!meta.ok || !meta.data)
+        return [];
+    const entities = [];
+    const walk = (node) => {
+        if (Array.isArray(node)) {
+            node.forEach(walk);
+            return;
+        }
+        if (!node || typeof node !== 'object')
+            return;
+        const record = node;
+        if (typeof record.name === 'string' && Array.isArray(record.properties))
+            entities.push(record);
+        Object.values(record).forEach(walk);
+    };
+    walk(meta.data);
+    // 元数据可能同时包含 dev/prod 两侧同名实体：按字段名去重（取首个定义）。
+    const fieldsByName = new Map();
+    for (const entity of entities.filter(item => item.name === formId)) {
+        for (const property of entity.properties) {
+            const name = property.name;
+            if (typeof name !== 'string' || fieldsByName.has(name))
+                continue;
+            fieldsByName.set(name, property);
+        }
+    }
+    const fields = [...fieldsByName.values()];
+    if (fields.length === 0)
+        return [];
+    const hints = [];
+    const missing = fields
+        .filter(property => property.required === true && property.readonly !== true)
+        .map(property => property.name)
+        .filter(name => !(name in parameters) || parameters[name] === null || parameters[name] === undefined || parameters[name] === '');
+    if (missing.length > 0)
+        hints.push(`缺少必填字段: ${missing.join(', ')}`);
+    const readonlyFields = fields
+        .filter(property => property.readonly === true)
+        .map(property => property.name)
+        .filter(name => name in parameters);
+    if (readonlyFields.length > 0)
+        hints.push(`系统/只读字段不可写（服务端将拒绝）: ${readonlyFields.join(', ')}`);
+    const known = new Set(fields.map(property => property.name));
+    const unknown = Object.keys(parameters).filter(key => !known.has(key));
+    if (unknown.length > 0)
+        hints.push(`表中不存在的字段: ${unknown.join(', ')}`);
+    const typeMismatch = [];
+    for (const property of fields) {
+        const name = property.name;
+        const type = String(property.type ?? '').toLowerCase();
+        const value = parameters[name];
+        if (value === undefined || value === null || value === '')
+            continue;
+        const isNumber = typeof value === 'number' || (typeof value === 'string' && value.trim() !== '' && !Number.isNaN(Number(value)));
+        if (type === 'number' && !isNumber)
+            typeMismatch.push(`${name}应为数字类型`);
+        if ((type === 'boolean' || type === 'bool' || type === 'switch') && typeof value !== 'boolean' && !['true', 'false'].includes(String(value).toLowerCase()))
+            typeMismatch.push(`${name}应为布尔类型`);
+    }
+    if (typeMismatch.length > 0)
+        hints.push(`字段类型偏差: ${typeMismatch.join('; ')}`);
+    return hints;
+}

package/dist/app/fn.js

@@ -0,0 +1,25 @@
+/**
+ * 云函数域（C15）：POST /api/appwrite/functions/*（AppwriteFunctionController）。
+ */
+import { apiCall } from '../client.js';
+export function listFunctions(appId, cfg) {
+    return apiCall('POST', '/api/appwrite/functions/list', { appId }, cfg);
+}
+export function functionDetail(appId, functionId, cfg) {
+    return apiCall('POST', '/api/appwrite/functions/detail', { appId, functionId }, cfg);
+}
+export function retryFunctionPublish(appId, functionId, cfg) {
+    return apiCall('POST', '/api/appwrite/functions/retry-publish', { appId, functionId }, cfg);
+}
+export function listFunctionDeployments(appId, functionId, page = {}, cfg) {
+    return apiCall('POST', '/api/appwrite/functions/deployments/list', { appId, functionId, ...page }, cfg);
+}
+export function deploymentDetail(appId, functionId, deploymentId, cfg) {
+    return apiCall('POST', '/api/appwrite/functions/deployments/detail', { appId, functionId, deploymentId }, cfg);
+}
+export function listFunctionExecutions(appId, functionId, page = {}, cfg) {
+    return apiCall('POST', '/api/appwrite/functions/executions/list', { appId, functionId, ...page }, cfg);
+}
+export function executionDetail(appId, functionId, executionId, cfg) {
+    return apiCall('POST', '/api/appwrite/functions/executions/detail', { appId, functionId, executionId }, cfg);
+}

package/dist/app/release.js

@@ -0,0 +1,105 @@
+/**
+ * 发布域（C10）：POST /api/deploy/create + update（触发执行），GET /api/deploy/query | list | last。
+ * 部署单状态机：INIT → INITED（安全检查通过）→ DEPLOYING → DEPLOYED / DEPLOY_FAILED / CANCEL。
+ * query 返回 content（infosec/mosec/域名发布状态/发布地址），供 release status 汇总。
+ */
+import { apiCall } from '../client.js';
+export function parseDeployTicketContent(ticket) {
+    if (typeof ticket.content !== 'string')
+        return ticket.content ?? {};
+    try {
+        return JSON.parse(ticket.content);
+    }
+    catch {
+        return {};
+    }
+}
+/** C10.01 发布指定版本：创建并受理部署单（服务端含权益/内容安全门禁）。 */
+export function createDeployTicket(appId, versionId, cfg) {
+    return apiCall('POST', '/api/deploy/create', { appId, versionId }, cfg);
+}
+/** 触发已就绪（INITED）部署单执行发布；服务端异步执行 DEPLOYING → 终态。 */
+export function triggerDeployTicket(deployId, cfg) {
+    return apiCall('POST', '/api/deploy/update', { id: deployId }, cfg);
+}
+/** C10.03 查询发布结果：同一查询返回任务详情、产物/安全检查、地址与失败原因。 */
+export function queryDeployTicket(deployId, cfg) {
+    return apiCall('GET', `/api/deploy/query?id=${encodeURIComponent(deployId)}`, undefined, cfg);
+}
+/** C10.05 查询发布记录：有权访问的发布记录及固定版本。 */
+export function listDeployTickets(appId, cfg) {
+    return apiCall('GET', `/api/deploy/list?appId=${encodeURIComponent(appId)}`, undefined, cfg);
+}
+export function lastDeployTicket(appId, cfg) {
+    return apiCall('GET', `/api/deploy/last?appId=${encodeURIComponent(appId)}`, undefined, cfg);
+}
+export const APP_DEPLOY_TERMINAL_STATUSES = new Set(['DEPLOYED', 'DEPLOY_FAILED', 'CANCEL']);
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * 发布等待循环：CREATE 后轮询 query；INITED 时触发 update（复用现有发布流程）；
+ * 终态、--no-wait 受理（DEPLOYING）或超时返回最近一次 ticket。
+ * 温和退避（5s→15s 封顶）降低轮询请求量；连续网络错误快速失败。
+ */
+export async function waitDeployResult(deployId, cfg, options = {}) {
+    const noWait = options.noWait === true;
+    const timeoutMs = options.timeoutMs ?? (noWait ? 5 * 60 * 1000 : 8 * 60 * 1000);
+    const baseIntervalMs = options.intervalMs ?? 5000;
+    const startedAt = Date.now();
+    let triggered = false;
+    let lastError;
+    let polls = 0;
+    let netErrors = 0;
+    for (;;) {
+        const r = await queryDeployTicket(deployId, cfg);
+        polls += 1;
+        // 网络故障快速失败：断网/网关不可达时空转到数分钟超时没有价值。
+        if (r.status === 0) {
+            netErrors += 1;
+            if (netErrors >= 3) {
+                lastError = `连续 ${netErrors} 次网络错误：${r.errorMessage ?? 'network'}`;
+                return { ticket: undefined, triggered, timedOut: false, lastError };
+            }
+        }
+        else {
+            netErrors = 0;
+        }
+        const ticket = r.ok ? r.data : undefined;
+        const status = typeof ticket?.['status'] === 'string' ? ticket['status'] : undefined;
+        if (!r.ok) {
+            lastError = r.errorMessage ?? r.errorCode ?? `HTTP ${r.status}`;
+            // 快速失败：单据不存在/无权限时继续轮询没有意义（避免长达数分钟的空转）。
+            const notFound = r.status === 404
+                || r.errorCode === 'NOT_FOUND'
+                || /not found|不存在|无权限|forbidden/iu.test(String(lastError));
+            if (notFound) {
+                return { ticket: ticket ?? undefined, triggered, timedOut: false, lastError };
+            }
+        }
+        if (status && APP_DEPLOY_TERMINAL_STATUSES.has(status)) {
+            return { ticket: ticket ?? undefined, triggered, timedOut: false, lastError };
+        }
+        if (status === 'INITED' && !triggered) {
+            // 安全门禁通过：触发现有发布流程（INITED → DEPLOYING，服务端异步执行）。
+            const up = await triggerDeployTicket(deployId, cfg);
+            triggered = true;
+            if (!up.ok)
+                lastError = up.errorMessage ?? up.errorCode ?? `HTTP ${up.status}`; // 触发失败语义保留（不重触发）
+            const updated = up.ok ? up.data : undefined;
+            const next = typeof updated?.['status'] === 'string' ? updated['status'] : undefined;
+            if (next && APP_DEPLOY_TERMINAL_STATUSES.has(next))
+                return { ticket: updated, triggered, timedOut: false };
+            if (updated && noWait)
+                return { ticket: updated, triggered, timedOut: false };
+        }
+        if (noWait && (triggered || (status && status !== 'INIT'))) {
+            return { ticket: ticket ?? undefined, triggered, timedOut: false, lastError };
+        }
+        if (Date.now() - startedAt > timeoutMs)
+            return { ticket: ticket ?? undefined, triggered, timedOut: true, lastError };
+        // 温和退避：每 4 轮 ×1.6，封顶 15s（8 分钟窗口轮询请求减半以上）。
+        const intervalMs = Math.min(baseIntervalMs * Math.pow(1.6, Math.floor(polls / 4)), 15000);
+        await sleep(Math.round(intervalMs));
+    }
+}

package/dist/app/sandbox.js

@@ -0,0 +1,32 @@
+/**
+ * 沙箱与预览域（C07）：POST /api/v1/sandbox/*（SandboxController）。
+ * 本轮只接只读查询与显式重启；ensure 依赖云环境，随联调窗口接入。
+ */
+import { apiCall } from '../client.js';
+export function ensureSandbox(appId, sprintId, cfg) {
+    return apiCall('POST', '/api/v1/sandbox/ensureSandbox', { appId, sprintId }, cfg);
+}
+/** 需要 sandboxId（来自 dev 会话/socketInfo），静态查询无法凭空获得。 */
+export function previewInfo(appId, sandboxId, cfg) {
+    return apiCall('POST', '/api/v1/sandbox/previewInfo', { appId, sandboxId }, cfg);
+}
+export function previewHealth(appId, sandboxId, cfg) {
+    return apiCall('POST', '/api/v1/sandbox/previewHealth', { appId, sandboxId }, cfg);
+}
+export function querySandboxSetting(appId, cfg) {
+    return apiCall('POST', '/api/v1/sandbox/queryAppSandboxSetting', { appId }, cfg);
+}
+/** restart 契约为 {chatId}（服务端按 CHAT WRITE 授权从上下文解析）。 */
+export function restartPreview(chatId, cfg) {
+    return apiCall('POST', '/api/v1/sandbox/restartPreview', { chatId }, cfg);
+}
+/** 构建/预览产物状态（构建日志入口，C07.14 诊断日志来源之一）。 */
+export function buildArtifactsStatus(appId, options = {}, cfg) {
+    return apiCall('POST', '/api/v1/sandbox/buildArtifactsStatus', {
+        appId,
+        ...(options.sprintId ? { sprintId: options.sprintId } : {}),
+        ...(options.versionId ? { versionId: options.versionId } : {}),
+        ...(options.buildId ? { buildId: options.buildId } : {}),
+        ...(options.artifactTarget ? { artifactTarget: options.artifactTarget } : {}),
+    }, cfg);
+}

package/dist/app/secret.js

@@ -0,0 +1,30 @@
+/**
+ * 秘密域（C16）：POST /api/appwrite/secrets/*（AppwriteSecretController）。
+ * 列表包含同步状态字段；删除/重试同步为显式写操作。
+ */
+import { apiCall } from '../client.js';
+export function listSecrets(appId, cfg, env = 'dev') {
+    // env 透传：prod 视角查看生产侧密钥与同步状态（服务端按 env 解析绑定）。
+    return apiCall('POST', '/api/appwrite/secrets/list', { appId, env }, cfg);
+}
+/** 停用/启用密钥（删除前必须先停用且同步完成；停用会同步删除云上变量）。 */
+export function disableSecret(appId, secretId, cfg, env = 'dev') {
+    return apiCall('POST', '/api/appwrite/secrets/disable', { appId, env, secretId }, cfg);
+}
+export function enableSecret(appId, secretId, cfg, env = 'dev') {
+    return apiCall('POST', '/api/appwrite/secrets/enable', { appId, env, secretId }, cfg);
+}
+export function deleteSecret(appId, secretId, cfg, env = 'dev') {
+    return apiCall('POST', '/api/appwrite/secrets/delete', { appId, env, secretId }, cfg);
+}
+export function retrySecretSync(appId, secretId, cfg, env = 'dev') {
+    return apiCall('POST', '/api/appwrite/secrets/retry-sync', { appId, env, secretId }, cfg);
+}
+export function createSecret(appId, key, value, cfg, description) {
+    return apiCall('POST', '/api/appwrite/secrets/create', {
+        appId,
+        key,
+        value,
+        ...(description ? { description } : {}),
+    }, cfg);
+}

package/dist/app/sse.js

@@ -0,0 +1,80 @@
+/**
+ * 服务端 SSE 文本帧解析。
+ *
+ * 只做与业务无关的帧拆分：
+ *  - `: comment`（例如心跳）跳过且不计入事件
+ *  - `data: [DONE]` 通知流结束
+ *  - `data: <json>` 逐帧回调，JSON 解析失败按文本帧回调
+ *  - 兼容 CRLF 与一个 data 字段拆多行的情况（多行按 SSE 规范用 \n 连接）
+ */
+/** 按逐字符增量解析 SSE 文本并回调完整帧；返回是否已被消费方要求停止。 */
+export class SseParser {
+    onFrame;
+    buffer = '';
+    /** 已完整回调的数据帧数量（不含心跳与 DONE）。 */
+    frameCount = 0;
+    constructor(onFrame) {
+        this.onFrame = onFrame;
+    }
+    /** 追加一段增量文本；返回 true 表示消费方要求停止读取。 */
+    push(chunk) {
+        this.buffer += chunk;
+        let index;
+        while ((index = this.buffer.indexOf('\n')) >= 0) {
+            let line = this.buffer.slice(0, index);
+            this.buffer = this.buffer.slice(index + 1);
+            if (line.endsWith('\r'))
+                line = line.slice(0, -1);
+            const stopped = this.handleLine(line);
+            if (stopped)
+                return true;
+        }
+        return false;
+    }
+    /** 流结束时冲刷剩余未换行的内容。 */
+    end() {
+        const line = this.buffer.replace(/\r$/u, '');
+        this.buffer = '';
+        if (line)
+            this.handleLine(line);
+    }
+    /** 返回 true 表示消费方要求停止读取。 */
+    handleLine(line) {
+        if (!line || line.startsWith(':'))
+            return false;
+        if (line.startsWith('event:'))
+            return false;
+        if (!line.startsWith('data:'))
+            return false;
+        let data = line.slice(5);
+        if (data.startsWith(' '))
+            data = data.slice(1);
+        if (data === '[DONE]') {
+            this.onFrame({ event: '', data: null });
+            return true;
+        }
+        this.frameCount += 1;
+        return this.onFrame({ event: '', data }) === true;
+    }
+}
+export function parseChatEvent(data) {
+    const trimmed = data.trim();
+    if (!trimmed)
+        return '';
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return trimmed;
+    }
+    catch {
+        return trimmed;
+    }
+}
+export function chatEventType(event) {
+    if (typeof event === 'string')
+        return '';
+    const value = event.__type ?? event.type ?? event.stage ?? '';
+    return typeof value === 'string' ? value : String(value ?? '');
+}

package/dist/app/version.js

@@ -0,0 +1,12 @@
+/**
+ * 版本与源码导出域（C08）：POST /api/appVersion/findAllByAppIdDesc、GET /api/app/code。
+ * 服务端仅提供“导出最新已保存版本源码”的能力（AppController.getCode），CLI 侧做对应限界。
+ */
+import { apiCall } from '../client.js';
+export function listAppVersions(appId, cfg) {
+    return apiCall('POST', '/api/appVersion/findAllByAppIdDesc', { appId }, cfg);
+}
+export function fetchSourceFiles(appId, cfg) {
+    const base = cfg.baseUrl.replace(/\/+$/, '') + (cfg.apiPrefix || '');
+    return apiCall('GET', `/api/app/code?appId=${encodeURIComponent(appId)}`, undefined, cfg);
+}