b4n1-web 0.7.0 → 0.9.3

package/dist/security.d.ts

@@ -1,65 +1,65 @@
 /**
- * B4n1Web SecurityShield - URL Security Validation
+ * B4n1Web SecurityShield — URL security validation with in-memory cache.
  *
- * Provides URL security validation with caching.
- * Fall-safe: returns safe=true if any error occurs.
- */
-import type { SecurityShieldOptions, SecurityCheckResult } from './types';
-/**
- * SecurityShield - Domain safety validation with caching
+ * SecurityShield provides URL safety checking for agentic browser navigation.
  *
- * @example
- * ```typescript
- * import { SecurityShield, navigate } from 'b4n1-web';
- *
- * // Simple usage
- * const result = await navigate('https://example.com');
- *
- * // With custom shield
- * const shield = new SecurityShield({ cacheDays: 30 });
- * const { isSafe, needsApiCheck } = shield.isUrlSafe('https://example.com');
- * ```
+ * API:
+ *   new SecurityShield({ dbPath?, cacheDays? })
+ *   shield.isUrlSafe(url)        → { isSafe: boolean, needsApiCheck: boolean }
+ *   shield.markDomain(domain, isSafe)
+ *   shield.clearCache()
  */
+import type { SecurityShieldOptions, SecurityCheckResult } from './types';
 export declare class SecurityShield {
-    private dbPath;
     private cacheDays;
     private cache;
-    constructor(options?: SecurityShieldOptions);
     /**
-     * Extract domain from URL
+     * Create a SecurityShield instance.
+     * @param opts - Optional configuration
+     * @param opts.cacheDays - TTL of a cached result in days (default 7)
      */
-    private extractDomain;
+    constructor(opts?: SecurityShieldOptions);
     /**
-     * Check if URL is safe to navigate
+     * Check whether a URL is safe to navigate.
+     *
+     * @param rawURL - The URL to check.
+     * @returns `{ isSafe, needsApiCheck }`
+     *   isSafe         — `true` if the domain is not blacklisted.
+     *   needsApiCheck  — `false` when the result was previously cached.
+     *
+     * @example
+     *   const { isSafe, needsApiCheck } = shield.isUrlSafe('https://unknown.com');
+     *   // → isSafe=true, needsApiCheck=true  (unknown domain, needs screening)
+     *
+     *   shield.markDomain('evil.com', false);
+     *   shield.isUrlSafe('https://evil.com');
+     *   // → isSafe=false, needsApiCheck=false (explicitly blacklisted)
      */
-    isUrlSafe(url: string): SecurityCheckResult;
+    isUrlSafe(rawURL: string): SecurityCheckResult;
     /**
-     * Mark a domain as safe or unsafe
+     * Explicitly mark a domain as safe (whitelist) or unsafe (blacklist).
+     * Overwrites any previous entry and resets the TTL timer.
+     *
+     * @param domain  - The domain to mark, e.g. `"example.com"`
+     * @param isSafe  - `true` to whitelist, `false` to blacklist
+     *
+     * @example
+     *   shield.markDomain('trusted.com', true);   // always allow
+     *   shield.markDomain('malware.com', false);  // always block
      */
     markDomain(domain: string, isSafe: boolean): void;
     /**
-     * Clear all cached domains
+     * Remove all cached domain entries.
+     * After clearing, every next `isUrlSafe()` call for a previously-known domain
+     * will return `needsApiCheck=true` again.
      */
     clearCache(): void;
+    /**
+     * Extract the hostname from a URL string.
+     * Returns `''` for invalid / missing URLs.
+     * @internal — exposed for testing as `extractDomain`.
+     */
+    extractDomain(rawURL: string): string | null;
+    private _extractHost;
 }
