@mebular/fleet 0.0.0-stage → 0.1.0

package/dist/quickstart.js

@@ -0,0 +1,482 @@
+// Fleet 一键上车（Stage 1）：`quickstart`（A 一条命令）+ `join`（B 一条命令）+ `pending`/`approve`。
+//
+// 设计约束：
+// - **仅消费 `@mebular/core` 公共 API**（不 import core 内部路径），不改 core 语义。
+// - 加入码含**敏感信任材料**（当前为同一用户主密钥，Stage 2 换令牌）：绝不进日志/错误信息，
+//   `--code-file` 以 0600 落盘；`describeJoinCode` 只返回脱敏字段。
+// - 默认拒绝不变：`quickstart` 默认 `--no-config-grant`，授权只走图上 grant（G1）。
+import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import net from 'node:net';
+import { hostname, networkInterfaces } from 'node:os';
+import { delimiter, dirname, join } from 'node:path';
+import { Mebular } from '@mebular/core';
+import { fleetConfigPath, fleetMasterKeyPath, loadFleetConfig, masterKeyFingerprint, permissionsApplicable, readMasterKeyFile, saveFleetConfig, writeMasterKeyFile, } from './config.js';
+import { mebularOptions, offlineMebularOptions, onboardDevice } from './onboard.js';
+import { activateJoinInvite, buildJoinToken } from './jointoken.js';
+/** 默认设备名：主机名清洗（小写、非法字符→`-`、去首尾 `-`）。 */
+export function sanitizeDeviceName(name) {
+    const cleaned = name
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^[-.]+|[-.]+$/g, '');
+    return cleaned.length > 0 ? cleaned : 'device';
+}
+export function defaultDeviceName(host = hostname()) {
+    return sanitizeDeviceName(host);
+}
+/**
+ * 默认设备目录：`FLEET_DIR` → `MEBULAR_HOME` → `~/.mebular`（W2 一机一节点统一 home）。
+ * 旧 `~/.fleet` 仅作 **embedded 测试模式**（`--dir` 显式指定）。
+ */
+export function defaultFleetDir(env = process.env) {
+    const fromEnv = env.FLEET_DIR ?? env.MEBULAR_HOME;
+    const home = env.HOME ?? env.USERPROFILE ?? '.';
+    return fromEnv !== undefined && fromEnv.length > 0 ? fromEnv : join(home, '.mebular');
+}
+/** PATH 中是否存在可执行文件（Windows 尝试 PATHEXT 扩展）。 */
+export function commandExists(command, env = process.env, platform = process.platform) {
+    const path = env.PATH ?? env.Path ?? '';
+    const exts = platform === 'win32' ? (env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD').split(';') : [''];
+    for (const dir of path.split(delimiter)) {
+        if (dir.length === 0)
+            continue;
+        for (const ext of exts) {
+            if (existsSync(join(dir, command + ext)))
+                return true;
+        }
+    }
+    return false;
+}
+const OPENCHAMBER_ENV_KEYS = [
+    'MEBULAR_FLEET_OPENCHAMBER_ENDPOINT',
+    'MEBULAR_FLEET_OPENCHAMBER_TOKEN',
+    'MEBULAR_FLEET_OPENCHAMBER_TOKEN_FILE',
+];
+/** agent 自动探测：PATH 有 hermes → hermes；存在 `MEBULAR_FLEET_OPENCHAMBER_*` → openchamber；否则 echo。 */
+export function detectAgents(env = process.env, platform = process.platform) {
+    const agents = [];
+    const sources = [];
+    if (commandExists('hermes', env, platform)) {
+        agents.push({ name: 'hermes', kind: 'hermes' });
+        sources.push('hermes:PATH');
+    }
+    if (OPENCHAMBER_ENV_KEYS.some((k) => (env[k] ?? '').length > 0)) {
+        agents.push({ name: 'openchamber', kind: 'openchamber' });
+        sources.push('openchamber:env');
+    }
+    if (agents.length === 0) {
+        agents.push({ name: 'echo', kind: 'echo' });
+        sources.push('echo:default');
+    }
+    return { agents, sources };
+}
+function parseListenPort(listen) {
+    const m = /^\/(?:ip4|ip6)\/([^/]+)\/tcp\/(\d+)$/.exec(listen);
+    if (!m)
+        return null;
+    return { host: m[1], port: Number(m[2]) };
+}
+/** 端口占用检查：占用 → 抛清晰错误 + 建议（`tcp/0` 表示随机端口，跳过）。 */
+export async function assertListenAvailable(listen) {
+    const parsed = parseListenPort(listen);
+    if (parsed === null || parsed.port === 0)
+        return;
+    const { host, port } = parsed;
+    await new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.once('error', (error) => {
+            if (error.code === 'EADDRINUSE') {
+                reject(new Error(`监听端口被占用：${listen}（EADDRINUSE）。建议：换端口（如 --listen /ip4/0.0.0.0/tcp/${port + 1}），或停用占用进程后重试。`));
+            }
+            else {
+                reject(new Error(`监听地址不可用：${listen}（${error.code ?? error.message}）`));
+            }
+        });
+        server.listen({ host: host === '0.0.0.0' || host === '::' ? undefined : host, port }, () => {
+            server.close(() => resolve());
+        });
+    });
+}
+/** 解析加入码：接受内联 base64 或其文本内容（兼容直接粘贴 JSON）。 */
+export function decodeJoinCode(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        throw new Error('加入码为空');
+    let json;
+    if (trimmed.startsWith('{')) {
+        json = trimmed;
+    }
+    else {
+        json = Buffer.from(trimmed, 'base64').toString('utf-8');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        throw new Error('加入码无法解析（既非 base64 也非 JSON）');
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        throw new Error('加入码形状非法');
+    const c = parsed;
+    if (c.v !== 1 || c.kind !== 'mebular-fleet-join')
+        throw new Error('加入码版本/类型不受支持');
+    if (typeof c.sha !== 'string' || typeof c.device !== 'string' || typeof c.namespace !== 'string') {
+        throw new Error('加入码缺少必填字段');
+    }
+    if (!Array.isArray(c.multiaddrs) || c.multiaddrs.some((a) => typeof a !== 'string')) {
+        throw new Error('加入码 multiaddrs 非法');
+    }
+    if (typeof c.fingerprint !== 'string')
+        throw new Error('加入码缺少指纹');
+    const trust = c.trust;
+    if (typeof trust !== 'object' || trust === null || typeof trust.publicKey !== 'string' || typeof trust.privateKeyPkcs8 !== 'string') {
+        throw new Error('加入码信任材料非法');
+    }
+    return {
+        v: 1,
+        kind: 'mebular-fleet-join',
+        sha: c.sha,
+        device: c.device,
+        namespace: c.namespace,
+        multiaddrs: c.multiaddrs,
+        fingerprint: c.fingerprint,
+        issuedAt: typeof c.issuedAt === 'number' ? c.issuedAt : 0,
+        trust: { publicKey: trust.publicKey, privateKeyPkcs8: trust.privateKeyPkcs8 },
+        ...(typeof c.note === 'string' ? { note: c.note } : {}),
+    };
+}
+/** 加入码 → 内联 base64。 */
+export function encodeJoinCode(code) {
+    return Buffer.from(JSON.stringify(code), 'utf-8').toString('base64');
+}
+/** 脱敏描述（**不含信任材料**，可用于日志/报告）。 */
+export function describeJoinCode(code) {
+    return {
+        v: code.v,
+        kind: code.kind,
+        sha: code.sha,
+        device: code.device,
+        namespace: code.namespace,
+        multiaddrs: code.multiaddrs,
+        fingerprint: code.fingerprint,
+        issuedAt: code.issuedAt,
+        hasTrustMaterial: true,
+    };
+}
+/** 写加入码文件（0600）。 */
+export async function writeJoinCodeFile(path, inline) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, inline, { mode: 0o600 });
+    if (permissionsApplicable())
+        await chmod(path, 0o600);
+}
+/**
+ * 构建 SHA 的**环境覆盖**（CLI 传入真实 `version.json` 值）。
+ * 本模块刻意不读 `import.meta`（ts-jest 以 CJS 加载 src，会编译失败）；
+ * 缺省 `unknown` → 版本核对自动跳过。
+ */
+export function envBuildSha(env = process.env) {
+    const envSha = env.MEBULAR_FLEET_BUILD_SHA;
+    return envSha !== undefined && envSha.length > 0 ? envSha : 'unknown';
+}
+/** W2：确保守护 bearer 令牌存在（写入 <dir>/auth/tokens.json，0600）；返回内联 token。 */
+export async function ensureDaemonToken(dir) {
+    const { createHash, randomUUID } = await import('node:crypto');
+    const tokensFile = join(dir, 'auth', 'tokens.json');
+    let record = { tokens: [] };
+    if (existsSync(tokensFile)) {
+        try {
+            const parsed = JSON.parse(await readFile(tokensFile, 'utf-8'));
+            if (Array.isArray(parsed.tokens))
+                record = { tokens: parsed.tokens };
+        }
+        catch {
+            record = { tokens: [] };
+        }
+    }
+    const token = `meb_${randomUUID().replace(/-/g, '')}${randomUUID().replace(/-/g, '')}`;
+    record.tokens.push({
+        id: randomUUID(),
+        sha256: createHash('sha256').update(token).digest('hex'),
+        scope: ['memory.read', 'memory.write', 'memory.admin'],
+        label: 'fleet-client',
+        createdAt: new Date().toISOString(),
+        revoked: false,
+    });
+    await mkdir(dirname(tokensFile), { recursive: true });
+    await writeFile(tokensFile, JSON.stringify(record, null, 2), { mode: 0o600 });
+    if (permissionsApplicable())
+        await chmod(tokensFile, 0o600);
+    return { token, tokensFile };
+}
+/**
+ * W2 B2：把统一守护配置写进同一 home（`<dir>/config.json`），并让 fleet 走 daemon 客户端：
+ * fleet.config.json 增 `store:'daemon'` + `daemon:{endpoint,token}`。**不动** embedded 配置字段。
+ */
+export async function configureDaemonHome(dir, config, namespace, joinPort, daemonPort, delegated, peers = []) {
+    const { token, tokensFile } = await ensureDaemonToken(dir);
+    const daemonConfig = {
+        storagePath: config.storagePath,
+        deviceId: config.device,
+        identity: { mode: delegated ? 'delegated' : 'root' },
+        encryption: delegated
+            ? { level: 'none', userMasterPublicKeyFile: delegated.userMasterPublicKeyFile }
+            : { level: 'none', keyFile: config.masterKeyFile },
+        network: { enabled: true, libp2p: { listen: [config.listen] }, ...(peers.length > 0 ? { peers } : {}) },
+        sync: {
+            autoSync: true,
+            pushOnWrite: true,
+            namespaces: [namespace],
+            antiEntropy: { enabled: true, intervalMs: 600000, jitterRatio: 0.2 },
+        },
+        joinService: { enabled: true, bind: '0.0.0.0', port: joinPort },
+        mcp: { http: { host: '127.0.0.1', port: daemonPort, auth: 'bearer', tokensFile } },
+    };
+    await writeFile(join(dir, 'config.json'), JSON.stringify(daemonConfig, null, 2), { mode: 0o600 });
+    if (permissionsApplicable())
+        await chmod(join(dir, 'config.json'), 0o600);
+    const endpoint = `http://127.0.0.1:${daemonPort}`;
+    const fleetPath = fleetConfigPath(dir);
+    const current = await loadFleetConfig(fleetPath);
+    await saveFleetConfig(fleetPath, { ...current, store: 'daemon', daemon: { endpoint, token } });
+    return { token, endpoint };
+}
+/** W2：Agent 侧 MCP 配置片段（守护 MCP stdio）。 */
+export function agentMcpConfig() {
+    return { mcp: { mebular: { type: 'local', command: ['mebular', 'mcp'] } } };
+}
+const DEFAULT_LISTEN = '/ip4/0.0.0.0/tcp/4001';
+const DEFAULT_JOIN_PORT = 4002;
+/** 选一个可对外通告的 LAN IPv4（无则回环）。 */
+export function pickLanHost() {
+    const ifaces = networkInterfaces();
+    for (const list of Object.values(ifaces)) {
+        for (const info of list ?? []) {
+            if (info.family === 'IPv4' && !info.internal)
+                return info.address;
+        }
+    }
+    return '127.0.0.1';
+}
+/** A 一条命令：onboard + 本机订阅(self) + 加入码 + 服务 + doctor。 */
+export async function quickstart(input) {
+    const env = input.env ?? process.env;
+    const namespace = input.namespace ?? 'tasks';
+    const listen = input.listen ?? DEFAULT_LISTEN;
+    const warnings = [];
+    await mkdir(input.dir, { recursive: true });
+    if (permissionsApplicable(input.platform))
+        await chmod(input.dir, 0o700);
+    if (input.skipPortCheck !== true)
+        await assertListenAvailable(listen);
+    const probe = input.agents !== undefined ? { agents: input.agents, sources: ['explicit'] } : detectAgents(env, input.platform);
+    const onboard = await onboardDevice({
+        dir: input.dir,
+        device: input.device,
+        namespace,
+        listen,
+        agents: probe.agents,
+    });
+    const config = onboard.config;
+    const encryption = await readMasterKeyFile(config.masterKeyFile);
+    // 图上订阅：本机声明参与该域（订阅自主，零门槛）。
+    const mebular = new Mebular(offlineMebularOptions(config, encryption));
+    await mebular.initialize();
+    try {
+        await mebular.subscribeNamespace(namespace);
+    }
+    finally {
+        await mebular.shutdown();
+    }
+    // T2：启用 join 服务并预生成一枚令牌（推荐路径；旧共享主密钥 code 仍保留用于兼容）。
+    const joinPort = input.joinPort ?? DEFAULT_JOIN_PORT;
+    await saveFleetConfig(fleetConfigPath(input.dir), {
+        ...config,
+        joinService: { enabled: true, bind: '0.0.0.0', port: joinPort },
+    });
+    const joinEndpoint = `http://${input.joinHost ?? pickLanHost()}:${joinPort}`;
+    const tokenBuilder = new Mebular(offlineMebularOptions(config, encryption));
+    await tokenBuilder.initialize();
+    let inviteToken;
+    try {
+        const token = await buildJoinToken({ mebular: tokenBuilder, deviceId: config.device, namespace, endpoint: joinEndpoint });
+        // 预生成令牌也进入单一有效邀请状态：之后在控制台重新生成会撤销它。
+        await activateJoinInvite(config.storagePath, token.nonce);
+        inviteToken = Buffer.from(JSON.stringify(token), 'utf-8').toString('base64');
+    }
+    finally {
+        await tokenBuilder.shutdown();
+    }
+    const multiaddrs = await captureMultiaddrs(config, encryption, warnings);
+    const inline = encodeJoinCode({
+        v: 1,
+        kind: 'mebular-fleet-join',
+        sha: input.buildSha ?? envBuildSha(env),
+        device: config.device,
+        namespace,
+        multiaddrs,
+        fingerprint: onboard.masterKeyFingerprint,
+        issuedAt: Date.now(),
+        trust: {
+            publicKey: Buffer.from(encryption.userMasterKey).toString('base64'),
+            privateKeyPkcs8: await exportPkcs8(encryption),
+        },
+        note: 'stage1: shared master key (stage2 will use a join token)',
+    });
+    if (input.codeFile !== undefined)
+        await writeJoinCodeFile(input.codeFile, inline);
+    let serviceInstalled = false;
+    let serviceNote;
+    if (input.installService !== undefined) {
+        const outcome = await input.installService(input.dir);
+        serviceInstalled = outcome.installed;
+        serviceNote = outcome.note;
+    }
+    // W2 B2：统一守护（同一 home）：写 config.json + fleet daemon 客户端 + （可选）mebular-serve 服务 + MCP 配置
+    const daemonPort = input.daemonPort ?? 7331;
+    let daemonInfo = null;
+    if (input.daemon === true) {
+        const { endpoint } = await configureDaemonHome(input.dir, config, namespace, joinPort, daemonPort, null);
+        let installed = false;
+        let dialNote;
+        if (input.installDaemon !== undefined) {
+            const outcome = await input.installDaemon(input.dir);
+            installed = outcome.installed;
+            dialNote = outcome.note;
+        }
+        daemonInfo = { endpoint, installed, ...(dialNote !== undefined ? { note: dialNote } : {}) };
+    }
+    return {
+        device: config.device,
+        dir: config.dir,
+        namespace,
+        fingerprint: onboard.masterKeyFingerprint,
+        code: inline,
+        ...(input.codeFile !== undefined ? { codeFile: input.codeFile } : {}),
+        multiaddrs,
+        agents: probe.agents,
+        agentSources: probe.sources,
+        serviceInstalled,
+        ...(serviceNote !== undefined ? { serviceNote } : {}),
+        joinNext: [
+            'fleet join --token <内联|文件>（推荐：主密钥不复制）',
+            '新设备加入后自行 subscribe；订阅零门槛、无需批准',
+        ],
+        warnings,
+        inviteToken,
+        joinEndpoint,
+        joinPort,
+        ...(daemonInfo !== null ? { daemon: daemonInfo } : {}),
+    };
+}
+async function captureMultiaddrs(config, encryption, warnings) {
+    const m = new Mebular(mebularOptions(config, encryption));
+    await m.initialize();
+    try {
+        const addrs = m.node?.getLocalMultiaddrs() ?? [];
+        if (addrs.length === 0)
+            warnings.push('未捕获到可达 multiaddr（对端需人工提供地址）');
+        return addrs;
+    }
+    finally {
+        await m.shutdown();
+    }
+}
+async function exportPkcs8(encryption) {
+    if (encryption.userMasterPrivateKey === undefined)
+        throw new Error('缺少用户主私钥，无法导出加入码信任材料');
+    const raw = await globalThis.crypto.subtle.exportKey('pkcs8', encryption.userMasterPrivateKey);
+    return Buffer.from(raw).toString('base64');
+}
+/** B 一条命令：版本核对 → 导入信任材料/地址 → onboard → 声明成员(active) → 服务 → doctor。 */
+export async function joinFleet(input) {
+    const env = input.env ?? process.env;
+    const code = decodeJoinCode(input.code);
+    const localSha = input.buildSha ?? envBuildSha(env);
+    if (code.sha !== 'unknown' && localSha !== 'unknown' && code.sha !== localSha) {
+        throw new Error(`版本不一致：加入码构建 SHA=${code.sha}，本机=${localSha}。请使用同版本（fleet --version）后重试。`);
+    }
+    const namespace = input.namespace ?? code.namespace;
+    const listen = input.listen ?? DEFAULT_LISTEN;
+    if (input.skipPortCheck !== true)
+        await assertListenAvailable(listen);
+    const probe = input.agents !== undefined ? { agents: input.agents, sources: ['explicit'] } : detectAgents(env, input.platform);
+    // 幂等/防覆盖：已有配置且设备不符 → 拒绝；已有同设备且指纹一致 → 复用。
+    const keyPath = fleetMasterKeyPath(input.dir);
+    let alreadyJoined = false;
+    if (existsSync(fleetConfigPath(input.dir))) {
+        const existing = await loadFleetConfig(fleetConfigPath(input.dir));
+        if (existing.device !== input.device) {
+            throw new Error(`目录已被设备 ${existing.device} 占用（--dir ${input.dir}）；换目录或先停用。`);
+        }
+        if (existsSync(keyPath)) {
+            const existingKey = await readMasterKeyFile(keyPath);
+            if (masterKeyFingerprint(existingKey.userMasterKey) !== code.fingerprint) {
+                throw new Error('本机已有不同主密钥，拒绝被加入码覆盖。');
+            }
+            alreadyJoined = true;
+        }
+    }
+    await mkdir(input.dir, { recursive: true });
+    if (permissionsApplicable(input.platform))
+        await chmod(input.dir, 0o700);
+    if (!existsSync(keyPath)) {
+        await writeMasterKeyFile(keyPath, await importTrust(code));
+    }
+    const onboard = await onboardDevice({
+        dir: input.dir,
+        device: input.device,
+        namespace,
+        listen,
+        agents: probe.agents,
+        peerDevice: code.device,
+        ...(code.multiaddrs[0] !== undefined ? { peerAddr: code.multiaddrs[0] } : {}),
+    });
+    const encryption = await readMasterKeyFile(onboard.config.masterKeyFile);
+    const mebular = new Mebular(offlineMebularOptions(onboard.config, encryption));
+    await mebular.initialize();
+    try {
+        await mebular.subscribeNamespace(namespace);
+    }
+    finally {
+        await mebular.shutdown();
+    }
+    let serviceInstalled = false;
+    let serviceNote;
+    if (input.installService !== undefined) {
+        const outcome = await input.installService(input.dir);
+        serviceInstalled = outcome.installed;
+        serviceNote = outcome.note;
+    }
+    return {
+        device: onboard.config.device,
+        dir: onboard.config.dir,
+        peer: code.device,
+        namespace,
+        fingerprint: onboard.masterKeyFingerprint,
+        alreadyJoined,
+        serviceInstalled,
+        ...(serviceNote !== undefined ? { serviceNote } : {}),
+        multiaddrs: code.multiaddrs,
+        agents: probe.agents,
+        agentSources: probe.sources,
+        next: ['本机已声明订阅；对端同步后即可互通（无需批准）'],
+    };
+}
+async function importTrust(code) {
+    const userMasterKey = new Uint8Array(Buffer.from(code.trust.publicKey, 'base64'));
+    const userMasterPrivateKey = await globalThis.crypto.subtle.importKey('pkcs8', Buffer.from(code.trust.privateKeyPkcs8, 'base64'), { name: 'Ed25519' }, true, ['sign']);
+    return { userMasterKey, userMasterPrivateKey };
+}
+/** 读加入码文件（或内联）。 */
+export async function readJoinCode(input) {
+    if (input.code !== undefined && input.code.length > 0)
+        return input.code;
+    if (input.codeFile !== undefined)
+        return await readFile(input.codeFile, 'utf-8');
+    throw new Error('join 需要 --code <内联> 或 --code-file <路径>');
+}
+//# sourceMappingURL=quickstart.js.map

