@enfocussw/switch-scripting-context 25.11.0-beta.8

package/dist/init.js

@@ -0,0 +1,616 @@
+"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.generateAgentsMd = generateAgentsMd;
+exports.generateGeminiMd = generateGeminiMd;
+exports.generateWindsurfRules = generateWindsurfRules;
+exports.generateZedRules = generateZedRules;
+exports.generateClineRules = generateClineRules;
+exports.buildIdMap = buildIdMap;
+exports.findMarkerRange = findMarkerRange;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+// ─── Markers ─────────────────────────────────────────────────────────────────
+const MARKER_BEGIN = '<!-- switch-scripting-context begin -->';
+const MARKER_END = '<!-- switch-scripting-context end -->';
+// ─── Content generators ──────────────────────────────────────────────────────
+function generateClaudeMd(docsDir) {
+    return `${MARKER_BEGIN}
+## Switch Scripting (Enfocus Switch)
+
+@${docsDir}/switch-scripting.md
+${MARKER_END}`;
+}
+function generateCopilotInstructions(docsDir) {
+    return `${MARKER_BEGIN}
+## Switch Scripting (Enfocus Switch)
+
+This project uses Enfocus Switch scripting (Node.js/TypeScript).
+Consult the Switch scripting reference before writing or modifying code.
+
+#file:../${docsDir}/switch-scripting.md
+${MARKER_END}`;
+}
+function generateCopilotScopedInstructions(docsDir) {
+    return `---
+applyTo: "**/*.ts"
+---
+${MARKER_BEGIN}
+You are working on an Enfocus Switch scripting project (Node.js/TypeScript).
+
+#file:../../${docsDir}/switch-scripting.md
+${MARKER_END}`;
+}
+function generateCursorMdc(docsDir) {
+    const apiFiles = [
+        'api-entry-points.md',
+        'api-job.md',
+        'api-flow-element.md',
+        'api-connection.md',
+        'api-http.md',
+        'api-enums.md',
+        'api-document-classes.md',
+        'api-script-declaration.md',
+        'api-script-structure.md',
+        'api-tooling.md',
+        'api-debugging.md',
+        'api-vscode.md',
+        'api-property-editors.md',
+        'api-job-patterns.md',
+        'api-switch.md',
+        'api-execution-environment.md',
+        'api-logging.md',
+        'api-logs-and-dataroot.md',
+    ];
+    const fileList = apiFiles.map(f => `- \`${docsDir}/switch-api/${f}\``).join('\n');
+    return `---
+description: Enfocus Switch scripting rules and API reference for Node.js/TypeScript scripts
+globs: ["**/*.ts", "**/*.js"]
+alwaysApply: false
+---
+
+${MARKER_BEGIN}
+You are working on an Enfocus Switch scripting project (Node.js/TypeScript).
+
+## Core rules
+
+- Entry point functions are top-level async functions — do NOT use \`export\`.
+- Every \`jobArrived\` must end with exactly one \`job.sendTo*()\` or \`job.fail()\`.
+- Use \`AccessLevel.ReadOnly\` for \`job.get()\` unless the file content will be modified.
+- After \`createJob()\`, \`createChild()\`, or \`createDataset()\` with a file path, delete the source file after routing — Switch does not auto-remove it.
+- Never edit \`<ScriptID>.xml\` or \`manifest.xml\` directly. For property/connection changes, instruct the user to use SwitchScripter.
+- After editing \`main.ts\`, transpile with \`SwitchScriptTool --transpile <folder>\` — do not use \`tsc\` directly.
+- Never use a script folder in production — pack with \`SwitchScriptTool --pack\` first; folders are excluded from flow exports.
+
+## API reference
+
+Read \`${docsDir}/switch-scripting.md\` for the full index, then consult the relevant file:
+
+${fileList}
+${MARKER_END}`;
+}
+// ─── Shared inline content (for tools without @file import support) ──────────
+const INLINE_CORE_RULES = `## Core rules
+
+- Entry point functions are top-level async functions — do NOT use \`export\`.
+- Every \`jobArrived\` must end with exactly one \`job.sendTo*()\` or \`job.fail()\`.
+- Use \`AccessLevel.ReadOnly\` for \`job.get()\` unless the file content will be modified.
+- After \`createJob()\`, \`createChild()\`, or \`createDataset()\` with a file path, delete the source file after routing — Switch does not auto-remove it.
+- Never edit \`<ScriptID>.xml\` or \`manifest.xml\` directly. For property/connection changes, instruct the user to use SwitchScripter.
+- After editing \`main.ts\`, transpile with \`SwitchScriptTool --transpile <folder>\` — do not use \`tsc\` directly.
+- Never use a script folder in production — pack with \`SwitchScriptTool --pack\` first; folders are excluded from flow exports.`;
+const API_FILES = [
+    'api-entry-points.md',
+    'api-job.md',
+    'api-flow-element.md',
+    'api-connection.md',
+    'api-http.md',
+    'api-enums.md',
+    'api-document-classes.md',
+    'api-script-declaration.md',
+    'api-script-structure.md',
+    'api-tooling.md',
+    'api-debugging.md',
+    'api-vscode.md',
+    'api-property-editors.md',
+    'api-job-patterns.md',
+    'api-switch.md',
+    'api-execution-environment.md',
+    'api-logging.md',
+    'api-logs-and-dataroot.md',
+];
+function inlineApiFileList(docsDir) {
+    return API_FILES.map(f => `- \`${docsDir}/switch-api/${f}\``).join('\n');
+}
+function generateInlineBlock(docsDir) {
+    return `You are working on an Enfocus Switch scripting project (Node.js/TypeScript).
+
+${INLINE_CORE_RULES}
+
+## API reference
+
+Read \`${docsDir}/switch-scripting.md\` for the full index, then consult the relevant file:
+
+${inlineApiFileList(docsDir)}`;
+}
+function generateAgentsMd(docsDir) {
+    return `${MARKER_BEGIN}
+## Switch Scripting (Enfocus Switch)
+
+${generateInlineBlock(docsDir)}
+${MARKER_END}`;
+}
+function generateGeminiMd(docsDir) {
+    return `${MARKER_BEGIN}
+## Switch Scripting (Enfocus Switch)
+
+@${docsDir}/switch-scripting.md
+${MARKER_END}`;
+}
+function generateWindsurfRules(docsDir) {
+    return `${MARKER_BEGIN}
+## Switch Scripting (Enfocus Switch)
+
+${generateInlineBlock(docsDir)}
+${MARKER_END}`;
+}
+function generateZedRules(docsDir) {
+    return `${MARKER_BEGIN}
+## Switch Scripting (Enfocus Switch)
+
+${generateInlineBlock(docsDir)}
+${MARKER_END}`;
+}
+function generateClineRules(docsDir) {
+    return `${MARKER_BEGIN}
+## Switch Scripting (Enfocus Switch)
+
+${generateInlineBlock(docsDir)}
+${MARKER_END}`;
+}
+// ─── Tool registry ───────────────────────────────────────────────────────────
+const TOOL_REGISTRY = [
+    {
+        id: 'claude',
+        label: 'Claude Code',
+        aliases: ['ClawCode'],
+        altIds: ['clawcode'],
+        files: [
+            {
+                targetPath: (root) => path.join(root, 'CLAUDE.md'),
+                generate: generateClaudeMd,
+            },
+        ],
+    },
+    {
+        id: 'copilot',
+        label: 'GitHub Copilot',
+        files: [
+            {
+                targetPath: (root) => path.join(root, '.github', 'copilot-instructions.md'),
+                generate: generateCopilotInstructions,
+            },
+            {
+                targetPath: (root) => path.join(root, '.github', 'instructions', 'switch-scripting.instructions.md'),
+                generate: generateCopilotScopedInstructions,
+            },
+        ],
+    },
+    {
+        id: 'cursor',
+        label: 'Cursor',
+        files: [
+            {
+                targetPath: (root) => path.join(root, '.cursor', 'rules', 'switch-scripting.mdc'),
+                generate: generateCursorMdc,
+            },
+        ],
+    },
+    {
+        id: 'codex',
+        label: 'Codex CLI / OpenCode',
+        altIds: ['opencode'],
+        files: [
+            {
+                targetPath: (root) => path.join(root, 'AGENTS.md'),
+                generate: generateAgentsMd,
+            },
+        ],
+    },
+    {
+        id: 'gemini',
+        label: 'Gemini CLI',
+        files: [
+            {
+                targetPath: (root) => path.join(root, 'GEMINI.md'),
+                generate: generateGeminiMd,
+            },
+        ],
+    },
+    {
+        id: 'windsurf',
+        label: 'Windsurf',
+        files: [
+            {
+                targetPath: (root) => path.join(root, '.windsurfrules'),
+                generate: generateWindsurfRules,
+            },
+        ],
+    },
+    {
+        id: 'zed',
+        label: 'Zed',
+        files: [
+            {
+                targetPath: (root) => path.join(root, '.rules'),
+                generate: generateZedRules,
+            },
+        ],
+    },
+    {
+        id: 'cline',
+        label: 'Cline',
+        files: [
+            {
+                targetPath: (root) => path.join(root, '.clinerules'),
+                generate: generateClineRules,
+            },
+        ],
+    },
+];
+// ─── ID map ──────────────────────────────────────────────────────────────────
+function buildIdMap(registry) {
+    const map = new Map();
+    for (const t of registry) {
+        map.set(t.id, t.id);
+        for (const alt of t.altIds ?? [])
+            map.set(alt, t.id);
+    }
+    return map;
+}
+// ─── Merge logic ─────────────────────────────────────────────────────────────
+function findMarkerRange(content) {
+    const begin = content.indexOf(MARKER_BEGIN);
+    const end = content.indexOf(MARKER_END);
+    if (begin === -1 || end === -1)
+        return null;
+    if (begin >= end)
+        return null;
+    return [begin, end + MARKER_END.length];
+}
+function resolveFileAction(targetPath, block, force) {
+    if (!fs.existsSync(targetPath)) {
+        return { path: targetPath, action: 'create', content: block };
+    }
+    if (force) {
+        return { path: targetPath, action: 'overwrite', content: block };
+    }
+    const existing = fs.readFileSync(targetPath, 'utf8');
+    const range = findMarkerRange(existing);
+    if (range) {
+        const updated = existing.slice(0, range[0]) + block + existing.slice(range[1]);
+        return { path: targetPath, action: 'merge-replace', content: updated };
+    }
+    const separator = existing.endsWith('\n') ? '\n' : '\n\n';
+    return { path: targetPath, action: 'merge-append', content: existing + separator + block + '\n' };
+}
+function applyFileAction(action, dryRun) {
+    const rel = path.relative(process.cwd(), action.path);
+    const label = action.action === 'create' ? 'created'
+        : action.action === 'overwrite' ? 'overwritten'
+            : action.action === 'merge-replace' ? 'updated (replaced Switch section)'
+                : 'updated (appended Switch section)';
+    if (dryRun) {
+        console.log(`  [dry-run] ${rel} → ${label}`);
+        return;
+    }
+    const dir = path.dirname(action.path);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(action.path, action.content, 'utf8');
+    console.log(`  ${rel} → ${label}`);
+}
+// ─── Docs copy ────────────────────────────────────────────────────────────────
+function copyDocs(packageRoot, destDir, dryRun) {
+    const src = path.join(packageRoot, 'docs');
+    if (dryRun) {
+        console.log(`  [dry-run] Copying docs/ → ${path.relative(process.cwd(), destDir)}/`);
+        return;
+    }
+    fs.cpSync(src, destDir, { recursive: true });
+    console.log(`  docs → ${path.relative(process.cwd(), destDir)}/`);
+}
+// ─── .gitignore update ───────────────────────────────────────────────────────
+function updateGitignore(targetRoot, docsDir, dryRun) {
+    const gitignorePath = path.join(targetRoot, '.gitignore');
+    const entry = `\n# switch-scripting-context (AI context docs — re-generate with npx switch-scripting-context init)\n${docsDir}/\n`;
+    if (!fs.existsSync(gitignorePath))
+        return;
+    const content = fs.readFileSync(gitignorePath, 'utf8');
+    if (content.includes(`${docsDir}/`))
+        return;
+    if (dryRun) {
+        console.log(`  [dry-run] .gitignore → append ${docsDir}/ entry`);
+        return;
+    }
+    fs.appendFileSync(gitignorePath, entry, 'utf8');
+    console.log(`  .gitignore → appended ${docsDir}/ entry`);
+}
+/** All AI config file paths that init may have created. */
+function aiConfigPaths(targetRoot, docsDir) {
+    return TOOL_REGISTRY.flatMap(t => t.files.map(f => f.targetPath(targetRoot, docsDir)));
+}
+function removeAiConfig(filePath, dryRun) {
+    if (!fs.existsSync(filePath))
+        return;
+    const content = fs.readFileSync(filePath, 'utf8');
+    const range = findMarkerRange(content);
+    if (!range)
+        return; // nothing from us in this file
+    const rel = path.relative(process.cwd(), filePath);
+    const before = content.slice(0, range[0]).trim();
+    const after = content.slice(range[1]).trim();
+    if (!before && !after) {
+        // File is entirely our content — delete it
+        if (dryRun) {
+            console.log(`  [dry-run] ${rel} → deleted`);
+            return;
+        }
+        fs.unlinkSync(filePath);
+        console.log(`  ${rel} → deleted`);
+    }
+    else {
+        // File has other content — strip our section
+        const stripped = (before ? before + '\n' : '') + (after ? '\n' + after + '\n' : '');
+        if (dryRun) {
+            console.log(`  [dry-run] ${rel} → removed Switch section`);
+            return;
+        }
+        fs.writeFileSync(filePath, stripped, 'utf8');
+        console.log(`  ${rel} → removed Switch section`);
+    }
+}
+function removeGitignoreEntry(targetRoot, docsDir, dryRun) {
+    const gitignorePath = path.join(targetRoot, '.gitignore');
+    if (!fs.existsSync(gitignorePath))
+        return;
+    const content = fs.readFileSync(gitignorePath, 'utf8');
+    // Remove the comment line and the docsDir/ line added by init
+    const updated = content
+        .replace(/\n# switch-scripting-context \(AI context docs[^\n]*\)\n/g, '\n')
+        .replace(new RegExp(`\n${docsDir}/\n`, 'g'), '\n');
+    if (updated === content)
+        return;
+    if (dryRun) {
+        console.log(`  [dry-run] .gitignore → removed ${docsDir}/ entry`);
+        return;
+    }
+    fs.writeFileSync(gitignorePath, updated, 'utf8');
+    console.log(`  .gitignore → removed ${docsDir}/ entry`);
+}
+function remove(options) {
+    const targetRoot = process.cwd();
+    const docsDestDir = path.join(targetRoot, options.docsDir);
+    if (options.dryRun)
+        console.log('\nDry run — no files will be written.\n');
+    // 1. Remove docs dir
+    console.log('Removing docs...');
+    if (fs.existsSync(docsDestDir)) {
+        if (options.dryRun) {
+            console.log(`  [dry-run] ${options.docsDir}/ → deleted`);
+        }
+        else {
+            fs.rmSync(docsDestDir, { recursive: true, force: true });
+            console.log(`  ${options.docsDir}/ → deleted`);
+        }
+    }
+    else {
+        console.log(`  ${options.docsDir}/ → not found, skipping`);
+    }
+    // 2. Remove AI config sections / files
+    console.log('\nCleaning AI config files...');
+    for (const filePath of aiConfigPaths(targetRoot, options.docsDir)) {
+        removeAiConfig(filePath, options.dryRun);
+    }
+    // 3. Update .gitignore
+    console.log('\nUpdating .gitignore...');
+    removeGitignoreEntry(targetRoot, options.docsDir, options.dryRun);
+    console.log('\nDone.\n');
+}
+// ─── Main init ───────────────────────────────────────────────────────────────
+function init(options) {
+    const targetRoot = process.cwd();
+    const packageRoot = path.resolve(__dirname, '..');
+    const docsDestDir = path.join(targetRoot, options.docsDir);
+    if (options.dryRun)
+        console.log('\nDry run — no files will be written.\n');
+    // 1. Copy docs
+    console.log('Copying docs...');
+    copyDocs(packageRoot, docsDestDir, options.dryRun);
+    // 2. Generate AI config files
+    const toolActions = [];
+    for (const toolDef of TOOL_REGISTRY) {
+        if (!options.tools.includes(toolDef.id))
+            continue;
+        for (const f of toolDef.files) {
+            toolActions.push({
+                targetPath: f.targetPath(targetRoot, options.docsDir),
+                block: f.generate(options.docsDir),
+            });
+        }
+    }
+    if (toolActions.length > 0) {
+        console.log('\nGenerating AI config files...');
+        for (const { targetPath, block } of toolActions) {
+            const action = resolveFileAction(targetPath, block, options.force);
+            applyFileAction(action, options.dryRun);
+        }
+    }
+    // 3. Update .gitignore
+    console.log('\nUpdating .gitignore...');
+    updateGitignore(targetRoot, options.docsDir, options.dryRun);
+    console.log('\nDone. Re-run after upgrading switch-scripting-context to refresh docs and config.\n');
+}
+// ─── CLI arg parsing ──────────────────────────────────────────────────────────
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    const subcommand = args[0] ?? 'help';
+    let toolsExplicit = false;
+    const initOptions = {
+        tools: TOOL_REGISTRY.map(t => t.id),
+        docsDir: 'switch-docs',
+        force: false,
+        dryRun: false,
+    };
+    const removeOptions = {
+        docsDir: 'switch-docs',
+        dryRun: false,
+    };
+    for (let i = 1; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--force') {
+            initOptions.force = true;
+        }
+        else if (arg === '--dry-run') {
+            initOptions.dryRun = true;
+            removeOptions.dryRun = true;
+        }
+        else if (arg === '--tools' && args[i + 1]) {
+            const idMap = buildIdMap(TOOL_REGISTRY);
+            const raw = args[++i].split(',').map(s => s.trim());
+            const invalid = raw.filter(t => !idMap.has(t));
+            if (invalid.length > 0) {
+                const allValid = [...idMap.keys()].sort().join(', ');
+                console.error(`Unknown tool(s): ${invalid.join(', ')}. Valid values: ${allValid}`);
+                process.exit(1);
+            }
+            initOptions.tools = raw.map(t => idMap.get(t));
+            toolsExplicit = true;
+        }
+        else if (arg === '--docs-dir' && args[i + 1]) {
+            initOptions.docsDir = args[++i];
+            removeOptions.docsDir = initOptions.docsDir;
+        }
+        else if (arg.startsWith('--')) {
+            console.error(`Unknown option: ${arg}`);
+            process.exit(1);
+        }
+    }
+    return { subcommand, initOptions, removeOptions, toolsExplicit };
+}
+// ─── Interactive tool prompt ──────────────────────────────────────────────────
+function toolPromptLabel(t) {
+    if (t.aliases && t.aliases.length > 0) {
+        return `${t.label}  (also covers ${t.aliases.join(', ')})`;
+    }
+    return t.label;
+}
+async function promptTools() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    console.log('\nWhich coding agent(s) do you use?');
+    console.log('Enter numbers separated by spaces (or press Enter to select all):\n');
+    TOOL_REGISTRY.forEach((t, i) => console.log(`  ${i + 1}) ${toolPromptLabel(t)}`));
+    console.log();
+    return new Promise((resolve) => {
+        rl.question('> ', (answer) => {
+            rl.close();
+            const trimmed = answer.trim();
+            if (!trimmed) {
+                resolve(TOOL_REGISTRY.map(t => t.id));
+                return;
+            }
+            const indices = trimmed.split(/[\s,]+/).map(n => parseInt(n, 10) - 1);
+            const valid = indices.filter(i => i >= 0 && i < TOOL_REGISTRY.length);
+            if (valid.length === 0) {
+                resolve(TOOL_REGISTRY.map(t => t.id));
+                return;
+            }
+            resolve(valid.map(i => TOOL_REGISTRY[i].id));
+        });
+    });
+}
+function printHelp() {
+    console.log(`
+Usage: switch-scripting-context <command> [options]
+
+Commands:
+  init      Copy docs and generate AI context config files
+  remove    Remove all files and config added by init
+
+Options (init):
+  --tools <list>    Comma-separated tools to configure
+                    IDs: claude, copilot, cursor, codex, gemini, windsurf, zed, cline
+                    Aliases: opencode (→ codex), clawcode (→ claude)
+                    Default: all tools
+  --docs-dir <dir>  Destination folder for docs in target project (default: switch-docs)
+  --force           Overwrite existing AI config files rather than merging
+  --dry-run         Print what would happen without writing any files
+  --help            Show this help message
+
+Options (remove):
+  --docs-dir <dir>  Docs folder to remove (default: switch-docs)
+  --dry-run         Print what would happen without writing any files
+
+Examples:
+  npx switch-scripting-context init
+  npx switch-scripting-context init --tools claude,copilot
+  npx switch-scripting-context init --docs-dir ai-docs --dry-run
+  npx switch-scripting-context remove
+  npx switch-scripting-context remove --dry-run
+`);
+}
+// ─── Entry point ─────────────────────────────────────────────────────────────
+async function run(argv = process.argv) {
+    const { subcommand, initOptions, removeOptions, toolsExplicit } = parseArgs(argv);
+    if (subcommand === 'help' || subcommand === '--help' || subcommand === '-h') {
+        printHelp();
+    }
+    else if (subcommand === 'init') {
+        if (!toolsExplicit) {
+            initOptions.tools = await promptTools();
+        }
+        init(initOptions);
+    }
+    else if (subcommand === 'remove') {
+        remove(removeOptions);
+    }
+    else {
+        console.error(`Unknown command: ${subcommand}`);
+        printHelp();
+        process.exit(1);
+    }
+}

