@lark-apaas/miaoda-cli 0.1.2-alpha.ccfdc05 → 0.1.2-alpha.d0d2ae1

package/dist/cli/handlers/observability/metric.js

@@ -1,208 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleObservabilityMetric = handleObservabilityMetric;
-const api = __importStar(require("../../../api/index"));
-const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
-const helpers_1 = require("./helpers");
-/**
- * PRD <metric-name> + --series → 服务端 metric name → 表头列名（=对应 --series 取值）。
- *
- * - 缺省 --series 时返回该 cliName 下所有相关线。
- * - latency / requests 的 error 线 v1.0.122 起由独立 metric 提供（不再 is_error filter）。
- *
- * 表头标签直接用 --series 名（"total"/"error"/"p50"/"p99"）；单一指标则用 cliName。
- */
-const METRIC_LABELS = {
-    cpu: { cpu_usage: "cpu" },
-    memory: { mem_usage: "memory" },
-    requests: {
-        client_api_request_count: "total",
-        client_api_request_error_count: "error",
-    },
-    latency: {
-        client_api_request_latency_p50: "p50",
-        client_api_request_latency_p99: "p99",
-    },
-};
-/** miaoda observability metric <metric-name> */
-async function handleObservabilityMetric(opts) {
-    if (!opts.metricName)
-        (0, shared_1.failArgs)("<metric-name> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
-    const { metricNames, labelByMetric, extraFilters } = resolveMetricSelection(opts.metricName, opts.series);
-    const filters = (0, helpers_1.buildFieldFilters)([
-        { key: "referer_path", value: opts.page ? (0, helpers_1.eqFilter)(opts.page) : undefined },
-        { key: "api", value: opts.api ? (0, helpers_1.eqFilter)(opts.api) : undefined },
-        ...extraFilters,
-    ]);
-    // since/until 直接以秒透传到 BAM；当前未做桶对齐（如需开启把 until
-    // 用 ceilMsToBucket(untilMs, downSample as GranularityBucket) 包一层即可）。
-    const downSample = opts.downSample ?? "1m";
-    const nowMs = Date.now();
-    const sinceMs = (0, helpers_1.parseToMs)(opts.since) ?? nowMs - 30 * 86_400_000;
-    const untilMs = (0, helpers_1.parseToMs)(opts.until) ?? nowMs;
-    const req = {
-        appID,
-        appEnv: "runtime",
-        metricNames,
-        startTimestamp: (0, helpers_1.msToSec)(sinceMs),
-        endTimestamp: (0, helpers_1.msToSec)(untilMs),
-        filters,
-        downSample,
-        needPackLackPoint: false,
-    };
-    const resp = await api.observability.queryMetricsData(req);
-    // requests 的 count / error_count：
-    //   - BAM 在该时间点无数据时会传 null，或者 values 里干脆缺 key
-    //   - CLI 按"请求过的 metricNames"逐一兜底为 0，让"没有请求"和"没有数据"
-    //     在表格 / JSON 里都显式呈现成 0，避免空格 / 缺字段被误解为缺失
-    // latency / cpu / memory 不做这个兜底——p50 没数据 ≠ 延迟为 0。
-    if (opts.metricName === "requests") {
-        fillRequestedMetricsWithZero(resp, metricNames);
-    }
-    emitMetricsResponse(resp, labelByMetric);
-}
-/**
- * 按"客户端请求过的 metricNames"兜底缺失/为 null 的值为 0；不去动 BAM 多返回的
- * 其他字段（防御性，避免误改不属于本次查询的数据）。
- */
-function fillRequestedMetricsWithZero(resp, requestedMetricNames) {
-    for (const point of resp.points ?? []) {
-        for (const name of requestedMetricNames) {
-            point.values[name] ??= 0;
-        }
-    }
-}
-// ── 渲染 ─────────
-//
-// BAM v1.0.123 起返回 points: [{timestamp, dimensions, values: {metricName: v}}]——
-// 服务端已把多 metric 合并到同 timestamp 的 row，下游直接平铺即可。
-// JSON 模式：原样透传 points（保留 BAM 原 metricName 作为 values 的 key）。
-// Pretty 模式：把 values 里的 metricName 重命名成 CLI label（p50/p99/total 等），
-//   再走 buildPivotSchema 渲染。
-function emitMetricsResponse(resp, labelByMetric) {
-    const points = resp.points ?? [];
-    // metric 不分页，但仍补齐 has_more / next_cursor 以对齐 log/trace 的信封形状
-    if ((0, output_1.isJsonMode)()) {
-        (0, output_1.emit)({ data: points, next_cursor: null, has_more: false });
-        return;
-    }
-    const { rows, seriesLabels } = renameAndSort(points, labelByMetric);
-    if (rows.length === 0) {
-        (0, output_1.emit)({ data: [], next_cursor: null, has_more: false });
-        return;
-    }
-    const hasLatency = Object.keys(labelByMetric).some((n) => n.includes("latency"));
-    (0, output_1.emit)({ data: rows, next_cursor: null, has_more: false }, buildPivotSchema(seriesLabels, hasLatency));
-}
-function renameAndSort(points, labelByMetric) {
-    // 列顺序按 labelByMetric 声明顺序，避免 BAM 返回顺序波动影响表头
-    const seriesLabels = Object.values(labelByMetric);
-    // TODO: 当 dimensions 非空（groupBy 多 series）时，把 dimensions 也并入 row
-    const rows = points.map((point) => {
-        const row = { timestamp: point.timestamp };
-        for (const [metricName, value] of Object.entries(point.values)) {
-            const label = labelByMetric[metricName] ?? metricName;
-            row[label] = value;
-        }
-        return row;
-    });
-    // 按时间倒序，与 log/trace 的"最新在前"风格一致
-    rows.sort((a, b) => b.timestamp - a.timestamp);
-    return { rows, seriesLabels };
-}
-function buildPivotSchema(seriesLabels, hasLatency) {
-    const valueFormat = hasLatency ? output_1.fmt.durationMs() : undefined;
-    return {
-        columns: [
-            { key: "timestamp", label: "time", format: output_1.fmt.sec() },
-            ...seriesLabels.map((label) => ({
-                key: label,
-                label,
-                ...(valueFormat ? { format: valueFormat } : {}),
-            })),
-        ],
-        strict: true,
-    };
-}
-/**
- * 解析 <metric-name> + --series 的组合：决定最终 metricNames、表头 label 映射、附加过滤。
- *
- * label 直接用 --series 取值（"total"/"error"/"p50"/"p99"）；单一指标 cliName 也作为 label。
- */
-function resolveMetricSelection(cliName, series) {
-    const extras = [];
-    if (cliName === "latency") {
-        if (series === "p99") {
-            return single("client_api_request_latency_p99", "p99", extras);
-        }
-        if (series === "p50") {
-            return single("client_api_request_latency_p50", "p50", extras);
-        }
-        return all(METRIC_LABELS.latency, extras);
-    }
-    if (cliName === "requests") {
-        // v1.0.122 起 error 线由独立 metric 提供，不再走 is_error filter
-        if (series === "total") {
-            return single("client_api_request_count", "total", extras);
-        }
-        if (series === "error") {
-            return single("client_api_request_error_count", "error", extras);
-        }
-        return all(METRIC_LABELS.requests, extras);
-    }
-    if (cliName === "cpu")
-        return all(METRIC_LABELS.cpu, extras);
-    if (cliName === "memory")
-        return all(METRIC_LABELS.memory, extras);
-    // 兜底：CLI 名直接作为 metric name + label
-    return single(cliName, cliName, extras);
-}
-function single(metricName, label, extras) {
-    return {
-        metricNames: [metricName],
-        labelByMetric: { [metricName]: label },
-        extraFilters: extras,
-    };
-}
-function all(labelByMetric, extras) {
-    return {
-        metricNames: Object.keys(labelByMetric),
-        labelByMetric,
-        extraFilters: extras,
-    };
-}

package/dist/cli/handlers/observability/trace.js

@@ -1,102 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleObservabilityTraceList = handleObservabilityTraceList;
-exports.handleObservabilityTraceGet = handleObservabilityTraceGet;
-const api = __importStar(require("../../../api/index"));
-const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
-const index_1 = require("../../../api/observability/index");
-const helpers_1 = require("./helpers");
-/** miaoda observability trace list */
-async function handleObservabilityTraceList(opts) {
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
-    const appEnv = "runtime";
-    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
-    // 过滤 key 对齐 BAM Span 字段名：
-    //   - 顶层字段：traceID（注意大小写）
-    //   - attributes 业务字段：user_id（snake_case）
-    //   - 入口 span：BAM 没有 entrySpanName fieldFilter，统一走 fuzzyFilter（trace endpoint
-    //     默认作用于 span name），所以 --root-span 不进 fieldFilters
-    const fieldFilters = (0, helpers_1.buildFieldFilters)([
-        { key: "trace_id", value: opts.traceId ? (0, helpers_1.eqFilter)(opts.traceId) : undefined },
-        { key: "user_id", value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, "i64") : undefined },
-    ]);
-    const req = {
-        appID,
-        appEnv,
-        startTimestampNs: (0, helpers_1.parseToNs)(opts.since),
-        endTimestampNs: (0, helpers_1.parseToNs)(opts.until),
-        limit,
-        pageToken: opts.cursor,
-        fieldFilters,
-        fuzzyFilter: opts.rootSpan ? (0, helpers_1.fuzzyFilter)(opts.rootSpan) : undefined,
-    };
-    const resp = await api.observability.searchTraces(req);
-    emitSearchTracesResponse(resp);
-}
-function emitSearchTracesResponse(resp) {
-    (0, output_1.emit)({
-        data: resp.spans ?? [],
-        next_cursor: resp.hasMore ? resp.nextPageToken : null,
-        has_more: resp.hasMore,
-    }, index_1.spanSchema);
-}
-/** miaoda observability trace get <trace-id> */
-async function handleObservabilityTraceGet(opts) {
-    if (!opts.traceId)
-        (0, shared_1.failArgs)("<trace-id> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
-    const appEnv = "runtime";
-    const resp = await api.observability.getTraces({
-        appID,
-        appEnv,
-        traceID: opts.traceId,
-        withLogSeverityCount: opts.withLogSeverityCount,
-    });
-    emitGetTraceResponse(resp);
-}
-function emitGetTraceResponse(resp) {
-    // JSON 模式：保持单条信封语义，便于下游一次解析
-    if ((0, output_1.isJsonMode)()) {
-        (0, output_1.emit)({
-            data: { spans: resp.spans ?? [], isBreak: resp.isBreak },
-        });
-        return;
-    }
-    // Pretty 模式：先打头部 key-value（断链状态等元信息），再按 spanSchema 渲染主表
-    (0, output_1.emit)({ data: { isBreak: resp.isBreak } });
-    (0, output_1.emit)({ data: resp.spans ?? [] }, index_1.spanSchema);
-}

package/dist/cli/version.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveRootVersionArg = resolveRootVersionArg;
-function resolveRootVersionArg(args) {
-    if (args.length === 1 && (args[0] === "-v" || args[0] === "--version"))
-        return "show";
-    if (args.some(isLooseVersionArg))
-        return "invalid-variant";
-    if (args.includes("-v") || args.includes("--version"))
-        return "invalid-placement";
-    return "none";
-}
-function isLooseVersionArg(arg) {
-    return ((arg.startsWith("-v") && arg !== "-v") || (arg.startsWith("--version") && arg !== "--version"));
-}

package/dist/utils/devops-error.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapDevopsError = mapDevopsError;
-const error_1 = require("./error");
-/**
- * 把 BAM lark.apaas.devops 的业务码（数字字符串）映射成 CLI 错误码。
- * 来源：服务端技术方案 wiki L7P8wlNQ5iyShLkxzlOcCo8LnTg「业务错误码映射表」。
- *
- * 放在 utils 下而不是某个具体 api 域里：app / deploy 都跑在 lark.apaas.devops
- * 这同一 PSM，业务码命名空间也共享；boundaries 规则又禁止 api 域间互引。
- */
-function mapDevopsError(bizCode, message) {
-    switch (bizCode) {
-        case "400002577":
-        case "400002569":
-            return new error_1.AppError("APP_NOT_FOUND", message, {
-                next_actions: ["Run `miaoda app list` to see available apps"],
-            });
-        case "400002579":
-            return new error_1.AppError("APP_PERMISSION_DENIED", message);
-        case "400002575":
-            return new error_1.AppError("INVALID_ARG_VALUE", message, {
-                next_actions: ["缩短 --name / --description 后重试（后端有长度限制）"],
-            });
-        default:
-            return undefined;
-    }
-}

package/dist/utils/git.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCurrentGitBranch = getCurrentGitBranch;
-const node_child_process_1 = require("node:child_process");
-/**
- * 读取 cwd 所在仓库的当前分支名。
- *
- * 不在 git 仓库、git 不可用、或处于 detached HEAD 时返回 undefined，
- * 让调用方决定回退策略（如交给后端使用应用默认分支）。
- */
-function getCurrentGitBranch(cwd = process.cwd()) {
-    let result;
-    try {
-        result = (0, node_child_process_1.spawnSync)("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
-            cwd,
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        });
-    }
-    catch {
-        return undefined;
-    }
-    if (result.status !== 0)
-        return undefined;
-    const branch = result.stdout.trim();
-    if (!branch || branch === "HEAD")
-        return undefined;
-    return branch;
-}

