publishport-opencli 1.0.0

package/dist/src/observation/retention.d.ts

@@ -0,0 +1,32 @@
+export interface TraceRetentionPolicyInput {
+    maxAgeDays?: number;
+    maxCountPerProfile?: number;
+    maxBytesPerProfile?: string | number;
+}
+export interface ResolvedTraceRetentionPolicy {
+    maxAgeDays: number;
+    maxAgeMs: number;
+    maxCountPerProfile: number;
+    maxBytesPerProfile: number;
+}
+export interface TraceRetentionPruneResult {
+    scanned: number;
+    deleted: string[];
+    kept: string[];
+    totalBytesBefore: number;
+    totalBytesAfter: number;
+}
+export declare const DEFAULT_TRACE_RETENTION_POLICY: {
+    maxAgeDays: number;
+    maxCountPerProfile: number;
+    maxBytesPerProfile: string;
+};
+export declare function parseByteSize(value: string | number): number;
+export declare function resolveTraceRetentionPolicy(input?: TraceRetentionPolicyInput): ResolvedTraceRetentionPolicy;
+export declare function traceExpiresAt(createdAt: string, policyInput?: TraceRetentionPolicyInput): string;
+export declare function pruneTraceArtifacts(tracesDir: string, opts?: {
+    policy?: TraceRetentionPolicyInput;
+    protectedTraceDirs?: string[];
+    now?: () => number;
+    warn?: (message: string) => void;
+}): TraceRetentionPruneResult;

package/dist/src/observation/retention.js

@@ -0,0 +1 @@
+import*as j from"node:fs";import*as F from"node:path";import{log as b}from"../logger.js";export const DEFAULT_TRACE_RETENTION_POLICY={maxAgeDays:7,maxCountPerProfile:20,maxBytesPerProfile:"500MB"};const w={B:1,KB:1024,MB:1048576,GB:1073741824};export function parseByteSize(G){if(typeof G==="number"){if(!Number.isFinite(G)||G<0)throw Error(`Invalid byte size: ${G}`);return Math.floor(G)}const H=G.trim().match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB)?$/i);if(!H)throw Error(`Invalid byte size: ${G}`);const K=Number(H[1]),Q=(H[2]??"B").toUpperCase();return Math.floor(K*w[Q])}export function resolveTraceRetentionPolicy(G={}){const H=G.maxAgeDays??DEFAULT_TRACE_RETENTION_POLICY.maxAgeDays,K=G.maxCountPerProfile??DEFAULT_TRACE_RETENTION_POLICY.maxCountPerProfile;if(!Number.isFinite(H)||H<0)throw Error(`Invalid trace maxAgeDays: ${H}`);if(!Number.isInteger(K)||K<0)throw Error(`Invalid trace maxCountPerProfile: ${K}`);return{maxAgeDays:H,maxAgeMs:H*24*60*60*1000,maxCountPerProfile:K,maxBytesPerProfile:parseByteSize(G.maxBytesPerProfile??DEFAULT_TRACE_RETENTION_POLICY.maxBytesPerProfile)}}export function traceExpiresAt(G,H={}){const K=resolveTraceRetentionPolicy(H),Q=Date.parse(G),W=Number.isFinite(Q)?Q:Date.now();return new Date(W+K.maxAgeMs).toISOString()}export function pruneTraceArtifacts(G,H={}){const K=H.warn??((q)=>b.warn(`[trace] ${q}`)),Q=resolveTraceRetentionPolicy(H.policy),W=H.now??Date.now,Z=new Set((H.protectedTraceDirs??[]).map((q)=>F.resolve(q))),V=N(G,Z,K),X=V.reduce((q,J)=>q+J.sizeBytes,0),z=new Set,k=[...V].sort((q,J)=>q.createdAtMs-J.createdAtMs||q.dir.localeCompare(J.dir)),L=W()-Q.maxAgeMs;for(const q of k)if(!q.protected&&q.createdAtMs<L)z.add(q.dir);let $=k.filter((q)=>!z.has(q.dir));while($.length>Q.maxCountPerProfile){const q=$.find((J)=>!J.protected);if(!q)break;z.add(q.dir);$=$.filter((J)=>J.dir!==q.dir)}let Y=$.reduce((q,J)=>q+J.sizeBytes,0);while(Y>Q.maxBytesPerProfile){const q=$.find((J)=>!J.protected);if(!q)break;z.add(q.dir);$=$.filter((J)=>J.dir!==q.dir);Y-=q.sizeBytes}const U=[];for(const q of k.map((J)=>J.dir).filter((J)=>z.has(J)))try{j.rmSync(q,{recursive:!0,force:!0});U.push(q)}catch(J){K(`Failed to prune trace artifact ${q}: ${J instanceof Error?J.message:String(J)}`)}const M=V.filter((q)=>!U.includes(q.dir));return{scanned:V.length,deleted:U,kept:M.map((q)=>q.dir),totalBytesBefore:X,totalBytesAfter:M.reduce((q,J)=>q+J.sizeBytes,0)}}function N(G,H,K){let Q;try{Q=j.readdirSync(G)}catch(Z){if(B(Z))return[];K(`Failed to list trace artifacts in ${G}: ${Z instanceof Error?Z.message:String(Z)}`);return[]}const W=[];for(const Z of Q){const V=F.join(G,Z);try{const X=j.statSync(V);if(!X.isDirectory())continue;W.push({dir:V,createdAtMs:O(V,X.mtimeMs),sizeBytes:S(V),protected:H.has(F.resolve(V))})}catch(X){if(!B(X))K(`Failed to inspect trace artifact ${V}: ${X instanceof Error?X.message:String(X)}`)}}return W}function O(G,H){try{const K=JSON.parse(j.readFileSync(F.join(G,"receipt.json"),"utf-8"));if(typeof K.createdAt==="string"){const Q=Date.parse(K.createdAt);if(Number.isFinite(Q))return Q}}catch{}return H}function S(G){let H=0;for(const K of j.readdirSync(G)){const Q=F.join(G,K),W=j.lstatSync(Q);if(W.isDirectory())H+=S(Q);else H+=W.size}return H}function B(G){return typeof G==="object"&&G!==null&&"code"in G&&G.code==="ENOENT"}

package/dist/src/observation/retention.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/observation/ring-buffer.d.ts

@@ -0,0 +1,22 @@
+export interface RingBufferOptions {
+    maxAgeMs?: number;
+    maxItems?: number;
+    now?: () => number;
+}
+export declare class RingBuffer<T extends {
+    ts: number;
+}> {
+    private readonly maxAgeMs;
+    private readonly maxItems;
+    private readonly now;
+    private items;
+    constructor(opts?: RingBufferOptions);
+    push(item: T): void;
+    values(opts?: {
+        since?: number;
+        until?: number;
+    }): T[];
+    clear(): void;
+    get size(): number;
+    private prune;
+}

package/dist/src/observation/ring-buffer.js

