auspex 0.2.0 → 0.3.0

package/dist/scraper/types.d.ts

@@ -1,161 +0,0 @@
-/**
- * Qual tier foi usado para fazer o scrape:
- *  - "http"       → Tier 1: fetch nativo + Cheerio (sem browser, ~100-500ms)
- *  - "stealth"    → Tier 2: got-scraping com TLS fingerprint spoofing (~200-800ms)
- *  - "browser"    → Tier 3: Playwright Chromium (browser completo, fallback final)
- */
-export type ScrapeTier = "http" | "stealth" | "browser";
-/** Resultado interno retornado por cada tier (não exposto ao usuário final) */
-export interface TierRawResult {
-    /** HTML completo da página */
-    html: string;
-    /** URL final após redirecionamentos */
-    finalUrl: string;
-    /** HTTP status code */
-    statusCode: number;
-    /**
-     * true  = conteúdo suficiente (sem loading screen / anti-bot).
-     * false = deve tentar o próximo tier na cascata.
-     */
-    sufficient: boolean;
-}
-/** Configuração global do Scraper */
-export interface ScraperConfig {
-    /** Timeout padrão em ms. Default: 30_000 */
-    timeout?: number;
-    /**
-     * Forçar uso de um tier específico em todos os scrapes desta instância.
-     * Pode ser sobrescrito por opção na chamada de `scrape()`.
-     */
-    forceTier?: ScrapeTier;
-    /** Domínios permitidos (whitelist anti-SSRF). Qualquer URL fora da lista é rejeitada. */
-    allowedDomains?: string[];
-    /** Domínios bloqueados (blacklist anti-SSRF). */
-    blockedDomains?: string[];
-    /** Log detalhado mostrando qual tier foi usado e por quê. Default: false */
-    verbose?: boolean;
-    /** Configurações do browser Chromium (Tier 3) */
-    browserConfig?: {
-        /** Rodar em modo headless. Default: true */
-        headless?: boolean;
-        /**
-         * Canal do browser instalado no sistema.
-         * Exemplos: 'chrome', 'chromium', 'msedge'.
-         * Se omitido, tenta 'chrome' (sistema) e depois playwright-chromium.
-         */
-        channel?: string;
-        /** Caminho explícito para o executável do browser */
-        executablePath?: string;
-    };
-}
-/** Formatos de saída do conteúdo */
-export type ContentFormat = "markdown" | "html" | "text";
-/** Opções de scraping passadas pelo usuário */
-export interface ScrapeOptions {
-    /** Formatos de saída desejados. Default: ['markdown', 'text'] */
-    formats?: ContentFormat[];
-    /** Timeout em ms. Default: 30_000 */
-    timeout?: number;
-    /** Só tentar extrair o conteúdo principal (remove nav, footer, ads). Default: true */
-    onlyMainContent?: boolean;
-    /** Headers HTTP extras */
-    headers?: Record<string, string>;
-    /**
-     * Forçar uso de um tier específico (ignora a cascata automática).
-     *  - "http"    → só HTTP + Cheerio
-     *  - "stealth" → pula HTTP, usa got-scraping diretamente
-     *  - "browser" → vai direto ao Playwright Chromium
-     */
-    forceTier?: ScrapeTier;
-    /** Incluir HTML bruto (antes da extração de conteúdo). Útil para map(). Default: false */
-    getRawHtml?: boolean;
-    /** Aguardar esse seletor CSS aparecer e estar visível antes de extrair */
-    waitForSelector?: string;
-    /** Interceptar respostas JSON das APIs chamadas pela SPA */
-    interceptAPIs?: boolean;
-}
-/** Dados SSR embutidos em tags <script> pelo framework */
-export interface SSRData {
-    /**
-     * Framework que gerou o dado:
-     *  - "next"      → Next.js (#__NEXT_DATA__)
-     *  - "nuxt"      → Nuxt 2/3 (window.__NUXT__)
-     *  - "gatsby"    → Gatsby (window.___gatsby)
-     *  - "remix"     → Remix (window.__remixContext)
-     *  - "sveltekit" → SvelteKit (script[data-sveltekit-fetched] ou window.__SVELTEKIT__)
-     *  - "vue"       → Vue SSR (window.__VUE_SSR_CONTEXT__ / window.__VUE_STORE__)
-     *  - "angular"   → Angular Universal (script#ng-state)
-     *  - "tanstack"  → TanStack Router / Start (window.__TSR_DEHYDRATED__)
-     *  - "generic"   → Outros (window.__INITIAL_STATE__, __APP_STATE__, etc.)
-     */
-    type: "next" | "nuxt" | "gatsby" | "remix" | "sveltekit" | "vue" | "angular" | "tanstack" | "generic";
-    /** Objeto JSON extraído */
-    data: unknown;
-}
-/** Chamada de API interceptada durante renderização do browser */
-export interface InterceptedAPI {
-    url: string;
-    method: string;
-    statusCode: number;
-    contentType: string;
-    data: unknown;
-}
-/** Link descoberto no mapeamento */
-export interface MapLink {
-    url: string;
-    /** Texto do âncora (innerText do <a>) */
-    title?: string;
-}
-/** Opções do mapeamento */
-export interface MapOptions {
-    /** Filtrar/ordenar links por relevância a este termo */
-    search?: string;
-    /** Incluir links de subdomínios. Default: true */
-    includeSubdomains?: boolean;
-    /** Ignorar query strings (?foo=bar). Default: true */
-    ignoreQueryParameters?: boolean;
-    /** Máximo de links a retornar. Default: 500 */
-    limit?: number;
-    /** Tier forçado (igual ao scrape) */
-    forceTier?: ScrapeTier;
-}
-/** Resultado do mapeamento */
-export interface MapResult {
-    url: string;
-    links: MapLink[];
-    tier: ScrapeTier;
-    durationMs: number;
-    error?: string;
-}
-/** Resultado completo do scrape */
-export interface ScrapeResult {
-    /** URL final (após redirecionamentos) */
-    url: string;
-    /** HTTP status code */
-    statusCode: number;
-    /** Título da página */
-    title: string;
-    /** Meta description */
-    description?: string;
-    /** Conteúdo em Markdown */
-    markdown?: string;
-    /** Conteúdo em HTML limpo */
-    html?: string;
-    /** Conteúdo em texto puro */
-    text?: string;
-    /** Tier usado para fazer o scrape */
-    tier: ScrapeTier;
-    /** Tempo total em ms */
-    durationMs: number;
-    /** Links encontrados na página */
-    links?: string[];
-    /** HTML bruto (quando getRawHtml: true) */
-    rawHtml?: string;
-    /** Dados SSR extraídos (Next.js, Nuxt, etc.) */
-    ssrData?: SSRData;
-    /** Chamadas JSON interceptadas durante renderização (só Tier 3) */
-    interceptedAPIs?: InterceptedAPI[];
-    /** Motivo de falha, se houver */
-    error?: string;
-}
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/scraper/types.js