package/dist/quickstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../src/quickstart.ts"],"names":[],"mappings":"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"}

package/dist/quota.d.ts

@@ -0,0 +1,41 @@
+/** 准入判定。 */
+export type QuotaDecision = 'accepted' | 'queued' | 'rejected';
+/** 每设备快照。 */
+export interface QuotaSnapshot {
+    device: string;
+    used: number;
+    queued: number;
+    rejected: number;
+}
+/** 构造选项。 */
+export interface LocalQuotaOptions {
+    /** 每设备（对**自己发出**）的上限 */
+    limitPerDevice: number;
+    /** 超额策略：`queue` 进本地队列；`reject` 直接拒绝。默认 `queue`。 */
+    onOverflow?: 'queue' | 'reject';
+}
+/** 每设备本地配额账本（确定性、纯本地）。 */
+export declare class LocalQuota {
+    private readonly limit;
+    private readonly overflow;
+    private readonly usedMap;
+    private readonly queuedMap;
+    private readonly rejectedMap;
+    constructor(options: LocalQuotaOptions);
+    private static bump;
+    /** 请求发出 `amount` 单位：返回本机判定（`accepted` / `queued` / `rejected`）。 */
+    decide(device: string, amount?: number): QuotaDecision;
+    /** 容量释放（如队列/在途被消费）：从 `used` 扣减（不为负）。 */
+    release(device: string, amount?: number): void;
+    /**
+     * 把本地队列里的量搬迁到 `used`（容量允许时）；返回搬迁成功的量。
+     * 仅本地排队消化，无跨端协调。
+     */
+    drainQueue(device: string, capacity?: number): number;
+    used(device: string): number;
+    queued(device: string): number;
+    rejected(device: string): number;
+    /** 每设备快照（按 device 字典序，确定性）。 */
+    snapshot(): QuotaSnapshot[];
+}
+//# sourceMappingURL=quota.d.ts.map

