@outfitter/cli 0.5.3 → 1.0.0

package/dist/input.js

@@ -1,366 +1,21 @@
 // @bun
+import {
+  expandFileArg,
+  parseFilter,
+  parseGlob,
+  parseKeyValue,
+  parseRange,
+  parseSortSpec
+} from "./shared/@outfitter/cli-1q5redaj.js";
+import {
+  collectIds
+} from "./shared/@outfitter/cli-gqtkhgw4.js";
+import"./shared/@outfitter/cli-sy99pjyj.js";
+import"./shared/@outfitter/cli-6shkwxdc.js";
+
 // packages/cli/src/input.ts
-import path from "path";
 import { ValidationError } from "@outfitter/contracts";
 import { Err, Ok } from "better-result";
-function isSecurePath(filePath, allowAbsolute = false) {
-  if (filePath.includes("\x00")) {
-    return false;
-  }
-  if (filePath.includes("..")) {
-    return false;
-  }
-  const normalized = path.normalize(filePath);
-  if (!allowAbsolute && path.isAbsolute(normalized)) {
-    return false;
-  }
-  return true;
-}
-function isSecureGlobPattern(pattern) {
-  if (pattern.startsWith("..")) {
-    return false;
-  }
-  if (pattern.includes("/../")) {
-    return false;
-  }
-  return true;
-}
-function isWithinWorkspace(resolvedPath, workspaceRoot) {
-  const normalizedPath = path.normalize(resolvedPath);
-  const normalizedRoot = path.normalize(workspaceRoot);
-  return normalizedPath === normalizedRoot || normalizedPath.startsWith(normalizedRoot + path.sep);
-}
-async function readStdin() {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    if (typeof chunk === "string") {
-      chunks.push(chunk);
-    } else if (Buffer.isBuffer(chunk)) {
-      chunks.push(chunk.toString("utf-8"));
-    } else if (chunk instanceof Uint8Array) {
-      chunks.push(Buffer.from(chunk).toString("utf-8"));
-    }
-  }
-  return chunks.join("");
-}
-function splitIds(input) {
-  return input.split(",").flatMap((part) => part.trim().split(/\s+/)).map((id) => id.trim()).filter(Boolean);
-}
-async function isDirectory(path2) {
-  try {
-    const result = await Bun.$`test -d ${path2}`.quiet();
-    return result.exitCode === 0;
-  } catch {
-    return false;
-  }
-}
-async function isFile(path2) {
-  try {
-    const result = await Bun.$`test -f ${path2}`.quiet();
-    return result.exitCode === 0;
-  } catch {
-    return false;
-  }
-}
-async function collectIds(input, options) {
-  const { allowFile = true, allowStdin = true } = options ?? {};
-  const ids = [];
-  const inputs = Array.isArray(input) ? input : [input];
-  for (const item of inputs) {
-    if (!item)
-      continue;
-    if (item.startsWith("@")) {
-      const filePath = item.slice(1);
-      if (filePath === "-") {
-        if (!allowStdin) {
-          throw new Error("Reading from stdin is not allowed");
-        }
-        const stdinContent = await readStdin();
-        const stdinIds = stdinContent.split(`
-`).map((line) => line.trim()).filter(Boolean);
-        ids.push(...stdinIds);
-      } else {
-        if (!allowFile) {
-          throw new Error("File references are not allowed");
-        }
-        if (!isSecurePath(filePath, true)) {
-          throw new Error(`Security error: path traversal not allowed: ${filePath}`);
-        }
-        const file = Bun.file(filePath);
-        const exists = await file.exists();
-        if (!exists) {
-          throw new Error(`File not found: ${filePath}`);
-        }
-        const content = await file.text();
-        const fileIds = content.split(`
-`).map((line) => line.trim()).filter(Boolean);
-        ids.push(...fileIds);
-      }
-    } else {
-      ids.push(...splitIds(item));
-    }
-  }
-  return [...new Set(ids)];
-}
-async function expandFileArg(input, options) {
-  const {
-    encoding: _encoding = "utf-8",
-    maxSize,
-    trim = false
-  } = options ?? {};
-  if (!input.startsWith("@")) {
-    return input;
-  }
-  const filePath = input.slice(1);
-  if (filePath === "-") {
-    let content2 = await readStdin();
-    if (trim) {
-      content2 = content2.trim();
-    }
-    return content2;
-  }
-  if (!isSecurePath(filePath, true)) {
-    throw new Error(`Security error: path traversal not allowed: ${filePath}`);
-  }
-  const file = Bun.file(filePath);
-  const exists = await file.exists();
-  if (!exists) {
-    throw new Error(`File not found: ${filePath}`);
-  }
-  if (maxSize !== undefined) {
-    const size = file.size;
-    if (size > maxSize) {
-      throw new Error(`File exceeds maximum size of ${maxSize} bytes`);
-    }
-  }
-  let content = await file.text();
-  if (trim) {
-    content = content.trim();
-  }
-  return content;
-}
-async function parseGlob(pattern, options) {
-  const {
-    cwd = process.cwd(),
-    ignore = [],
-    onlyFiles = false,
-    onlyDirectories = false,
-    followSymlinks = false
-  } = options ?? {};
-  if (!isSecureGlobPattern(pattern)) {
-    throw new Error(`Security error: glob pattern may escape workspace: ${pattern}`);
-  }
-  const resolvedCwd = path.resolve(cwd);
-  const glob = new Bun.Glob(pattern);
-  const matches = [];
-  const scanOptions = {
-    cwd,
-    followSymlinks,
-    onlyFiles: onlyFiles === true
-  };
-  for await (const match of glob.scan(scanOptions)) {
-    const fullPath = path.resolve(cwd, match);
-    if (!isWithinWorkspace(fullPath, resolvedCwd)) {
-      continue;
-    }
-    let shouldIgnore = false;
-    for (const ignorePattern of ignore) {
-      const ignoreGlob = new Bun.Glob(ignorePattern);
-      if (ignoreGlob.match(match)) {
-        shouldIgnore = true;
-        break;
-      }
-    }
-    if (shouldIgnore)
-      continue;
-    if (onlyDirectories) {
-      const isDir = await isDirectory(fullPath);
-      if (!isDir)
-        continue;
-    }
-    if (onlyFiles) {
-      const isF = await isFile(fullPath);
-      if (!isF)
-        continue;
-    }
-    matches.push(match);
-  }
-  return matches;
-}
-function parseKeyValue(input) {
-  const pairs = [];
-  const inputs = Array.isArray(input) ? input : [input];
-  for (const item of inputs) {
-    if (!item)
-      continue;
-    const parts = item.split(",");
-    for (const part of parts) {
-      const trimmed = part.trim();
-      if (!trimmed)
-        continue;
-      const eqIndex = trimmed.indexOf("=");
-      if (eqIndex === -1) {
-        return new Err(new ValidationError({
-          message: `Missing '=' in key-value pair: ${trimmed}`
-        }));
-      }
-      const key = trimmed.slice(0, eqIndex).trim();
-      const value = trimmed.slice(eqIndex + 1);
-      if (!key) {
-        return new Err(new ValidationError({ message: "Empty key in key-value pair" }));
-      }
-      pairs.push({ key, value });
-    }
-  }
-  return new Ok(pairs);
-}
-function parseRange(input, type) {
-  const trimmed = input.trim();
-  if (type === "date") {
-    const parts = trimmed.split("..");
-    if (parts.length === 1) {
-      const dateStr = parts[0];
-      if (dateStr === undefined) {
-        return new Err(new ValidationError({ message: "Empty date input" }));
-      }
-      const date = new Date(dateStr.trim());
-      if (Number.isNaN(date.getTime())) {
-        return new Err(new ValidationError({ message: `Invalid date format: ${dateStr}` }));
-      }
-      return new Ok({ type: "date", start: date, end: date });
-    }
-    if (parts.length === 2) {
-      const startStr = parts[0];
-      const endStr = parts[1];
-      if (startStr === undefined || endStr === undefined) {
-        return new Err(new ValidationError({ message: "Invalid date range format" }));
-      }
-      const start = new Date(startStr.trim());
-      const end = new Date(endStr.trim());
-      if (Number.isNaN(start.getTime())) {
-        return new Err(new ValidationError({ message: `Invalid date format: ${startStr}` }));
-      }
-      if (Number.isNaN(end.getTime())) {
-        return new Err(new ValidationError({ message: `Invalid date format: ${endStr}` }));
-      }
-      if (start.getTime() > end.getTime()) {
-        return new Err(new ValidationError({
-          message: "Start date must be before or equal to end date"
-        }));
-      }
-      return new Ok({ type: "date", start, end });
-    }
-    return new Err(new ValidationError({ message: `Invalid date range format: ${input}` }));
-  }
-  const singleNum = Number(trimmed);
-  if (!(Number.isNaN(singleNum) || trimmed.includes("-", trimmed.startsWith("-") ? 1 : 0))) {
-    return new Ok({ type: "number", min: singleNum, max: singleNum });
-  }
-  let separatorIndex = -1;
-  for (let i = 1;i < trimmed.length; i++) {
-    const char = trimmed[i];
-    const prevChar = trimmed[i - 1];
-    if (char === "-" && prevChar !== undefined && /[\d\s]/.test(prevChar)) {
-      separatorIndex = i;
-      break;
-    }
-  }
-  if (separatorIndex === -1) {
-    return new Err(new ValidationError({ message: `Invalid numeric range format: ${input}` }));
-  }
-  const minStr = trimmed.slice(0, separatorIndex).trim();
-  const maxStr = trimmed.slice(separatorIndex + 1).trim();
-  const min = Number(minStr);
-  const max = Number(maxStr);
-  if (Number.isNaN(min)) {
-    return new Err(new ValidationError({ message: `Invalid number: ${minStr}` }));
-  }
-  if (Number.isNaN(max)) {
-    return new Err(new ValidationError({ message: `Invalid number: ${maxStr}` }));
-  }
-  if (min > max) {
-    return new Err(new ValidationError({ message: "Min must be less than or equal to max" }));
-  }
-  return new Ok({ type: "number", min, max });
-}
-function parseFilter(input) {
-  const trimmed = input.trim();
-  if (!trimmed) {
-    return new Ok([]);
-  }
-  const filters = [];
-  const parts = trimmed.split(",");
-  for (const part of parts) {
-    let partTrimmed = part.trim();
-    if (!partTrimmed)
-      continue;
-    let isNegated = false;
-    if (partTrimmed.startsWith("!")) {
-      isNegated = true;
-      partTrimmed = partTrimmed.slice(1).trim();
-    }
-    const colonIndex = partTrimmed.indexOf(":");
-    if (colonIndex === -1) {
-      return new Err(new ValidationError({
-        message: `Missing ':' in filter expression: ${part.trim()}`
-      }));
-    }
-    const field = partTrimmed.slice(0, colonIndex).trim();
-    let value = partTrimmed.slice(colonIndex + 1).trim();
-    let operator;
-    if (isNegated) {
-      operator = "ne";
-    } else if (value.startsWith(">=")) {
-      operator = "gte";
-      value = value.slice(2).trim();
-    } else if (value.startsWith("<=")) {
-      operator = "lte";
-      value = value.slice(2).trim();
-    } else if (value.startsWith(">")) {
-      operator = "gt";
-      value = value.slice(1).trim();
-    } else if (value.startsWith("<")) {
-      operator = "lt";
-      value = value.slice(1).trim();
-    } else if (value.startsWith("~")) {
-      operator = "contains";
-      value = value.slice(1).trim();
-    }
-    const filter = { field, value };
-    if (operator) {
-      filter.operator = operator;
-    }
-    filters.push(filter);
-  }
-  return new Ok(filters);
-}
-function parseSortSpec(input) {
-  const trimmed = input.trim();
-  if (!trimmed) {
-    return new Ok([]);
-  }
-  const criteria = [];
-  const parts = trimmed.split(",");
-  for (const part of parts) {
-    const partTrimmed = part.trim();
-    if (!partTrimmed)
-      continue;
-    const colonIndex = partTrimmed.indexOf(":");
-    if (colonIndex === -1) {
-      criteria.push({ field: partTrimmed, direction: "asc" });
-    } else {
-      const field = partTrimmed.slice(0, colonIndex).trim();
-      const direction = partTrimmed.slice(colonIndex + 1).trim().toLowerCase();
-      if (direction !== "asc" && direction !== "desc") {
-        return new Err(new ValidationError({
-          message: `Invalid sort direction: ${direction}. Must be 'asc' or 'desc'.`
-        }));
-      }
-      criteria.push({ field, direction });
-    }
-  }
-  return new Ok(criteria);
-}
 function normalizeId(input, options) {
   const {
     trim = false,

package/dist/internal/envelope-helpers.d.ts

@@ -0,0 +1,4 @@
+import { buildDryRunHint, createErrorEnvelope, createSuccessEnvelope, extractCategory, extractMessage, extractRetryAfterSeconds, formatEnvelopeHuman, getExitCode, safeCallHintFn } from "../shared/@outfitter/cli-nkt399zf.js";
+import "../shared/@outfitter/cli-30mt7c5w.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { safeCallHintFn, getExitCode, formatEnvelopeHuman, extractRetryAfterSeconds, extractMessage, extractCategory, createSuccessEnvelope, createErrorEnvelope, buildDryRunHint };

package/dist/internal/envelope-helpers.js

@@ -0,0 +1,24 @@
+// @bun
+import {
+  buildDryRunHint,
+  createErrorEnvelope,
+  createSuccessEnvelope,
+  extractCategory,
+  extractMessage,
+  extractRetryAfterSeconds,
+  formatEnvelopeHuman,
+  getExitCode,
+  safeCallHintFn
+} from "../shared/@outfitter/cli-ry7btmy4.js";
+import"../shared/@outfitter/cli-dg0cz7rw.js";
+export {
+  safeCallHintFn,
+  getExitCode,
+  formatEnvelopeHuman,
+  extractRetryAfterSeconds,
+  extractMessage,
+  extractCategory,
+  createSuccessEnvelope,
+  createErrorEnvelope,
+  buildDryRunHint
+};

package/dist/internal/envelope-types.d.ts

@@ -0,0 +1,3 @@
+import { CommandEnvelope, ErrorEnvelope, RunHandlerOptions, SuccessEnvelope } from "../shared/@outfitter/cli-30mt7c5w.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { SuccessEnvelope, RunHandlerOptions, ErrorEnvelope, CommandEnvelope };

package/dist/internal/envelope-types.js

@@ -0,0 +1 @@
+// @bun

package/dist/internal/flag-builders.d.ts

@@ -0,0 +1,3 @@
+import { booleanFlagPreset, enumFlagPreset, numberFlagPreset, stringListFlagPreset } from "../shared/@outfitter/cli-dv8kk4jw.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { stringListFlagPreset, numberFlagPreset, enumFlagPreset, booleanFlagPreset };

package/dist/internal/flag-builders.js

@@ -0,0 +1,155 @@
+// @bun
+import {
+  createPreset
+} from "../shared/@outfitter/cli-8cfxdady.js";
+
+// packages/cli/src/internal/flag-builders.ts
+function resolveSourceKeys(key, sources) {
+  return sources && sources.length > 0 ? sources : [key];
+}
+function normalizeStringListInput(value, separator) {
+  if (Array.isArray(value)) {
+    const items2 = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
+    return items2.length > 0 ? items2 : undefined;
+  }
+  if (typeof value !== "string")
+    return;
+  const items = value.split(separator).map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : undefined;
+}
+function booleanFlagPreset(config) {
+  const sources = resolveSourceKeys(config.key, config.sources);
+  const defaultValue = config.defaultValue ?? false;
+  const isNegatedFlag = config.flags.includes("--no-");
+  const optionDefault = isNegatedFlag && config.defaultValue === undefined ? {} : { defaultValue };
+  return createPreset({
+    id: config.id,
+    options: [
+      {
+        flags: config.flags,
+        description: config.description,
+        ...optionDefault,
+        ...config.required === true ? { required: true } : {}
+      }
+    ],
+    resolve: (flags) => {
+      for (const source of sources) {
+        const value = flags[source];
+        if (typeof value === "boolean") {
+          return { [config.key]: value };
+        }
+      }
+      if (config.negatedSources) {
+        for (const source of config.negatedSources) {
+          const value = flags[source];
+          if (typeof value === "boolean") {
+            return { [config.key]: !value };
+          }
+        }
+      }
+      return { [config.key]: defaultValue };
+    }
+  });
+}
+function enumFlagPreset(config) {
+  const sources = resolveSourceKeys(config.key, config.sources);
+  const allowed = new Set(config.values);
+  return createPreset({
+    id: config.id,
+    options: [
+      {
+        flags: config.flags,
+        description: config.description,
+        ...config.required === true ? { required: true } : {}
+      }
+    ],
+    resolve: (flags) => {
+      for (const source of sources) {
+        const value = flags[source];
+        if (typeof value === "string" && allowed.has(value)) {
+          return { [config.key]: value };
+        }
+      }
+      return {
+        [config.key]: config.defaultValue
+      };
+    }
+  });
+}
+function numberFlagPreset(config) {
+  const sources = resolveSourceKeys(config.key, config.sources);
+  return createPreset({
+    id: config.id,
+    options: [
+      {
+        flags: config.flags,
+        description: config.description,
+        ...config.required === true ? { required: true } : {}
+      }
+    ],
+    resolve: (flags) => {
+      let parsed;
+      for (const source of sources) {
+        const value = flags[source];
+        if (value === "" || value == null || typeof value === "boolean") {
+          continue;
+        }
+        const numeric = Number(value);
+        if (Number.isFinite(numeric)) {
+          parsed = config.integer === false ? numeric : Math.floor(numeric);
+          break;
+        }
+      }
+      if (parsed === undefined) {
+        parsed = config.defaultValue;
+      }
+      if (typeof config.min === "number" && Number.isFinite(config.min)) {
+        parsed = Math.max(parsed, config.min);
+      }
+      if (typeof config.max === "number" && Number.isFinite(config.max)) {
+        parsed = Math.min(parsed, config.max);
+      }
+      return { [config.key]: parsed };
+    }
+  });
+}
+function stringListFlagPreset(config) {
+  const sources = resolveSourceKeys(config.key, config.sources);
+  const separator = config.separator ?? ",";
+  const fallback = config.defaultValue === undefined ? undefined : [...config.defaultValue];
+  return createPreset({
+    id: config.id,
+    options: [
+      {
+        flags: config.flags,
+        description: config.description,
+        ...config.required === true ? { required: true } : {}
+      }
+    ],
+    resolve: (flags) => {
+      let resolved;
+      for (const source of sources) {
+        const parsed = normalizeStringListInput(flags[source], separator);
+        if (parsed !== undefined) {
+          resolved = parsed;
+          break;
+        }
+      }
+      if (resolved === undefined) {
+        resolved = fallback === undefined ? undefined : [...fallback];
+      }
+      if (resolved && config.dedupe) {
+        resolved = [...new Set(resolved)];
+      }
+      return {
+        [config.key]: resolved
+      };
+    }
+  });
+}
+export {
+  stringListFlagPreset,
+  numberFlagPreset,
+  enumFlagPreset,
+  booleanFlagPreset
+};

package/dist/internal/flag-types.d.ts

@@ -0,0 +1,3 @@
+import { composePresets, createPreset, createSchemaPreset, isSchemaPreset } from "../shared/@outfitter/cli-n54zs151.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { isSchemaPreset, createSchemaPreset, createPreset, composePresets };

package/dist/internal/flag-types.js

@@ -0,0 +1,13 @@
+// @bun
+import {
+  composePresets,
+  createPreset,
+  createSchemaPreset,
+  isSchemaPreset
+} from "../shared/@outfitter/cli-8cfxdady.js";
+export {
+  isSchemaPreset,
+  createSchemaPreset,
+  createPreset,
+  composePresets
+};

package/dist/internal/hint-action-graph.d.ts

@@ -0,0 +1,5 @@
+import { buildActionGraph, graphErrorHints, graphSuccessHints } from "../shared/@outfitter/cli-pmd04gtv.js";
+import "../shared/@outfitter/cli-16wg5mka.js";
+import "../shared/@outfitter/cli-xde45xcc.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { graphSuccessHints, graphErrorHints, buildActionGraph };

package/dist/internal/hint-action-graph.js

@@ -0,0 +1,11 @@
+// @bun
+import {
+  buildActionGraph,
+  graphErrorHints,
+  graphSuccessHints
+} from "../shared/@outfitter/cli-hvg2m5gf.js";
+export {
+  graphSuccessHints,
+  graphErrorHints,
+  buildActionGraph
+};

package/dist/internal/hint-command-tree.d.ts

@@ -0,0 +1,5 @@
+import { buildCommandTree, commandTreeHints } from "../shared/@outfitter/cli-yfewnyc2.js";
+import "../shared/@outfitter/cli-16wg5mka.js";
+import "../shared/@outfitter/cli-xde45xcc.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { commandTreeHints, buildCommandTree };

package/dist/internal/hint-command-tree.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  buildCommandTree,
+  commandTreeHints
+} from "../shared/@outfitter/cli-htzez8v2.js";
+export {
+  commandTreeHints,
+  buildCommandTree
+};

package/dist/internal/hint-error-recovery.d.ts

@@ -0,0 +1,2 @@
+import { errorRecoveryHints } from "../shared/@outfitter/cli-tm2fzngs.js";
+export { errorRecoveryHints };

package/dist/internal/hint-error-recovery.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  errorRecoveryHints
+} from "../shared/@outfitter/cli-2dfxs239.js";
+export {
+  errorRecoveryHints
+};