@@ -0,0 +1 @@
+export class RingBuffer{maxAgeMs;maxItems;now;items=[];constructor(s={}){this.maxAgeMs=s.maxAgeMs??120000;this.maxItems=s.maxItems??1000;this.now=s.now??Date.now}push(s){this.items.push(s);this.prune()}values(s={}){this.prune();return this.items.filter((t)=>{if(s.since!==void 0&&t.ts<s.since)return!1;if(s.until!==void 0&&t.ts>s.until)return!1;return!0})}clear(){this.items=[]}get size(){this.prune();return this.items.length}prune(){const s=this.now()-this.maxAgeMs;if(this.items.length>this.maxItems)this.items=this.items.slice(this.items.length-this.maxItems);if(this.maxAgeMs>0){const t=this.items.findIndex((e)=>e.ts>=s);if(t>0)this.items=this.items.slice(t);else if(t===-1)this.items=[]}}}

package/dist/src/observation/ring-buffer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/observation/session.d.ts

@@ -0,0 +1,25 @@
+import type { ObservationEvent, ObservationEventInput, ObservationScope, ObservationStream } from './events.js';
+export declare const DEFAULT_OBSERVATION_WINDOW_MS = 120000;
+export interface ObservationSessionOptions {
+    id?: string;
+    scope: ObservationScope;
+    windowMs?: number;
+    maxEventsPerStream?: number;
+    now?: () => number;
+}
+export declare class ObservationSession {
+    readonly id: string;
+    readonly scope: ObservationScope;
+    readonly startedAt: number;
+    private readonly now;
+    private counter;
+    private readonly buffers;
+    constructor(opts: ObservationSessionOptions);
+    record(input: ObservationEventInput): ObservationEvent;
+    events(opts?: {
+        stream?: ObservationStream;
+        since?: number;
+        until?: number;
+    }): ObservationEvent[];
+}
+export declare function createTraceId(now?: number | (() => number)): string;

package/dist/src/observation/session.js

@@ -0,0 +1 @@
+import{RingBuffer as r}from"./ring-buffer.js";import{randomBytes as o}from"node:crypto";export const DEFAULT_OBSERVATION_WINDOW_MS=120000;export class ObservationSession{id;scope;startedAt;now;counter=0;buffers;constructor(e){this.id=e.id??createTraceId(e.now?.()??Date.now());this.scope=e.scope;this.now=e.now??Date.now;this.startedAt=this.now();const t={maxAgeMs:e.windowMs??DEFAULT_OBSERVATION_WINDOW_MS,maxItems:e.maxEventsPerStream??1000,now:this.now};this.buffers={action:new r(t),network:new r(t),console:new r(t),screenshot:new r({...t,maxItems:Math.min(e.maxEventsPerStream??50,50)}),state:new r({...t,maxItems:Math.min(e.maxEventsPerStream??50,50)}),error:new r(t)}}record(e){const t={...e,id:e.id??`${this.id}-${++this.counter}`,ts:e.ts??this.now()};this.buffers[t.stream].push(t);return t}events(e={}){return(e.stream?[e.stream]:Object.keys(this.buffers)).flatMap((s)=>this.buffers[s].values({since:e.since,until:e.until})).sort((s,n)=>s.ts-n.ts||s.id.localeCompare(n.id))}}export function createTraceId(e=Date.now){const t=typeof e==="function"?e():e,s=o(4).toString("hex");return`${new Date(t).toISOString().replace(/[-:.TZ]/g,"").slice(0,14)}-${s}`}

package/dist/src/output.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Output formatting: table, JSON, Markdown, CSV, YAML.
+ */
+export interface RenderOptions {
+    fmt?: string;
+    /** True when the user explicitly passed -f on the command line */
+    fmtExplicit?: boolean;
+    columns?: string[];
+    title?: string;
+    elapsed?: number;
+    source?: string;
+    footerExtra?: string;
+}
+export declare function render(data: unknown, opts?: RenderOptions): void;

package/dist/src/output.js

@@ -0,0 +1,2 @@
+import O from"cli-table3";import Q from"js-yaml";function I(q){if(Array.isArray(q))return q;if(q&&typeof q==="object")return[q];return[{value:q}]}function L(q,D){return D.columns??Object.keys(q[0]??{})}export function render(q,D={}){let B=D.fmt??"table";if(!D.fmtExplicit){if(B==="table"&&!process.stdout.isTTY)B="yaml"}if(q===null||q===void 0){console.log(q);return}switch(B){case"json":U(q);break;case"plain":V(q,D);break;case"md":case"markdown":W(q,D);break;case"csv":X(q,D);break;case"yaml":case"yml":Z(q);break;default:S(q,D);break}}function S(q,D){const B=I(q);if(!B.length){console.log("(no data)");return}const F=L(B,D),G=F.map((H)=>_(H)),E=new O({head:G.map((H)=>H),style:{head:[],border:[]},wordWrap:!0,wrapOnWordBoundary:!0});for(const H of B)E.push(F.map((N)=>{const K=H[N];return K===null||K===void 0?"":String(K)}));console.log();if(D.title)console.log(`  ${D.title}`);console.log(E.toString());const A=[];A.push(`${B.length} items`);if(D.elapsed!==void 0)A.push(`${D.elapsed.toFixed(1)}s`);if(D.source)A.push(D.source);if(D.footerExtra)A.push(D.footerExtra);console.log(A.join(" · "))}function U(q){console.log(JSON.stringify(q,null,2))}function V(q,D){const B=I(q);if(!B.length)return;if(B.length===1){const F=B[0],G=Object.entries(F);if(G.length===1){const[E,A]=G[0];if(E==="response"||E==="content"||E==="markdown"||E==="text"||E==="value"){console.log(String(A??""));return}}}B.forEach((F,G)=>{Object.entries(F).filter(([,A])=>A!==void 0&&A!==null&&String(A)!=="").forEach(([A,H])=>{console.log(`${A}: ${H}`)});if(G<B.length-1)console.log("")})}function W(q,D){const B=I(q);if(!B.length)return;if(B.length===1){const E=Object.entries(B[0]);if(E.length===1){const[A,H]=E[0];if(A==="content"||A==="markdown"||A==="text"||A==="value"){console.log(String(H??""));return}}}const F=L(B,D),G=(E)=>E.replace(/\|/g,"\\|").replace(/\r\n|\r|\n/g,"<br>");console.log("| "+F.map(G).join(" | ")+" |");console.log("| "+F.map(()=>"---").join(" | ")+" |");for(const E of B)console.log("| "+F.map((A)=>G(String(E[A]??""))).join(" | ")+" |")}function X(q,D){const B=I(q);if(!B.length)return;const F=L(B,D);console.log(F.join(","));for(const G of B)console.log(F.map((E)=>{const A=String(G[E]??"");return A.includes(",")||A.includes('"')||A.includes(`
+`)||A.includes("\r")?`"${A.replace(/"/g,'""')}"`:A}).join(","))}function Z(q){console.log(Q.dump(q,{sortKeys:!1,lineWidth:120,noRefs:!0}))}function _(q){return q.charAt(0).toUpperCase()+q.slice(1)}