-/**
- * Navigate to URL with optional security check
- *
- * @example
- * ```typescript
- * import { navigate } from 'b4n1-web';
- *
- * const result = await navigate('https://example.com');
- * if (result.success) {
- *   console.log(result.markdown);
- * }
- * ```
- */
-export declare function navigate(url: string, ignoreSecurity?: boolean, securityShield?: SecurityShield): Promise<{
-    url: string;
-    success: boolean;
-    markdown?: string;
-    links?: string[];
-    error?: string;
-}>;
 //# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAoD;gBAErD,OAAO,GAAE,qBAA0B;IAM/C;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAkB3C;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAMjD;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,cAAc,GAAE,OAAe,EAC/B,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAkCD"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAQ1E,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAA0B;IAEvC;;;;OAIG;gBACS,IAAI,GAAE,qBAA0B;IAK5C;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB;IAsB9C;;;;;;;;;;OAUG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAMjD;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAsD5C,OAAO,CAAC,YAAY;CAIrB"}

package/dist/security.js

@@ -1,126 +1,160 @@
 "use strict";
 /**
- * B4n1Web SecurityShield - URL Security Validation
+ * B4n1Web SecurityShield — URL security validation with in-memory cache.
  *
- * Provides URL security validation with caching.
- * Fall-safe: returns safe=true if any error occurs.
+ * SecurityShield provides URL safety checking for agentic browser navigation.
+ *
+ * API:
+ *   new SecurityShield({ dbPath?, cacheDays? })
+ *   shield.isUrlSafe(url)        → { isSafe: boolean, needsApiCheck: boolean }
+ *   shield.markDomain(domain, isSafe)
+ *   shield.clearCache()
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SecurityShield = void 0;
-exports.navigate = navigate;
-const browser_1 = require("./browser");
-const types_1 = require("./types");
-/**
- * SecurityShield - Domain safety validation with caching
- *
- * @example
- * ```typescript
- * import { SecurityShield, navigate } from 'b4n1-web';
- *
- * // Simple usage
- * const result = await navigate('https://example.com');
- *
- * // With custom shield
- * const shield = new SecurityShield({ cacheDays: 30 });
- * const { isSafe, needsApiCheck } = shield.isUrlSafe('https://example.com');
- * ```
- */
+/** Default cache TTL in days */
+const DEFAULT_CACHE_DAYS = 7;
 class SecurityShield {
-    constructor(options = {}) {
-        this.dbPath = options.dbPath ?? `${process.env.HOME}/.b4n1web/security.db`;
-        this.cacheDays = options.cacheDays ?? 7;
-        this.cache = new Map();
-    }
+    cacheDays;
+    cache;
     /**
-     * Extract domain from URL
+     * Create a SecurityShield instance.
+     * @param opts - Optional configuration
+     * @param opts.cacheDays - TTL of a cached result in days (default 7)
      */
-    extractDomain(url) {
-        try {
-            const parsed = new URL(url);
-            return parsed.hostname.toLowerCase();
-        }
-        catch {
-            return null;
-        }
+    constructor(opts = {}) {
+        this.cacheDays = opts.cacheDays ?? DEFAULT_CACHE_DAYS;
+        this.cache = new Map();
     }
     /**
-     * Check if URL is safe to navigate
+     * Check whether a URL is safe to navigate.
+     *
+     * @param rawURL - The URL to check.
+     * @returns `{ isSafe, needsApiCheck }`
+     *   isSafe         — `true` if the domain is not blacklisted.
+     *   needsApiCheck  — `false` when the result was previously cached.
+     *
+     * @example
+     *   const { isSafe, needsApiCheck } = shield.isUrlSafe('https://unknown.com');
+     *   // → isSafe=true, needsApiCheck=true  (unknown domain, needs screening)
+     *
+     *   shield.markDomain('evil.com', false);
+     *   shield.isUrlSafe('https://evil.com');
+     *   // → isSafe=false, needsApiCheck=false (explicitly blacklisted)
      */
-    isUrlSafe(url) {
-        const domain = this.extractDomain(url);
-        if (!domain) {
+    isUrlSafe(rawURL) {
+        const host = this._extractHost(rawURL);
+        if (!host) {
+            // Invalid URL — safe default, no API check needed
             return { isSafe: true, needsApiCheck: false };
         }
-        const cached = this.cache.get(domain);
-        if (cached) {
-            if (Date.now() > cached.expires) {
-                this.cache.delete(domain);
-                return { isSafe: true, needsApiCheck: true };
+        const now = Date.now();
+        const entry = this.cache.get(host);
+        if (entry) {
+            if (now < entry.expires) {
+                // Cached and fresh — does not need an external API call
+                return { isSafe: entry.isSafe, needsApiCheck: false };
             }
-            return { isSafe: cached.isSafe, needsApiCheck: false };
+            // Expired — re-check
+            this.cache.delete(host);
         }
+        // New domain — safe but needs external API verification
         return { isSafe: true, needsApiCheck: true };
     }
     /**
-     * Mark a domain as safe or unsafe
+     * Explicitly mark a domain as safe (whitelist) or unsafe (blacklist).
+     * Overwrites any previous entry and resets the TTL timer.
+     *
+     * @param domain  - The domain to mark, e.g. `"example.com"`
+     * @param isSafe  - `true` to whitelist, `false` to blacklist
+     *
+     * @example
+     *   shield.markDomain('trusted.com', true);   // always allow
+     *   shield.markDomain('malware.com', false);  // always block
      */
     markDomain(domain, isSafe) {
-        const normalizedDomain = domain.toLowerCase();
-        const expires = Date.now() + this.cacheDays * 24 * 60 * 60 * 1000;
-        this.cache.set(normalizedDomain, { isSafe, expires });
+        const normalized = domain.toLowerCase().trim();
+        const expires = Date.now() + this.cacheDays * 86400_000; // days → ms
+        this.cache.set(normalized, { isSafe, expires });
     }
     /**
-     * Clear all cached domains
+     * Remove all cached domain entries.
+     * After clearing, every next `isUrlSafe()` call for a previously-known domain
+     * will return `needsApiCheck=true` again.
      */
     clearCache() {
         this.cache.clear();
     }
-}
-exports.SecurityShield = SecurityShield;
-/**
- * Navigate to URL with optional security check
- *
- * @example
- * ```typescript
- * import { navigate } from 'b4n1-web';
- *
- * const result = await navigate('https://example.com');
- * if (result.success) {
- *   console.log(result.markdown);
- * }
- * ```
- */
-async function navigate(url, ignoreSecurity = false, securityShield) {
-    if (!securityShield) {
-        securityShield = new SecurityShield();
-    }
-    if (!ignoreSecurity) {
-        const { isSafe } = securityShield.isUrlSafe(url);
-        if (!isSafe) {
-            return {
-                url,
-                success: false,
-                error: 'URL flagged as unsafe by security check',
-            };
+    // ── helpers ────────────────────────────────────────────────
+    /**
+     * Extract the hostname from a URL string.
+     * Returns `''` for invalid / missing URLs.
+     * @internal — exposed for testing as `extractDomain`.
+     */
+    extractDomain(rawURL) {
+        try {
+            const url = rawURL?.trim();
+            if (!url)
+                return null;
+            let rest;
+            // Check for scheme (handles both :// and : schemes like data:, javascript:)
+            const schemeIndex = url.indexOf(':');
+            if (schemeIndex === -1) {
+                // no scheme
+                return null;
+            }
+            const scheme = url.slice(0, schemeIndex);
+            rest = url.slice(schemeIndex + 1);
+            // Handle special cases for schemes
+            if (scheme === 'data' || scheme === 'javascript') {
+                return '';
+            }
+            // Handle // authority format (like //example.com/path)
+            if (rest.startsWith('//')) {
+                rest = rest.slice(2);
+            }
+            // For other schemes like http:, https:, ftp:, etc., we already removed the scheme above
+            // Strip userinfo "user:pass@"
+            const atIdx = rest.lastIndexOf('@');
+            const afterAuth = atIdx >= 0 ? rest.slice(atIdx + 1) : rest;
+            // Strip path/query/fragment
+            const [rawHost, ..._] = afterAuth.split(/[\/?#]/, 1);
+            if (!rawHost)
+                return null;
+            let host = rawHost.trim();
+            if (!host)
+                return null;
+            // IPv6 in brackets: [::1]:8080 → ::
+            if (host.startsWith('[')) {
+                const bracketEnd = host.indexOf(']');
+                if (bracketEnd === -1)
+                    return null;
+                host = host.slice(1, bracketEnd); // Extract content between brackets
+                return host.toLowerCase(); // ::1 is final, no port to strip
+            }
+            // Strip port after last ':' — works for 'example.com:8080'
+            const colonIdx = host.lastIndexOf(':');
+            if (colonIdx > 0) {
+                host = host.slice(0, colonIdx);
+            }
+            // Accept localhost / single-label hosts too
+            return host.toLowerCase() || null;
+        }
+        catch {
+            return null;
         }
     }
-    try {
-        const browser = new browser_1.AgentBrowser({ mode: types_1.BrowserMode.LIGHT });
-        const page = await browser.goto(url);
-        browser.close();
-        return {
-            url: page.url,
-            success: true,
-            markdown: page.markdown,
-            links: page.links,
-        };
-    }
-    catch (error) {
-        return {
-            url,
-            success: false,
-            error: error.message,
-        };
+    _extractHost(rawURL) {
+        const r = this.extractDomain(rawURL);
+        return r ?? '';
     }
 }
+exports.SecurityShield = SecurityShield;
+function _stripPort(host) {
+    const at = host.indexOf('@');
+    const colon = host.indexOf(':', at >= 0 ? at + 1 : 0);
+    if (colon >= 0)
+        return host.slice(0, colon);
+    return host;
+}
 //# sourceMappingURL=security.js.map

package/dist/security.js.map

@@ -1 +1 @@
-{"version":3,"file":"security.js","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA+FH,4BA4CC;AAzID,uCAAoD;AACpD,mCAAsC;AAGtC;;;;;;;;;;;;;;GAcG;AACH,MAAa,cAAc;IAKzB,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,uBAAuB,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,GAAW;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,GAAW;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;gBAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAC/C,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QACzD,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAc,EAAE,MAAe;QACxC,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAClE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AA3DD,wCA2DC;AAED;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,QAAQ,CAC5B,GAAW,EACX,iBAA0B,KAAK,EAC/B,cAA+B;IAQ/B,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,GAAG;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,yCAAyC;aACjD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,sBAAY,CAAC,EAAE,IAAI,EAAE,mBAAW,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAS,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhB,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO;YACL,GAAG;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,CAAC,OAAO;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -30,6 +30,11 @@ export interface SecurityCheckResult {
     isSafe: boolean;
     needsApiCheck: boolean;
 }
+export interface IframeInfo {
+    index: number;
+    src?: string;
+    title?: string;
+}
 export declare class BinaryNotFoundError extends Error {
     constructor(message?: string);
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,EAAE,OAAO;IACT,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,SAAuG;CAI3H"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,EAAE,OAAO;IACT,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,SAAuG;CAI3H"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,wBAAS,CAAA;IACT,gCAAiB,CAAA;AACnB,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB;AAkCD,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,GAAG,oGAAoG;QACxH,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,wBAAS,CAAA;IACT,gCAAiB,CAAA;AACnB,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB;AAwCD,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,GAAG,oGAAoG;QACxH,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "b4n1-web",
-  "version": "0.7.0",
+  "version": "0.9.3",
   "description": "B4n1Web SDK for JavaScript/TypeScript - Agentic Browser Engine with bundled binary",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,7 +28,7 @@
   ],
   "author": "Bani Montoya <banimontoya@gmail.com>",
   "license": "MIT",
-  "homepage": "https://github.com/B4N1-com/b4n1-web",
+  "homepage": "https://web.b4n1.com",
   "repository": {
     "type": "git",
     "url": "https://github.com/B4N1-com/b4n1-web.git"
@@ -38,7 +38,8 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.6"
   },
   "engines": {
     "node": ">=18.0.0"