@vforsh/argus-core 0.1.2 → 0.1.4

package/dist/registry/types.d.ts

@@ -1,13 +1,35 @@
 /** Target matching rules for CDP selection. */
 export type WatcherMatch = {
-    /** Exact URL match against the CDP target URL. */
+    /** Substring match against the CDP target URL. */
     url?: string;
-    /** Exact title match against the CDP target title. */
+    /** Substring match against the CDP target title. */
     title?: string;
     /** JavaScript regex pattern (without flags) matched against the CDP target URL. */
     urlRegex?: string;
     /** JavaScript regex pattern (without flags) matched against the CDP target title. */
     titleRegex?: string;
+    /**
+     * Filter by target type (e.g., 'page', 'iframe', 'worker').
+     * Exact match against the Chrome target `type` field.
+     */
+    type?: string;
+    /**
+     * Match against URL origin only (protocol + host + port).
+     * Ignores path, query params, and hash. Useful for iframe matching
+     * when parent pages may include the iframe URL in query params.
+     */
+    origin?: string;
+    /**
+     * Connect to a specific target by its Chrome target ID.
+     * Bypasses URL/title matching entirely. Get target IDs from `argus page targets`.
+     */
+    targetId?: string;
+    /**
+     * Filter by parent target URL pattern.
+     * Only matches targets whose parent's URL includes this substring.
+     * Useful for targeting iframes within a specific parent page.
+     */
+    parent?: string;
 };
 /** Chrome CDP connection details. */
 export type WatcherChrome = {
@@ -38,6 +60,8 @@ export type WatcherRecord = {
     chrome?: WatcherChrome;
     /** Whether to include ISO timestamps in formatted log output. */
     includeTimestamps?: boolean;
+    /** Source mode: 'cdp' (direct Chrome connection) or 'extension' (via Chrome extension). */
+    source?: 'cdp' | 'extension';
 };
 /** Registry schema v1. */
 export type RegistryV1 = {

package/dist/registry/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG;IAC1B,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG;IAC3B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG;IAC3B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED,0BAA0B;AAC1B,MAAM,MAAM,UAAU,GAAG;IACxB,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAA;IACV,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACvC,CAAA;AAED,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG;IAChC,2EAA2E;IAC3E,QAAQ,EAAE,UAAU,CAAA;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG;IAC1B,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG;IAC3B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG;IAC3B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,2FAA2F;IAC3F,MAAM,CAAC,EAAE,KAAK,GAAG,WAAW,CAAA;CAC5B,CAAA;AAED,0BAA0B;AAC1B,MAAM,MAAM,UAAU,GAAG;IACxB,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAA;IACV,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACvC,CAAA;AAED,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG;IAChC,2EAA2E;IAC3E,QAAQ,EAAE,UAAU,CAAA;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA"}

package/dist/textPattern.d.ts

@@ -0,0 +1,23 @@
+export type TextPattern = {
+    type: 'exact';
+    value: string;
+} | {
+    type: 'regex';
+    regex: RegExp;
+};
+/**
+ * Parse a plain string or `/regex/flags` value into a reusable text pattern.
+ */
+export declare const parseTextPattern: (text: string) => TextPattern;
+/**
+ * Test whether a line matches a parsed text pattern.
+ */
+export declare const matchesTextPattern: (line: string, pattern: TextPattern) => boolean;
+/**
+ * Find the first match range for a parsed text pattern within a line.
+ */
+export declare const findTextPatternMatch: (line: string, pattern: TextPattern) => {
+    index: number;
+    length: number;
+} | null;
+//# sourceMappingURL=textPattern.d.ts.map

package/dist/textPattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textPattern.d.ts","sourceRoot":"","sources":["../src/textPattern.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAI7F;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,WAa/C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,SAAS,WAAW,KAAG,OAQvE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,SAAS,WAAW,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAgB7G,CAAA"}

package/dist/textPattern.js

@@ -0,0 +1,48 @@
+const REGEX_PATTERN = /^\/(.+)\/([imsu]*)$/;
+/**
+ * Parse a plain string or `/regex/flags` value into a reusable text pattern.
+ */
+export const parseTextPattern = (text) => {
+    const match = REGEX_PATTERN.exec(text);
+    if (!match) {
+        return { type: 'exact', value: text };
+    }
+    const [, pattern, flags] = match;
+    try {
+        return { type: 'regex', regex: new RegExp(pattern, flags) };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid regex pattern "${text}": ${msg}`);
+    }
+};
+/**
+ * Test whether a line matches a parsed text pattern.
+ */
+export const matchesTextPattern = (line, pattern) => {
+    if (pattern.type === 'exact') {
+        return line.includes(pattern.value);
+    }
+    const matched = pattern.regex.test(line);
+    pattern.regex.lastIndex = 0;
+    return matched;
+};
+/**
+ * Find the first match range for a parsed text pattern within a line.
+ */
+export const findTextPatternMatch = (line, pattern) => {
+    if (pattern.type === 'exact') {
+        const index = line.indexOf(pattern.value);
+        return index >= 0 ? { index, length: pattern.value.length } : null;
+    }
+    const matched = pattern.regex.exec(line);
+    pattern.regex.lastIndex = 0;
+    if (!matched || matched.index < 0) {
+        return null;
+    }
+    return {
+        index: matched.index,
+        length: Math.max(1, matched[0]?.length ?? 0),
+    };
+};
+//# sourceMappingURL=textPattern.js.map

package/dist/textPattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textPattern.js","sourceRoot":"","sources":["../src/textPattern.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,qBAAqB,CAAA;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAe,EAAE;IAC7D,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACtC,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,KAAK,CAAA;IAChC,IAAI,CAAC;QACJ,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,OAAQ,EAAE,KAAK,CAAC,EAAE,CAAA;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAClE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAA;IAC3D,CAAC;AACF,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,OAAoB,EAAW,EAAE;IACjF,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;IAC3B,OAAO,OAAO,CAAA;AACf,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,OAAoB,EAA4C,EAAE;IACpH,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACzC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACnE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;IAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO;QACN,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;KAC5C,CAAA;AACF,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vforsh/argus-core",
-	"version": "0.1.2",
+	"version": "0.1.4",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/vforsh/argus.git",
@@ -24,5 +24,11 @@
 	"scripts": {
 		"build": "tsc -b",
 		"typecheck": "tsc -b --pretty false --noEmit"
+	},
+	"peerDependencies": {
+		"commander": "^14.0.0"
+	},
+	"devDependencies": {
+		"commander": "^14.0.2"
 	}
 }