package/dist/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../src/quota.ts"],"names":[],"mappings":"AAIA,YAAY;AACZ,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,YAAY;AACZ,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CACjC;AAQD,0BAA0B;AAC1B,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAE7C,OAAO,EAAE,iBAAiB;IAQtC,OAAO,CAAC,MAAM,CAAC,IAAI;IAInB,mEAAmE;IACnE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,aAAa;IAejD,wCAAwC;IACxC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,IAAI;IAMzC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAa,GAAG,MAAM;IAazD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI5B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIhC,+BAA+B;IAC/B,QAAQ,IAAI,aAAa,EAAE;CAS5B"}

package/dist/quota.js

@@ -0,0 +1,84 @@
+// Fleet 本地配额（M1）：**每设备对自己发出的量本地记账**，超额本地拒绝或排队。
+//
+// 禁中心化：无注册服务、无全局账本、无跨端对账；不同设备的配额互不影响（见 DESIGN.md §4）。
+function assertAmount(amount) {
+    if (!Number.isInteger(amount) || amount <= 0) {
+        throw new Error(`quota amount 必须为正整数：${amount}`);
+    }
+}
+/** 每设备本地配额账本（确定性、纯本地）。 */
+export class LocalQuota {
+    limit;
+    overflow;
+    usedMap = new Map();
+    queuedMap = new Map();
+    rejectedMap = new Map();
+    constructor(options) {
+        if (!Number.isInteger(options.limitPerDevice) || options.limitPerDevice <= 0) {
+            throw new Error(`limitPerDevice 必须为正整数：${options.limitPerDevice}`);
+        }
+        this.limit = options.limitPerDevice;
+        this.overflow = options.onOverflow ?? 'queue';
+    }
+    static bump(map, key, amount) {
+        map.set(key, (map.get(key) ?? 0) + amount);
+    }
+    /** 请求发出 `amount` 单位：返回本机判定（`accepted` / `queued` / `rejected`）。 */
+    decide(device, amount = 1) {
+        assertAmount(amount);
+        const used = this.usedMap.get(device) ?? 0;
+        if (used + amount <= this.limit) {
+            LocalQuota.bump(this.usedMap, device, amount);
+            return 'accepted';
+        }
+        if (this.overflow === 'reject') {
+            LocalQuota.bump(this.rejectedMap, device, amount);
+            return 'rejected';
+        }
+        LocalQuota.bump(this.queuedMap, device, amount);
+        return 'queued';
+    }
+    /** 容量释放（如队列/在途被消费）：从 `used` 扣减（不为负）。 */
+    release(device, amount = 1) {
+        assertAmount(amount);
+        const used = this.usedMap.get(device) ?? 0;
+        this.usedMap.set(device, Math.max(0, used - amount));
+    }
+    /**
+     * 把本地队列里的量搬迁到 `used`（容量允许时）；返回搬迁成功的量。
+     * 仅本地排队消化，无跨端协调。
+     */
+    drainQueue(device, capacity = this.limit) {
+        if (!Number.isInteger(capacity) || capacity < 0)
+            throw new Error(`capacity 非法：${capacity}`);
+        const queued = this.queuedMap.get(device) ?? 0;
+        const used = this.usedMap.get(device) ?? 0;
+        const room = Math.max(0, capacity - used);
+        const moved = Math.min(queued, room);
+        if (moved > 0) {
+            this.queuedMap.set(device, queued - moved);
+            this.usedMap.set(device, used + moved);
+        }
+        return moved;
+    }
+    used(device) {
+        return this.usedMap.get(device) ?? 0;
+    }
+    queued(device) {
+        return this.queuedMap.get(device) ?? 0;
+    }
+    rejected(device) {
+        return this.rejectedMap.get(device) ?? 0;
+    }
+    /** 每设备快照（按 device 字典序，确定性）。 */
+    snapshot() {
+        const devices = new Set([...this.usedMap.keys(), ...this.queuedMap.keys(), ...this.rejectedMap.keys()]);
+        return [...devices].sort().map((device) => ({
+            device,
+            used: this.usedMap.get(device) ?? 0,
+            queued: this.queuedMap.get(device) ?? 0,
+            rejected: this.rejectedMap.get(device) ?? 0,
+        }));
+    }
+}
+//# sourceMappingURL=quota.js.map

package/dist/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../src/quota.ts"],"names":[],"mappings":"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"}