package/dist/src/output.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/package-exports.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/package-paths.d.ts

@@ -0,0 +1,8 @@
+export interface PackageJsonLike {
+    bin?: string | Record<string, string>;
+    main?: string;
+}
+export declare function findPackageRoot(startFile: string, fileExists?: (candidate: string) => boolean): string;
+export declare function getBuiltEntryCandidates(packageRoot: string, readFile?: (filePath: string) => string): string[];
+export declare function getCliManifestPath(clisDir: string): string;
+export declare function getFetchAdaptersScriptPath(packageRoot: string): string;

package/dist/src/package-paths.js

@@ -0,0 +1 @@
+import*as A from"node:fs";import*as w from"node:path";export function findPackageRoot(j,z=A.existsSync){let q=w.dirname(j);while(!0){if(z(w.join(q,"package.json")))return q;const v=w.dirname(q);if(v===q)throw Error(`Could not find package.json above ${j}`);q=v}}export function getBuiltEntryCandidates(j,z=(q)=>A.readFileSync(q,"utf-8")){const q=[];try{const v=JSON.parse(z(w.join(j,"package.json")));if(typeof v.bin==="string")q.push(w.join(j,v.bin));else if(v.bin&&typeof v.bin==="object"&&typeof v.bin.opencli==="string")q.push(w.join(j,v.bin.opencli));if(typeof v.main==="string")q.push(w.join(j,v.main))}catch{}q.push(w.join(j,"dist","src","main.js"),w.join(j,"dist","main.js"));return[...new Set(q)]}export function getCliManifestPath(j){return w.resolve(j,"..","cli-manifest.json")}export function getFetchAdaptersScriptPath(j){return w.join(j,"scripts","fetch-adapters.js")}

package/dist/src/pipeline/executor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pipeline executor: runs YAML pipeline steps sequentially.
+ */
+import type { IPage } from '../types.js';
+export interface PipelineContext {
+    args?: Record<string, unknown>;
+    debug?: boolean;
+    /** Max retry attempts per step (default: 2 for browser steps, 0 for others) */
+    stepRetries?: number;
+}
+export declare function executePipeline(page: IPage | null, pipeline: unknown[], ctx?: PipelineContext): Promise<unknown>;

package/dist/src/pipeline/executor.js

@@ -0,0 +1 @@
+import{getStep as X}from"./registry.js";import{log as K}from"../logger.js";import{ConfigError as Z}from"../errors.js";import{BROWSER_ONLY_STEPS as $}from"../capabilityRouting.js";import{isTransientBrowserError as k}from"../browser/errors.js";export async function executePipeline(G,q,A={}){const z=A.args??{},H=A.debug??!1;let I=null;const Q=q.length;try{for(let D=0;D<q.length;D++){const J=q[D];if(!J||typeof J!=="object")continue;for(const[F,M]of Object.entries(J)){if(H)L(D+1,Q,F,M);const V=X(F);if(V)I=await C(V,G,M,I,z,F,A.stepRetries);else throw new Z(`Unknown pipeline step "${F}" at index ${D}.`,"Check the YAML pipeline step name or register the custom step before execution.");if(H)P(F,I)}}}catch(D){if(G?.closeWindow)try{await G.closeWindow()}catch{}throw D}return I}async function C(G,q,A,z,H,I,Q){const D=Q??($.has(I)?2:0);for(let J=0;J<=D;J++)try{return await G(q,A,z,H)}catch(F){if(J>=D)throw F;if(!k(F))throw F;await new Promise((M)=>setTimeout(M,1000))}throw Error(`Step "${I}" failed after ${D} retries`)}function L(G,q,A,z){let H="";if(typeof z==="string")H=z.length<=80?` → ${z}`:` → ${z.slice(0,77)}...`;else if(z&&typeof z==="object"&&!Array.isArray(z))H=` (${Object.keys(z).join(", ")})`;K.step(G,q,A,H)}function P(G,q){if(q===null||q===void 0)K.stepResult("(no data)");else if(Array.isArray(q))K.stepResult(`${q.length} items`);else if(typeof q==="object"){const A=Object.keys(q).slice(0,5);K.stepResult(`dict (${A.join(", ")}${Object.keys(q).length>5?"...":""})`)}else if(typeof q==="string"){const A=q.slice(0,60).replace(/\n/g,"\\n");K.stepResult(`"${A}${q.length>60?"...":""}"`)}else K.stepResult(`${typeof q}`)}

package/dist/src/pipeline/executor.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for pipeline/executor.ts: pipeline execution with mock page.
+ */
+export {};

package/dist/src/pipeline/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Pipeline module: re-exports for backward compatibility.
+ */
+export { executePipeline, type PipelineContext } from './executor.js';
+export { render, evalExpr, resolvePath, normalizeEvaluateSource, type RenderContext } from './template.js';

package/dist/src/pipeline/index.js

@@ -0,0 +1 @@
+export{executePipeline}from"./executor.js";export{render,evalExpr,resolvePath,normalizeEvaluateSource}from"./template.js";

package/dist/src/pipeline/registry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Dynamic registry for pipeline steps.
+ * Allows core and third-party plugins to register custom YAML operations.
+ */
+import type { IPage } from '../types.js';
+/**
+ * Step handler: all pipeline steps conform to this generic interface.
+ * TData is the type of the `data` state flowing into the step.
+ * TResult is the expected return type.
+ */
+export type StepHandler<TData = unknown, TResult = unknown, TParams = unknown> = (page: IPage | null, params: TParams, data: TData, args: Record<string, unknown>) => Promise<TResult>;
+/**
+ * Get a registered step handler by name.
+ */
+export declare function getStep(name: string): StepHandler | undefined;
+/**
+ * List all currently registered step names. Used by `validate.ts` to allowlist
+ * step names without maintaining a parallel hand-coded list.
+ *
+ * Note: this depends on registerStep() side effects below already having run.
+ * Importing this module triggers all core registrations at the bottom of the
+ * file, so the returned array reflects every core + plugin step at call time.
+ */
+export declare function getRegisteredStepNames(): string[];
+/**
+ * Register a new custom step handler for the YAML pipeline.
+ */
+export declare function registerStep(name: string, handler: StepHandler): void;

package/dist/src/pipeline/registry.js

@@ -0,0 +1 @@
+import{stepNavigate as A,stepClick as B,stepType as G,stepFill as H,stepWait as J,stepPress as K,stepSnapshot as O,stepEvaluate as Q}from"./steps/browser.js";import{stepFetch as U}from"./steps/fetch.js";import{stepSelect as V,stepMap as X,stepFilter as Y,stepSort as Z,stepLimit as $}from"./steps/transform.js";import{stepIntercept as b}from"./steps/intercept.js";import{stepTap as k}from"./steps/tap.js";import{stepDownload as u}from"./steps/download.js";const x=new Map;export function getStep(q){return x.get(q)}export function getRegisteredStepNames(){return[...x.keys()]}export function registerStep(q,z){x.set(q,z)}registerStep("navigate",A);registerStep("fetch",U);registerStep("select",V);registerStep("evaluate",Q);registerStep("snapshot",O);registerStep("click",B);registerStep("type",G);registerStep("fill",H);registerStep("wait",J);registerStep("press",K);registerStep("map",X);registerStep("filter",Y);registerStep("sort",Z);registerStep("limit",$);registerStep("intercept",b);registerStep("tap",k);registerStep("download",u);