@@ -1,3 +0,0 @@
-// ─── Tipos do Scraper ──────────────────────────────────────────────────────
-export {};
-//# sourceMappingURL=types.js.map

package/dist/scraper/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scraper/types.ts"],"names":[],"mappings":"AAAA,8EAA8E"}

package/dist/security/action-validator.d.ts

@@ -1,83 +0,0 @@
-import { z } from "zod";
-export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-    type: z.ZodLiteral<"click">;
-    selector: z.ZodEffects<z.ZodString, string, string>;
-}, "strip", z.ZodTypeAny, {
-    type: "click";
-    selector: string;
-}, {
-    type: "click";
-    selector: string;
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"type">;
-    selector: z.ZodEffects<z.ZodString, string, string>;
-    text: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    type: "type";
-    text: string;
-    selector: string;
-}, {
-    type: "type";
-    text: string;
-    selector: string;
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"goto">;
-    url: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    type: "goto";
-    url: string;
-}, {
-    type: "goto";
-    url: string;
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"wait">;
-    ms: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    type: "wait";
-    ms: number;
-}, {
-    type: "wait";
-    ms: number;
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"scroll">;
-    direction: z.ZodEnum<["up", "down"]>;
-}, "strip", z.ZodTypeAny, {
-    type: "scroll";
-    direction: "up" | "down";
-}, {
-    type: "scroll";
-    direction: "up" | "down";
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"done">;
-    result: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    type: "done";
-    result: string;
-}, {
-    type: "done";
-    result: string;
-}>]>;
-export declare class ActionValidationError extends Error {
-    constructor(message: string);
-}
-export declare function validateAction(raw: unknown): {
-    type: "click";
-    selector: string;
-} | {
-    type: "type";
-    text: string;
-    selector: string;
-} | {
-    type: "goto";
-    url: string;
-} | {
-    type: "wait";
-    ms: number;
-} | {
-    type: "scroll";
-    direction: "up" | "down";
-} | {
-    type: "done";
-    result: string;
-};
-//# sourceMappingURL=action-validator.d.ts.map

