@zenalexa/unicli 0.207.1

package/dist/commands/plugin.js

@@ -0,0 +1,122 @@
+/**
+ * Plugin CLI subcommands — install/uninstall/list/update/create third-party plugins.
+ *
+ * Commands:
+ *   plugin install <source>  — Install from GitHub or local path
+ *   plugin uninstall <name>  — Remove an installed plugin
+ *   plugin list              — List all installed plugins (adapters + manifest)
+ *   plugin update [name]     — Update one or all plugins
+ *   plugin create <name>     — Scaffold a new plugin with unicli-plugin.json
+ *   plugin steps             — List custom pipeline steps from plugins
+ */
+import chalk from "chalk";
+import { installPlugin, uninstallPlugin, listPlugins, updatePlugin, } from "../plugin.js";
+import { createPlugin, listManifestPlugins } from "../plugin/loader.js";
+import { listCustomSteps } from "../plugin/step-registry.js";
+export function registerPluginCommands(program) {
+    const plugin = program
+        .command("plugin")
+        .description("Manage third-party adapter plugins");
+    plugin
+        .command("install <source>")
+        .description("Install a plugin (github:user/repo, URL, or local path)")
+        .action((source) => {
+        try {
+            const info = installPlugin(source);
+            console.log(chalk.green(`Installed "${info.name}" (${info.commands} adapters) → ${info.path}`));
+        }
+        catch (err) {
+            console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+    plugin
+        .command("uninstall <name>")
+        .description("Uninstall a plugin")
+        .action((name) => {
+        try {
+            uninstallPlugin(name);
+            console.log(chalk.green(`Uninstalled "${name}"`));
+        }
+        catch (err) {
+            console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+    plugin
+        .command("list")
+        .description("List installed plugins")
+        .action(() => {
+        const legacyPlugins = listPlugins();
+        const manifestPlugins = listManifestPlugins();
+        // Deduplicate: manifest plugins override legacy entries with same name
+        const manifestNames = new Set(manifestPlugins.map((p) => p.name));
+        const legacyOnly = legacyPlugins.filter((p) => !manifestNames.has(p.name));
+        if (legacyOnly.length === 0 && manifestPlugins.length === 0) {
+            console.log("No plugins installed.");
+            return;
+        }
+        for (const p of manifestPlugins) {
+            console.log(`  ${chalk.bold(p.name)} v${p.version} — ${p.description ?? ""} ${chalk.dim("[manifest]")}`);
+        }
+        for (const p of legacyOnly) {
+            console.log(`  ${chalk.bold(p.name)} — ${p.commands} adapters ${chalk.dim(p.source ?? "")}`);
+        }
+    });
+    plugin
+        .command("update [name]")
+        .description("Update a plugin (or all)")
+        .action((name) => {
+        try {
+            if (name) {
+                const info = updatePlugin(name);
+                console.log(chalk.green(`Updated "${info.name}" (${info.commands} adapters)`));
+            }
+            else {
+                const plugins = listPlugins();
+                for (const p of plugins) {
+                    try {
+                        updatePlugin(p.name);
+                        console.log(chalk.green(`  ✓ ${p.name}`));
+                    }
+                    catch (err) {
+                        console.log(chalk.red(`  ✗ ${p.name}: ${err instanceof Error ? err.message : String(err)}`));
+                    }
+                }
+            }
+        }
+        catch (err) {
+            console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+    plugin
+        .command("create <name>")
+        .description("Scaffold a new plugin with unicli-plugin.json manifest")
+        .action((name) => {
+        try {
+            const dir = createPlugin(name);
+            console.log(chalk.green(`Created plugin scaffold at ${dir}`));
+            console.log(chalk.dim("  Edit unicli-plugin.json and add adapters/steps."));
+        }
+        catch (err) {
+            console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+    plugin
+        .command("steps")
+        .description("List custom pipeline steps registered by plugins")
+        .action(() => {
+        const steps = listCustomSteps();
+        if (steps.length === 0) {
+            console.log("No custom pipeline steps registered.");
+            return;
+        }
+        console.log(`${steps.length} custom step(s):`);
+        for (const s of steps) {
+            console.log(`  - ${s}`);
+        }
+    });
+}
+//# sourceMappingURL=plugin.js.map

package/dist/commands/plugin.js.map

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

package/dist/commands/record.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Record mode — capture network requests and auto-generate adapter YAML.
+ *
+ * Flow: connect browser → navigate → inject full-capture interceptor →
+ * poll captured requests (multi-tab via CDP Target domain) →
+ * analyze → score → deduplicate → write YAML candidates.
+ *
+ * Enhanced with:
+ *   - Multi-tab recording via CDP Target.setDiscoverTargets
+ *   - Write candidate generation (POST/PUT/PATCH/DELETE with JSON bodies)
+ *   - URL parameter templatization (query/page/id/limit params + numeric path segments)
+ *   - Deduplication by normalized URL pattern
+ */
+import { Command } from "commander";
+export interface RecordedRequest {
+    url: string;
+    data: unknown;
+    ts: number;
+    method?: string;
+    requestBody?: unknown;
+    targetId?: string;
+}
+export interface ScoredCandidate {
+    name: string;
+    url: string;
+    score: number;
+    isWrite: boolean;
+    responsePreview: unknown;
+    requestBody?: unknown;
+    method?: string;
+}
+/** Template variable descriptor for templatizeUrl */
+export interface TemplateArg {
+    name: string;
+    required: boolean;
+}
+/** Return value of templatizeUrl */
+export interface TemplatizeResult {
+    url: string;
+    args: TemplateArg[];
+}
+/**
+ * Templatize a URL by replacing known query params and numeric path segments
+ * with Jinja2-style template variables (`${{ args.X }}`).
+ *
+ * Returns the templatized URL string and the list of discovered arg names.
+ *
+ * NOTE: The URL is assembled as a raw string (not via URL.toString()) to
+ * prevent URLSearchParams from percent-encoding the template expressions.
+ */
+export declare function templatizeUrl(rawUrl: string): TemplatizeResult;
+/**
+ * Deduplicate captured requests by normalized URL pattern.
+ * For each dedup group, keep the request with the richest response.
+ */
+export declare function deduplicateRequests(requests: RecordedRequest[]): RecordedRequest[];
+/**
+ * Return true if the request is a write candidate:
+ * mutating HTTP method + JSON-parseable request body (or no body for DELETE).
+ */
+export declare function isWriteCandidate(req: RecordedRequest): boolean;
+/**
+ * Build a write-candidate YAML adapter string.
+ */
+export declare function buildWriteCandidateYaml(site: string, candidate: ScoredCandidate, baseUrl: string): string;
+/**
+ * Analyze captured requests, separating read and write candidates.
+ * Deduplication is applied before scoring.
+ */
+export declare function analyzeRequests(requests: RecordedRequest[]): {
+    readCandidates: ScoredCandidate[];
+    writeCandidates: ScoredCandidate[];
+};
+export declare function registerRecordCommand(program: Command): void;
+//# sourceMappingURL=record.d.ts.map

package/dist/commands/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/commands/record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AA0CD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAoE9D;AAiDD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,eAAe,EAAE,GAC1B,eAAe,EAAE,CAmBnB;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAG9D;AAID;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,MAAM,GACd,MAAM,CAsDR;AA6ID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG;IAC5D,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,eAAe,EAAE,eAAe,EAAE,CAAC;CACpC,CA2DA;AA6BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0Q5D"}