package/dist/utils/time.js

@@ -1,203 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TIMESTAMP_HELP = void 0;
-exports.parseTimeToMs = parseTimeToMs;
-exports.msToNs = msToNs;
-exports.msToSec = msToSec;
-exports.parseToMs = parseToMs;
-exports.parseToNs = parseToNs;
-exports.parseToSec = parseToSec;
-exports.floorMsToBucket = floorMsToBucket;
-exports.ceilMsToBucket = ceilMsToBucket;
-const error_1 = require("./error");
-exports.TIMESTAMP_HELP = "支持格式：" +
-    "相对时间 30m/1h/2d/1w；" +
-    "日期 2026-04-01（本地时区当日 00:00:00）；" +
-    "本地日期+时间 2026-04-01T10:00:00（按本地时区，T 分隔）；" +
-    "带时区 ISO 2026-04-01T10:00:00Z（UTC）或 2026-04-01T10:00:00+08:00（指定偏移）。" +
-    "禁止用空格分隔：'YYYY-MM-DD HH:mm:ss' 不带引号会被 shell 拆成两个参数。";
-/**
- * 解析时间字符串到毫秒时间戳；不匹配任一支持格式抛 ARGS_INVALID。
- *
- * 时区约定（重要）：
- *   - 不带显式时区的形式（YYYY-MM-DD、YYYY-MM-DDTHH:mm:ss）一律按
- *     **本地时区**解释，与 pretty 输出（output.ts:renderDate 用 getFullYear 等本地方法）形成
- *     输入/输出闭环：用户复制输出文本作为 --since 不会差时区。
- *   - 带显式时区（结尾 Z 或 ±HH:MM / ±HHMM）按显式时区解析，跨机器一致。
- *   - 因此跨机器同步使用时建议带显式时区；同机器复制粘贴 pretty 输出更省事。
- *
- * 拒绝 Date.parse 松散接受的形式：YYYY/MM/DD、自然语言（'April 1 2026'）、单独年份等。
- *
- * 失败抛 AppError("ARGS_INVALID", ...)；CLI 层用 withHelp 自动转 exit 2 + help。
- */
-function parseTimeToMs(input, now = new Date()) {
-    // 1. 相对时间：30m / 1h / 2d / 1w
-    const relative = /^(\d+)([mhdw])$/.exec(input);
-    if (relative) {
-        const n = Number(relative[1]);
-        const unit = relative[2];
-        const factor = unit === "m"
-            ? 60_000
-            : unit === "h"
-                ? 3_600_000
-                : unit === "d"
-                    ? 86_400_000
-                    : /* w */ 604_800_000;
-        return now.getTime() - n * factor;
-    }
-    // 2. 纯日期：YYYY-MM-DD → 本地当日 00:00:00
-    const date = /^(\d{4})-(\d{2})-(\d{2})$/.exec(input);
-    if (date) {
-        return localDateMs(input, date[1], date[2], date[3], "00", "00", "00", "0");
-    }
-    // 3. 本地日期+时间：YYYY-MM-DDTHH:mm:ss[.SSS]（不带时区，T 分隔）。
-    //    不接受空格分隔——'YYYY-MM-DD HH:mm:ss' 不带引号会被 shell 拆成两个参数，
-    //    宁可不支持也不要让 agent 踩"看起来传了 since 实际只传了一半"的坑。
-    const localDt = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,3}))?$/.exec(input);
-    if (localDt) {
-        // capture 7 是可选 .SSS 组，运行时可能 undefined；TS lib 的 RegExp match 索引
-        // 类型把它标成 string，所以这里显式 cast 让 ?? 在 lint 视角下也"必要"。
-        const msPart = localDt[7] ?? "0";
-        return localDateMs(input, localDt[1], localDt[2], localDt[3], localDt[4], localDt[5], localDt[6], msPart);
-    }
-    // 4. 带显式时区的 ISO 8601：YYYY-MM-DDTHH:mm:ss[.SSS](Z|±HH:MM|±HHMM)
-    const iso = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d{1,9})?(Z|[+-](\d{2}):?(\d{2}))$/.exec(input);
-    if (iso) {
-        validateDateTimeParts(input, iso[1], iso[2], iso[3], iso[4], iso[5], iso[6]);
-        if (iso[7] !== "Z")
-            validateOffset(input, iso[8], iso[9]);
-        const ms = Date.parse(input);
-        if (Number.isNaN(ms))
-            failInvalidTimestamp(input);
-        return ms;
-    }
-    failInvalidTimestamp(input);
-}
-function localDateMs(input, y, mo, d, h, mi, s, msPart) {
-    validateDateTimeParts(input, y, mo, d, h, mi, s);
-    // 毫秒位补齐到 3 位再截断（"5" → 500，"12" → 120，"123" → 123）
-    const ms = Number(msPart.padEnd(3, "0").slice(0, 3));
-    const date = new Date(Number(y), Number(mo) - 1, Number(d), Number(h), Number(mi), Number(s), ms);
-    if (date.getFullYear() !== Number(y) ||
-        date.getMonth() !== Number(mo) - 1 ||
-        date.getDate() !== Number(d) ||
-        date.getHours() !== Number(h) ||
-        date.getMinutes() !== Number(mi) ||
-        date.getSeconds() !== Number(s) ||
-        date.getMilliseconds() !== ms) {
-        failInvalidTimestamp(input);
-    }
-    return date.getTime();
-}
-function validateDateTimeParts(input, y, mo, d, h, mi, s) {
-    const year = Number(y);
-    const month = Number(mo);
-    const day = Number(d);
-    const hour = Number(h);
-    const minute = Number(mi);
-    const second = Number(s);
-    if (month < 1 || month > 12 || hour > 23 || minute > 59 || second > 59) {
-        failInvalidTimestamp(input);
-    }
-    const utc = new Date(Date.UTC(year, month - 1, day));
-    if (utc.getUTCFullYear() !== year ||
-        utc.getUTCMonth() !== month - 1 ||
-        utc.getUTCDate() !== day) {
-        failInvalidTimestamp(input);
-    }
-}
-function validateOffset(input, h, mi) {
-    if (h === undefined || mi === undefined)
-        failInvalidTimestamp(input);
-    const hour = Number(h);
-    const minute = Number(mi);
-    if (hour > 23 || minute > 59)
-        failInvalidTimestamp(input);
-}
-function failInvalidTimestamp(input) {
-    throw new error_1.AppError("ARGS_INVALID", `无法解析时间 '${input}'。${exports.TIMESTAMP_HELP}`);
-}
-/** 毫秒 → 纳秒（字符串，避免 JS Number 精度丢失） */
-function msToNs(ms) {
-    return `${String(ms)}000000`;
-}
-/** 毫秒 → 秒（字符串，向下取整） */
-function msToSec(ms) {
-    return String(Math.floor(ms / 1000));
-}
-/** 解析到毫秒数；input 为空返回 undefined */
-function parseToMs(input, now) {
-    if (!input)
-        return undefined;
-    return parseTimeToMs(input, now);
-}
-/** 解析到纳秒字符串；input 为空返回 undefined */
-function parseToNs(input, now) {
-    if (!input)
-        return undefined;
-    return msToNs(parseTimeToMs(input, now));
-}
-/** 解析到秒字符串；input 为空返回 undefined */
-function parseToSec(input, now) {
-    if (!input)
-        return undefined;
-    return msToSec(parseTimeToMs(input, now));
-}
-// ── 桶边界对齐 ──
-//
-// metric 的 down-sample 与 analytics 的 timeAggregationUnit 都按 UTC 桶切片。
-// 当用户传的 since/until 落在桶中间，服务端可能返回不到该桶（边界数据丢失）。
-// 约定：since 向下取整、until 向上取整，把 since/until 各自所在桶完整纳入。
-//
-// 周界以 ISO 周（周一为周首，UTC）；月按 UTC 月初对齐。
-const MS_MIN = 60_000;
-const MS_HOUR = 3_600_000;
-const MS_DAY = 86_400_000;
-/** 把 ms 向下对齐到桶起点（UTC）。未识别的 bucket 原样返回。 */
-function floorMsToBucket(ms, bucket) {
-    switch (bucket) {
-        case "1m":
-            return Math.floor(ms / MS_MIN) * MS_MIN;
-        case "1h":
-            return Math.floor(ms / MS_HOUR) * MS_HOUR;
-        case "1d":
-        case "DAY": {
-            const d = new Date(ms);
-            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
-        }
-        case "WEEK": {
-            const d = new Date(ms);
-            const offsetDays = (d.getUTCDay() + 6) % 7; // 距上一个周一的天数
-            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate() - offsetDays);
-        }
-        case "MONTH": {
-            const d = new Date(ms);
-            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1);
-        }
-        default:
-            return ms;
-    }
-}
-/** 把 ms 向上对齐到下一个桶起点（UTC）；恰在边界则不变。 */
-function ceilMsToBucket(ms, bucket) {
-    const floor = floorMsToBucket(ms, bucket);
-    if (floor === ms)
-        return ms;
-    switch (bucket) {
-        case "1m":
-            return floor + MS_MIN;
-        case "1h":
-            return floor + MS_HOUR;
-        case "1d":
-        case "DAY":
-            return floor + MS_DAY;
-        case "WEEK":
-            return floor + 7 * MS_DAY;
-        case "MONTH": {
-            const d = new Date(floor);
-            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 1);
-        }
-        default:
-            return ms;
-    }
-}