package/docs/switch-api/api-connection.md

@@ -0,0 +1,63 @@
+# Connection Class
+
+A `Connection` represents an outgoing connection from the flow element. Obtain instances via `flowElement.getOutConnections()`.
+
+## Identity
+
+```ts
+connection.getId(): string
+```
+Unique ID for the connection. Stable across deactivate/reactivate, Switch restarts, holding/releasing connections, and renaming the flow itself. Changes on export/re-import, a flow upgrade, or renaming the flow *element* (not the flow).
+
+```ts
+connection.getName(): string
+```
+Display name as shown on the canvas. May be an empty string.
+
+```ts
+connection.getType(): string
+```
+Connection type. One of: `"Move"`, `"Filter"`, `"Traffic-data"`, `"Traffic-log"`, `"Traffic-datawithlog"`.
+
+## Connection properties
+
+Connection properties are declared in the script's XML declaration (`ConnectionFields`) and configured per-connection in the canvas. See [api-script-declaration.md](api-script-declaration.md) for how to declare them (via SwitchScripter).
+
+```ts
+connection.getPropertyStringValue(tag: string): Promise<string | string[]>
+```
+Returns the connection property value as a string.
+
+```ts
+connection.getPropertyType(tag: string): PropertyType
+```
+Returns the `PropertyType` of the property.
+
+```ts
+connection.getPropertyDisplayName(tag: string): string
+```
+Returns the English display name of the property (for use in log messages).
+
+```ts
+connection.hasProperty(tag: string): boolean
+```
+Returns `true` if the property exists and is visible for the current configuration.
+
+## File count
+
+```ts
+connection.getFileCount(nested?: boolean): Promise<number>
+```
+Returns the number of files in the folder at the other end of this connection. If `nested` is `false`, counts only direct children; if `true` (the default, so it can be omitted), counts recursively (subfolders themselves are not counted).
+
+## Connection.Level enum
+
+Used with `job.sendToData()` and `job.sendToLog()` for traffic light connections.
+
+| Value | String |
+|---|---|
+| `Connection.Level.Success` | `"success"` |
+| `Connection.Level.Warning` | `"warning"` |
+| `Connection.Level.Error` | `"error"` |
+
+Available as `EnfocusSwitch.Connection.Level.*` outside `main.ts`.