package/dist/security/action-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"action-validator.d.ts","sourceRoot":"","sources":["../../src/security/action-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiBvB,CAAC;AAEH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO;;;;;;;;;;;;;;;;;;;EAQ1C"}

package/dist/security/action-validator.js

@@ -1,36 +0,0 @@
-import { z } from "zod";
-import { DEFAULTS } from "../config/defaults.js";
-const SELECTOR_BLACKLIST = [/javascript:/i, /on\w+\s*=/i, /<script/i];
-const selectorSchema = z.string().trim().min(1, "Selector must not be empty or whitespace-only").refine((s) => !SELECTOR_BLACKLIST.some((pattern) => pattern.test(s)), "Selector contains forbidden pattern");
-export const actionSchema = z.discriminatedUnion("type", [
-    z.object({ type: z.literal("click"), selector: selectorSchema }),
-    z.object({
-        type: z.literal("type"),
-        selector: selectorSchema,
-        text: z.string().max(DEFAULTS.maxTypeLength),
-    }),
-    z.object({ type: z.literal("goto"), url: z.string().url() }),
-    z.object({
-        type: z.literal("wait"),
-        ms: z.number().int().positive().max(DEFAULTS.maxWaitMs),
-    }),
-    z.object({
-        type: z.literal("scroll"),
-        direction: z.enum(["up", "down"]),
-    }),
-    z.object({ type: z.literal("done"), result: z.string() }),
-]);
-export class ActionValidationError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "ActionValidationError";
-    }
-}
-export function validateAction(raw) {
-    const result = actionSchema.safeParse(raw);
-    if (!result.success) {
-        throw new ActionValidationError(`Invalid action: ${result.error.issues.map((i) => i.message).join(", ")}`);
-    }
-    return result.data;
-}
-//# sourceMappingURL=action-validator.js.map

package/dist/security/action-validator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"action-validator.js","sourceRoot":"","sources":["../../src/security/action-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;AAEtE,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+CAA+C,CAAC,CAAC,MAAM,CACrG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAC7D,qCAAqC,CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACvD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAChE,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,QAAQ,EAAE,cAAc;QACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;KAC7C,CAAC;IACF,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;IAC5D,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;KACxD,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,qBAAqB,CAC7B,mBAAmB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/security/url-validator.d.ts

@@ -1,9 +0,0 @@
-export interface UrlValidationOptions {
-    allowedDomains?: string[];
-    blockedDomains?: string[];
-}
-export declare class UrlValidationError extends Error {
-    constructor(message: string);
-}
-export declare function validateUrl(rawUrl: string, options?: UrlValidationOptions): Promise<string>;
-//# sourceMappingURL=url-validator.d.ts.map

package/dist/security/url-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"url-validator.d.ts","sourceRoot":"","sources":["../../src/security/url-validator.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CA2DjB"}

package/dist/security/url-validator.js

@@ -1,69 +0,0 @@
-import { resolve } from "node:dns/promises";
-const ALLOWED_PROTOCOLS = new Set(["http:", "https:"]);
-const BLOCKED_HOSTS = new Set(["localhost", "[::1]"]);
-const PRIVATE_IP_RANGES = [
-    /^127\./,
-    /^10\./,
-    /^192\.168\./,
-    /^172\.(1[6-9]|2\d|3[01])\./,
-    /^169\.254\./,
-    /^0\./,
-    /^fc00:/i,
-    /^fe80:/i,
-    /^::1$/,
-];
-function isPrivateIp(ip) {
-    return PRIVATE_IP_RANGES.some((range) => range.test(ip));
-}
-export class UrlValidationError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "UrlValidationError";
-    }
-}
-export async function validateUrl(rawUrl, options = {}) {
-    let parsed;
-    try {
-        parsed = new URL(rawUrl);
-    }
-    catch {
-        throw new UrlValidationError(`Invalid URL: ${rawUrl}`);
-    }
-    if (!ALLOWED_PROTOCOLS.has(parsed.protocol)) {
-        throw new UrlValidationError(`Blocked protocol: ${parsed.protocol} — only http and https are allowed`);
-    }
-    const hostname = parsed.hostname;
-    if (BLOCKED_HOSTS.has(hostname)) {
-        throw new UrlValidationError(`Blocked host: ${hostname}`);
-    }
-    if (isPrivateIp(hostname)) {
-        throw new UrlValidationError(`Blocked private IP: ${hostname}`);
-    }
-    if (options.allowedDomains && options.allowedDomains.length > 0) {
-        const allowed = options.allowedDomains.some((d) => hostname === d || hostname.endsWith(`.${d}`));
-        if (!allowed) {
-            throw new UrlValidationError(`Domain ${hostname} is not in the allowedDomains list`);
-        }
-    }
-    if (options.blockedDomains && options.blockedDomains.length > 0) {
-        const blocked = options.blockedDomains.some((d) => hostname === d || hostname.endsWith(`.${d}`));
-        if (blocked) {
-            throw new UrlValidationError(`Domain ${hostname} is in the blockedDomains list`);
-        }
-    }
-    try {
-        const addresses = await resolve(hostname);
-        for (const addr of addresses) {
-            if (isPrivateIp(addr)) {
-                throw new UrlValidationError(`DNS rebinding detected: ${hostname} resolves to private IP ${addr}`);
-            }
-        }
-    }
-    catch (err) {
-        if (err instanceof UrlValidationError)
-            throw err;
-        // DNS resolution failed — allow the request through, the browser will handle the error
-    }
-    return parsed.href;
-}
-//# sourceMappingURL=url-validator.js.map