package/dist/src/pipeline/steps/browser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Pipeline step: navigate, click, type, wait, press, snapshot.
+ * Browser interaction primitives.
+ */
+import type { IPage } from '../../types.js';
+export declare function stepNavigate(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepClick(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepType(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepFill(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepWait(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepPress(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepSnapshot(page: IPage | null, params: unknown, _data: unknown, _args: Record<string, unknown>): Promise<unknown>;
+export declare function stepEvaluate(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;

package/dist/src/pipeline/steps/browser.js

@@ -0,0 +1 @@
+import{render as z}from"../template.js";import{isRecord as D}from"../../utils.js";export async function stepNavigate(k,b,h,q){if(D(b)&&"url"in b){const v=String(z(b.url,{args:q,data:h}));await k.goto(v,{waitUntil:b.waitUntil,settleMs:typeof b.settleMs==="number"?b.settleMs:void 0})}else{const v=z(b,{args:q,data:h});await k.goto(String(v))}return h}export async function stepClick(k,b,h,q){await k.click(String(z(b,{args:q,data:h})).replace(/^@/,""));return h}export async function stepType(k,b,h,q){if(D(b)){const v=String(z(b.ref??"",{args:q,data:h})).replace(/^@/,""),A=String(z(b.text??"",{args:q,data:h}));await k.typeText(v,A);if(b.submit)await k.pressKey("Enter")}return h}export async function stepFill(k,b,h,q){if(D(b)){const v=String(z(b.ref??"",{args:q,data:h})).replace(/^@/,""),A=String(z(b.text??"",{args:q,data:h}));await k.fillText(v,A);if(b.submit)await k.pressKey("Enter")}return h}export async function stepWait(k,b,h,q){if(typeof b==="number")await k.wait(b);else if(D(b)){if("text"in b)await k.wait({text:String(z(b.text,{args:q,data:h})),timeout:typeof b.timeout==="number"?b.timeout:void 0});else if("time"in b)await k.wait(Number(b.time))}else if(typeof b==="string")await k.wait(Number(z(b,{args:q,data:h})));return h}export async function stepPress(k,b,h,q){await k.pressKey(String(z(b,{args:q,data:h})));return h}export async function stepSnapshot(k,b,h,q){const v=D(b)?b:{};return k.snapshot({interactive:typeof v.interactive==="boolean"?v.interactive:!1,compact:typeof v.compact==="boolean"?v.compact:!1,maxDepth:typeof v.max_depth==="number"?v.max_depth:void 0,raw:typeof v.raw==="boolean"?v.raw:!1})}export async function stepEvaluate(k,b,h,q){const v=String(z(b,{args:q,data:h}));let A=await k.evaluate(v);if(typeof A==="string"){const C=A.trim();if(C.startsWith("[")&&C.endsWith("]")||C.startsWith("{")&&C.endsWith("}"))try{A=JSON.parse(C)}catch{}}return A}

package/dist/src/pipeline/steps/download.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pipeline step: download — file download with concurrency and progress.
+ *
+ * Supports:
+ * - Direct HTTP downloads (images, documents)
+ * - yt-dlp integration for video platforms
+ * - Browser cookie forwarding for authenticated downloads
+ * - Filename templating and deduplication
+ */
+import type { IPage } from '../../types.js';
+export interface DownloadResult {
+    status: 'success' | 'skipped' | 'failed';
+    path?: string;
+    size?: number;
+    error?: string;
+    duration?: number;
+}
+export declare function stepDownload(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;

package/dist/src/pipeline/steps/download.js

@@ -0,0 +1 @@
+import*as S from"node:fs";import*as H from"node:path";import{render as M}from"../template.js";import{getErrorMessage as m}from"../../errors.js";import{httpDownload as p,ytdlpDownload as d,saveDocument as i,detectContentType as s,requiresYtdlp as j,sanitizeFilename as o,generateFilename as t,exportCookiesToNetscape as r,getTempDir as a,formatCookieHeader as e}from"../../download/index.js";import{DownloadProgressTracker as bb,formatBytes as Y}from"../../download/progress.js";import{mapConcurrent as Gb}from"../../utils.js";async function Jb(V,O){try{const b=await V.getCookies({domain:O});return e(b)}catch{return""}}async function Kb(V,O){try{return(await V.getCookies({domain:O})).filter((J)=>J.name).map((J)=>({name:J.name,value:J.value,domain:J.domain,path:J.path??"/",secure:J.secure??!1,httpOnly:J.httpOnly??!1}))}catch{return[]}}function Lb(V){const O=new Map;for(const b of V)O.set(`${b.domain}	${b.path}	${b.name}`,b);return[...O.values()]}export async function stepDownload(V,O,b,J){const K=typeof O==="object"&&O!==null?O:{},q=typeof O==="string"?O:K.url??"",h=K.dir??"./downloads",v=K.filename??"",y=typeof K.concurrency==="number"?K.concurrency:3,T=K.skip_existing!==!1,f=typeof K.timeout==="number"?K.timeout*1000:30000,A=K.use_ytdlp??!1,x=Array.isArray(K.ytdlp_args)?K.ytdlp_args.map((L)=>String(L)):[],F=K.type??"auto",u=K.progress!==!1,w=K.content,C=K.metadata,D=String(M(h,{args:J,data:b}));S.mkdirSync(D,{recursive:!0});const E=Array.isArray(b)?b:b?[b]:[];if(E.length===0)return[];const U=new bb(E.length,u),P=new Map;let N;if(V){if(A||E.some((L,R)=>{const W=String(M(q,{args:J,data:b,item:L,index:R}));return j(W)}))try{const L=[...new Set(E.flatMap((W,_)=>{const X=String(M(q,{args:J,data:b,item:W,index:_}));if(!A&&!j(X))return[];try{return[new URL(X).hostname]}catch{return[]}}))],R=Lb((await Promise.all(L.map((W)=>Kb(V,W)))).flat());if(R.length>0){const W=a();S.mkdirSync(W,{recursive:!0});N=H.join(W,`cookies_${Date.now()}.txt`);r(R,N)}}catch{}}const g=await Gb(E,y,async(L,R)=>{const W=Date.now(),_=String(M(q,{args:J,data:b,item:L,index:R}));if(!_){U.onFileComplete(!1);return{...L,_download:{status:"failed",error:"Empty URL"}}}let X;if(v)X=String(M(v,{args:J,data:b,item:L,index:R}));else X=t(_,R);X=o(X);const I=H.join(D,X);if(T&&S.existsSync(I)){U.onFileComplete(!0,!0);return{...L,_download:{status:"skipped",path:I,size:S.statSync(I).size}}}const Q=U.onFileStart(X,R),B=F==="auto"?s(_):F,k=A||B==="video"&&j(_);let G;try{if(B==="document"&&w){const $=String(M(w,{args:J,data:b,item:L,index:R})),Z=C?Object.fromEntries(Object.entries(C).map(([n,l])=>[n,M(l,{args:J,data:b,item:L,index:R})])):void 0,z=H.extname(X).toLowerCase();G=await i($,I,z===".json"?"json":z===".html"?"html":"markdown",Z);if(Q)Q.complete(G.success,G.success?Y(G.size):void 0)}else if(k){G=await d(_,I,{cookiesFile:N,extraArgs:x,onProgress:($)=>{if(Q)Q.update($,100)}});if(Q)Q.complete(G.success,G.success?Y(G.size):void 0)}else{let $="";if(V)try{const Z=new URL(_).hostname;let z=P.get(Z);if(!z){z=Jb(V,Z);P.set(Z,z)}$=await z}catch{$=""}G=await p(_,I,{cookies:$,timeout:f,onProgress:(Z,z)=>{if(Q)Q.update(Z,z)}});if(Q)Q.complete(G.success,G.success?Y(G.size):void 0)}}catch($){const Z=m($);G={success:!1,size:0,error:Z};if(Q)Q.fail(Z)}U.onFileComplete(G.success);const c=Date.now()-W;return{...L,_download:{status:G.success?"success":"failed",path:G.success?I:void 0,size:G.size,error:G.error,duration:c}}});if(N&&S.existsSync(N))try{S.unlinkSync(N)}catch{}U.finish();return g}

package/dist/src/pipeline/steps/download.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/pipeline/steps/fetch.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Pipeline step: fetch — HTTP API requests.
+ */
+import type { IPage } from '../../types.js';
+export declare function stepFetch(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;

package/dist/src/pipeline/steps/fetch.js

@@ -0,0 +1,31 @@
+import{CliError as x,getErrorMessage as E}from"../../errors.js";import{log as k}from"../../logger.js";import{render as w}from"../template.js";import{isRecord as _,mapConcurrent as I}from"../../utils.js";const R=/\$\{\{[^}]*\b(?:item|index)\b[^}]*\}\}/;async function v(Z,$,A,V,F,D,z){const Y={};for(const[K,C]of Object.entries(V))Y[K]=String(w(C,{args:D,data:z}));const G={};for(const[K,C]of Object.entries(F))G[K]=String(w(C,{args:D,data:z}));let X=$;if(Object.keys(Y).length>0){const K=new URLSearchParams(Y).toString();X=`${X}${X.includes("?")?"&":"?"}${K}`}if(Z===null){const K=await fetch(X,{method:A.toUpperCase(),headers:G});if(!K.ok)throw new x("FETCH_ERROR",`HTTP ${K.status} ${K.statusText} from ${X}`);return K.json()}return Z.fetchJson(X,{method:A.toUpperCase(),headers:G})}async function T(Z,$,A,V,F){const D=JSON.stringify(V),z=JSON.stringify($),Y=JSON.stringify(A);return await Z.evaluate(`
+    async () => {
+      const urls = ${z};
+      const method = ${Y};
+      const headers = ${D};
+      const concurrency = ${F};
+
+      const results = new Array(urls.length);
+      let idx = 0;
+
+      async function worker() {
+        while (idx < urls.length) {
+          const i = idx++;
+          try {
+            const resp = await fetch(urls[i], { method, headers, credentials: "include" });
+            if (!resp.ok) {
+              throw new Error('HTTP ' + resp.status + ' ' + resp.statusText + ' from ' + urls[i]);
+            }
+            results[i] = await resp.json();
+          } catch (e) {
+            results[i] = { error: e instanceof Error ? e.message : String(e) };
+            // Note: getErrorMessage() is a Node.js utility — can't use it inside evaluate()
+          }
+        }
+      }
+
+      const workers = Array.from({ length: Math.min(concurrency, urls.length) }, () => worker());
+      await Promise.all(workers);
+      return results;
+    }
+  `)}export async function stepFetch(Z,$,A,V){const F=_($)?$:{},D=typeof $==="string"?$:F.url??"",z=typeof F.method==="string"?F.method:"GET",Y=_(F.params)?F.params:{},G=_(F.headers)?F.headers:{},X=String(D);if(Array.isArray(A)&&R.test(X)){const C=typeof F.concurrency==="number"?F.concurrency:5,B={};for(const[W,L]of Object.entries(G))B[W]=String(w(L,{args:V,data:A}));const M={};for(const[W,L]of Object.entries(Y))M[W]=String(w(L,{args:V,data:A}));const J=A.map((W,L)=>{let Q=String(w(X,{args:V,data:A,item:W,index:L}));if(Object.keys(M).length>0){const S=new URLSearchParams(M).toString();Q=`${Q}${Q.includes("?")?"&":"?"}${S}`}return Q});if(Z!==null){const W=await T(Z,J,z.toUpperCase(),B,C);for(let L=0;L<W.length;L++){const Q=W[L];if(Q&&typeof Q==="object"&&"error"in Q)k.warn(`Batch fetch failed for ${J[L]}: ${Q.error}`)}return W}return I(A,C,async(W,L)=>{const Q=String(w(X,{args:V,data:A,item:W,index:L}));try{return await v(null,Q,z,Y,G,V,A)}catch(S){const N=E(S);k.warn(`Batch fetch failed for ${Q}: ${N}`);return{error:N}}})}const K=w(D,{args:V,data:A});return v(Z,String(K),z,Y,G,V,A)}

package/dist/src/pipeline/steps/fetch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/pipeline/steps/intercept.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Pipeline step: intercept — declarative XHR interception.
+ */
+import type { IPage } from '../../types.js';
+export declare function stepIntercept(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;

package/dist/src/pipeline/steps/intercept.js

@@ -0,0 +1 @@
+import{render as D,normalizeEvaluateSource as J}from"../template.js";export async function stepIntercept(k,B,w,C){const y=typeof B==="object"&&B!==null?B:{},q=y.trigger??"",F=y.capture??"",H=y.timeout??8,G=y.select??null;if(!F)return w;await k.installInterceptor(F);if(q.startsWith("navigate:")){const b=D(q.slice(9),{args:C,data:w});await k.goto(String(b))}else if(q.startsWith("evaluate:")){const b=q.slice(9);await k.evaluate(J(D(b,{args:C,data:w})))}else if(q.startsWith("click:")){const b=D(q.slice(6),{args:C,data:w});await k.click(String(b).replace(/^@/,""))}else if(q==="scroll")await k.scroll("down");await k.waitForCapture(H);const A=await k.getInterceptedRequests();let x=A.length===1?A[0]:A.length>1?A:w;if(G&&x){let b=x;for(const I of String(G).split("."))if(b&&typeof b==="object"&&!Array.isArray(b))b=b[I];else break;x=b??x}return x}

package/dist/src/pipeline/steps/tap.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Pipeline step: tap — declarative Store Action Bridge.
+ *
+ * Generates a self-contained IIFE that:
+ * 1. Injects fetch + XHR dual interception proxy
+ * 2. Finds the Pinia/Vuex store and calls the action
+ * 3. Captures the response matching the URL pattern
+ * 4. Auto-cleans up interception in finally block
+ * 5. Returns the captured data (optionally sub-selected)
+ */
+import type { IPage } from '../../types.js';
+export declare function stepTap(page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;

package/dist/src/pipeline/steps/tap.js

@@ -0,0 +1,53 @@
+import{render as z}from"../template.js";import{generateTapInterceptorJs as _}from"../../interceptor.js";import{CliError as $}from"../../errors.js";export async function stepTap(L,B,x,y){const q=typeof B==="object"&&B!==null?B:{},F=String(z(q.store??"",{args:y,data:x})),v=String(z(q.action??"",{args:y,data:x})),M=String(z(q.capture??"",{args:y,data:x})),O=q.timeout??5,G=q.select?String(z(q.select,{args:y,data:x})):null,Q=q.framework??null,S=q.args??[];if(!F||!v)throw new $("TAP_MISSING_PARAMS","tap: store and action are required");const V=G?G.split(".").map((D)=>`?.[${JSON.stringify(D)}]`).join(""):"",K=S.map((D)=>{const Z=z(D,{args:y,data:x});return JSON.stringify(Z)}),W=K.length?`store[${JSON.stringify(v)}](${K.join(", ")})`:`store[${JSON.stringify(v)}]()`,b=_(JSON.stringify(M)),Y=`
+    async () => {
+      // ── 1. Setup capture proxy (fetch + XHR dual interception) ──
+      ${b.setupVar}
+      ${b.fetchPatch}
+      ${b.xhrPatch}
+
+      try {
+        // ── 2. Find store ──
+        let store = null;
+        const storeName = ${JSON.stringify(F)};
+        const fw = ${JSON.stringify(Q)};
+
+        const app = document.querySelector('#app');
+        if (!fw || fw === 'pinia') {
+          try {
+            const pinia = app?.__vue_app__?.config?.globalProperties?.$pinia;
+            if (pinia?._s) store = pinia._s.get(storeName);
+          } catch {}
+        }
+        if (!store && (!fw || fw === 'vuex')) {
+          try {
+            const vuexStore = app?.__vue_app__?.config?.globalProperties?.$store
+              ?? app?.__vue__?.$store;
+            if (vuexStore) {
+              store = { [${JSON.stringify(v)}]: (...a) => vuexStore.dispatch(storeName + '/' + ${JSON.stringify(v)}, ...a) };
+            }
+          } catch {}
+        }
+
+        if (!store) return { error: 'Store not found: ' + storeName, hint: 'Page may not be fully loaded or store name may be incorrect' };
+        if (typeof store[${JSON.stringify(v)}] !== 'function') {
+          return { error: 'Action not found: ' + ${JSON.stringify(v)} + ' on store ' + storeName,
+            hint: 'Available: ' + Object.keys(store).filter(k => typeof store[k] === 'function' && !k.startsWith('$') && !k.startsWith('_')).join(', ') };
+        }
+
+        // ── 3. Call store action ──
+        await ${W};
+
+        // ── 4. Wait for network response ──
+        if (!${b.capturedVar}) {
+          const timeoutPromise = new Promise(r => setTimeout(r, ${O} * 1000));
+          await Promise.race([${b.promiseVar}, timeoutPromise]);
+        }
+      } finally {
+        // ── 5. Always restore originals ──
+        ${b.restorePatch}
+      }
+
+      if (!${b.capturedVar}) return { error: 'No matching response captured for pattern: ' + capturePattern };
+      return ${b.capturedVar}${V} ?? ${b.capturedVar};
+    }
+  `;return L.evaluate(Y)}

package/dist/src/pipeline/steps/transform.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pipeline steps: data transforms — select, map, filter, sort, limit.
+ */
+import type { IPage } from '../../types.js';
+export declare function stepSelect(_page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepMap(_page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepFilter(_page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;
+export declare function stepSort(_page: IPage | null, params: unknown, data: unknown, _args: Record<string, unknown>): Promise<unknown>;
+export declare function stepLimit(_page: IPage | null, params: unknown, data: unknown, args: Record<string, unknown>): Promise<unknown>;

package/dist/src/pipeline/steps/transform.js

@@ -0,0 +1 @@
+import{render as Q,evalExpr as U}from"../template.js";import{isRecord as I}from"../../utils.js";export async function stepSelect(G,A,q,C){const z=String(Q(A,{args:C,data:q}));if(q&&typeof q==="object"){let B=q;for(const D of z.split("."))if(I(B))B=B[D];else if(Array.isArray(B)&&/^\d+$/.test(D))B=B[parseInt(D,10)];else return null;return B}return q}export async function stepMap(G,A,q,C){if(!q||typeof q!=="object")return q;let z=q;if(I(A)&&"select"in A)z=await stepSelect(null,A.select,q,C);if(!z||typeof z!=="object")return z;let B=Array.isArray(z)?z:[z];if(I(z)&&Array.isArray(z.data))B=z.data;const D=[],M=I(A)?A:{};for(let J=0;J<B.length;J++){const O=B[J],K={};for(const[L,H]of Object.entries(M)){if(L==="select")continue;K[L]=Q(H,{args:C,data:z,root:q,item:O,index:J})}D.push(K)}return D}export async function stepFilter(G,A,q,C){if(!Array.isArray(q))return q;return q.filter((z,B)=>U(String(A),{args:C,item:z,index:B}))}function T(G){return typeof G==="number"&&Number.isFinite(G)?G:null}export async function stepSort(G,A,q,C){if(!Array.isArray(q))return q;const z=I(A)?String(A.by??""):String(A),B=I(A)?A.order==="desc":!1;return[...q].sort((D,M)=>{const J=I(D)?D[z]:void 0,O=I(M)?M[z]:void 0,K=T(J),L=T(O);let H;if(K!==null&&L!==null)H=K-L;else if(K!==null)H=-1;else if(L!==null)H=1;else H=String(J??"").localeCompare(String(O??""),void 0,{numeric:!0});return B?-H:H})}export async function stepLimit(G,A,q,C){if(!Array.isArray(q))return q;return q.slice(0,Number(Q(A,{args:C,data:q})))}

package/dist/src/pipeline/template.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Pipeline template engine: ${{ ... }} expression rendering.
+ */
+export interface RenderContext {
+    args?: Record<string, unknown>;
+    data?: unknown;
+    root?: unknown;
+    item?: unknown;
+    index?: number;
+}
+export declare function render(template: unknown, ctx: RenderContext): unknown;
+export declare function evalExpr(expr: string, ctx: RenderContext): unknown;
+export declare function resolvePath(pathStr: string, ctx: RenderContext): unknown;
+/**
+ * Normalize JavaScript source for browser evaluate() calls.
+ */
+export declare function normalizeEvaluateSource(source: string): string;

package/dist/src/pipeline/template.js

@@ -0,0 +1 @@
+import P from"node:vm";import{isRecord as I}from"../utils.js";import{log as M}from"../logger.js";export function render(G,q){if(typeof G!=="string")return G;const $=G.trim(),Q=$.match(/^\$\{\{\s*([^}]*(?:\}[^}][^}]*)*)\s*\}\}$/);if(Q&&!$.includes("}}-")&&!$.includes("}}${{"))return evalExpr(Q[1].trim(),q);const Z=$.match(/^\$\{\{\s*([\s\S]*?)\s*\}\}$/);if(Z){const Y=Z[1];if(!Y.includes("${{"))return evalExpr(Y.trim(),q)}return G.replace(/\$\{\{\s*(.*?)\s*\}\}/g,(Y,U)=>String(evalExpr(U.trim(),q)))}export function evalExpr(G,q){const $=q.args??{},Q=q.item??{},Z=q.data,Y=q.root,U=q.index??0,k=G.split(/(?<!\|)\|(?!\|)/).map((B)=>B.trim());if(k.length>1){let B=evalExpr(k[0],q);for(let H=1;H<k.length;H++)B=T(k[H],B);return B}const F=G.match(/^(['"])(.*)\1$/);if(F)return F[2];if(/^\d+(\.\d+)?$/.test(G))return Number(G);const W=resolvePath(G,{args:$,item:Q,data:Z,root:Y,index:U});if(W!==null&&W!==void 0)return W;return R(G,{args:$,item:Q,data:Z,root:Y,index:U})}function T(G,q){const $=G.match(/^(\w+)(?:\((.+)\))?$/);if(!$)return q;const[,Q,Z]=$,Y=Z?.replace(/^['"]|['"]$/g,"")??"";switch(Q){case"default":{if(q===null||q===void 0||q===""){const U=parseInt(Y,10);if(!Number.isNaN(U)&&String(U)===Y.trim())return U;return Y}return q}case"join":return Array.isArray(q)?q.join(Y||", "):q;case"upper":return typeof q==="string"?q.toUpperCase():q;case"lower":return typeof q==="string"?q.toLowerCase():q;case"trim":return typeof q==="string"?q.trim():q;case"truncate":{const U=parseInt(Y,10)||50;return typeof q==="string"&&q.length>U?`${q.slice(0,U)}...`:q}case"replace":{if(typeof q!=="string")return q;if(Z==null)return q;const U=Z.indexOf(",");if(U===-1)return q;const k=(B)=>B.trim().replace(/^['"]|['"]$/g,""),F=k(Z.slice(0,U)),W=k(Z.slice(U+1));return q.replaceAll(F,W)}case"keys":return q&&typeof q==="object"?Object.keys(q):q;case"length":return Array.isArray(q)?q.length:typeof q==="string"?q.length:q;case"first":return Array.isArray(q)?q[0]:q;case"last":return Array.isArray(q)?q[q.length-1]:q;case"json":return JSON.stringify(q??null);case"slugify":return typeof q==="string"?q.toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"-").replace(/^-|-$/g,""):q;case"sanitize":return typeof q==="string"?q.replace(/[<>:"/\\|?*\x00-\x1f]/g,"_"):q;case"ext":{if(typeof q!=="string")return q;const U=q.lastIndexOf("."),k=Math.max(q.lastIndexOf("/"),q.lastIndexOf("\\"));return U>k?q.slice(U):""}case"basename":{if(typeof q!=="string")return q;const U=q.split(/[/\\]/);return U[U.length-1]||q}case"urlencode":return typeof q==="string"?encodeURIComponent(q):q;case"urldecode":return typeof q==="string"?decodeURIComponent(q):q;default:return q}}export function resolvePath(G,q){const $=q.args??{},Q=q.item??{},Z=q.data,Y=q.root,U=q.index??0,k=G.split("."),F=k[0];let W,B;if(F==="args"){W=$;B=k.slice(1)}else if(F==="item"){W=Q;B=k.slice(1)}else if(F==="data"){W=Z;B=k.slice(1)}else if(F==="root"){W=Y;B=k.slice(1)}else if(F==="index")return U;else{W=Q;B=k}for(const H of B)if(I(W))W=W[H];else if(Array.isArray(W)&&/^\d+$/.test(H))W=W[parseInt(H,10)];else return null;return W}const y=/\b(constructor|__proto__|prototype|globalThis|process|require|import|eval)\b/,X=new WeakMap;function L(G){if(G===null||G===void 0)return G;if(typeof G!=="object"&&typeof G!=="function")return G;const q=G,$=X.get(q);if($!==void 0)return JSON.parse($);try{const Q=JSON.stringify(G,(Z,Y)=>typeof Y==="bigint"?Y.toString():Y);X.set(q,Q);return JSON.parse(Q)}catch(Q){M.warn(`[pipeline/template] sanitizeContext failed: ${Q instanceof Error?Q.message:String(Q)}. Returning {} for this branch. Likely cause: circular reference, Symbol, or other non-serializable value in pipeline context.`);return{}}}const D=256,J=new Map;function V(G){let q=J.get(G);if(q)return q;if(J.size>=D){const $=J.keys().next().value;if($!==void 0)J.delete($)}q=new P.Script(`(${G})`);J.set(G,q);return q}let K=null,O=null;function w(){if(K&&O)return{sandbox:K,context:O};K={args:{},item:{},data:null,root:null,index:0,encodeURIComponent,decodeURIComponent,JSON,Math,Number,String,Boolean,Array,Date};O=P.createContext(K,{codeGeneration:{strings:!1,wasm:!1}});return{sandbox:K,context:O}}const z=new Set(["args","item","data","root","index","encodeURIComponent","decodeURIComponent","JSON","Math","Number","String","Boolean","Array","Date"]);function R(G,q){if(G.length>2000)return;if(y.test(G))return;try{const $=V(G),{sandbox:Q,context:Z}=w();for(const Y of Object.keys(Q))if(!z.has(Y))delete Q[Y];Q.args=L(q.args??{});Q.item=L(q.item??{});Q.data=L(q.data);Q.root=L(q.root);Q.index=q.index??0;return $.runInContext(Z,{timeout:50})}catch{return}}export function normalizeEvaluateSource(G){const q=G.trim();if(!q)return"() => undefined";if(q.startsWith("(")&&q.endsWith(")()"))return`() => (${q})`;if(/^(async\s+)?\([^)]*\)\s*=>/.test(q))return q;if(/^(async\s+)?[A-Za-z_][A-Za-z0-9_]*\s*=>/.test(q))return q;if(q.startsWith("function ")||q.startsWith("async function "))return q;return`() => (${q})`}

package/dist/src/pipeline/template.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for the pipeline template engine: render, evalExpr, resolvePath.
+ */
+export {};

package/dist/src/pipeline/transform.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for pipeline transform steps: select, map, filter, sort, limit.
+ */
+export {};

package/dist/src/plugin-manifest.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Plugin manifest: reads and validates opencli-plugin.json files.
+ *
+ * Supports two modes:
+ * 1. Single plugin: repo root IS the plugin directory.
+ * 2. Monorepo: repo contains multiple plugins declared in `plugins` field.
+ */
+export interface SubPluginEntry {
+    /** Relative path from repo root to the sub-plugin directory. */
+    path: string;
+    version?: string;
+    description?: string;
+    /** Semver range for opencli compatibility (overrides top-level). */
+    opencli?: string;
+    /** When true, this sub-plugin is skipped during install. */
+    disabled?: boolean;
+}
+export interface PluginManifest {
+    /** Plugin name (single-plugin mode). */
+    name?: string;
+    /** Semantic version of the plugin (single-plugin mode). */
+    version?: string;
+    /** Semver range for opencli compatibility, e.g. ">=1.0.0". */
+    opencli?: string;
+    /** Human-readable description. */
+    description?: string;
+    /** Monorepo sub-plugins. Key = logical plugin name. */
+    plugins?: Record<string, SubPluginEntry>;
+}
+export declare const MANIFEST_FILENAME = "opencli-plugin.json";
+/**
+ * Read and parse opencli-plugin.json from a directory.
+ * Returns null if the file does not exist or is unparseable.
+ */
+export declare function readPluginManifest(dir: string): PluginManifest | null;
+/** Returns true when the manifest declares a monorepo (has `plugins` field). */
+export declare function isMonorepo(manifest: PluginManifest): boolean;
+/**
+ * Get the list of enabled sub-plugins from a monorepo manifest.
+ * Returns entries sorted by key name.
+ */
+export declare function getEnabledPlugins(manifest: PluginManifest): Array<{
+    name: string;
+    entry: SubPluginEntry;
+}>;
+/**
+ * Check if the current opencli version satisfies a semver range string.
+ *
+ * Supports a simplified subset of semver ranges:
+ *   ">=1.0.0"   – greater than or equal
+ *   "<=1.5.0"   – less than or equal
+ *   ">1.0.0"    – strictly greater
+ *   "<2.0.0"    – strictly less
+ *   "^1.2.0"    – compatible (>=1.2.0 and <2.0.0)
+ *   "~1.2.0"    – patch-level (>=1.2.0 and <1.3.0)
+ *   "1.2.0"     – exact match
+ *   ">=1.0.0 <2.0.0" – multiple constraints (space-separated, all must match)
+ *
+ * Returns true if compatible, false if not, and true for empty/undefined
+ * ranges (no constraint = always compatible).
+ */
+export declare function checkCompatibility(range: string | undefined): boolean;
+/** Parse a version string ("1.2.3") into [major, minor, patch]. */
+export declare function parseVersion(version: string): [number, number, number] | null;
+/**
+ * Check if a version string satisfies a range expression.
+ * Space-separated constraints are ANDed together.
+ */
+export declare function satisfiesRange(versionStr: string, range: string): boolean;
+export { readPluginManifest as _readPluginManifest, isMonorepo as _isMonorepo, getEnabledPlugins as _getEnabledPlugins, checkCompatibility as _checkCompatibility, parseVersion as _parseVersion, satisfiesRange as _satisfiesRange, };

package/dist/src/plugin-manifest.js

@@ -0,0 +1 @@
+import*as U from"node:fs";import*as W from"node:path";import{PKG_VERSION as X}from"./version.js";export const MANIFEST_FILENAME="opencli-plugin.json";export function readPluginManifest(z){const D=W.join(z,MANIFEST_FILENAME);try{const q=U.readFileSync(D,"utf-8"),J=JSON.parse(q);if(typeof J!=="object"||J===null||Array.isArray(J))return null;return J}catch{return null}}export function isMonorepo(z){return z.plugins!==void 0&&z.plugins!==null&&typeof z.plugins==="object"&&Object.keys(z.plugins).length>0}export function getEnabledPlugins(z){if(!z.plugins)return[];return Object.entries(z.plugins).filter(([,D])=>!D.disabled).map(([D,q])=>({name:D,entry:q})).sort((D,q)=>D.name.localeCompare(q.name))}export function checkCompatibility(z){if(!z||z.trim()==="")return!0;return satisfiesRange(X,z)}export function parseVersion(z){const D=z.trim().match(/^(\d+)\.(\d+)\.(\d+)/);if(!D)return null;return[parseInt(D[1],10),parseInt(D[2],10),parseInt(D[3],10)]}function H(z,D){for(let q=0;q<3;q++){if(z[q]<D[q])return-1;if(z[q]>D[q])return 1}return 0}function Y(z,D){const q=D.trim();if(!q)return!0;if(q.startsWith("^")){const B=parseVersion(q.slice(1));if(!B)return!0;const Q=[B[0]+1,0,0];return H(z,B)>=0&&H(z,Q)<0}if(q.startsWith("~")){const B=parseVersion(q.slice(1));if(!B)return!0;const Q=[B[0],B[1]+1,0];return H(z,B)>=0&&H(z,Q)<0}if(q.startsWith(">=")){const B=parseVersion(q.slice(2));if(!B)return!0;return H(z,B)>=0}if(q.startsWith("<=")){const B=parseVersion(q.slice(2));if(!B)return!0;return H(z,B)<=0}if(q.startsWith(">")){const B=parseVersion(q.slice(1));if(!B)return!0;return H(z,B)>0}if(q.startsWith("<")){const B=parseVersion(q.slice(1));if(!B)return!0;return H(z,B)<0}if(q.startsWith("=")){const B=parseVersion(q.slice(1));if(!B)return!0;return H(z,B)===0}const J=parseVersion(q);if(!J)return!0;return H(z,J)===0}export function satisfiesRange(z,D){const q=parseVersion(z);if(!q)return!0;return D.trim().split(/\s+/).every((B)=>Y(q,B))}export{readPluginManifest as _readPluginManifest,isMonorepo as _isMonorepo,getEnabledPlugins as _getEnabledPlugins,checkCompatibility as _checkCompatibility,parseVersion as _parseVersion,satisfiesRange as _satisfiesRange};

package/dist/src/plugin-manifest.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for plugin manifest: reading, validating, and compatibility checks.
+ */
+export {};

package/dist/src/plugin-scaffold.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Plugin scaffold: generates a ready-to-develop plugin directory.
+ *
+ * Usage: opencli plugin create <name> [--dir <path>]
+ *
+ * Creates:
+ *   <name>/
+ *     opencli-plugin.json   — manifest with name, version, description
+ *     package.json          — ESM package with opencli peer dependency
+ *     hello.ts              — sample pipeline command
+ *     greet.ts              — sample TS command using func()
+ *     README.md             — basic documentation
+ */
+export interface ScaffoldOptions {
+    /** Directory to create the plugin in. Defaults to `./<name>` */
+    dir?: string;
+    /** Plugin description */
+    description?: string;
+}
+export interface ScaffoldResult {
+    name: string;
+    dir: string;
+    files: string[];
+}
+/**
+ * Create a new plugin scaffold directory.
+ */
+export declare function createPluginScaffold(name: string, opts?: ScaffoldOptions): ScaffoldResult;