@xberg-io/crawlberg-wasm 1.9.0 → 1.10.2

package/pkg/bundler/crawlberg_wasm.d.ts

@@ -7,6 +7,13 @@
 export class WasmActionResult {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmActionResult;
     static default(): WasmActionResult;
     constructor(actionIndex?: number | null, actionType?: string | null, success?: boolean | null, data?: any | null, error?: string | null);
     actionIndex: number;
@@ -24,6 +31,13 @@ export class WasmActionResult {
 export class WasmArticleMetadata {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmArticleMetadata;
     static default(): WasmArticleMetadata;
     constructor(tags?: string[] | null, publishedTime?: string | null, modifiedTime?: string | null, author?: string | null, section?: string | null);
     get author(): string | undefined;
@@ -80,12 +94,33 @@ export class WasmAuthConfig {
 export class WasmBatchCrawlResult {
     free(): void;
     [Symbol.dispose](): void;
+    clearResult(): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmBatchCrawlResult;
     static default(): WasmBatchCrawlResult;
+    /**
+     * Takes ownership of `result`.
+     * wasm-bindgen lowers a by-value class argument through `__destroy_into_raw()`, so each
+     * of those handles is dead once this returns. Passing a freshly built value is fine. To
+     * keep a handle you already hold, build with `default()` and assign the property instead:
+     * the generated setter borrows and leaves your handle alive.
+     */
     constructor(url?: string | null, result?: WasmCrawlResult | null, error?: string | null);
     get error(): string | undefined;
     set error(value: string | null | undefined);
+    /**
+     * Returns a detached copy of `result`.
+     *
+     * Changes to the returned value do not update this object. To update `result`,
+     * read it, modify the copy, then assign the copy back to `result`.
+     */
     get result(): WasmCrawlResult | undefined;
-    set result(value: WasmCrawlResult | null | undefined);
+    set result(value: WasmCrawlResult);
     url: string;
 }
 
@@ -98,10 +133,28 @@ export class WasmBatchCrawlResult {
 export class WasmBatchCrawlResults {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmBatchCrawlResults;
     static default(): WasmBatchCrawlResults;
+    /**
+     * Takes ownership of every element in `results`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(results?: WasmBatchCrawlResult[] | null, totalCount?: number | null, completedCount?: number | null, failedCount?: number | null);
     completedCount: number;
     failedCount: number;
+    /**
+     * Returns detached copies of the elements in `results`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `results`.
+     */
     results: WasmBatchCrawlResult[];
     totalCount: number;
 }
@@ -112,12 +165,33 @@ export class WasmBatchCrawlResults {
 export class WasmBatchScrapeResult {
     free(): void;
     [Symbol.dispose](): void;
+    clearResult(): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmBatchScrapeResult;
     static default(): WasmBatchScrapeResult;
+    /**
+     * Takes ownership of `result`.
+     * wasm-bindgen lowers a by-value class argument through `__destroy_into_raw()`, so each
+     * of those handles is dead once this returns. Passing a freshly built value is fine. To
+     * keep a handle you already hold, build with `default()` and assign the property instead:
+     * the generated setter borrows and leaves your handle alive.
+     */
     constructor(url?: string | null, result?: WasmScrapeResult | null, error?: string | null);
     get error(): string | undefined;
     set error(value: string | null | undefined);
+    /**
+     * Returns a detached copy of `result`.
+     *
+     * Changes to the returned value do not update this object. To update `result`,
+     * read it, modify the copy, then assign the copy back to `result`.
+     */
     get result(): WasmScrapeResult | undefined;
-    set result(value: WasmScrapeResult | null | undefined);
+    set result(value: WasmScrapeResult);
     url: string;
 }
 
@@ -130,10 +204,28 @@ export class WasmBatchScrapeResult {
 export class WasmBatchScrapeResults {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmBatchScrapeResults;
     static default(): WasmBatchScrapeResults;
+    /**
+     * Takes ownership of every element in `results`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(results?: WasmBatchScrapeResult[] | null, totalCount?: number | null, completedCount?: number | null, failedCount?: number | null);
     completedCount: number;
     failedCount: number;
+    /**
+     * Returns detached copies of the elements in `results`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `results`.
+     */
     results: WasmBatchScrapeResult[];
     totalCount: number;
 }
@@ -152,7 +244,22 @@ export enum WasmBrowserBackend {
 export class WasmBrowserConfig {
     free(): void;
     [Symbol.dispose](): void;
+    clearProxy(): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmBrowserConfig;
     static default(): WasmBrowserConfig;
+    /**
+     * Takes ownership of `proxy`.
+     * wasm-bindgen lowers a by-value class argument through `__destroy_into_raw()`, so each
+     * of those handles is dead once this returns. Passing a freshly built value is fine. To
+     * keep a handle you already hold, build with `default()` and assign the property instead:
+     * the generated setter borrows and leaves your handle alive.
+     */
     constructor(mode?: WasmBrowserMode | null, backend?: WasmBrowserBackend | null, timeout?: bigint | null, overallTimeout?: bigint | null, shutdownTimeout?: bigint | null, wait?: WasmBrowserWait | null, blockUrlPatterns?: string[] | null, captureNetworkEvents?: boolean | null, sessionAffinity?: boolean | null, chromeArgs?: string[] | null, endpoint?: string | null, waitSelector?: string | null, extraWait?: bigint | null, proxy?: WasmProxyConfig | null, evalScript?: string | null, robotsUserAgent?: string | null, chromePath?: string | null);
     get backend(): string;
     set backend(value: WasmBrowserBackend);
@@ -171,8 +278,14 @@ export class WasmBrowserConfig {
     set mode(value: WasmBrowserMode);
     get overallTimeout(): bigint | undefined;
     set overallTimeout(value: bigint | null | undefined);
+    /**
+     * Returns a detached copy of `proxy`.
+     *
+     * Changes to the returned value do not update this object. To update `proxy`,
+     * read it, modify the copy, then assign the copy back to `proxy`.
+     */
     get proxy(): WasmProxyConfig | undefined;
-    set proxy(value: WasmProxyConfig | null | undefined);
+    set proxy(value: WasmProxyConfig);
     get robotsUserAgent(): string | undefined;
     set robotsUserAgent(value: string | null | undefined);
     sessionAffinity: boolean;
@@ -194,11 +307,35 @@ export class WasmBrowserConfig {
 export class WasmBrowserExtras {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmBrowserExtras;
     static default(): WasmBrowserExtras;
+    /**
+     * Takes ownership of every element in `networkEvents`, `cookies`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(networkEvents?: WasmResponseMeta[] | null, cookies?: WasmCookieInfo[] | null, evalResult?: any | null);
+    /**
+     * Returns detached copies of the elements in `cookies`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `cookies`.
+     */
     cookies: WasmCookieInfo[];
     get evalResult(): any | undefined;
     set evalResult(value: any | null | undefined);
+    /**
+     * Returns detached copies of the elements in `networkEvents`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `networkEvents`.
+     */
     networkEvents: WasmResponseMeta[];
 }
 
@@ -228,6 +365,13 @@ export enum WasmBrowserWait {
 export class WasmCitationReference {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmCitationReference;
     static default(): WasmCitationReference;
     constructor(index?: number | null, url?: string | null, text?: string | null);
     index: number;
@@ -241,9 +385,27 @@ export class WasmCitationReference {
 export class WasmCitationResult {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmCitationResult;
     static default(): WasmCitationResult;
+    /**
+     * Takes ownership of every element in `references`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(content?: string | null, references?: WasmCitationReference[] | null);
     content: string;
+    /**
+     * Returns detached copies of the elements in `references`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `references`.
+     */
     references: WasmCitationReference[];
 }
 
@@ -257,6 +419,13 @@ export class WasmCitationResult {
 export class WasmContentConfig {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmContentConfig;
     static default(): WasmContentConfig;
     constructor(outputFormat?: string | null, preprocessingPreset?: string | null, removeNavigation?: boolean | null, removeForms?: boolean | null, stripTags?: string[] | null, preserveTags?: string[] | null, excludeSelectors?: string[] | null, skipImages?: boolean | null, wrap?: boolean | null, wrapWidth?: number | null, includeDocumentStructure?: boolean | null, extractMetadata?: boolean | null, maxDepth?: number | null);
     excludeSelectors: string[];
@@ -288,6 +457,13 @@ export enum WasmContentFilterKind {
 export class WasmCookieInfo {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmCookieInfo;
     static default(): WasmCookieInfo;
     constructor(name?: string | null, value?: string | null, domain?: string | null, path?: string | null);
     get domain(): string | undefined;
@@ -304,7 +480,22 @@ export class WasmCookieInfo {
 export class WasmCrawlConfig {
     free(): void;
     [Symbol.dispose](): void;
+    clearProxy(): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmCrawlConfig;
     static default(): WasmCrawlConfig;
+    /**
+     * Takes ownership of `content`, `browser`, `proxy`, `ssrf`.
+     * wasm-bindgen lowers a by-value class argument through `__destroy_into_raw()`, so each
+     * of those handles is dead once this returns. Passing a freshly built value is fine. To
+     * keep a handle you already hold, build with `default()` and assign the property instead:
+     * the generated setter borrows and leaves your handle alive.
+     */
     constructor(crawlStrategy?: WasmCrawlStrategyKind | null, respectRobotsTxt?: boolean | null, softHttpErrors?: boolean | null, stayOnDomain?: boolean | null, allowSubdomains?: boolean | null, includePaths?: string[] | null, excludePaths?: string[] | null, pathPatternsMatchQuery?: boolean | null, pathPatternsMatchUrl?: boolean | null, dedupIncludeQuery?: boolean | null, stripTrackingParams?: boolean | null, trackingParams?: string[] | null, customHeaders?: any | null, requestTimeout?: bigint | null, maxRedirects?: number | null, retryCount?: number | null, retryCodes?: Uint16Array | null, retryInitialDelayMs?: bigint | null, retryMaxDelayMs?: bigint | null, rateLimitJitterRatio?: number | null, cookiesEnabled?: boolean | null, removeTags?: string[] | null, content?: WasmContentConfig | null, downloadAssets?: boolean | null, assetTypes?: WasmAssetCategory[] | null, browser?: WasmBrowserConfig | null, userAgents?: string[] | null, captureScreenshot?: boolean | null, followDocumentUrls?: boolean | null, downloadDocuments?: boolean | null, documentMimeTypes?: string[] | null, saveBrowserProfile?: boolean | null, ssrf?: WasmSsrfPolicy | null, maxDepth?: number | null, maxPages?: number | null, maxLinksPerPage?: number | null, maxConcurrent?: number | null, contentFilter?: WasmContentFilterKind | null, bm25Query?: string | null, bm25Threshold?: number | null, userAgent?: string | null, rateLimitMs?: bigint | null, auth?: any | null, maxBodySize?: number | null, mapLimit?: number | null, mapSearch?: string | null, maxAssetSize?: number | null, proxy?: WasmProxyConfig | null, documentUrlDepth?: number | null, documentMaxSize?: number | null, documentOutputDir?: string | null, documentContentEncoding?: WasmDocumentContentEncoding | null, warcOutput?: string | null, browserProfile?: string | null, ssrfDenyPrivateExplicit?: boolean | null);
     /**
      * Validate the configuration, returning an error if any values are invalid.
@@ -323,10 +514,22 @@ export class WasmCrawlConfig {
     set bm25Threshold(value: number | null | undefined);
     get browserProfile(): string | undefined;
     set browserProfile(value: string | null | undefined);
+    /**
+     * Returns a detached copy of `browser`.
+     *
+     * Changes to the returned value do not update this object. To update `browser`,
+     * read it, modify the copy, then assign the copy back to `browser`.
+     */
     browser: WasmBrowserConfig;
     captureScreenshot: boolean;
     get contentFilter(): string | undefined;
     set contentFilter(value: WasmContentFilterKind | null | undefined);
+    /**
+     * Returns a detached copy of `content`.
+     *
+     * Changes to the returned value do not update this object. To update `content`,
+     * read it, modify the copy, then assign the copy back to `content`.
+     */
     content: WasmContentConfig;
     cookiesEnabled: boolean;
     get crawlStrategy(): string;
@@ -366,8 +569,14 @@ export class WasmCrawlConfig {
     maxRedirects: number;
     pathPatternsMatchQuery: boolean;
     pathPatternsMatchUrl: boolean;
+    /**
+     * Returns a detached copy of `proxy`.
+     *
+     * Changes to the returned value do not update this object. To update `proxy`,
+     * read it, modify the copy, then assign the copy back to `proxy`.
+     */
     get proxy(): WasmProxyConfig | undefined;
-    set proxy(value: WasmProxyConfig | null | undefined);
+    set proxy(value: WasmProxyConfig);
     rateLimitJitterRatio: number;
     get rateLimitMs(): bigint | undefined;
     set rateLimitMs(value: bigint | null | undefined);
@@ -383,6 +592,12 @@ export class WasmCrawlConfig {
     softHttpErrors: boolean;
     get ssrfDenyPrivateExplicit(): boolean | undefined;
     set ssrfDenyPrivateExplicit(value: boolean | null | undefined);
+    /**
+     * Returns a detached copy of `ssrf`.
+     *
+     * Changes to the returned value do not update this object. To update `ssrf`,
+     * read it, modify the copy, then assign the copy back to `ssrf`.
+     */
     ssrf: WasmSsrfPolicy;
     stayOnDomain: boolean;
     stripTrackingParams: boolean;
@@ -404,6 +619,13 @@ export class WasmCrawlEngineHandle {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmCrawlEngineHandle;
 }
 
 /**
@@ -412,7 +634,27 @@ export class WasmCrawlEngineHandle {
 export class WasmCrawlPageResult {
     free(): void;
     [Symbol.dispose](): void;
+    clearDownloadedDocument(): void;
+    clearExtractionMeta(): void;
+    clearMarkdown(): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmCrawlPageResult;
     static default(): WasmCrawlPageResult;
+    /**
+     * Takes ownership of `metadata`, `markdown`, `extractionMeta`, `downloadedDocument`.
+     * wasm-bindgen lowers a by-value class argument through `__destroy_into_raw()`, so each
+     * of those handles is dead once this returns. Passing a freshly built value is fine. To
+     * keep a handle you already hold, build with `default()` and assign the property instead:
+     * the generated setter borrows and leaves your handle alive.
+     * Takes ownership of every element in `links`, `images`, `feeds`, `jsonLd`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(url?: string | null, normalizedUrl?: string | null, statusCode?: number | null, contentType?: string | null, html?: string | null, bodySize?: number | null, metadata?: WasmPageMetadata | null, links?: WasmLinkInfo[] | null, images?: WasmImageInfo[] | null, feeds?: WasmFeedInfo[] | null, jsonLd?: WasmJsonLdEntry[] | null, depth?: number | null, stayedOnDomain?: boolean | null, wasSkipped?: boolean | null, isPdf?: boolean | null, browserUsed?: boolean | null, finalUrl?: string | null, redirectCount?: number | null, noindexDetected?: boolean | null, nofollowDetected?: boolean | null, ssrfRefusedUrls?: string[] | null, detectedCharset?: string | null, markdown?: WasmMarkdownResult | null, extractedData?: any | null, extractionMeta?: WasmExtractionMeta | null, downloadedDocument?: WasmDownloadedDocument | null);
     bodySize: number;
     browserUsed: boolean;
@@ -420,21 +662,69 @@ export class WasmCrawlPageResult {
     depth: number;
     get detectedCharset(): string | undefined;
     set detectedCharset(value: string | null | undefined);
+    /**
+     * Returns a detached copy of `downloadedDocument`.
+     *
+     * Changes to the returned value do not update this object. To update `downloadedDocument`,
+     * read it, modify the copy, then assign the copy back to `downloadedDocument`.
+     */
     get downloadedDocument(): WasmDownloadedDocument | undefined;
-    set downloadedDocument(value: WasmDownloadedDocument | null | undefined);
+    set downloadedDocument(value: WasmDownloadedDocument);
     get extractedData(): any | undefined;
     set extractedData(value: any | null | undefined);
+    /**
+     * Returns a detached copy of `extractionMeta`.
+     *
+     * Changes to the returned value do not update this object. To update `extractionMeta`,
+     * read it, modify the copy, then assign the copy back to `extractionMeta`.
+     */
     get extractionMeta(): WasmExtractionMeta | undefined;
-    set extractionMeta(value: WasmExtractionMeta | null | undefined);
+    set extractionMeta(value: WasmExtractionMeta);
+    /**
+     * Returns detached copies of the elements in `feeds`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `feeds`.
+     */
     feeds: WasmFeedInfo[];
     finalUrl: string;
     html: string;
+    /**
+     * Returns detached copies of the elements in `images`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `images`.
+     */
     images: WasmImageInfo[];
     isPdf: boolean;
+    /**
+     * Returns detached copies of the elements in `jsonLd`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `jsonLd`.
+     */
     jsonLd: WasmJsonLdEntry[];
+    /**
+     * Returns detached copies of the elements in `links`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `links`.
+     */
     links: WasmLinkInfo[];
+    /**
+     * Returns a detached copy of `markdown`.
+     *
+     * Changes to the returned value do not update this object. To update `markdown`,
+     * read it, modify the copy, then assign the copy back to `markdown`.
+     */
     get markdown(): WasmMarkdownResult | undefined;
-    set markdown(value: WasmMarkdownResult | null | undefined);
+    set markdown(value: WasmMarkdownResult);
+    /**
+     * Returns a detached copy of `metadata`.
+     *
+     * Changes to the returned value do not update this object. To update `metadata`,
+     * read it, modify the copy, then assign the copy back to `metadata`.
+     */
     metadata: WasmPageMetadata;
     nofollowDetected: boolean;
     noindexDetected: boolean;
@@ -453,7 +743,19 @@ export class WasmCrawlPageResult {
 export class WasmCrawlResult {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmCrawlResult;
     static default(): WasmCrawlResult;
+    /**
+     * Takes ownership of every element in `pages`, `cookies`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(pages?: WasmCrawlPageResult[] | null, finalUrl?: string | null, redirectCount?: number | null, wasSkipped?: boolean | null, cookies?: WasmCookieInfo[] | null, stayedOnDomain?: boolean | null, browserUsed?: boolean | null, error?: string | null);
     /**
      * Returns the count of unique normalized URLs encountered during crawling.
@@ -467,10 +769,22 @@ export class WasmCrawlResult {
      */
     uniqueNormalizedUrls(): number;
     browserUsed: boolean;
+    /**
+     * Returns detached copies of the elements in `cookies`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `cookies`.
+     */
     cookies: WasmCookieInfo[];
     get error(): string | undefined;
     set error(value: string | null | undefined);
     finalUrl: string;
+    /**
+     * Returns detached copies of the elements in `pages`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `pages`.
+     */
     pages: WasmCrawlPageResult[];
     redirectCount: number;
     stayedOnDomain: boolean;
@@ -509,6 +823,13 @@ export enum WasmDocumentContentEncoding {
 export class WasmDownloadedAsset {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmDownloadedAsset;
     static default(): WasmDownloadedAsset;
     constructor(url?: string | null, contentHash?: string | null, size?: number | null, assetCategory?: WasmAssetCategory | null, mimeType?: string | null, htmlTag?: string | null);
     get assetCategory(): string;
@@ -532,6 +853,13 @@ export class WasmDownloadedAsset {
 export class WasmDownloadedDocument {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmDownloadedDocument;
     static default(): WasmDownloadedDocument;
     constructor(url?: string | null, mimeType?: string | null, size?: number | null, contentHash?: string | null, headers?: any | null, truncated?: boolean | null, filename?: string | null, contentPath?: string | null, contentBase64?: string | null);
     get contentBase64(): string | undefined;
@@ -554,6 +882,13 @@ export class WasmDownloadedDocument {
 export class WasmExtractionMeta {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmExtractionMeta;
     static default(): WasmExtractionMeta;
     constructor(chunksProcessed?: number | null, cost?: number | null, promptTokens?: bigint | null, completionTokens?: bigint | null, model?: string | null);
     chunksProcessed: number;
@@ -573,6 +908,13 @@ export class WasmExtractionMeta {
 export class WasmFaviconInfo {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmFaviconInfo;
     static default(): WasmFaviconInfo;
     constructor(url?: string | null, rel?: string | null, sizes?: string | null, mimeType?: string | null);
     get mimeType(): string | undefined;
@@ -589,6 +931,13 @@ export class WasmFaviconInfo {
 export class WasmFeedInfo {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmFeedInfo;
     static default(): WasmFeedInfo;
     constructor(url?: string | null, feedType?: WasmFeedType | null, title?: string | null);
     get feedType(): string;
@@ -613,6 +962,13 @@ export enum WasmFeedType {
 export class WasmHeadingInfo {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmHeadingInfo;
     static default(): WasmHeadingInfo;
     constructor(level?: number | null, text?: string | null);
     level: number;
@@ -652,6 +1008,13 @@ export class WasmHostMatcher {
 export class WasmHreflangEntry {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmHreflangEntry;
     static default(): WasmHreflangEntry;
     constructor(lang?: string | null, url?: string | null);
     lang: string;
@@ -664,6 +1027,13 @@ export class WasmHreflangEntry {
 export class WasmImageInfo {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmImageInfo;
     static default(): WasmImageInfo;
     constructor(url?: string | null, source?: WasmImageSource | null, alt?: string | null, width?: number | null, height?: number | null);
     get alt(): string | undefined;
@@ -693,8 +1063,26 @@ export enum WasmImageSource {
 export class WasmInteractionResult {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmInteractionResult;
     static default(): WasmInteractionResult;
+    /**
+     * Takes ownership of every element in `actionResults`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(actionResults?: WasmActionResult[] | null, finalHtml?: string | null, finalUrl?: string | null, ssrfRefusedUrls?: string[] | null, screenshotBase64?: string | null);
+    /**
+     * Returns detached copies of the elements in `actionResults`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `actionResults`.
+     */
     actionResults: WasmActionResult[];
     finalHtml: string;
     finalUrl: string;
@@ -709,6 +1097,13 @@ export class WasmInteractionResult {
 export class WasmJsonLdEntry {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmJsonLdEntry;
     static default(): WasmJsonLdEntry;
     constructor(schemaType?: string | null, raw?: string | null, name?: string | null);
     get name(): string | undefined;
@@ -723,6 +1118,13 @@ export class WasmJsonLdEntry {
 export class WasmLinkInfo {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmLinkInfo;
     static default(): WasmLinkInfo;
     constructor(url?: string | null, text?: string | null, linkType?: WasmLinkType | null, nofollow?: boolean | null, rel?: string | null);
     get linkType(): string;
@@ -750,8 +1152,26 @@ export enum WasmLinkType {
 export class WasmMapResult {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmMapResult;
     static default(): WasmMapResult;
+    /**
+     * Takes ownership of every element in `urls`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(urls?: WasmSitemapUrl[] | null);
+    /**
+     * Returns detached copies of the elements in `urls`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `urls`.
+     */
     urls: WasmSitemapUrl[];
 }
 
@@ -761,6 +1181,13 @@ export class WasmMapResult {
 export class WasmMarkdownResult {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmMarkdownResult;
     static default(): WasmMarkdownResult;
     constructor(content?: string | null, tables?: any | null, warnings?: string[] | null, citations?: boolean | null, documentStructure?: any | null, fitContent?: string | null);
     citations: boolean;
@@ -809,10 +1236,34 @@ export class WasmPageAction {
 export class WasmPageMetadata {
     free(): void;
     [Symbol.dispose](): void;
+    clearArticle(): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmPageMetadata;
     static default(): WasmPageMetadata;
+    /**
+     * Takes ownership of `article`.
+     * wasm-bindgen lowers a by-value class argument through `__destroy_into_raw()`, so each
+     * of those handles is dead once this returns. Passing a freshly built value is fine. To
+     * keep a handle you already hold, build with `default()` and assign the property instead:
+     * the generated setter borrows and leaves your handle alive.
+     * Takes ownership of every element in `hreflangs`, `favicons`, `headings`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(title?: string | null, description?: string | null, canonicalUrl?: string | null, keywords?: string | null, author?: string | null, viewport?: string | null, themeColor?: string | null, generator?: string | null, robots?: string | null, htmlLang?: string | null, htmlDir?: string | null, ogTitle?: string | null, ogType?: string | null, ogImage?: string | null, ogDescription?: string | null, ogUrl?: string | null, ogSiteName?: string | null, ogLocale?: string | null, ogVideo?: string | null, ogAudio?: string | null, ogLocaleAlternates?: string[] | null, twitterCard?: string | null, twitterTitle?: string | null, twitterDescription?: string | null, twitterImage?: string | null, twitterSite?: string | null, twitterCreator?: string | null, dcTitle?: string | null, dcCreator?: string | null, dcSubject?: string | null, dcDescription?: string | null, dcPublisher?: string | null, dcDate?: string | null, dcType?: string | null, dcFormat?: string | null, dcIdentifier?: string | null, dcLanguage?: string | null, dcRights?: string | null, article?: WasmArticleMetadata | null, hreflangs?: WasmHreflangEntry[] | null, favicons?: WasmFaviconInfo[] | null, headings?: WasmHeadingInfo[] | null, wordCount?: number | null);
+    /**
+     * Returns a detached copy of `article`.
+     *
+     * Changes to the returned value do not update this object. To update `article`,
+     * read it, modify the copy, then assign the copy back to `article`.
+     */
     get article(): WasmArticleMetadata | undefined;
-    set article(value: WasmArticleMetadata | null | undefined);
+    set article(value: WasmArticleMetadata);
     get author(): string | undefined;
     set author(value: string | null | undefined);
     get canonicalUrl(): string | undefined;
@@ -841,13 +1292,46 @@ export class WasmPageMetadata {
     set dcType(value: string | null | undefined);
     get description(): string | undefined;
     set description(value: string | null | undefined);
+    /**
+     * Returns detached copies of the elements in `favicons`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `favicons`.
+     */
     get favicons(): Array<any> | undefined;
+    /**
+     * Takes ownership of every element in `favicons`.
+     * wasm-bindgen cannot borrow class values nested in an array; copy each retained
+     * element with `copyForTransfer()` before passing the array.
+     */
     set favicons(value: WasmFaviconInfo[] | null | undefined);
     get generator(): string | undefined;
     set generator(value: string | null | undefined);
+    /**
+     * Returns detached copies of the elements in `headings`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `headings`.
+     */
     get headings(): Array<any> | undefined;
+    /**
+     * Takes ownership of every element in `headings`.
+     * wasm-bindgen cannot borrow class values nested in an array; copy each retained
+     * element with `copyForTransfer()` before passing the array.
+     */
     set headings(value: WasmHeadingInfo[] | null | undefined);
+    /**
+     * Returns detached copies of the elements in `hreflangs`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `hreflangs`.
+     */
     get hreflangs(): Array<any> | undefined;
+    /**
+     * Takes ownership of every element in `hreflangs`.
+     * wasm-bindgen cannot borrow class values nested in an array; copy each retained
+     * element with `copyForTransfer()` before passing the array.
+     */
     set hreflangs(value: WasmHreflangEntry[] | null | undefined);
     get htmlDir(): string | undefined;
     set htmlDir(value: string | null | undefined);
@@ -905,6 +1389,13 @@ export class WasmPageMetadata {
 export class WasmProxyConfig {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmProxyConfig;
     static default(): WasmProxyConfig;
     constructor(url?: string | null, username?: string | null, password?: string | null);
     get password(): string | undefined;
@@ -920,6 +1411,13 @@ export class WasmProxyConfig {
 export class WasmResponseMeta {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmResponseMeta;
     static default(): WasmResponseMeta;
     constructor(etag?: string | null, lastModified?: string | null, cacheControl?: string | null, server?: string | null, xPoweredBy?: string | null, contentLanguage?: string | null, contentEncoding?: string | null);
     get cacheControl(): string | undefined;
@@ -944,41 +1442,129 @@ export class WasmResponseMeta {
 export class WasmScrapeResult {
     free(): void;
     [Symbol.dispose](): void;
+    clearBrowser(): void;
+    clearDownloadedDocument(): void;
+    clearExtractionMeta(): void;
+    clearMarkdown(): void;
+    clearResponseMeta(): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmScrapeResult;
     static default(): WasmScrapeResult;
+    /**
+     * Takes ownership of `metadata`, `responseMeta`, `markdown`, `extractionMeta`, `downloadedDocument`, `browser`.
+     * wasm-bindgen lowers a by-value class argument through `__destroy_into_raw()`, so each
+     * of those handles is dead once this returns. Passing a freshly built value is fine. To
+     * keep a handle you already hold, build with `default()` and assign the property instead:
+     * the generated setter borrows and leaves your handle alive.
+     * Takes ownership of every element in `links`, `images`, `feeds`, `jsonLd`, `assets`.
+     * wasm-bindgen cannot borrow class values nested in an array. To keep those handles,
+     * copy each retained element with `copyForTransfer()` before passing the array.
+     */
     constructor(statusCode?: number | null, finalUrl?: string | null, contentType?: string | null, html?: string | null, bodySize?: number | null, metadata?: WasmPageMetadata | null, links?: WasmLinkInfo[] | null, images?: WasmImageInfo[] | null, feeds?: WasmFeedInfo[] | null, jsonLd?: WasmJsonLdEntry[] | null, isAllowed?: boolean | null, noindexDetected?: boolean | null, nofollowDetected?: boolean | null, isPdf?: boolean | null, wasSkipped?: boolean | null, authHeaderSent?: boolean | null, assets?: WasmDownloadedAsset[] | null, jsRenderHint?: boolean | null, browserUsed?: boolean | null, ssrfRefusedUrls?: string[] | null, crawlDelay?: bigint | null, xRobotsTag?: string | null, detectedCharset?: string | null, responseMeta?: WasmResponseMeta | null, markdown?: WasmMarkdownResult | null, extractedData?: any | null, extractionMeta?: WasmExtractionMeta | null, screenshotBase64?: string | null, downloadedDocument?: WasmDownloadedDocument | null, browser?: WasmBrowserExtras | null);
+    /**
+     * Returns detached copies of the elements in `assets`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `assets`.
+     */
     assets: WasmDownloadedAsset[];
     authHeaderSent: boolean;
     bodySize: number;
     browserUsed: boolean;
+    /**
+     * Returns a detached copy of `browser`.
+     *
+     * Changes to the returned value do not update this object. To update `browser`,
+     * read it, modify the copy, then assign the copy back to `browser`.
+     */
     get browser(): WasmBrowserExtras | undefined;
-    set browser(value: WasmBrowserExtras | null | undefined);
+    set browser(value: WasmBrowserExtras);
     contentType: string;
     get crawlDelay(): bigint | undefined;
     set crawlDelay(value: bigint | null | undefined);
     get detectedCharset(): string | undefined;
     set detectedCharset(value: string | null | undefined);
+    /**
+     * Returns a detached copy of `downloadedDocument`.
+     *
+     * Changes to the returned value do not update this object. To update `downloadedDocument`,
+     * read it, modify the copy, then assign the copy back to `downloadedDocument`.
+     */
     get downloadedDocument(): WasmDownloadedDocument | undefined;
-    set downloadedDocument(value: WasmDownloadedDocument | null | undefined);
+    set downloadedDocument(value: WasmDownloadedDocument);
     get extractedData(): any | undefined;
     set extractedData(value: any | null | undefined);
+    /**
+     * Returns a detached copy of `extractionMeta`.
+     *
+     * Changes to the returned value do not update this object. To update `extractionMeta`,
+     * read it, modify the copy, then assign the copy back to `extractionMeta`.
+     */
     get extractionMeta(): WasmExtractionMeta | undefined;
-    set extractionMeta(value: WasmExtractionMeta | null | undefined);
+    set extractionMeta(value: WasmExtractionMeta);
+    /**
+     * Returns detached copies of the elements in `feeds`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `feeds`.
+     */
     feeds: WasmFeedInfo[];
     finalUrl: string;
     html: string;
+    /**
+     * Returns detached copies of the elements in `images`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `images`.
+     */
     images: WasmImageInfo[];
     isAllowed: boolean;
     isPdf: boolean;
     jsRenderHint: boolean;
+    /**
+     * Returns detached copies of the elements in `jsonLd`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `jsonLd`.
+     */
     jsonLd: WasmJsonLdEntry[];
+    /**
+     * Returns detached copies of the elements in `links`.
+     *
+     * Changes to the returned values do not update this object. Modify the copies,
+     * then assign the array back to `links`.
+     */
     links: WasmLinkInfo[];
+    /**
+     * Returns a detached copy of `markdown`.
+     *
+     * Changes to the returned value do not update this object. To update `markdown`,
+     * read it, modify the copy, then assign the copy back to `markdown`.
+     */
     get markdown(): WasmMarkdownResult | undefined;
-    set markdown(value: WasmMarkdownResult | null | undefined);
+    set markdown(value: WasmMarkdownResult);
+    /**
+     * Returns a detached copy of `metadata`.
+     *
+     * Changes to the returned value do not update this object. To update `metadata`,
+     * read it, modify the copy, then assign the copy back to `metadata`.
+     */
     metadata: WasmPageMetadata;
     nofollowDetected: boolean;
     noindexDetected: boolean;
+    /**
+     * Returns a detached copy of `responseMeta`.
+     *
+     * Changes to the returned value do not update this object. To update `responseMeta`,
+     * read it, modify the copy, then assign the copy back to `responseMeta`.
+     */
     get responseMeta(): WasmResponseMeta | undefined;
-    set responseMeta(value: WasmResponseMeta | null | undefined);
+    set responseMeta(value: WasmResponseMeta);
     get screenshotBase64(): string | undefined;
     set screenshotBase64(value: string | null | undefined);
     ssrfRefusedUrls: string[];
@@ -1002,6 +1588,13 @@ export enum WasmScrollDirection {
 export class WasmSitemapUrl {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmSitemapUrl;
     static default(): WasmSitemapUrl;
     constructor(url?: string | null, lastmod?: string | null, changefreq?: string | null, priority?: string | null);
     get changefreq(): string | undefined;
@@ -1019,6 +1612,13 @@ export class WasmSitemapUrl {
 export class WasmSsrfPolicy {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return an independent handle for an ownership-taking API.
+     *
+     * Use `copyForTransfer()` for each class value placed in an array when the original
+     * handle must remain usable.
+     */
+    copyForTransfer(): WasmSsrfPolicy;
     static default(): WasmSsrfPolicy;
     /**
      * Create a policy from environment variables.
@@ -1032,18 +1632,19 @@ export class WasmSsrfPolicy {
      * - Rust-side SSRF checking is unenforceable and redundant in a wasm32 context.
      * - For testing and localhost access, the host's network sandbox is the enforcing boundary.
      *
-     * **Node.js caveat:** `deny_private` (whatever its value) has no effect on hostname-based
-     * requests under `wasm32`. There is no DNS resolution on this target, so `validate_url`
-     * only ever checks a literal IP host; a domain name falls straight through to `Ok(())`. In a
-     * browser this is covered by same-origin/CORS. Node's `fetch` enforces no CORS, so a Node
-     * service embedding this wasm module can be driven to internal hosts by domain name even
-     * though `deny_private = true`. Do not rely on this policy to stop that in Node — enforce
-     * egress restrictions (network policy, firewall, proxy allowlist) outside the process.
+     * **Node.js caveat:** `deny_private` and `denylist` have no effect on hostname-based requests
+     * under `wasm32`. There is no DNS resolution on this target, so `validate_url` only ever
+     * checks a literal IP host; a domain name falls straight through to `Ok(())`. In a browser
+     * this is covered by same-origin/CORS. Node's `fetch` enforces no CORS, so a Node service
+     * embedding this wasm module can be driven to internal hosts by domain name despite the
+     * policy. Enforce egress restrictions (network policy, firewall, proxy allowlist) outside
+     * the process.
      */
     static fromEnv(): WasmSsrfPolicy;
-    constructor(denyPrivate?: boolean | null, allowlist?: any | null, maxRedirects?: number | null, schemeAllowlist?: string[] | null);
+    constructor(denyPrivate?: boolean | null, allowlist?: any | null, denylist?: any | null, maxRedirects?: number | null, schemeAllowlist?: string[] | null);
     allowlist: any;
     denyPrivate: boolean;
+    denylist: any;
     maxRedirects: number;
     schemeAllowlist: string[];
 }