@openclaw/firecrawl-plugin 2026.8.1-beta.2 → 2026.8.1-beta.3

package/dist/api.js

@@ -1,4 +1,4 @@
-import { n as runFirecrawlScrape } from "./firecrawl-client-Aw46OXVC.js";
+import { n as runFirecrawlScrape } from "./firecrawl-client-mz7GIgb4.js";
 import { readStringValue } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/firecrawl/api.ts
 async function fetchFirecrawlContent(params) {

package/dist/{firecrawl-client-Aw46OXVC.js → firecrawl-client-mz7GIgb4.js}

@@ -1,10 +1,12 @@
+import { parseFiniteNumber } from "openclaw/plugin-sdk/number-runtime";
 import { readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
 import { DEFAULT_CACHE_TTL_MINUTES, markdownToText, normalizeCacheKey, readCache, readResponseText, resolveCacheTtlMs, resolvePositiveTimeoutSeconds, withSelfHostedWebToolsEndpoint, withStrictWebToolsEndpoint, writeCache } from "openclaw/plugin-sdk/provider-web-fetch";
-import { normalizeSecretInput, resolveSecretInputString } from "openclaw/plugin-sdk/secret-input";
+import { normalizeSecretInput } from "openclaw/plugin-sdk/secret-input";
 import { truncateSanitizedExternalContent, wrapExternalContent, wrapWebContent } from "openclaw/plugin-sdk/security-runtime";
 import { SsrFBlockedError, isBlockedHostnameOrIp, isPrivateIpAddress, resolvePinnedHostnameWithPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { canResolveEnvSecretRefInReadOnlyPath } from "openclaw/plugin-sdk/extension-shared";
+import { z } from "zod";
+import { resolveReadOnlyEnvSecretRef } from "openclaw/plugin-sdk/secret-ref-readonly";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -29,33 +31,13 @@ function resolveFirecrawlFetchConfig(cfg) {
 	if (pluginWebFetch && typeof pluginWebFetch === "object" && !Array.isArray(pluginWebFetch)) return pluginWebFetch;
 }
 function resolveConfiguredSecret(value, path, cfg) {
-	const resolved = resolveSecretInputString({
+	return resolveReadOnlyEnvSecretRef({
 		value,
 		path,
-		defaults: cfg?.secrets?.defaults,
-		mode: "inspect"
-	});
-	if (resolved.status === "available") {
-		const normalized = normalizeSecretInput(resolved.value);
-		return normalized ? {
-			status: "available",
-			value: normalized
-		} : { status: "missing" };
-	}
-	if (resolved.status === "missing") return { status: "missing" };
-	if (resolved.ref.source !== "env") return { status: "blocked" };
-	const envVarName = resolved.ref.id.trim();
-	if (envVarName !== FIRECRAWL_API_KEY_ENV_VAR) return { status: "blocked" };
-	if (!canResolveEnvSecretRefInReadOnlyPath({
 		cfg,
-		provider: resolved.ref.provider,
-		id: envVarName
-	})) return { status: "blocked" };
-	const envValue = normalizeSecretInput(process.env[envVarName]);
-	return envValue ? {
-		status: "available",
-		value: envValue
-	} : { status: "missing" };
+		expectedEnvId: FIRECRAWL_API_KEY_ENV_VAR,
+		normalizeValue: normalizeSecretInput
+	});
 }
 function resolveFirecrawlApiKey(cfg) {
 	const pluginConfig = cfg?.plugins?.entries?.firecrawl?.config;
@@ -109,7 +91,6 @@ var firecrawl_client_exports = /* @__PURE__ */ __exportAll({
 	testing: () => testing
 });
 const SEARCH_CACHE = /* @__PURE__ */ new Map();
-const SCRAPE_CACHE = /* @__PURE__ */ new Map();
 const DEFAULT_SEARCH_COUNT = 5;
 const FIRECRAWL_SEARCH_MAX_RESULTS = 100;
 const FIRECRAWL_SEARCH_MAX_CONTENT_CHARS = 2e4;
@@ -176,7 +157,7 @@ async function resolveEndpoint(baseUrl, pathname, lookupFn) {
 }
 async function postFirecrawlJson(params, parse) {
 	const apiKey = normalizeSecretInput(params.apiKey);
-	return await ((params.mode ?? await validateFirecrawlBaseUrl(params.url)) === "selfHosted" ? withSelfHostedWebToolsEndpoint : withStrictWebToolsEndpoint)({
+	const result = await ((params.mode ?? await validateFirecrawlBaseUrl(params.url)) === "selfHosted" ? withSelfHostedWebToolsEndpoint : withStrictWebToolsEndpoint)({
 		url: params.url,
 		timeoutSeconds: params.timeoutSeconds,
 		...params.signal ? { signal: params.signal } : {},
@@ -213,6 +194,8 @@ async function postFirecrawlJson(params, parse) {
 		}
 		return await parse(response);
 	});
+	params.signal?.throwIfAborted();
+	return result;
 }
 function resolveSiteName(urlRaw) {
 	try {
@@ -231,27 +214,61 @@ function normalizeFirecrawlResultUrl(value) {
 		return;
 	}
 }
+const optionalFirecrawlStringSchema = z.string().optional().catch(void 0);
+const invalidFirecrawlSearchItemSchema = z.unknown().transform(() => null);
+const firecrawlSearchMetadataSchema = z.object({
+	sourceURL: optionalFirecrawlStringSchema,
+	title: optionalFirecrawlStringSchema,
+	publishedTime: optionalFirecrawlStringSchema,
+	publishedDate: optionalFirecrawlStringSchema
+}).optional().catch(void 0);
+const firecrawlSearchItemSchema = z.object({
+	url: optionalFirecrawlStringSchema,
+	sourceURL: optionalFirecrawlStringSchema,
+	sourceUrl: optionalFirecrawlStringSchema,
+	title: optionalFirecrawlStringSchema,
+	description: optionalFirecrawlStringSchema,
+	snippet: optionalFirecrawlStringSchema,
+	summary: optionalFirecrawlStringSchema,
+	markdown: optionalFirecrawlStringSchema,
+	content: optionalFirecrawlStringSchema,
+	text: optionalFirecrawlStringSchema,
+	publishedDate: optionalFirecrawlStringSchema,
+	published: optionalFirecrawlStringSchema,
+	metadata: firecrawlSearchMetadataSchema
+});
+const firecrawlSearchItemsSchema = z.array(z.union([firecrawlSearchItemSchema, invalidFirecrawlSearchItemSchema])).transform((items) => items.filter((item) => item !== null));
+const firecrawlNestedSearchDataSchema = z.looseObject({
+	results: firecrawlSearchItemsSchema.optional().catch(void 0),
+	data: firecrawlSearchItemsSchema.optional().catch(void 0),
+	web: firecrawlSearchItemsSchema.optional().catch(void 0)
+});
+const firecrawlSearchPayloadSchema = z.looseObject({
+	data: z.union([firecrawlSearchItemsSchema, firecrawlNestedSearchDataSchema]).optional().catch(void 0),
+	results: firecrawlSearchItemsSchema.optional().catch(void 0),
+	web: z.looseObject({ results: firecrawlSearchItemsSchema.optional().catch(void 0) }).optional().catch(void 0)
+});
 function resolveSearchItems(payload) {
+	const parsed = firecrawlSearchPayloadSchema.parse(payload);
+	const nestedData = Array.isArray(parsed.data) ? void 0 : parsed.data;
 	const rawItems = [
-		payload.data,
-		payload.results,
-		payload.data?.results,
-		payload.data?.data,
-		payload.data?.web,
-		payload.web?.results
-	].find((candidate) => Array.isArray(candidate));
-	if (!Array.isArray(rawItems)) return [];
+		Array.isArray(parsed.data) ? parsed.data : void 0,
+		parsed.results,
+		nestedData?.results,
+		nestedData?.data,
+		nestedData?.web,
+		parsed.web?.results
+	].find((candidate) => candidate !== void 0);
+	if (!rawItems) return [];
 	const items = [];
 	for (const entry of rawItems.slice(0, FIRECRAWL_SEARCH_MAX_RESULTS)) {
-		if (!entry || typeof entry !== "object") continue;
-		const record = entry;
-		const metadata = record.metadata && typeof record.metadata === "object" ? record.metadata : void 0;
-		const url = normalizeFirecrawlResultUrl(typeof record.url === "string" && record.url || typeof record.sourceURL === "string" && record.sourceURL || typeof record.sourceUrl === "string" && record.sourceUrl || typeof metadata?.sourceURL === "string" && metadata.sourceURL || "");
+		const metadata = entry.metadata;
+		const url = normalizeFirecrawlResultUrl(entry.url || entry.sourceURL || entry.sourceUrl || metadata?.sourceURL || "");
 		if (!url) continue;
-		const title = typeof record.title === "string" && record.title || typeof metadata?.title === "string" && metadata.title || "";
-		const description = typeof record.description === "string" && record.description || typeof record.snippet === "string" && record.snippet || typeof record.summary === "string" && record.summary || void 0;
-		const content = typeof record.markdown === "string" && record.markdown || typeof record.content === "string" && record.content || typeof record.text === "string" && record.text || void 0;
-		const rawPublished = typeof record.publishedDate === "string" && record.publishedDate || typeof record.published === "string" && record.published || typeof metadata?.publishedTime === "string" && metadata.publishedTime || typeof metadata?.publishedDate === "string" && metadata.publishedDate || void 0;
+		const title = entry.title || metadata?.title || "";
+		const description = entry.description || entry.snippet || entry.summary || void 0;
+		const content = entry.markdown || entry.content || entry.text || void 0;
+		const rawPublished = entry.publishedDate || entry.published || metadata?.publishedTime || metadata?.publishedDate || void 0;
 		const published = rawPublished && FIRECRAWL_PUBLISHED_DATE_RE.test(rawPublished) ? rawPublished : void 0;
 		items.push({
 			title,
@@ -382,6 +399,9 @@ function resolveScrapeData(payload) {
 function parseFirecrawlScrapePayload(params) {
 	const data = resolveScrapeData(params.payload);
 	const metadata = data.metadata && typeof data.metadata === "object" ? data.metadata : void 0;
+	const rawStatus = parseFiniteNumber(metadata?.statusCode) ?? parseFiniteNumber(data.statusCode);
+	const status = rawStatus === void 0 ? void 0 : Math.floor(rawStatus);
+	if (status !== void 0 && (status < 200 || status >= 300)) throw new Error(`Firecrawl fetch failed (${status}): target returned an unsuccessful HTTP status.`);
 	const markdown = typeof data.markdown === "string" && data.markdown || typeof data.content === "string" && data.content || "";
 	if (!markdown) throw new Error("Firecrawl scrape returned no content.");
 	const rawText = params.extractMode === "text" ? markdownToText(markdown) : markdown;
@@ -401,7 +421,6 @@ function parseFirecrawlScrapePayload(params) {
 		source: "web_fetch",
 		includeWarning: false
 	});
-	const status = typeof metadata?.statusCode === "number" && metadata.statusCode || typeof data.statusCode === "number" && data.statusCode || void 0;
 	const title = typeof metadata?.title === "string" && metadata.title ? wrapBoundedMetadata(metadata.title) : void 0;
 	const warning = typeof params.payload.warning === "string" && params.payload.warning ? wrapBoundedMetadata(params.payload.warning) : void 0;
 	return {
@@ -438,24 +457,8 @@ async function runFirecrawlScrape(params) {
 	const maxCharsCap = typeof configuredMaxCharsCap === "number" && Number.isFinite(configuredMaxCharsCap) && configuredMaxCharsCap > 0 ? Math.floor(configuredMaxCharsCap) : DEFAULT_SCRAPE_MAX_CHARS;
 	const requestedMaxChars = typeof params.maxChars === "number" && Number.isFinite(params.maxChars) && params.maxChars > 0 ? Math.floor(params.maxChars) : DEFAULT_SCRAPE_MAX_CHARS;
 	const maxChars = Math.min(requestedMaxChars, maxCharsCap);
-	const cacheKey = normalizeCacheKey(JSON.stringify({
-		type: "firecrawl-scrape",
-		url: params.url,
-		extractMode: params.extractMode,
-		baseUrl,
-		onlyMainContent,
-		maxAgeMs,
-		proxy,
-		storeInCache,
-		maxChars
-	}));
-	const cached = readCache(SCRAPE_CACHE, cacheKey);
-	if (cached) return {
-		...cached.value,
-		cached: true
-	};
 	const endpoint = await resolveEndpoint(baseUrl, "/v2/scrape");
-	const result = parseFirecrawlScrapePayload({
+	return parseFirecrawlScrapePayload({
 		payload: await postFirecrawlJson({
 			url: endpoint.url,
 			mode: endpoint.mode,
@@ -484,8 +487,6 @@ async function runFirecrawlScrape(params) {
 		extractMode: params.extractMode,
 		maxChars
 	});
-	writeCache(SCRAPE_CACHE, cacheKey, result, resolveCacheTtlMs(void 0, DEFAULT_CACHE_TTL_MINUTES));
-	return result;
 }
 const testing = {
 	assertFirecrawlScrapeTargetAllowed,

package/dist/{firecrawl-fetch-provider-CYViV-li.js → firecrawl-fetch-provider-kMXMNJJw.js}

@@ -1,10 +1,10 @@
-import { t as FIRECRAWL_WEB_FETCH_PROVIDER_SHARED } from "./firecrawl-fetch-provider-shared-BhzfHFkE.js";
+import { t as FIRECRAWL_WEB_FETCH_PROVIDER_SHARED } from "./firecrawl-fetch-provider-shared-DlD5WG_i.js";
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
 import { enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-fetch-contract";
 //#region extensions/firecrawl/src/firecrawl-fetch-provider.ts
 let firecrawlClientModulePromise;
 function loadFirecrawlClientModule() {
-	firecrawlClientModulePromise ??= import("./firecrawl-client-Aw46OXVC.js").then((n) => n.t);
+	firecrawlClientModulePromise ??= import("./firecrawl-client-mz7GIgb4.js").then((n) => n.t);
 	return firecrawlClientModulePromise;
 }
 function createFirecrawlWebFetchProvider() {

package/dist/{firecrawl-fetch-provider-shared-BhzfHFkE.js → firecrawl-fetch-provider-shared-DlD5WG_i.js}

@@ -39,7 +39,10 @@ const FIRECRAWL_WEB_FETCH_PROVIDER_SHARED = {
 		};
 	},
 	setConfiguredCredentialValue: (configTarget, value) => {
-		const webFetch = ensureRecord(ensureRecord(ensureRecord(ensureRecord(ensureRecord(configTarget, "plugins"), "entries"), "firecrawl"), "config"), "webFetch");
+		const plugins = configTarget.plugins ??= {};
+		const entries = plugins.entries ??= {};
+		const firecrawlEntry = entries.firecrawl ??= {};
+		const webFetch = ensureRecord(firecrawlEntry.config ??= {}, "webFetch");
 		webFetch.apiKey = value;
 	}
 };

package/dist/{firecrawl-free-search-provider-nqgr2mhw.js → firecrawl-free-search-provider-BnGTMs5x.js}

@@ -2,7 +2,7 @@ import { buildFirecrawlFreeWebSearchProviderBase, buildFirecrawlWebSearchProvide
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 //#region extensions/firecrawl/src/firecrawl-search-provider.ts
-const loadFirecrawlClientModule$1 = createLazyRuntimeModule(() => import("./firecrawl-client-Aw46OXVC.js").then((n) => n.t));
+const loadFirecrawlClientModule$1 = createLazyRuntimeModule(() => import("./firecrawl-client-mz7GIgb4.js").then((n) => n.t));
 const GenericFirecrawlSearchSchema = {
 	type: "object",
 	properties: {
@@ -45,7 +45,7 @@ function createFirecrawlWebSearchProvider() {
 //#region extensions/firecrawl/src/firecrawl-free-search-provider.ts
 let firecrawlClientModulePromise;
 function loadFirecrawlClientModule() {
-	firecrawlClientModulePromise ??= import("./firecrawl-client-Aw46OXVC.js").then((n) => n.t);
+	firecrawlClientModulePromise ??= import("./firecrawl-client-mz7GIgb4.js").then((n) => n.t);
 	return firecrawlClientModulePromise;
 }
 function createFirecrawlFreeWebSearchProvider() {

package/dist/index.js

@@ -1,6 +1,6 @@
-import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./firecrawl-client-Aw46OXVC.js";
-import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-CYViV-li.js";
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-nqgr2mhw.js";
+import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./firecrawl-client-mz7GIgb4.js";
+import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-kMXMNJJw.js";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-BnGTMs5x.js";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { optionalStringEnum } from "openclaw/plugin-sdk/channel-actions";
 import { jsonResult, readNonNegativeIntegerParam, readPositiveIntegerParam, readStringArrayParam, readStringParam } from "openclaw/plugin-sdk/provider-web-search";
@@ -34,7 +34,7 @@ function createFirecrawlScrapeTool(api) {
 		name: "firecrawl_scrape",
 		label: "Firecrawl Scrape",
 		resultContentSource: "network",
-		description: "Scrape a page using Firecrawl v2/scrape. Useful for JS-heavy or bot-protected pages where plain web_fetch is weak.",
+		description: "Scrape a page using Firecrawl v2/scrape. Useful for JS-heavy or bot-protected pages where a plain URL fetch is weak.",
 		parameters: FirecrawlScrapeToolSchema,
 		execute: async (_toolCallId, rawParams, signal) => {
 			signal?.throwIfAborted();

package/dist/web-fetch-contract-api.js

@@ -1,4 +1,4 @@
-import { t as FIRECRAWL_WEB_FETCH_PROVIDER_SHARED } from "./firecrawl-fetch-provider-shared-BhzfHFkE.js";
+import { t as FIRECRAWL_WEB_FETCH_PROVIDER_SHARED } from "./firecrawl-fetch-provider-shared-DlD5WG_i.js";
 import { enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-fetch-contract";
 //#region extensions/firecrawl/web-fetch-contract-api.ts
 function createFirecrawlWebFetchProvider() {

package/dist/web-fetch-provider.js

@@ -1,2 +1,2 @@
-import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-CYViV-li.js";
+import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-kMXMNJJw.js";
 export { createFirecrawlWebFetchProvider };

package/dist/web-search-provider.js

@@ -1,2 +1,2 @@
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-nqgr2mhw.js";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-BnGTMs5x.js";
 export { createFirecrawlFreeWebSearchProvider, createFirecrawlWebSearchProvider };

package/node_modules/zod/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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/node_modules/zod/README.md

@@ -0,0 +1,191 @@
+<p align="center">
+  <img src="logo.svg" width="200px" align="center" alt="Zod logo" />
+  <h1 align="center">Zod</h1>
+  <p align="center">
+    TypeScript-first schema validation with static type inference
+    <br/>
+    by <a href="https://x.com/colinhacks">@colinhacks</a>
+  </p>
+</p>
+<br/>
+
+<p align="center">
+<a href="https://github.com/colinhacks/zod/actions?query=branch%3Amain"><img src="https://github.com/colinhacks/zod/actions/workflows/test.yml/badge.svg?event=push&branch=main" alt="Zod CI status" /></a>
+<a href="https://opensource.org/licenses/MIT" rel="nofollow"><img src="https://img.shields.io/github/license/colinhacks/zod" alt="License"></a>
+<a href="https://www.npmjs.com/package/zod" rel="nofollow"><img src="https://img.shields.io/npm/dw/zod.svg" alt="npm"></a>
+<a href="https://discord.gg/KaSRdyX2vc" rel="nofollow"><img src="https://img.shields.io/discord/893487829802418277?label=Discord&logo=discord&logoColor=white" alt="discord server"></a>
+<a href="https://github.com/colinhacks/zod" rel="nofollow"><img src="https://img.shields.io/github/stars/colinhacks/zod" alt="stars"></a>
+</p>
+
+<div align="center">
+  <a href="https://zod.dev/api">Docs</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://discord.gg/RcG33DQJdf">Discord</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://twitter.com/colinhacks">𝕏</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://bsky.app/profile/zod.dev">Bluesky</a>
+  <br />
+</div>
+
+<br/>
+<br/>
+
+### [Read the docs →](https://zod.dev/api)
+
+<br/>
+<br/>
+
+## What is Zod?
+
+Zod is a TypeScript-first validation library. Define a schema and parse some data with it. You'll get back a strongly typed, validated result.
+
+```ts
+import * as z from "zod";
+
+const User = z.object({
+  name: z.string(),
+});
+
+// some untrusted data...
+const input = {
+  /* stuff */
+};
+
+// the parsed result is validated and type safe!
+const data = User.parse(input);
+
+// so you can use it with confidence :)
+console.log(data.name);
+```
+
+<br/>
+
+## Features
+
+- Zero external dependencies
+- Works in Node.js and all modern browsers
+- Tiny: `2kb` core bundle (gzipped)
+- Immutable API: methods return a new instance
+- Concise interface
+- Works with TypeScript and plain JS
+- Built-in JSON Schema conversion
+- Extensive ecosystem
+
+<br/>
+
+## Installation
+
+```sh
+npm install zod
+```
+
+<br/>
+
+## Basic usage
+
+Before you can do anything else, you need to define a schema. For the purposes of this guide, we'll use a simple object schema.
+
+```ts
+import * as z from "zod";
+
+const Player = z.object({
+  username: z.string(),
+  xp: z.number(),
+});
+```
+
+### Parsing data
+
+Given any Zod schema, use `.parse` to validate an input. If it's valid, Zod returns a strongly-typed _deep clone_ of the input.
+
+```ts
+Player.parse({ username: "billie", xp: 100 });
+// => returns { username: "billie", xp: 100 }
+```
+
+**Note** — If your schema uses certain asynchronous APIs like `async` [refinements](https://zod.dev/api#refinements) or [transforms](https://zod.dev/api#transforms), you'll need to use the `.parseAsync()` method instead.
+
+```ts
+const schema = z.string().refine(async (val) => val.length <= 8);
+
+await schema.parseAsync("hello");
+// => "hello"
+```
+
+### Handling errors
+
+When validation fails, the `.parse()` method will throw a `ZodError` instance with granular information about the validation issues.
+
+```ts
+try {
+  Player.parse({ username: 42, xp: "100" });
+} catch (err) {
+  if (err instanceof z.ZodError) {
+    err.issues;
+    /* [
+      {
+        expected: 'string',
+        code: 'invalid_type',
+        path: [ 'username' ],
+        message: 'Invalid input: expected string'
+      },
+      {
+        expected: 'number',
+        code: 'invalid_type',
+        path: [ 'xp' ],
+        message: 'Invalid input: expected number'
+      }
+    ] */
+  }
+}
+```
+
+To avoid a `try/catch` block, you can use the `.safeParse()` method to get back a plain result object containing either the successfully parsed data or a `ZodError`. The result type is a [discriminated union](https://www.typescriptlang.org/docs/handbook/2/narrowing.html#discriminated-unions), so you can handle both cases conveniently.
+
+```ts
+const result = Player.safeParse({ username: 42, xp: "100" });
+if (!result.success) {
+  result.error; // ZodError instance
+} else {
+  result.data; // { username: string; xp: number }
+}
+```
+
+**Note** — If your schema uses certain asynchronous APIs like `async` [refinements](https://zod.dev/api#refinements) or [transforms](https://zod.dev/api#transforms), you'll need to use the `.safeParseAsync()` method instead.
+
+```ts
+const schema = z.string().refine(async (val) => val.length <= 8);
+
+await schema.safeParseAsync("hello");
+// => { success: true; data: "hello" }
+```
+
+### Inferring types
+
+Zod infers a static type from your schema definitions. You can extract this type with the `z.infer<>` utility and use it however you like.
+
+```ts
+const Player = z.object({
+  username: z.string(),
+  xp: z.number(),
+});
+
+// extract the inferred type
+type Player = z.infer<typeof Player>;
+
+// use it in your code
+const player: Player = { username: "billie", xp: 100 };
+```
+
+In some cases, the input & output types of a schema can diverge. For instance, the `.transform()` API can convert the input from one type to another. In these cases, you can extract the input and output types independently:
+
+```ts
+const mySchema = z.string().transform((val) => val.length);
+
+type MySchemaIn = z.input<typeof mySchema>;
+// => string
+
+type MySchemaOut = z.output<typeof mySchema>; // equivalent to z.infer<typeof mySchema>
+// number
+```

package/node_modules/zod/index.cjs

@@ -0,0 +1,33 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = void 0;
+const z = __importStar(require("./v4/classic/external.cjs"));
+exports.z = z;
+__exportStar(require("./v4/classic/external.cjs"), exports);
+exports.default = z;

package/node_modules/zod/index.d.cts

@@ -0,0 +1,4 @@
+import * as z from "./v4/classic/external.cjs";
+export * from "./v4/classic/external.cjs";
+export { z };
+export default z;

package/node_modules/zod/index.d.ts

@@ -0,0 +1,4 @@
+import * as z from "./v4/classic/external.js";
+export * from "./v4/classic/external.js";
+export { z };
+export default z;

package/node_modules/zod/index.js

@@ -0,0 +1,4 @@
+import * as z from "./v4/classic/external.js";
+export * from "./v4/classic/external.js";
+export { z };
+export default z;

package/node_modules/zod/locales/index.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../v4/locales/index.cjs"), exports);

package/node_modules/zod/locales/index.d.cts

@@ -0,0 +1 @@
+export * from "../v4/locales/index.cjs";

package/node_modules/zod/locales/index.d.ts

@@ -0,0 +1 @@
+export * from "../v4/locales/index.js";

package/node_modules/zod/locales/index.js

@@ -0,0 +1 @@
+export * from "../v4/locales/index.js";

package/node_modules/zod/locales/package.json

@@ -0,0 +1,7 @@
+{ 
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.cts",
+  "sideEffects": false
+}

package/node_modules/zod/mini/index.cjs

@@ -0,0 +1,32 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = void 0;
+const z = __importStar(require("../v4/mini/external.cjs"));
+exports.z = z;
+__exportStar(require("../v4/mini/external.cjs"), exports);

package/node_modules/zod/mini/index.d.cts

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.cjs";
+export * from "../v4/mini/external.cjs";
+export { z };

package/node_modules/zod/mini/index.d.ts

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.js";
+export * from "../v4/mini/external.js";
+export { z };

package/node_modules/zod/mini/index.js

@@ -0,0 +1,3 @@
+import * as z from "../v4/mini/external.js";
+export * from "../v4/mini/external.js";
+export { z };