package/dist/security/url-validator.js.map

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

package/dist/types.d.ts

@@ -1,96 +0,0 @@
-export interface AgentConfig {
-    llmApiKey: string;
-    llmBaseUrl?: string;
-    port?: number;
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-    topP?: number;
-    frequencyPenalty?: number;
-    presencePenalty?: number;
-    maxIterations?: number;
-    timeoutMs?: number;
-    maxWaitMs?: number;
-    gotoTimeoutMs?: number;
-    allowedDomains?: string[];
-    blockedDomains?: string[];
-}
-export interface RunOptions {
-    url: string;
-    prompt: string;
-}
-export type AgentAction = {
-    type: "click";
-    selector: string;
-} | {
-    type: "type";
-    selector: string;
-    text: string;
-} | {
-    type: "goto";
-    url: string;
-} | {
-    type: "wait";
-    ms: number;
-} | {
-    type: "scroll";
-    direction: "up" | "down";
-} | {
-    type: "done";
-    result: string;
-};
-export interface ActionRecord {
-    action: AgentAction;
-    iteration: number;
-    timestamp: number;
-}
-export type AgentStatus = "done" | "max_iterations" | "error" | "timeout";
-/** Método de execução utilizado pelo agente */
-export type AgentTier = "http" | "playwright";
-export interface LLMUsage {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-    calls: number;
-}
-export interface MemoryUsage {
-    /** RSS do processo do browser Playwright em KB. 0 quando tier="http". */
-    browserPeakRssKb: number;
-    /** Heap usado pelo processo Node.js no momento da conclusão (MB) */
-    nodeHeapUsedMb: number;
-}
-export interface AgentResult {
-    status: AgentStatus;
-    /** Método usado: "http" = Cheerio sem browser | "playwright" = browser completo */
-    tier: AgentTier;
-    data: string | null;
-    report: string;
-    durationMs: number;
-    actions: ActionRecord[];
-    usage: LLMUsage;
-    memory: MemoryUsage;
-    error?: string;
-}
-export interface PageSnapshot {
-    url: string;
-    title: string;
-    text: string;
-    links: SnapshotLink[];
-    forms: SnapshotForm[];
-}
-export interface SnapshotLink {
-    text: string;
-    href: string;
-    index: number;
-}
-export interface SnapshotForm {
-    action: string;
-    inputs: SnapshotInput[];
-}
-export interface SnapshotInput {
-    name: string;
-    type: string;
-    placeholder: string;
-    selector: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}