@camunda8/cli 2.8.0-alpha.9 → 3.0.0

package/dist/default-plugins/element-template/marketplace.js

@@ -0,0 +1,396 @@
+/**
+ * Marketplace OOTB element-template index.
+ *
+ * Source: GET https://marketplace.cloud.camunda.io/api/v1/ootb-connectors
+ *   → { [id]: [{ version, ref, engine: { camunda: "^8.x" } }, ...] }
+ *
+ * Each `ref` is a commit-pinned raw.githubusercontent.com URL → immutable.
+ * We download every ref once, inline the templates into a single
+ * `templates.json` cache file, and inject `metadata.upstreamRef = <ref>` so
+ * subsequent syncs can skip already-cached entries (matches Modeler's
+ * approach in `app/lib/template-updater/util.js`).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import semver from "semver";
+import { isRecord, USER_AGENT } from "./helpers.js";
+const DEFAULT_OOTB_URL = "https://marketplace.cloud.camunda.io/api/v1/ootb-connectors";
+const FETCH_CONCURRENCY = 12;
+const STALE_AFTER_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+const FETCH_TIMEOUT_MS = 30_000; // 30 s per HTTP request
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+export function getMarketplaceUrl() {
+    return process.env.C8CTL_OOTB_ELEMENT_TEMPLATES_URL || DEFAULT_OOTB_URL;
+}
+export function getCacheDir() {
+    if (!globalThis.c8ctl?.getUserDataDir) {
+        throw new Error("c8ctl runtime is not available; cannot resolve element-template cache dir.");
+    }
+    return join(globalThis.c8ctl.getUserDataDir(), "element-templates");
+}
+function getCachePath() {
+    return join(getCacheDir(), "templates.json");
+}
+function getFetchedAtPath() {
+    return join(getCacheDir(), "fetched-at");
+}
+// ---------------------------------------------------------------------------
+// Cache I/O
+// ---------------------------------------------------------------------------
+function isTemplateArray(value) {
+    return (Array.isArray(value) &&
+        value.every((item) => isRecord(item) && Array.isArray(item.properties)));
+}
+export function loadCache() {
+    const path = getCachePath();
+    if (!existsSync(path))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Element template cache is corrupt at ${path}: ${message}`);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error(`Element template cache is corrupt at ${path}: expected an array`);
+    }
+    if (!isTemplateArray(parsed)) {
+        throw new Error(`Element template cache is corrupt at ${path}: entries must be template objects with a properties array`);
+    }
+    return parsed;
+}
+function loadFetchedAt() {
+    const path = getFetchedAtPath();
+    if (!existsSync(path))
+        return null;
+    const value = readFileSync(path, "utf-8").trim();
+    const ms = Number(value);
+    return Number.isFinite(ms) ? ms : null;
+}
+function saveCache(templates) {
+    const dir = getCacheDir();
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(getCachePath(), `${JSON.stringify(templates, null, 2)}\n`, "utf-8");
+    writeFileSync(getFetchedAtPath(), String(Date.now()), "utf-8");
+}
+export function isCacheStale() {
+    const fetchedAt = loadFetchedAt();
+    if (fetchedAt === null)
+        return true;
+    return Date.now() - fetchedAt > STALE_AFTER_MS;
+}
+export function getCacheAgeDays() {
+    const fetchedAt = loadFetchedAt();
+    if (fetchedAt === null)
+        return null;
+    return Math.floor((Date.now() - fetchedAt) / (24 * 60 * 60 * 1000));
+}
+export function nudgeIfStale(logger) {
+    if (!existsSync(getCachePath()))
+        return;
+    if (!isCacheStale())
+        return;
+    const days = getCacheAgeDays();
+    const ageText = days === null ? "stale" : `${days} day${days === 1 ? "" : "s"} old`;
+    logger.warn(`Element template cache is ${ageText}. ` +
+        "Run 'c8ctl element-template sync' to refresh.");
+}
+// ---------------------------------------------------------------------------
+// HTTP
+// ---------------------------------------------------------------------------
+async function fetchJson(url) {
+    const response = await fetch(url, {
+        headers: { "User-Agent": USER_AGENT },
+        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} ${response.statusText} for ${url}`);
+    }
+    return response.json();
+}
+async function fetchIndex() {
+    const raw = await fetchJson(getMarketplaceUrl());
+    if (!isRecord(raw)) {
+        throw new Error("Marketplace index is not a JSON object");
+    }
+    // Trust the upstream shape — schema-validated at the marketplace.
+    const result = {};
+    for (const [id, value] of Object.entries(raw)) {
+        if (!Array.isArray(value))
+            continue;
+        const entries = [];
+        for (const entry of value) {
+            if (!isRecord(entry))
+                continue;
+            entries.push({
+                version: typeof entry.version === "number" ? entry.version : undefined,
+                ref: typeof entry.ref === "string" ? entry.ref : undefined,
+                engine: isRecord(entry.engine)
+                    ? {
+                        camunda: typeof entry.engine.camunda === "string"
+                            ? entry.engine.camunda
+                            : undefined,
+                    }
+                    : undefined,
+            });
+        }
+        result[id] = entries;
+    }
+    return result;
+}
+function isTemplateLike(value) {
+    return isRecord(value) && Array.isArray(value.properties);
+}
+async function fetchTemplate(url) {
+    const raw = await fetchJson(url);
+    if (!isTemplateLike(raw)) {
+        throw new Error(`Fetched template at ${url} did not match expected shape`);
+    }
+    return raw;
+}
+// ---------------------------------------------------------------------------
+// Sync
+// ---------------------------------------------------------------------------
+/**
+ * Run `fn` over `items` with at most `concurrency` in flight.
+ * Each fn() must handle its own errors — exceptions abort the pool.
+ */
+async function pool(items, concurrency, fn) {
+    const queue = items.slice();
+    const workers = Array.from({ length: Math.min(concurrency, queue.length) }, async () => {
+        while (queue.length > 0) {
+            const item = queue.shift();
+            if (item === undefined)
+                break;
+            await fn(item);
+        }
+    });
+    await Promise.all(workers);
+}
+/**
+ * Flatten the marketplace index `{ id: [{version, ref, engine}] }` into a flat
+ * list of `{ id, version, ref, engine }` entries, dropping legacy entries with
+ * no `version`.
+ */
+function flattenIndex(index) {
+    const entries = [];
+    for (const [id, versions] of Object.entries(index)) {
+        for (const entry of versions) {
+            if (entry.version === undefined || entry.ref === undefined)
+                continue;
+            entries.push({
+                id,
+                version: entry.version,
+                ref: entry.ref,
+                engine: entry.engine,
+            });
+        }
+    }
+    return entries;
+}
+/**
+ * Sync the cache with the marketplace.
+ *
+ * - Always re-fetches the index.
+ * - Fetches refs that aren't already cached (matches by `metadata.upstreamRef`).
+ * - With `prune: true`, drops cached entries whose `upstreamRef` is no longer
+ *   in the fresh index.
+ *
+ * Per-template fetch failures are logged + counted but do not abort the run.
+ *
+ * Returns a summary `{ total, fetched, cached, errors, pruned }`.
+ */
+export async function syncTemplates({ logger, prune = false, }) {
+    logger.info(`Fetching index from ${getMarketplaceUrl()} ...`);
+    const index = await fetchIndex();
+    const entries = flattenIndex(index);
+    logger.info(`Index has ${entries.length} template versions across ${Object.keys(index).length} connectors.`);
+    let existing;
+    try {
+        existing = loadCache() || [];
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn(`Corrupt cache — starting fresh: ${message}`);
+        existing = [];
+    }
+    const byUpstreamRef = new Map();
+    for (const tpl of existing) {
+        const ref = tpl.metadata?.upstreamRef;
+        if (ref)
+            byUpstreamRef.set(ref, tpl);
+    }
+    const freshRefs = new Set(entries.map((e) => e.ref));
+    const toFetch = entries.filter((e) => !byUpstreamRef.has(e.ref));
+    logger.info(`${byUpstreamRef.size > 0
+        ? `Reusing ${entries.length - toFetch.length} cached, `
+        : ""}fetching ${toFetch.length} new...`);
+    let fetched = 0;
+    let errors = 0;
+    let progress = 0;
+    const fetchedTemplates = [];
+    await pool(toFetch, FETCH_CONCURRENCY, async (entry) => {
+        progress += 1;
+        const myProgress = progress;
+        const label = `${entry.id}@${entry.version}`;
+        try {
+            const template = await fetchTemplate(entry.ref);
+            template.metadata = template.metadata || {};
+            template.metadata.upstreamRef = entry.ref;
+            fetchedTemplates.push(template);
+            fetched += 1;
+            logger.info(`  [${myProgress}/${toFetch.length}] ${label}`);
+        }
+        catch (error) {
+            errors += 1;
+            const message = error instanceof Error ? error.message : String(error);
+            logger.warn(`  [${myProgress}/${toFetch.length}] ${label} — ${message}`);
+        }
+    });
+    // Build the new cache: keep cached entries that are still in the index,
+    // plus everything we just fetched. Sort fetched entries by id+version so
+    // cache order (and therefore search result order) is deterministic
+    // regardless of network timing.
+    fetchedTemplates.sort((a, b) => {
+        const idCmp = (a.id ?? "").localeCompare(b.id ?? "");
+        if (idCmp !== 0)
+            return idCmp;
+        return (a.version ?? 0) - (b.version ?? 0);
+    });
+    const next = [];
+    for (const tpl of existing) {
+        const ref = tpl.metadata?.upstreamRef;
+        if (ref && freshRefs.has(ref)) {
+            next.push(tpl);
+        }
+    }
+    next.push(...fetchedTemplates);
+    let pruned = 0;
+    if (prune) {
+        pruned =
+            existing.length -
+                next.filter((t) => {
+                    const ref = t.metadata?.upstreamRef;
+                    return ref !== undefined && byUpstreamRef.has(ref);
+                }).length;
+    }
+    // Without --prune, keep templates whose upstreamRef vanished from the index
+    // (e.g. user wants to retain an older version that was removed upstream).
+    if (!prune) {
+        for (const tpl of existing) {
+            const ref = tpl.metadata?.upstreamRef;
+            if (ref && !freshRefs.has(ref) && !next.includes(tpl)) {
+                next.push(tpl);
+            }
+        }
+    }
+    saveCache(next);
+    const summary = {
+        total: next.length,
+        fetched,
+        cached: entries.length - toFetch.length,
+        errors,
+        pruned,
+    };
+    logger.info(`Sync complete: ${summary.fetched} fetched, ${summary.cached} cached` +
+        `${summary.errors > 0 ? `, ${summary.errors} errors` : ""}` +
+        `${prune ? `, ${summary.pruned} pruned` : ""}.`);
+    return summary;
+}
+/**
+ * Run a sync if the cache doesn't exist yet. No-op if cache is present.
+ */
+export async function bootstrapIfNeeded({ logger, }) {
+    if (existsSync(getCachePath()))
+        return;
+    logger.info("Element template cache not found — running first-time sync...");
+    await syncTemplates({ logger });
+}
+// ---------------------------------------------------------------------------
+// Lookup & search
+// ---------------------------------------------------------------------------
+/**
+ * Return all cached templates matching `id`. Empty if none.
+ */
+export function findById(id) {
+    const cache = loadCache();
+    if (!cache)
+        return [];
+    return cache.filter((t) => t.id === id);
+}
+/**
+ * Pick the template version best matching the BPMN's executionPlatformVersion.
+ *
+ * - If `version` is given: exact `version` match required.
+ * - If `executionPlatformVersion` is given: highest `version` whose
+ *   `engines.camunda` is satisfied by `coerce(executionPlatformVersion)`.
+ *   Templates without `engines.camunda` are treated as compatible with any
+ *   version (legacy fallback).
+ * - Otherwise: highest `version`.
+ *
+ * Returns `null` if no candidate matches.
+ */
+export function pickVersion(templates, { version, executionPlatformVersion } = {}) {
+    if (templates.length === 0)
+        return null;
+    if (version !== undefined) {
+        const exact = templates.find((t) => Number(t.version) === Number(version));
+        return exact || null;
+    }
+    let candidates = templates.filter((t) => t.version !== undefined);
+    if (executionPlatformVersion) {
+        const coerced = semver.coerce(executionPlatformVersion);
+        if (coerced) {
+            candidates = candidates.filter((t) => {
+                const constraint = t.engines?.camunda;
+                if (!constraint)
+                    return true;
+                return semver.satisfies(coerced, constraint);
+            });
+        }
+    }
+    if (candidates.length === 0)
+        return null;
+    return candidates.reduce((best, cur) => Number(cur.version) > Number(best.version) ? cur : best);
+}
+/**
+ * Substring search on name + description + keywords (case-insensitive).
+ * Mirrors Modeler's discovery path. Deprecated versions are excluded
+ * before the per-id latest-version reduction so that if the newest
+ * version of a connector is deprecated, the latest non-deprecated
+ * version is still discoverable.
+ */
+export function searchTemplates(query) {
+    const cache = loadCache() || [];
+    const q = query.toLowerCase();
+    const matches = cache
+        .filter((t) => {
+        const name = (t.name || "").toLowerCase();
+        const description = (t.description || "").toLowerCase();
+        const id = (t.id || "").toLowerCase();
+        const keywords = (t.keywords ?? []).map((k) => k.toLowerCase()).join(" ");
+        return (name.includes(q) ||
+            description.includes(q) ||
+            id.includes(q) ||
+            keywords.includes(q));
+    })
+        // Filter deprecated before per-id reduction so the latest
+        // non-deprecated version surfaces when the newest is deprecated.
+        .filter((t) => !t.deprecated);
+    // Reduce to the latest version per id.
+    const byId = new Map();
+    for (const t of matches) {
+        if (t.id === undefined)
+            continue;
+        const existing = byId.get(t.id);
+        if (!existing || Number(t.version || 0) > Number(existing.version || 0)) {
+            byId.set(t.id, t);
+        }
+    }
+    return [...byId.values()];
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/default-plugins/element-template/marketplace.js.map

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

package/dist/default-plugins/element-template/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "c8ctl-plugin-element-template",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "c8ctl plugin to apply and inspect Camunda element templates",
+  "keywords": ["c8ctl", "c8ctl-plugin", "element-template", "camunda"],
+  "main": "c8ctl-plugin.ts"
+}

