@fa-software/semi2-dsh 0.0.16 → 0.0.17-preview.20260929054409

package/lib/service/host-writes.js

@@ -1,79 +0,0 @@
-// @fa-software/semi2-dsh/service/host-writes —— 磁盘写入的唯一闸口：串行队列 + 宿主就绪门 + 两段独立预算。
-// 只剩「盘上自铸内容的认领清理」走这里；状态段与工作区映射都是内存覆盖行，不落盘、不过这道门。
-// dsh 0.1.7 的 settings.update 是 Profile 配置编辑，内部 `ctx.loader.await()` 要等整棵 loader 空闲：
-// 排队（含等宿主就绪）到点只让调用方降级、写入留在队列继续等，写盘到点才按 writeTimeoutMs 降级。
-import { ConfigurationError } from "../hub/errors.js";
-/** 排队（含等宿主就绪）的调用方上限缺省值（ms）。 */
-const QUEUE_WAIT_MS = 15_000;
-/** 单次写盘的上限缺省值（ms）。 */
-const WRITE_TIMEOUT_MS = 3_000;
-/** 到点标记：与「底层真的返回了 undefined」区分开。 */
-const EXPIRED = Symbol('expired');
-export function createHostWrites(warn, options = {}) {
-    const queueWaitMs = options.queueWaitMs ?? QUEUE_WAIT_MS;
-    const writeTimeoutMs = options.writeTimeoutMs ?? WRITE_TIMEOUT_MS;
-    /** 队列尾：只按底层任务真正落定前进，调用方是否已降级与它无关。 */
-    let tail = Promise.resolve();
-    /** 排队告警去重（按段）：成功落定一次即复位。 */
-    const reported = new Set();
-    return {
-        run(ns, task) {
-            const started = Promise.withResolvers();
-            const execution = tail.then(async () => {
-                await waitHostReady(options.ready);
-                started.resolve();
-                await task();
-            });
-            // 队列尾按底层任务真正落定前进：被放弃的那笔仍占着 profile 的 writer 锁，下一笔不能抢跑。
-            tail = execution.then(() => undefined, () => undefined);
-            // 结果处理先接住拒绝：调用方降级后任务仍会跑完，迟到失败不该变成未处理拒绝。
-            const outcome = execution.then(() => null, (error) => (error instanceof Error ? error : new Error(String(error))));
-            return (async () => {
-                if ((await within(started.promise, queueWaitMs)) === EXPIRED) {
-                    if (!reported.has(ns)) {
-                        reported.add(ns);
-                        warn(`${ns} 写入排队中（宿主仍在启动，等满 ${queueWaitMs}ms），本轮先降级；宿主就绪后照常落定`);
-                    }
-                    throw new ConfigurationError('CONFIG_APPLY_FAILED');
-                }
-                const result = await within(outcome, writeTimeoutMs);
-                if (result === EXPIRED) {
-                    warn(`${ns} 设置写入超时（${writeTimeoutMs}ms），本端继续，状态可能落后`);
-                    throw new ConfigurationError('CONFIG_APPLY_FAILED');
-                }
-                if (result !== null)
-                    throw result;
-                reported.delete(ns);
-            })();
-        },
-    };
-}
-/** 宿主就绪门：等 profile 的 loader 条目树空闲——设置写入内部等的就是它；没有该端（宿主直跑 / 假宿主）立即放行。 */
-async function waitHostReady(ready) {
-    if (ready === undefined)
-        return;
-    try {
-        await ready();
-    }
-    catch {
-        // 就绪门只负责等：树自身异常不该拦下写入，交给写盘预算与调用方的降级。
-    }
-}
-/** 到点返回 {@link EXPIRED}，否则原样给出结果；定时器总在返回前清掉。 */
-async function within(promise, ms) {
-    let timer;
-    try {
-        return await Promise.race([
-            promise,
-            new Promise((resolve) => {
-                timer = globalThis.setTimeout(() => {
-                    resolve(EXPIRED);
-                }, ms);
-            }),
-        ]);
-    }
-    finally {
-        if (timer !== undefined)
-            globalThis.clearTimeout(timer);
-    }
-}

package/lib/types/service/host-writes.d.ts

@@ -1,16 +0,0 @@
-export interface HostWritesOptions {
-    /** 宿主就绪门（调用方从 `ctx.get('loader', false)` 取；缺席即立刻放行）。 */
-    ready?: (() => Promise<unknown>) | undefined;
-    /** 调用方在队列里等宿主就绪的上限（ms，缺省 {@link QUEUE_WAIT_MS}）。 */
-    queueWaitMs?: number | undefined;
-    /** 调用方等真正写盘的上限（ms，缺省 {@link WRITE_TIMEOUT_MS}）。 */
-    writeTimeoutMs?: number | undefined;
-}
-export interface HostWrites {
-    /**
-     * 排进本进程唯一的写入队列：前一笔**真正落定**后才轮到自己，轮到时先等宿主（loader 条目树）空闲，再执行 task。
-     * 调用方在任一预算到期时按 `CONFIG_APPLY_FAILED` 降级；task 不被取消——排队超时的这笔仍会照常落定。
-     */
-    run(ns: string, task: () => Promise<unknown>): Promise<void>;
-}
-export declare function createHostWrites(warn: (message: string) => void, options?: HostWritesOptions): HostWrites;