@stelfield/cli 0.0.0-stage → 0.12.1

package/src/input-limits.js

@@ -0,0 +1,84 @@
+// v0.20.0 M6: client-side pre-check of the publish input limits.
+//
+// What this is for (plain words): the platform publishes its current limits at GET /api/v1/tasks/input-limits
+// (title length, description length, attachment count and total size). Before sending a request the CLI checks
+// the same numbers so the agent hears "too long" immediately. The numbers are NEVER written into the CLI:
+// they are read from the platform on every call, so changing a limit on the server takes effect at once.
+// The wording and the field names are the same as the backend 422 `input_limit_exceeded`, because the
+// backend remains the final judge (it also guards the web page and old CLI versions).
+
+const MB = 1024 * 1024;
+
+function isNum(v) {
+  return typeof v === 'number' && Number.isFinite(v);
+}
+
+// Same counting as the backend: characters (code points) after trimming spaces at both ends.
+function charCount(text) {
+  return [...String(text).trim()].length;
+}
+
+// 2 decimals, no trailing ".0" (matches the backend text: 3 / 1.01).
+function fmtMb(value) {
+  return String(Number(value.toFixed(2)));
+}
+
+/**
+ * @param {object|null} limits  response of getInputLimits (null = unknown, skip)
+ * @param {{title?: string, description?: string}} input
+ * @returns {null | {error, message, field, limit, current}}
+ */
+export function checkTaskText(limits, input) {
+  if (!limits) return null;
+  const rules = [
+    ['title', limits.title_max_chars, '任务标题'],
+    ['description', limits.desc_max_chars, '任务描述'],
+  ];
+  for (const [field, limit, label] of rules) {
+    if (input[field] == null || !isNum(limit)) continue;
+    const size = charCount(input[field]);
+    if (size > limit) {
+      return {
+        error: 'input_limit_exceeded',
+        message: `${label}最多 ${limit} 个字（当前 ${size} 个字）`,
+        field, limit, current: size,
+      };
+    }
+  }
+  return null;
+}
+
+/**
+ * @param {object|null} limits  response of getInputLimits
+ * @param {{count: number, totalBytes: number, sizeBytes: number}} usage  what the task has now + the new file
+ */
+export function checkAttachment(limits, usage) {
+  if (!limits) return null;
+  const maxCount = limits.attach_max_count;
+  const maxMb = limits.attach_max_total_mb;
+  if (isNum(maxCount) && usage.count + 1 > maxCount) {
+    return {
+      error: 'input_limit_exceeded',
+      message: `单个任务最多 ${maxCount} 个附件（当前已有 ${usage.count} 个）`,
+      field: 'attach_count', limit: maxCount, current: usage.count + 1,
+    };
+  }
+  if (isNum(maxMb) && usage.totalBytes + usage.sizeBytes > maxMb * MB) {
+    const afterMb = Math.ceil(((usage.totalBytes + usage.sizeBytes) / MB) * 100) / 100;
+    return {
+      error: 'input_limit_exceeded',
+      message: `附件总大小最多 ${maxMb} MB（加上这个文件会到 ${fmtMb(afterMb)} MB）`,
+      field: 'attach_total_mb', limit: maxMb, current: afterMb,
+    };
+  }
+  return null;
+}
+
+/** Build an Error shaped like an API refusal (status 422, body = the backend error body). */
+export function limitError(refusal) {
+  const e = new Error(`请求失败（422）：${refusal.message}`);
+  e.status = 422;
+  e.body = refusal;
+  e.retryAfter = null;
+  return e;
+}