package/dist/default-plugins/element-template/template-ref.js

@@ -0,0 +1,232 @@
+/**
+ * Template/BPMN input resolution shared by element-template subcommands.
+ *
+ * Covers:
+ *   - Classifying a `<template>` argument as URL, local path, or OOTB id.
+ *   - Loading a template from any of those sources (cache lookup for ids,
+ *     fetch/parse for URLs and paths).
+ *   - Reading BPMN input from a file path or stdin.
+ *   - Extracting `modeler:executionPlatformVersion` from BPMN XML.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { getPropertyDetail, getSettableProperties, parseTemplateJson, readFileOrUrl, } from "./helpers.js";
+import { bootstrapIfNeeded, findById, nudgeIfStale, pickVersion, } from "./marketplace.js";
+if (!globalThis.c8ctl)
+    throw new Error("c8ctl runtime not initialised");
+const c8ctl = globalThis.c8ctl;
+/**
+ * Read BPMN XML from a file path or stdin. Returns null if no input is available.
+ *
+ * Stdin is consumed via async iteration so a slow upstream writer (e.g.
+ * `apply | lint` in a pipeline, or any producer that hasn't flushed yet)
+ * is awaited until 'end'. Do not use `readFileSync(0)` here — when stdin
+ * is a pipe with no buffered data yet, it throws EAGAIN, which gets
+ * swallowed and surfaces as "no input".
+ */
+export async function readBpmnInput(filePath) {
+    if (filePath) {
+        const resolved = resolvePath(filePath);
+        if (!existsSync(resolved)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        return { xml: readFileSync(resolved, "utf-8"), source: resolved };
+    }
+    if (!process.stdin.isTTY) {
+        process.stdin.setEncoding("utf-8");
+        let xml = "";
+        for await (const chunk of process.stdin) {
+            xml += chunk;
+        }
+        if (!xml.trim()) {
+            return null;
+        }
+        return { xml, source: "stdin" };
+    }
+    return null;
+}
+/**
+ * Classify a template argument as one of:
+ *   - { kind: 'url', value }
+ *   - { kind: 'path', value }
+ *   - { kind: 'id', id, version? }
+ *
+ * Detection rules (in order):
+ *   1. starts with http:// or https://  → URL
+ *   2. contains / or \, starts with `.`, or ends with .json → path
+ *   3. matches `<id>` or `<id>@<n>`  → id
+ */
+export function parseTemplateRef(arg) {
+    if (!arg) {
+        return null;
+    }
+    if (/^http:\/\//.test(arg)) {
+        throw new Error(`Insecure template URL rejected: ${arg}\n` +
+            "Template URLs must use HTTPS to protect credentials and content integrity.");
+    }
+    if (/^https:\/\//.test(arg)) {
+        return { kind: "url", value: arg };
+    }
+    if (arg.includes("/") ||
+        arg.includes("\\") ||
+        arg.startsWith(".") ||
+        arg.toLowerCase().endsWith(".json")) {
+        return { kind: "path", value: arg };
+    }
+    const match = arg.match(/^([^@\s]+?)(?:@(\d+))?$/);
+    if (!match) {
+        return { kind: "path", value: arg };
+    }
+    return {
+        kind: "id",
+        id: match[1],
+        version: match[2] !== undefined ? Number(match[2]) : undefined,
+    };
+}
+export async function getExecutionPlatformVersion(xml) {
+    const BpmnModdle = (await import("bpmn-moddle")).default;
+    const moddle = new BpmnModdle();
+    try {
+        const { rootElement } = await moddle.fromXML(xml);
+        const version = rootElement.$attrs?.["modeler:executionPlatformVersion"];
+        return typeof version === "string" ? version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Walk the moddle tree returned by bpmn-moddle and check whether any element
+ * carries the given `id`. Used by the dry-run path to surface "element not
+ * found" before reporting a successful preview.
+ */
+function containsId(node, id, seen) {
+    if (node === null || typeof node !== "object")
+        return false;
+    if (seen.has(node))
+        return false;
+    seen.add(node);
+    // biome-ignore lint/plugin: narrowing unknown to a plain object record for tree traversal
+    const record = node;
+    if (record.id === id)
+        return true;
+    for (const key of Object.keys(record)) {
+        if (key.startsWith("$"))
+            continue;
+        const value = record[key];
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (containsId(item, id, seen))
+                    return true;
+            }
+        }
+        else if (containsId(value, id, seen)) {
+            return true;
+        }
+    }
+    return false;
+}
+export async function elementExistsInBpmn(xml, elementId) {
+    const BpmnModdle = (await import("bpmn-moddle")).default;
+    const moddle = new BpmnModdle();
+    try {
+        const { rootElement } = await moddle.fromXML(xml);
+        return containsId(rootElement, elementId, new Set());
+    }
+    catch (error) {
+        // Surface BPMN parse failures so dry-run does not report a successful
+        // plan for invalid XML.
+        throw error;
+    }
+}
+export async function readTemplateFromPathOrUrl(input) {
+    const content = await readFileOrUrl(input);
+    return parseTemplateJson(content);
+}
+/**
+ * Resolve an `<id>[@<v>]` reference to a single template object using the
+ * local cache, bootstrapping if needed. `executionPlatformVersion` (from the
+ * BPMN file) drives version selection when no explicit version is pinned.
+ */
+export async function resolveOotbTemplate(ref, { executionPlatformVersion, } = {}) {
+    const logger = c8ctl.getLogger();
+    await bootstrapIfNeeded({ logger });
+    nudgeIfStale(logger);
+    const candidates = findById(ref.id);
+    if (candidates.length === 0) {
+        throw new Error(`Element template '${ref.id}' not found. Run 'c8ctl element-template sync' to refresh the cache, ` +
+            "or use 'c8ctl element-template search <query>' to find an id.");
+    }
+    const picked = pickVersion(candidates, {
+        version: ref.version,
+        executionPlatformVersion,
+    });
+    if (!picked) {
+        if (ref.version !== undefined) {
+            const known = candidates
+                .map((t) => t.version)
+                .filter((v) => Number.isFinite(Number(v)))
+                .sort((a, b) => Number(a) - Number(b));
+            const available = known.length > 0
+                ? `Available: ${known.join(", ")}.`
+                : "No known versions in cache.";
+            throw new Error(`Element template '${ref.id}' has no version ${ref.version}. ${available}`);
+        }
+        const available = candidates
+            .map((t) => {
+            const versionLabel = Number.isFinite(Number(t.version))
+                ? String(t.version)
+                : "unversioned";
+            return `${versionLabel} (${t.engines?.camunda || "any"})`;
+        })
+            .join(", ");
+        throw new Error(`Element template '${ref.id}' has no version compatible with execution platform ` +
+            `${executionPlatformVersion}. Available: ${available}.`);
+    }
+    return picked;
+}
+/**
+ * Load and parse a template (OOTB id, local path, or URL), and produce the
+ * derived views the inspect subcommands need: settable property details,
+ * a group id→label map, and a side-table from detail → source property.
+ *
+ * The side-table preserves access to the raw schema-shaped property for
+ * JSON projection without leaking the back-reference into the detail
+ * itself. Required because two distinct properties can share the same
+ * `binding.name` + type (template authors use it for operation-conditional
+ * duplicates), so we can't recover identity from the detail's name+type
+ * tuple.
+ */
+export async function loadTemplate(templateArg) {
+    const ref = parseTemplateRef(templateArg);
+    if (!ref) {
+        throw new Error("Missing template argument.");
+    }
+    let template;
+    if (ref.kind === "id") {
+        template = await resolveOotbTemplate(ref);
+    }
+    else {
+        template = await readTemplateFromPathOrUrl(ref.value);
+    }
+    const settable = getSettableProperties(template.properties);
+    const groupLabelMap = new Map((template.groups ?? []).map((g) => [g.id, g.label]));
+    const sourceByDetail = new WeakMap();
+    const allDetails = settable.map((p) => {
+        const detail = getPropertyDetail(p, groupLabelMap);
+        sourceByDetail.set(detail, p);
+        return detail;
+    });
+    // `autoResolvedVersion` is true when the user gave an OOTB id without
+    // pinning `@<n>` and we picked the latest. The info card surfaces
+    // this as a dim parenthetical on the Version row instead of a
+    // separate stderr warning.
+    return {
+        template,
+        allDetails,
+        groupLabelMap,
+        sourceByDetail,
+        autoResolvedVersion: ref.kind === "id" && ref.version === undefined,
+    };
+}
+//# sourceMappingURL=template-ref.js.map

package/dist/default-plugins/element-template/template-ref.js.map

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