@solarisdk/browser 0.3.0 → 0.4.0

package/LICENSE

@@ -1,17 +1,21 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
+MIT License
 
-   Copyright 2026 Solari Browser
+Copyright (c) 2026 Solari
 
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-       http://www.apache.org/licenses/LICENSE-2.0
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -102,6 +102,22 @@ For staging or self-hosted gateways, pass `baseUrl` instead of `region`.
 
 ## Managed proxies
 
+Proxy bandwidth is billed per GB, and pages heavy in video and images can cost tens of megabytes
+per session. `blockHeavy` (off by default) skips them:
+
+```ts
+await solari.launch({
+    stealth: true,
+    proxy: "us",
+    blockHeavy: true, // video/audio + images over 100 KB; or { fonts: true, imageMaxBytes: 50_000 }
+});
+```
+
+Blocked requests fail inside the browser, so nothing is fetched and nothing leaves through a different
+route; the page sees an ordinary failed load and the blocked image or video does not appear. Images that
+declare no size, and requests made by service workers or cross-origin iframes, are not covered.
+Replays still play: they load media from the original site.
+
 ```ts
 await solari.launch({
     stealth: true,
@@ -137,4 +153,4 @@ try {
 
 ## License
 
-Apache-2.0
+MIT

package/dist/index.d.ts

@@ -96,6 +96,16 @@ export interface Profile {
     name: string;
     [k: string]: unknown;
 }
+/** What `blockHeavy` skips. Every field is optional. */
+export interface BlockHeavyOptions {
+    /** Block video and audio. Default true. */
+    media?: boolean;
+    /** Block web fonts. Default false (blocking fonts changes how the page renders and fingerprints). */
+    fonts?: boolean;
+    /** Block images whose declared size (Content-Length, as sent over the wire) exceeds this many bytes;
+     *  `null` keeps every image. Default 102400 (100 KB). */
+    imageMaxBytes?: number | null;
+}
 export interface CreateSessionOptions {
     /** Attach a stored browser profile (cookies + localStorage). */
     profileId?: string;
@@ -125,6 +135,15 @@ export interface CreateSessionOptions {
      *  (`sessionTimeoutMs`, else an hour, never past the plan maximum) or until
      *  it is released, so a dropped client can reconnect. */
     keepAlive?: boolean;
+    /** Skip heavy files so a proxied session does not pay proxy bandwidth for them. Off by default.
+     *
+     *    blockHeavy: true                                  // video/audio + images over 100 KB
+     *    blockHeavy: { fonts: true, imageMaxBytes: 50_000 }
+     *
+     *  Blocked requests fail inside the browser (nothing is fetched and nothing goes out directly), so the page sees an
+     *  ordinary failed load: a blocked image or video simply does not appear. Images without a declared size, and requests
+     *  made by service workers or cross-origin iframes, are not covered. The gateway rejects a malformed value with 400. */
+    blockHeavy?: boolean | BlockHeavyOptions;
     /** Free-form JSON object stored with the session (labels, job ids, ...). */
     userMetadata?: Record<string, unknown>;
 }

package/dist/index.js

@@ -333,6 +333,8 @@ class SessionsResource {
             body.timeoutSeconds = timeoutSeconds;
         if (options?.keepAlive === true)
             body.keepAlive = true;
+        if (options?.blockHeavy !== undefined && options.blockHeavy !== false)
+            body.blockHeavy = options.blockHeavy;
         if (options?.userMetadata !== undefined)
             body.userMetadata = options.userMetadata;
         // A create allocates a slot and launches a browser before it can answer,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@solarisdk/browser",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Official client SDK for Solari Browser.",
-  "license": "Apache-2.0",
+  "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",