@camunda8/cli 3.1.0 → 3.2.0-alpha.10

package/dist/{search-helpers.d.ts → utils/command-local/search-helpers.d.ts}

@@ -4,7 +4,7 @@
  * (#291). Search command handlers in `src/commands/search.ts` re-import
  * these.
  */
-import type { Logger } from "./logger.ts";
+import type { Logger } from "../../core/index.ts";
 /** Default page size the Camunda REST API uses when no explicit limit is set */
 export declare const API_DEFAULT_PAGE_SIZE = 100;
 /**

package/dist/utils/command-local/search-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/command-local/search-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,OAC3B,CAAC;AAE3B,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAChB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC3B,SAAS,MAAM,EACf,yBAAsB,KACpB,MAmBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAClC,OAAO,OAAO,EACd,SAAS,MAAM,KACb,OAGF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAChC,OAAO,OAAO,EACd,SAAS,MAAM,KACb,OAGF,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,EACnB,YAAY,CAAC,EAAE,MAAM,EAAE,GACrB,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,GACjB,IAAI,CAWN"}

package/dist/utils/command-local/search-helpers.js.map

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

package/dist/utils/command-local/watch-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-constants.d.ts","sourceRoot":"","sources":["../../../src/utils/command-local/watch-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iFAAiF;AACjF,eAAO,MAAM,eAAe,OAAO,CAAC"}

package/dist/utils/command-local/watch-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-constants.js","sourceRoot":"","sources":["../../../src/utils/command-local/watch-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./command-local/deploy-version.ts";
+export * from "./command-local/mcp-proxy-helpers.ts";
+export * from "./command-local/open-helpers.ts";
+export * from "./command-local/search-helpers.ts";
+export * from "./command-local/watch-constants.ts";
+export * from "./shared/date-filter.ts";
+export * from "./shared/ignore.ts";
+export * from "./shared/resource-extensions.ts";
+export * from "./shared/validation.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAMA,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,16 @@
+// Public barrel for the `utils` layer.
+//
+// Other layers and the composition root MUST import utils symbols through this
+// barrel (`../utils/index.ts`), never from deep utils files. Intra-utils imports
+// use direct sibling paths. Enforced by
+// tests/unit/layering-import-boundary.test.ts (Rules A and B).
+export * from "./command-local/deploy-version.js";
+export * from "./command-local/mcp-proxy-helpers.js";
+export * from "./command-local/open-helpers.js";
+export * from "./command-local/search-helpers.js";
+export * from "./command-local/watch-constants.js";
+export * from "./shared/date-filter.js";
+export * from "./shared/ignore.js";
+export * from "./shared/resource-extensions.js";
+export * from "./shared/validation.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,wCAAwC;AACxC,+DAA+D;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC"}

package/dist/utils/shared/date-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-filter.d.ts","sourceRoot":"","sources":["../../../src/utils/shared/date-filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,MAAM,GACX;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgBvC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,MAAM,GACT;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAKlC"}

package/dist/utils/shared/date-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-filter.js","sourceRoot":"","sources":["../../../src/utils/shared/date-filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC3B,KAAa;IAEb,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,cAAc,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,IAAI,GAAG,OAAO;QACnB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,SAAS,CAAC;QAC7C,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,IAAI,OAAO,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAE9B,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC9B,IAAa,EACb,EAAW;IAEX,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE;QAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;IACzB,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,KAAa,EAAE,QAAyB;IAC3D,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,yBAAyB;QACzB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,OAAO,KAAK,CAAC;IACd,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,gBAAgB,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,OAAO,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,GAAG,KAAK,gBAAgB;QAC1B,CAAC,CAAC,GAAG,KAAK,gBAAgB,CAAC;AAC7B,CAAC"}

package/dist/{ignore.d.ts → utils/shared/ignore.d.ts}

@@ -9,8 +9,14 @@
  * The `.c8ignore` file is resolved from the deploy/watch target directory
  * (via `resolveIgnoreBaseDir`), falling back to `process.cwd()` when no
  * target is specified. See #258.
+ *
+ * Pattern matching is implemented using `node:path#matchesGlob` (Node ≥ 21)
+ * and supports the subset of gitignore-style rules documented below.
  */
-import { type Ignore } from "ignore";
+/** A compiled set of .c8ignore / default patterns. */
+export interface Ignore {
+    ignores(path: string): boolean;
+}
 /**
  * Load ignore rules from the `.c8ignore` file in `baseDir` (if present)
  * merged with built-in default patterns.
@@ -38,4 +44,16 @@ export declare function isIgnored(ig: Ignore, filePath: string, baseDir: string)
  * `resolve(".")` === `process.cwd()` — backward-compatible.
  */
 export declare function resolveIgnoreBaseDir(paths: string[]): string;
+/**
+ * Load "deploy-always" rules from a `.c8ignore` file.
+ *
+ * Reads only the negation patterns (`!pattern`) and builds a positive
+ * matcher from them — stripping the `!` prefix. The resulting `Ignore`
+ * matches files that should always be deployed (regardless of the
+ * extension allow-list) because the user negated them in `.c8ignore`.
+ *
+ * Returns `null` when no `.c8ignore` exists or it contains no negation
+ * patterns.
+ */
+export declare function loadDeployAlwaysRules(baseDir: string): Ignore | null;
 //# sourceMappingURL=ignore.d.ts.map

package/dist/utils/shared/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../../src/utils/shared/ignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,sDAAsD;AACtD,MAAM,WAAW,MAAM;IACtB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAkHD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcvD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACxB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACb,OAAO,CAWT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAwC5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBpE"}

package/dist/utils/shared/ignore.js

@@ -0,0 +1,234 @@
+/**
+ * .c8ignore support — filter files/directories using .gitignore-style patterns.
+ *
+ * Default ignore patterns (always active):
+ *   node_modules/
+ *   target/
+ *   .git/
+ *
+ * The `.c8ignore` file is resolved from the deploy/watch target directory
+ * (via `resolveIgnoreBaseDir`), falling back to `process.cwd()` when no
+ * target is specified. See #258.
+ *
+ * Pattern matching is implemented using `node:path#matchesGlob` (Node ≥ 21)
+ * and supports the subset of gitignore-style rules documented below.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, matchesGlob, relative, resolve, sep } from "node:path";
+const DEFAULT_PATTERNS = ["node_modules/", "target/", ".git/"];
+const C8IGNORE_FILENAME = ".c8ignore";
+/**
+ * Translate a single gitignore-style line into one or more glob patterns
+ * suitable for `path.matchesGlob`.
+ *
+ * Rules applied (subset of gitignore spec). These mirror the behaviour of the
+ * `ignore` npm package — see the `c8ignore-parity` regression guard:
+ * - Lines starting with `#` and blank lines are skipped.
+ * - A leading `!` negates the pattern.
+ * - A trailing `/` restricts matching to directories: the pattern matches the
+ *   directory entry (a path queried *with* a trailing slash, e.g. `build/`)
+ *   and its contents, but NOT a bare path of the same name (`build`), which
+ *   gitignore would treat as a file. The directory walker queries directory
+ *   entries with a trailing slash, so traversal pruning still works.
+ * - A trailing `/**` (e.g. `foo/**`) matches everything *inside* the directory
+ *   but not the directory entry itself.
+ * - A leading `/` or an embedded `/` anchors the pattern to the base dir.
+ * - Otherwise the pattern matches at any depth.
+ */
+function parsePattern(raw) {
+    // Trim trailing whitespace. The full gitignore spec allows a trailing `\ `
+    // to preserve spaces, but that edge case is not needed here — we
+    // deliberately omit it for simplicity.
+    const trimmed = raw.trimEnd();
+    if (!trimmed || trimmed.startsWith("#"))
+        return null;
+    const negate = trimmed.startsWith("!");
+    const withoutNegate = negate ? trimmed.slice(1) : trimmed;
+    // A trailing slash restricts the pattern to directories.
+    const dirOnly = withoutNegate.endsWith("/");
+    const withoutTrailing = withoutNegate.replace(/\/$/, "");
+    // A leading / anchors the pattern to the base directory — the slash is a
+    // positional marker, not part of the glob itself.
+    const pattern = withoutTrailing.replace(/^\//, "");
+    if (!pattern)
+        return null;
+    // Anchored: a leading slash, or any embedded slash, pins the pattern to the
+    // base directory. Otherwise it matches at any depth.
+    const anchored = withoutNegate.startsWith("/") || pattern.includes("/");
+    let globs;
+    if (dirOnly) {
+        // Directory-only (`dir/`): match the directory entry (queried with a
+        // trailing slash) and everything under it, but NOT a bare path of the
+        // same name. `dir/**` matches `dir/` and `dir/child`, never bare `dir`.
+        globs = anchored
+            ? [`${pattern}/**`]
+            : [`${pattern}/**`, `**/${pattern}/**`];
+    }
+    else if (pattern.endsWith("/**")) {
+        // Contents-only (`dir/**`): match everything inside the directory but
+        // not the directory entry itself.
+        const core = pattern.slice(0, -3);
+        globs = [`${core}/*`, `${core}/*/**`];
+    }
+    else if (anchored) {
+        // Anchored entry: match the entry itself (file or directory) and its
+        // contents. e.g. `/src`, `src/build`.
+        globs = [pattern, `${pattern}/**`];
+    }
+    else {
+        // Unanchored entry: match as a file or directory at any depth.
+        // e.g. `*.log` or `target` → the entry and its contents at any depth.
+        globs = [pattern, `**/${pattern}`, `${pattern}/**`, `**/${pattern}/**`];
+    }
+    return { negate, globs };
+}
+function buildIgnoreChecker(patterns) {
+    const matches = (path, { globs }) => globs.some((g) => matchesGlob(path, g));
+    // gitignore rule: you cannot re-include a file if a parent directory of
+    // that file is excluded. Returns true when any ancestor of `rel` is
+    // ignored by the first `upTo` patterns (last-match-wins for ancestors).
+    // Ancestors are directories, so they are queried with a trailing slash —
+    // otherwise directory-only patterns (`dir/`) would not match them.
+    const ancestorIgnored = (rel, upTo) => rel
+        .split("/")
+        .slice(1)
+        .some((_, depth) => {
+        const ancestor = `${rel
+            .split("/")
+            .slice(0, depth + 1)
+            .join("/")}/`;
+        return patterns
+            .slice(0, upTo)
+            .reduce((ignored, p) => (matches(ancestor, p) ? !p.negate : ignored), false);
+    });
+    return (rel) => patterns.reduce((ignored, p, i) => {
+        if (!matches(rel, p))
+            return ignored;
+        if (p.negate) {
+            // A negation can only un-ignore a path if no parent directory is
+            // currently excluded (gitignore rule: excluded dirs cannot be
+            // re-included via negation on their descendants).
+            return ancestorIgnored(rel, i) ? ignored : false;
+        }
+        return true;
+    }, false);
+}
+/**
+ * Load ignore rules from the `.c8ignore` file in `baseDir` (if present)
+ * merged with built-in default patterns.
+ */
+export function loadIgnoreRules(baseDir) {
+    const lines = [...DEFAULT_PATTERNS];
+    const ignoreFilePath = join(baseDir, C8IGNORE_FILENAME);
+    if (existsSync(ignoreFilePath)) {
+        const content = readFileSync(ignoreFilePath, "utf-8");
+        lines.push(...content.split("\n"));
+    }
+    const patterns = lines
+        .map(parsePattern)
+        .filter((p) => p !== null);
+    return { ignores: buildIgnoreChecker(patterns) };
+}
+/**
+ * Check whether a path should be ignored.
+ *
+ * `filePath` must be an absolute path.
+ * `baseDir` is the root directory the ignore rules are relative to.
+ *
+ * Returns `true` when the path matches an ignore rule.
+ */
+export function isIgnored(ig, filePath, baseDir) {
+    let rel = relative(baseDir, filePath);
+    // `ignore` expects forward-slash separators
+    if (sep !== "/") {
+        rel = rel.split(sep).join("/");
+    }
+    // Paths outside baseDir can't be ignored
+    if (rel === "" || rel === ".." || rel.startsWith("../")) {
+        return false;
+    }
+    return ig.ignores(rel);
+}
+/**
+ * Determine the base directory for `.c8ignore` lookup from the paths the
+ * user passed to `deploy` or `watch`.
+ *
+ * - Single directory path → use that directory.
+ * - Single file path → use its parent directory.
+ * - Multiple paths → deepest common ancestor directory.
+ * - No paths → fall back to `process.cwd()`.
+ *
+ * When no target is specified the CLI defaults to `["."]`, so
+ * `resolve(".")` === `process.cwd()` — backward-compatible.
+ */
+export function resolveIgnoreBaseDir(paths) {
+    if (paths.length === 0)
+        return resolve(process.cwd());
+    const toDir = (p) => {
+        const abs = resolve(p);
+        try {
+            return statSync(abs).isDirectory() ? abs : dirname(abs);
+        }
+        catch {
+            // Path may not exist yet; use parent directory
+            return dirname(abs);
+        }
+    };
+    const dirs = paths.map(toDir);
+    if (dirs.length === 1)
+        return dirs[0];
+    // Multiple paths: find deepest common ancestor.
+    // On Windows, drive letters are case-insensitive (c:\ === C:\),
+    // so we compare segments case-insensitively on win32.
+    const caseFold = process.platform === "win32"
+        ? (s) => s.toLowerCase()
+        : (s) => s;
+    const segments = dirs.map((d) => d.split(sep));
+    const common = [];
+    const maxCommonLength = Math.min(...segments.map((s) => s.length));
+    for (let i = 0; i < maxCommonLength; i++) {
+        const seg = segments[0][i];
+        if (!segments.every((s) => caseFold(s[i]) === caseFold(seg))) {
+            break;
+        }
+        common.push(seg);
+    }
+    if (common.length === 0)
+        return resolve(process.cwd());
+    // Normalize filesystem root: on POSIX [''] → '/', on Windows ['C:'] → 'C:\'
+    const joined = common.join(sep);
+    return joined === "" || joined.endsWith(":") ? resolve(joined + sep) : joined;
+}
+/**
+ * Load "deploy-always" rules from a `.c8ignore` file.
+ *
+ * Reads only the negation patterns (`!pattern`) and builds a positive
+ * matcher from them — stripping the `!` prefix. The resulting `Ignore`
+ * matches files that should always be deployed (regardless of the
+ * extension allow-list) because the user negated them in `.c8ignore`.
+ *
+ * Returns `null` when no `.c8ignore` exists or it contains no negation
+ * patterns.
+ */
+export function loadDeployAlwaysRules(baseDir) {
+    const ignoreFilePath = join(baseDir, C8IGNORE_FILENAME);
+    if (!existsSync(ignoreFilePath))
+        return null;
+    const content = readFileSync(ignoreFilePath, "utf-8");
+    const positivePatterns = [];
+    for (const raw of content.split("\n")) {
+        const trimmed = raw.trimEnd();
+        // Parse the full line so `parsePattern` handles comment detection,
+        // negation stripping, and anchoring correctly. A manual `!` strip
+        // before parsing would mis-classify patterns like `!#file` (the `#`
+        // would be treated as a comment after the `!` is removed).
+        const parsed = parsePattern(trimmed);
+        if (parsed?.negate) {
+            positivePatterns.push({ ...parsed, negate: false });
+        }
+    }
+    if (positivePatterns.length === 0)
+        return null;
+    return { ignores: buildIgnoreChecker(positivePatterns) };
+}
+//# sourceMappingURL=ignore.js.map

package/dist/utils/shared/ignore.js.map

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

package/dist/utils/shared/resource-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-extensions.d.ts","sourceRoot":"","sources":["../../../src/utils/shared/resource-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,qBAAqB,UAA6B,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,UAYrC,CAAC"}

package/dist/utils/shared/resource-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-extensions.js","sourceRoot":"","sources":["../../../src/utils/shared/resource-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACxC,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,MAAM;IACN,OAAO;CACP,CAAC"}

package/dist/utils/shared/validation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generic CLI input validators with no dependency on the command registry.
+ *
+ * These narrow raw CLI strings to validated values and exit with code 1 on
+ * invalid input. They live in `utils/` (leaf layer, core-only deps) so that
+ * non-command modules — e.g. `utils/command-local/open-helpers.ts` — can reuse
+ * them without importing the `framework/` layer.
+ */
+/**
+ * Validate that a positional argument is present and non-empty.
+ * Unlike requireOption (for --flags), this uses a descriptive label
+ * in the error message.
+ * Exits with code 1 if missing.
+ */
+export declare function requirePositional(value: string | undefined, label: string, hint?: string): string;
+/**
+ * Validate that a string value is one of an allowed set.
+ * Works with readonly tuples (e.g. `OPEN_APPS as const`).
+ * Uses .find() so TypeScript narrows to T with no cast.
+ * Exits with code 1 if invalid, listing valid values.
+ */
+export declare function requireOneOf<T extends string>(value: string, allowed: readonly T[], label: string, hint?: string): T;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/shared/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/shared/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC5C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACX,CAAC,CAWH"}

package/dist/utils/shared/validation.js

@@ -0,0 +1,43 @@
+/**
+ * Generic CLI input validators with no dependency on the command registry.
+ *
+ * These narrow raw CLI strings to validated values and exit with code 1 on
+ * invalid input. They live in `utils/` (leaf layer, core-only deps) so that
+ * non-command modules — e.g. `utils/command-local/open-helpers.ts` — can reuse
+ * them without importing the `framework/` layer.
+ */
+import { getLogger } from "../../core/index.js";
+/**
+ * Validate that a positional argument is present and non-empty.
+ * Unlike requireOption (for --flags), this uses a descriptive label
+ * in the error message.
+ * Exits with code 1 if missing.
+ */
+export function requirePositional(value, label, hint) {
+    if (!value) {
+        const logger = getLogger();
+        logger.error(`${label} is required`);
+        if (hint)
+            logger.info(hint);
+        process.exit(1);
+    }
+    return value;
+}
+/**
+ * Validate that a string value is one of an allowed set.
+ * Works with readonly tuples (e.g. `OPEN_APPS as const`).
+ * Uses .find() so TypeScript narrows to T with no cast.
+ * Exits with code 1 if invalid, listing valid values.
+ */
+export function requireOneOf(value, allowed, label, hint) {
+    const match = allowed.find((v) => v === value);
+    if (match === undefined) {
+        const logger = getLogger();
+        logger.error(`Unknown ${label} '${value}'. Available: ${allowed.join(", ")}`);
+        if (hint)
+            logger.info(hint);
+        process.exit(1);
+    }
+    return match;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/shared/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/utils/shared/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAChC,KAAyB,EACzB,KAAa,EACb,IAAa;IAEb,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;QACrC,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC3B,KAAa,EACb,OAAqB,EACrB,KAAa,EACb,IAAa;IAEb,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;IAC/C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CACX,WAAW,KAAK,KAAK,KAAK,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/D,CAAC;QACF,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}