package/dist/internal/hint-types.d.ts

@@ -0,0 +1,4 @@
+import { ActionGraph, ActionGraphEdge, CommandTree, CommandTreeNode, CommandTreeOption } from "../shared/@outfitter/cli-16wg5mka.js";
+import "../shared/@outfitter/cli-xde45xcc.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { CommandTreeOption, CommandTreeNode, CommandTree, ActionGraphEdge, ActionGraph };

package/dist/internal/hint-types.js

@@ -0,0 +1 @@
+// @bun

package/dist/internal/input-helpers.d.ts

@@ -0,0 +1,18 @@
+/**
+* Basic I/O and validation helpers for CLI input.
+*
+* @internal
+*/
+/**
+* Reads stdin content using async iteration.
+*/
+declare function readStdin(): Promise<string>;
+/**
+* Splits a string by comma and/or space, trimming each part.
+*/
+declare function splitIds(input: string): string[];
+/**
+* Checks if a path is a directory using Bun shell.
+*/
+declare function isDirectory(dirPath: string): Promise<boolean>;
+export { splitIds, readStdin, isDirectory };

package/dist/internal/input-helpers.js

@@ -0,0 +1,11 @@
+// @bun
+import {
+  isDirectory,
+  readStdin,
+  splitIds
+} from "../shared/@outfitter/cli-6shkwxdc.js";
+export {
+  splitIds,
+  readStdin,
+  isDirectory
+};

package/dist/internal/input-normalization.d.ts

@@ -0,0 +1,3 @@
+import { collectIds } from "../shared/@outfitter/cli-bcajqy33.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { collectIds };