@openclaw/firecrawl-plugin 2026.10.10-beta.5 → 2026.11.5-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/dist/.setup/{firecrawl-client-CMLsufX8.mjs → firecrawl-client-CDyLQvtN.mjs} +98 -143
  2. package/dist/.setup/{firecrawl-fetch-provider-uRENNKri.mjs → firecrawl-fetch-provider-QmPccHZS.mjs} +6 -13
  3. package/dist/.setup/{firecrawl-search-provider-CFhWH8gx.mjs → firecrawl-search-provider-wsRgx6kl.mjs} +7 -19
  4. package/dist/.source-module-urls/ad8205c790d921269d4ea28d22ab658579b9674fd00e025664fcf0b8ea32155c.json +1 -1
  5. package/dist/api.js +2 -3
  6. package/dist/index.js +69 -90
  7. package/dist/web-fetch-contract-api.js +1 -1
  8. package/dist/web-fetch-provider.js +1 -1
  9. package/dist/web-search-contract-api.js +1 -1
  10. package/dist/web-search-provider.js +1 -1
  11. package/node_modules/typebox/build/format/duration.d.mts +2 -2
  12. package/node_modules/typebox/build/format/duration.mjs +2 -2
  13. package/node_modules/typebox/build/format/idn_email.d.mts +1 -0
  14. package/node_modules/typebox/build/format/idn_email.mjs +1 -0
  15. package/node_modules/typebox/build/format/idn_hostname.d.mts +1 -1
  16. package/node_modules/typebox/build/format/idn_hostname.mjs +1 -1
  17. package/node_modules/typebox/build/format/ipv4.d.mts +2 -2
  18. package/node_modules/typebox/build/format/ipv4.mjs +2 -2
  19. package/node_modules/typebox/build/format/ipv6.d.mts +1 -1
  20. package/node_modules/typebox/build/format/ipv6.mjs +1 -1
  21. package/node_modules/typebox/build/format/relative_json_pointer.d.mts +2 -2
  22. package/node_modules/typebox/build/format/relative_json_pointer.mjs +2 -2
  23. package/node_modules/typebox/build/schema/build.mjs +1 -0
  24. package/node_modules/typebox/build/schema/engine/_unique.d.mts +4 -2
  25. package/node_modules/typebox/build/schema/engine/_unique.mjs +7 -3
  26. package/node_modules/typebox/build/schema/engine/additionalItems.mjs +3 -3
  27. package/node_modules/typebox/build/schema/engine/additionalProperties.d.mts +0 -3
  28. package/node_modules/typebox/build/schema/engine/additionalProperties.mjs +15 -17
  29. package/node_modules/typebox/build/schema/engine/contains.mjs +3 -3
  30. package/node_modules/typebox/build/schema/engine/index.d.mts +1 -0
  31. package/node_modules/typebox/build/schema/engine/index.mjs +1 -0
  32. package/node_modules/typebox/build/schema/engine/items.mjs +7 -4
  33. package/node_modules/typebox/build/schema/engine/maxContains.mjs +2 -2
  34. package/node_modules/typebox/build/schema/engine/minContains.mjs +3 -3
  35. package/node_modules/typebox/build/schema/engine/oneOf.mjs +2 -2
  36. package/node_modules/typebox/build/schema/engine/patternProperties.mjs +2 -2
  37. package/node_modules/typebox/build/schema/engine/propertyNames.mjs +2 -2
  38. package/node_modules/typebox/build/schema/engine/unevaluatedItems.mjs +2 -2
  39. package/node_modules/typebox/build/schema/engine/unevaluatedProperties.mjs +2 -2
  40. package/node_modules/typebox/build/system/hashing/hash.mjs +63 -34
  41. package/node_modules/typebox/build/system/locale/en_US.mjs +2 -1
  42. package/node_modules/typebox/build/system/memory/assign.d.mts +2 -8
  43. package/node_modules/typebox/build/system/memory/assign.mjs +13 -6
  44. package/node_modules/typebox/build/system/memory/clone.d.mts +4 -5
  45. package/node_modules/typebox/build/system/memory/clone.mjs +8 -96
  46. package/node_modules/typebox/build/system/memory/create.d.mts +1 -5
  47. package/node_modules/typebox/build/system/memory/create.mjs +18 -13
  48. package/node_modules/typebox/build/system/memory/deep.d.mts +2 -0
  49. package/node_modules/typebox/build/system/memory/deep.mjs +108 -0
  50. package/node_modules/typebox/build/system/memory/discard.d.mts +1 -1
  51. package/node_modules/typebox/build/system/memory/discard.mjs +9 -8
  52. package/node_modules/typebox/build/system/memory/finalize.d.mts +4 -0
  53. package/node_modules/typebox/build/system/memory/finalize.mjs +30 -0
  54. package/node_modules/typebox/build/system/memory/keys.d.mts +2 -0
  55. package/node_modules/typebox/build/system/memory/keys.mjs +8 -0
  56. package/node_modules/typebox/build/system/memory/update.d.mts +1 -4
  57. package/node_modules/typebox/build/system/memory/update.mjs +43 -16
  58. package/node_modules/typebox/build/type/engine/call/index.d.mts +1 -0
  59. package/node_modules/typebox/build/type/engine/call/index.mjs +1 -0
  60. package/node_modules/typebox/build/type/engine/evaluate/composite.d.mts +2 -24
  61. package/node_modules/typebox/build/type/engine/evaluate/composite.mjs +2 -29
  62. package/node_modules/typebox/build/type/engine/evaluate/index.d.mts +1 -0
  63. package/node_modules/typebox/build/type/engine/evaluate/index.mjs +1 -0
  64. package/node_modules/typebox/build/type/engine/evaluate/narrow.d.mts +5 -1
  65. package/node_modules/typebox/build/type/engine/evaluate/narrow.mjs +6 -1
  66. package/node_modules/typebox/build/type/engine/evaluate/property.d.mts +30 -0
  67. package/node_modules/typebox/build/type/engine/evaluate/property.mjs +29 -0
  68. package/node_modules/typebox/build/type/engine/immutable/instantiate_add.d.mts +1 -3
  69. package/node_modules/typebox/build/type/engine/immutable/instantiate_add.mjs +1 -4
  70. package/node_modules/typebox/build/type/engine/object/from_intersect.d.mts +2 -2
  71. package/node_modules/typebox/build/type/engine/object/from_intersect.mjs +2 -2
  72. package/node_modules/typebox/build/type/engine/object/from_union.d.mts +2 -2
  73. package/node_modules/typebox/build/type/engine/object/from_union.mjs +2 -2
  74. package/node_modules/typebox/build/type/engine/optional/instantiate_add.d.mts +1 -3
  75. package/node_modules/typebox/build/type/engine/optional/instantiate_add.mjs +1 -4
  76. package/node_modules/typebox/build/type/engine/readonly/instantiate_add.d.mts +1 -3
  77. package/node_modules/typebox/build/type/engine/readonly/instantiate_add.mjs +1 -4
  78. package/node_modules/typebox/build/type/engine/this/index.d.mts +1 -0
  79. package/node_modules/typebox/build/type/engine/this/index.mjs +1 -0
  80. package/node_modules/typebox/build/value/clone/clone.d.mts +4 -3
  81. package/node_modules/typebox/build/value/clone/clone.mjs +5 -7
  82. package/node_modules/typebox/build/value/repair/from_cyclic.d.mts +2 -0
  83. package/node_modules/typebox/build/value/repair/from_cyclic.mjs +6 -0
  84. package/node_modules/typebox/build/value/shared/union_priority_sort.mjs +25 -14
  85. package/node_modules/typebox/package.json +1 -1
  86. package/node_modules/typebox/readme.md +1 -1
  87. package/package.json +5 -5
  88. package/node_modules/typebox/build/system/memory/freeze.d.mts +0 -4
  89. package/node_modules/typebox/build/system/memory/freeze.mjs +0 -6
package/dist/index.js CHANGED
@@ -1,11 +1,11 @@
1
- import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./.setup/firecrawl-client-CMLsufX8.mjs";
2
- import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-uRENNKri.mjs";
3
- import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-CFhWH8gx.mjs";
1
+ import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./.setup/firecrawl-client-CDyLQvtN.mjs";
2
+ import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-QmPccHZS.mjs";
3
+ import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-wsRgx6kl.mjs";
4
+ import { optionalNonNegativeIntegerSchema, optionalPositiveIntegerSchema, optionalStringEnum } from "openclaw/plugin-sdk/channel-actions";
4
5
  import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
5
- import { optionalStringEnum } from "openclaw/plugin-sdk/channel-actions";
6
6
  import { jsonResult, readNonNegativeIntegerParam, readPositiveIntegerParam, readStringArrayParam, readStringParam } from "openclaw/plugin-sdk/provider-web-search";
7
7
  import { Type } from "typebox";
8
- //#region extensions/firecrawl/src/firecrawl-scrape-tool.ts
8
+ // extensions/firecrawl/index.ts
9
9
  const FirecrawlScrapeToolSchema = Type.Object({
10
10
  url: Type.String({ description: "HTTP or HTTPS URL to scrape via Firecrawl." }),
11
11
  extractMode: optionalStringEnum(["markdown", "text"], { description: "Extraction mode (\"markdown\" or \"text\"). Default: markdown." }),
@@ -14,63 +14,21 @@ const FirecrawlScrapeToolSchema = Type.Object({
14
14
  minimum: 100
15
15
  })),
16
16
  onlyMainContent: Type.Optional(Type.Boolean({ description: "Keep only main content when Firecrawl supports it." })),
17
- maxAgeMs: Type.Optional(Type.Integer({
18
- description: "Maximum Firecrawl cache age in milliseconds.",
19
- minimum: 0
20
- })),
17
+ maxAgeMs: optionalNonNegativeIntegerSchema({ description: "Maximum Firecrawl cache age in milliseconds." }),
21
18
  proxy: optionalStringEnum([
22
19
  "auto",
23
20
  "basic",
24
21
  "stealth"
25
22
  ], { description: "Firecrawl proxy mode (\"auto\", \"basic\", or \"stealth\")." }),
26
23
  storeInCache: Type.Optional(Type.Boolean({ description: "Whether Firecrawl should store the scrape in its cache." })),
27
- timeoutSeconds: Type.Optional(Type.Integer({
28
- description: "Timeout in seconds for the Firecrawl scrape request.",
29
- minimum: 1
30
- }))
24
+ timeoutSeconds: optionalPositiveIntegerSchema({ description: "Timeout in seconds for the Firecrawl scrape request." })
31
25
  }, { additionalProperties: false });
32
- function createFirecrawlScrapeTool(api) {
33
- return {
34
- name: "firecrawl_scrape",
35
- label: "Firecrawl Scrape",
36
- resultContentSource: "network",
37
- description: "Scrape a page using Firecrawl v2/scrape. Useful for JS-heavy or bot-protected pages where a plain URL fetch is weak.",
38
- parameters: FirecrawlScrapeToolSchema,
39
- execute: async (_toolCallId, rawParams, signal) => {
40
- signal?.throwIfAborted();
41
- const url = readStringParam(rawParams, "url", { required: true });
42
- const extractMode = readStringParam(rawParams, "extractMode") === "text" ? "text" : "markdown";
43
- const maxChars = readPositiveIntegerParam(rawParams, "maxChars");
44
- const maxAgeMs = readNonNegativeIntegerParam(rawParams, "maxAgeMs");
45
- const timeoutSeconds = readPositiveIntegerParam(rawParams, "timeoutSeconds");
46
- const proxyRaw = readStringParam(rawParams, "proxy");
47
- const proxy = proxyRaw === "basic" || proxyRaw === "stealth" || proxyRaw === "auto" ? proxyRaw : void 0;
48
- const onlyMainContent = typeof rawParams.onlyMainContent === "boolean" ? rawParams.onlyMainContent : void 0;
49
- const storeInCache = typeof rawParams.storeInCache === "boolean" ? rawParams.storeInCache : void 0;
50
- return jsonResult(await runFirecrawlScrape({
51
- cfg: api.config,
52
- url,
53
- extractMode,
54
- maxChars,
55
- onlyMainContent,
56
- maxAgeMs,
57
- proxy,
58
- storeInCache,
59
- timeoutSeconds,
60
- ...signal ? { signal } : {}
61
- }));
62
- }
63
- };
64
- }
65
- //#endregion
66
- //#region extensions/firecrawl/src/firecrawl-search-tool.ts
67
26
  const FirecrawlSearchToolSchema = Type.Object({
68
27
  query: Type.String({ description: "Search query string." }),
69
- count: Type.Optional(Type.Integer({
28
+ count: optionalPositiveIntegerSchema({
70
29
  description: "Number of results to return (1-100).",
71
- minimum: 1,
72
30
  maximum: 100
73
- })),
31
+ }),
74
32
  sources: Type.Optional(Type.Array(Type.String(), { description: "Optional sources list, for example [\"web\"], [\"news\"], or [\"images\"]." })),
75
33
  categories: Type.Optional(Type.Array(Type.String(), { description: "Optional Firecrawl categories, for example [\"github\"] or [\"research\"]." })),
76
34
  includeDomains: Type.Optional(Type.Array(Type.String(), { description: "Restrict results to these hostnames (no protocol or path). Cannot be combined with excludeDomains." })),
@@ -79,43 +37,8 @@ const FirecrawlSearchToolSchema = Type.Object({
79
37
  location: Type.Optional(Type.String({ description: "Geo-target location, for example \"Germany\" or \"San Francisco,California,United States\"." })),
80
38
  country: Type.Optional(Type.String({ description: "ISO country code for geo-targeting, for example \"US\", \"DE\", or \"JP\"." })),
81
39
  scrapeResults: Type.Optional(Type.Boolean({ description: "Include scraped result content when Firecrawl returns it." })),
82
- timeoutSeconds: Type.Optional(Type.Integer({
83
- description: "Timeout in seconds for the Firecrawl Search request.",
84
- minimum: 1
85
- }))
40
+ timeoutSeconds: optionalPositiveIntegerSchema({ description: "Timeout in seconds for the Firecrawl Search request." })
86
41
  }, { additionalProperties: false });
87
- function createFirecrawlSearchTool(api) {
88
- return {
89
- name: "firecrawl_search",
90
- label: "Firecrawl Search",
91
- resultContentSource: "network",
92
- description: "Search the web using Firecrawl v2/search. Supports includeDomains/excludeDomains filtering and tbs time filters (day/week/month/year). Can optionally include scraped content from result pages.",
93
- parameters: FirecrawlSearchToolSchema,
94
- execute: async (_toolCallId, rawParams, signal) => {
95
- signal?.throwIfAborted();
96
- return jsonResult(await runFirecrawlSearch({
97
- query: readStringParam(rawParams, "query", { required: true }),
98
- count: readPositiveIntegerParam(rawParams, "count", {
99
- max: 100,
100
- message: "count must be an integer from 1 to 100"
101
- }),
102
- timeoutSeconds: readPositiveIntegerParam(rawParams, "timeoutSeconds"),
103
- sources: readStringArrayParam(rawParams, "sources"),
104
- categories: readStringArrayParam(rawParams, "categories"),
105
- includeDomains: readStringArrayParam(rawParams, "includeDomains"),
106
- excludeDomains: readStringArrayParam(rawParams, "excludeDomains"),
107
- tbs: readStringParam(rawParams, "tbs"),
108
- location: readStringParam(rawParams, "location"),
109
- country: readStringParam(rawParams, "country"),
110
- scrapeResults: rawParams.scrapeResults === true,
111
- cfg: api.config,
112
- ...signal ? { signal } : {}
113
- }));
114
- }
115
- };
116
- }
117
- //#endregion
118
- //#region extensions/firecrawl/index.ts
119
42
  var firecrawl_default = definePluginEntry({
120
43
  id: "firecrawl",
121
44
  name: "Firecrawl Plugin",
@@ -124,9 +47,65 @@ var firecrawl_default = definePluginEntry({
124
47
  api.registerWebFetchProvider(createFirecrawlWebFetchProvider());
125
48
  api.registerWebSearchProvider(createFirecrawlWebSearchProvider());
126
49
  api.registerWebSearchProvider(createFirecrawlFreeWebSearchProvider());
127
- api.registerTool(createFirecrawlSearchTool(api));
128
- api.registerTool(createFirecrawlScrapeTool(api));
50
+ api.registerTool({
51
+ name: "firecrawl_search",
52
+ label: "Firecrawl Search",
53
+ resultContentSource: "network",
54
+ description: "Search the web using Firecrawl v2/search. Supports includeDomains/excludeDomains filtering and tbs time filters (day/week/month/year). Can optionally include scraped content from result pages.",
55
+ parameters: FirecrawlSearchToolSchema,
56
+ execute: async (_toolCallId, rawParams, signal) => {
57
+ signal?.throwIfAborted();
58
+ return jsonResult(await runFirecrawlSearch({
59
+ query: readStringParam(rawParams, "query", { required: true }),
60
+ count: readPositiveIntegerParam(rawParams, "count", {
61
+ max: 100,
62
+ message: "count must be an integer from 1 to 100"
63
+ }),
64
+ timeoutSeconds: readPositiveIntegerParam(rawParams, "timeoutSeconds"),
65
+ sources: readStringArrayParam(rawParams, "sources"),
66
+ categories: readStringArrayParam(rawParams, "categories"),
67
+ includeDomains: readStringArrayParam(rawParams, "includeDomains"),
68
+ excludeDomains: readStringArrayParam(rawParams, "excludeDomains"),
69
+ tbs: readStringParam(rawParams, "tbs"),
70
+ location: readStringParam(rawParams, "location"),
71
+ country: readStringParam(rawParams, "country"),
72
+ scrapeResults: rawParams.scrapeResults === true,
73
+ cfg: api.config,
74
+ ...signal ? { signal } : {}
75
+ }));
76
+ }
77
+ });
78
+ api.registerTool({
79
+ name: "firecrawl_scrape",
80
+ label: "Firecrawl Scrape",
81
+ resultContentSource: "network",
82
+ description: "Scrape a page using Firecrawl v2/scrape. Useful for JS-heavy or bot-protected pages where a plain URL fetch is weak.",
83
+ parameters: FirecrawlScrapeToolSchema,
84
+ execute: async (_toolCallId, rawParams, signal) => {
85
+ signal?.throwIfAborted();
86
+ const url = readStringParam(rawParams, "url", { required: true });
87
+ const extractMode = readStringParam(rawParams, "extractMode") === "text" ? "text" : "markdown";
88
+ const maxChars = readPositiveIntegerParam(rawParams, "maxChars");
89
+ const maxAgeMs = readNonNegativeIntegerParam(rawParams, "maxAgeMs");
90
+ const timeoutSeconds = readPositiveIntegerParam(rawParams, "timeoutSeconds");
91
+ const proxyRaw = readStringParam(rawParams, "proxy");
92
+ const proxy = proxyRaw === "basic" || proxyRaw === "stealth" || proxyRaw === "auto" ? proxyRaw : void 0;
93
+ const onlyMainContent = typeof rawParams.onlyMainContent === "boolean" ? rawParams.onlyMainContent : void 0;
94
+ const storeInCache = typeof rawParams.storeInCache === "boolean" ? rawParams.storeInCache : void 0;
95
+ return jsonResult(await runFirecrawlScrape({
96
+ cfg: api.config,
97
+ url,
98
+ extractMode,
99
+ maxChars,
100
+ onlyMainContent,
101
+ maxAgeMs,
102
+ proxy,
103
+ storeInCache,
104
+ timeoutSeconds,
105
+ ...signal ? { signal } : {}
106
+ }));
107
+ }
108
+ });
129
109
  }
130
110
  });
131
- //#endregion
132
111
  export { firecrawl_default as default };
@@ -1,2 +1,2 @@
1
- export { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-uRENNKri.mjs";
1
+ export { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-QmPccHZS.mjs";
2
2
  import "./web-fetch-provider.js";
@@ -1 +1 @@
1
- export { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-uRENNKri.mjs";
1
+ export { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-QmPccHZS.mjs";
@@ -1,2 +1,2 @@
1
- export { t as createFirecrawlFreeWebSearchProvider, n as createFirecrawlWebSearchProvider } from "./.setup/firecrawl-search-provider-CFhWH8gx.mjs";
1
+ export { t as createFirecrawlFreeWebSearchProvider, n as createFirecrawlWebSearchProvider } from "./.setup/firecrawl-search-provider-wsRgx6kl.mjs";
2
2
  import "./web-search-provider.js";
@@ -1 +1 @@
1
- export { t as createFirecrawlFreeWebSearchProvider, n as createFirecrawlWebSearchProvider } from "./.setup/firecrawl-search-provider-CFhWH8gx.mjs";
1
+ export { t as createFirecrawlFreeWebSearchProvider, n as createFirecrawlWebSearchProvider } from "./.setup/firecrawl-search-provider-wsRgx6kl.mjs";
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Returns true if the value is a valid ISO-8601 duration.
3
- * @specification https://tools.ietf.org/html/rfc3339
2
+ * Returns true if the value is a valid duration.
3
+ * @specification https://www.rfc-editor.org/rfc/rfc3339.html#appendix-A
4
4
  */
5
5
  export declare function IsDuration(value: string): boolean;
@@ -1,7 +1,7 @@
1
1
  const Duration = /^P((\d+Y(\d+M(\d+D)?)?|\d+M(\d+D)?|\d+D)(T(\d+H(\d+M(\d+S)?)?|\d+M(\d+S)?|\d+S))?|T(\d+H(\d+M(\d+S)?)?|\d+M(\d+S)?|\d+S)|\d+W)$/;
2
2
  /**
3
- * Returns true if the value is a valid ISO-8601 duration.
4
- * @specification https://tools.ietf.org/html/rfc3339
3
+ * Returns true if the value is a valid duration.
4
+ * @specification https://www.rfc-editor.org/rfc/rfc3339.html#appendix-A
5
5
  */
6
6
  export function IsDuration(value) {
7
7
  return Duration.test(value);
@@ -1,5 +1,6 @@
1
1
  /**
2
2
  * Returns true if the value is an IdnEmail
3
3
  * @specification https://datatracker.ietf.org/doc/html/rfc4952
4
+ * @specification https://datatracker.ietf.org/doc/html/rfc6531
4
5
  */
5
6
  export declare function IsIdnEmail(value: string): boolean;
@@ -2,6 +2,7 @@ const IdnEmail = /^(?:[A-Za-z0-9!#$%&'*+\/=?^_`{|}~\u{0080}-\u{10FFFF}-]+(?:\.[A
2
2
  /**
3
3
  * Returns true if the value is an IdnEmail
4
4
  * @specification https://datatracker.ietf.org/doc/html/rfc4952
5
+ * @specification https://datatracker.ietf.org/doc/html/rfc6531
5
6
  */
6
7
  export function IsIdnEmail(value) {
7
8
  return IdnEmail.test(value.normalize('NFC'));
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Returns true if the value is a valid internationalized (IDN) hostname.
3
- * @specification https://tools.ietf.org/html/rfc3490
3
+ * @specification https://datatracker.ietf.org/doc/html/rfc5890
4
4
  * @specification https://tools.ietf.org/html/rfc5891
5
5
  * @specification https://tools.ietf.org/html/rfc5892
6
6
  * @specification https://tools.ietf.org/html/rfc5893
@@ -1,7 +1,7 @@
1
1
  import * as Idna from './idna/index.mjs';
2
2
  /**
3
3
  * Returns true if the value is a valid internationalized (IDN) hostname.
4
- * @specification https://tools.ietf.org/html/rfc3490
4
+ * @specification https://datatracker.ietf.org/doc/html/rfc5890
5
5
  * @specification https://tools.ietf.org/html/rfc5891
6
6
  * @specification https://tools.ietf.org/html/rfc5892
7
7
  * @specification https://tools.ietf.org/html/rfc5893
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Returns true if the value is a IPV4 address
3
- * @specification http://tools.ietf.org/html/rfc2673#section-3.2
2
+ * Returns true if the value is an IPv4 address
3
+ * @specification https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.2
4
4
  */
5
5
  export declare function IsIPv4(value: string): boolean;
@@ -1,7 +1,7 @@
1
1
  const IPv4 = /^(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)$/;
2
2
  /**
3
- * Returns true if the value is a IPV4 address
4
- * @specification http://tools.ietf.org/html/rfc2673#section-3.2
3
+ * Returns true if the value is an IPv4 address
4
+ * @specification https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.2
5
5
  */
6
6
  export function IsIPv4(value) {
7
7
  return IPv4.test(value);
@@ -1,5 +1,5 @@
1
1
  /**
2
2
  * Returns true if the value is an IPv6 address
3
- * @specification http://tools.ietf.org/html/rfc2373#section-2.2
3
+ * @specification https://datatracker.ietf.org/doc/html/rfc4291#section-2.2
4
4
  */
5
5
  export declare function IsIPv6(value: string): boolean;
@@ -1,7 +1,7 @@
1
1
  const IPv6 = /^(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:)?[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)$/i;
2
2
  /**
3
3
  * Returns true if the value is an IPv6 address
4
- * @specification http://tools.ietf.org/html/rfc2373#section-2.2
4
+ * @specification https://datatracker.ietf.org/doc/html/rfc4291#section-2.2
5
5
  */
6
6
  export function IsIPv6(value) {
7
7
  return IPv6.test(value);
@@ -1,6 +1,6 @@
1
1
  /**
2
- * Returns true if the value is a relative json pointer
3
- * @specification https://datatracker.ietf.org/doc/html/rfc6901
2
+ * Returns true if the value is a relative JSON Pointer
3
+ * @specification https://datatracker.ietf.org/doc/html/draft-handrews-relative-json-pointer/
4
4
  * @source https://github.com/ajv-validator/ajv-formats
5
5
  */
6
6
  export declare function IsRelativeJsonPointer(value: string): boolean;
@@ -1,7 +1,7 @@
1
1
  const RelativeJsonPointer = /^(?:0|[1-9][0-9]*)(?:#|(?:\/(?:[^~/]|~0|~1)*)*)$/;
2
2
  /**
3
- * Returns true if the value is a relative json pointer
4
- * @specification https://datatracker.ietf.org/doc/html/rfc6901
3
+ * Returns true if the value is a relative JSON Pointer
4
+ * @specification https://datatracker.ietf.org/doc/html/draft-handrews-relative-json-pointer/
5
5
  * @source https://github.com/ajv-validator/ajv-formats
6
6
  */
7
7
  export function IsRelativeJsonPointer(value) {
@@ -106,6 +106,7 @@ export function Build(...args) {
106
106
  2: (context, schema) => [context, schema],
107
107
  1: (schema) => [{}, schema]
108
108
  });
109
+ Engine.ResetUnique();
109
110
  Engine.ResetExternal();
110
111
  Engine.ResetFunctions();
111
112
  const stack = Engine.Stack(context, schema);
@@ -1,2 +1,4 @@
1
- /** Returns a Unique Variable Name */
2
- export declare function Unique(): string;
1
+ /** Creates a unique variable name */
2
+ export declare function CreateUnique(): string;
3
+ /** Resets the unique variable name counter */
4
+ export declare function ResetUnique(): void;
@@ -1,5 +1,9 @@
1
1
  let index = 0;
2
- /** Returns a Unique Variable Name */
3
- export function Unique() {
4
- return `var_${index++}`;
2
+ /** Creates a unique variable name */
3
+ export function CreateUnique() {
4
+ return `unique_${index++}`;
5
+ }
6
+ /** Resets the unique variable name counter */
7
+ export function ResetUnique() {
8
+ index = 0;
5
9
  }
@@ -1,6 +1,6 @@
1
1
  // deno-fmt-ignore-file
2
2
  import * as Schema from '../types/index.mjs';
3
- import { Unique } from './_unique.mjs';
3
+ import * as Unique from './_unique.mjs';
4
4
  import { Guard as G, EmitGuard as E } from '../../guard/index.mjs';
5
5
  import { BuildSchemaPushStack, CheckSchemaPushStack, ErrorSchemaPushStack } from './schema.mjs';
6
6
  // ------------------------------------------------------------------
@@ -13,14 +13,14 @@ function IsValid(schema) {
13
13
  // Build
14
14
  // ------------------------------------------------------------------
15
15
  function BuildAdditionalItemsStandard(stack, context, schema, value) {
16
- const [item, index] = [Unique(), Unique()];
16
+ const [item, index] = [Unique.CreateUnique(), Unique.CreateUnique()];
17
17
  const isSchema = BuildSchemaPushStack(stack, context, schema.additionalItems, item);
18
18
  const isLength = E.IsLessThan(index, E.Constant(schema.items.length));
19
19
  const addIndex = context.AddIndex(index);
20
20
  return E.Every(value, E.Constant(0), [item, index], E.Or(isLength, E.And(isSchema, addIndex)));
21
21
  }
22
22
  function BuildAdditionalItemsFast(stack, context, schema, value) {
23
- const [item, index] = [Unique(), Unique()];
23
+ const [item, index] = [Unique.CreateUnique(), Unique.CreateUnique()];
24
24
  const isSchema = BuildSchemaPushStack(stack, context, schema.additionalItems, item);
25
25
  const isLength = E.IsLessThan(index, E.Constant(schema.items.length));
26
26
  return E.Every(value, E.Constant(0), [item, index], E.Or(isLength, isSchema));
@@ -1,9 +1,6 @@
1
1
  import * as Schema from '../types/index.mjs';
2
2
  import * as Stack from './_stack.mjs';
3
3
  import { BuildContext, CheckContext, ErrorContext } from './_context.mjs';
4
- export declare function CanAdditionalPropertiesFast(_context: BuildContext, schema: Schema.XAdditionalProperties, _value: string): schema is Schema.XAdditionalProperties & Schema.XRequired;
5
- export declare function BuildAdditionalPropertiesFast(_context: BuildContext, schema: Schema.XAdditionalProperties & Schema.XRequired, value: string): string;
6
- export declare function BuildAdditionalPropertiesStandard(stack: Stack.XStack, context: BuildContext, schema: Schema.XAdditionalProperties, value: string): string;
7
4
  export declare function BuildAdditionalProperties(stack: Stack.XStack, context: BuildContext, schema: Schema.XAdditionalProperties, value: string): string;
8
5
  export declare function CheckAdditionalProperties(stack: Stack.XStack, context: CheckContext, schema: Schema.XAdditionalProperties, value: Record<PropertyKey, unknown>): boolean;
9
6
  export declare function ErrorAdditionalProperties(stack: Stack.XStack, context: ErrorContext, schemaPath: string, instancePath: string, schema: Schema.XAdditionalProperties, value: Record<PropertyKey, unknown>): boolean;
@@ -1,8 +1,8 @@
1
1
  // deno-fmt-ignore-file
2
2
  import * as Schema from '../types/index.mjs';
3
+ import * as Unique from './_unique.mjs';
3
4
  import * as Externals from './_externals.mjs';
4
5
  import * as Pathing from './_pathing.mjs';
5
- import { Unique } from './_unique.mjs';
6
6
  import { UnicodeRegExp } from './_regexp.mjs';
7
7
  import { EmitGuard as E, Guard as G } from '../../guard/index.mjs';
8
8
  import { BuildSchemaPushStack, CheckSchemaPushStack, ErrorSchemaPushStack } from './schema.mjs';
@@ -42,35 +42,33 @@ function GetPropertiesPattern(schema) {
42
42
  return G.IsEqual(patterns.length, 0) ? '(?!)' : `(${patterns.join('|')})`;
43
43
  }
44
44
  // ------------------------------------------------------------------
45
- // BuildAdditionalPropertiesFast
45
+ // BuildAdditionalPropertiesFast (AdditionalProperties False)
46
46
  //
47
- // Optimized logic for schemas with `additionalProperties: false`.
48
- //
49
- // This fast-path applies only when:
50
- // - `additionalProperties` is explicitly set to false,
51
- // - the schema uses only `properties` (no `patternProperties`),
52
- // - and all defined properties are required (i.e., no optional keys).
53
- //
54
- // This constraint is common when enforcing strict object shapes
55
- // with only known, fixed keys. When all these conditions are met,
56
- // we can generate a simplified and efficient runtime check.
47
+ // - AdditionalProperties is explicitly set to false,
48
+ // - The schema uses only Properties (no PatternProperties),
49
+ // - Required contains exactly the keys in Properties.
57
50
  //
58
51
  // ------------------------------------------------------------------
59
- export function CanAdditionalPropertiesFast(_context, schema, _value) {
52
+ function HasExactRequiredProperties(schema) {
53
+ const keys = G.Keys(schema.properties);
54
+ return G.IsEqual(keys.length, schema.required.length)
55
+ && G.Every(keys, 0, (key) => schema.required.includes(key));
56
+ }
57
+ function CanAdditionalPropertiesFast(_context, schema, _value) {
60
58
  return Schema.IsRequired(schema)
61
59
  && Schema.IsProperties(schema)
62
60
  && !Schema.IsPatternProperties(schema)
63
61
  && G.IsEqual(schema.additionalProperties, false)
64
- && G.IsEqual(G.Keys(schema.properties).length, schema.required.length);
62
+ && HasExactRequiredProperties(schema);
65
63
  }
66
- export function BuildAdditionalPropertiesFast(_context, schema, value) {
64
+ function BuildAdditionalPropertiesFast(_context, schema, value) {
67
65
  return E.IsEqual(E.Member(E.Call(E.Member('Object', 'getOwnPropertyNames'), [value]), 'length'), E.Constant(schema.required.length));
68
66
  }
69
67
  // ------------------------------------------------------------------
70
68
  // BuildAdditionalPropertiesStandard
71
69
  // ------------------------------------------------------------------
72
- export function BuildAdditionalPropertiesStandard(stack, context, schema, value) {
73
- const [key, _index] = [Unique(), Unique()];
70
+ function BuildAdditionalPropertiesStandard(stack, context, schema, value) {
71
+ const [key, _index] = [Unique.CreateUnique(), Unique.CreateUnique()];
74
72
  const regexp = Externals.CreateVariable(UnicodeRegExp(GetPropertiesPattern(schema)));
75
73
  const isSchema = BuildSchemaPushStack(stack, context, schema.additionalProperties, `${value}[${key}]`);
76
74
  const isKey = E.Call(E.Member(regexp, 'test'), [key]);
@@ -1,6 +1,6 @@
1
1
  // deno-fmt-ignore-file
2
2
  import * as Schema from '../types/index.mjs';
3
- import { Unique } from './_unique.mjs';
3
+ import * as Unique from './_unique.mjs';
4
4
  import { EmitGuard as E, Guard as G } from '../../guard/index.mjs';
5
5
  import { BuildSchema, CheckSchema } from './schema.mjs';
6
6
  // ------------------------------------------------------------------
@@ -13,13 +13,13 @@ function IsValid(schema) {
13
13
  // Build
14
14
  // ------------------------------------------------------------------
15
15
  function BuildContainsStandard(stack, context, schema, value) {
16
- const [item, index] = [Unique(), Unique()];
16
+ const [item, index] = [Unique.CreateUnique(), Unique.CreateUnique()];
17
17
  const isLength = E.Not(E.IsEqual(E.Member(value, 'length'), E.Constant(0)));
18
18
  const isSome = E.SomeAll(value, [item, index], E.And(BuildSchema(stack, context, schema.contains, item), context.AddIndex(index)));
19
19
  return E.And(isLength, isSome);
20
20
  }
21
21
  function BuildContainsFast(stack, context, schema, value) {
22
- const [item] = [Unique()];
22
+ const [item] = [Unique.CreateUnique()];
23
23
  const isLength = E.Not(E.IsEqual(E.Member(value, 'length'), E.Constant(0)));
24
24
  const isSome = E.Some(value, [item, '_'], BuildSchema(stack, context, schema.contains, item));
25
25
  return E.And(isLength, isSome);
@@ -4,6 +4,7 @@ export * from './_functions.mjs';
4
4
  export * from './_reducer.mjs';
5
5
  export * from './_refine.mjs';
6
6
  export * from './_stack.mjs';
7
+ export * from './_unique.mjs';
7
8
  export * from './additionalItems.mjs';
8
9
  export * from './additionalProperties.mjs';
9
10
  export * from './allOf.mjs';
@@ -7,6 +7,7 @@ export * from './_functions.mjs';
7
7
  export * from './_reducer.mjs';
8
8
  export * from './_refine.mjs';
9
9
  export * from './_stack.mjs';
10
+ export * from './_unique.mjs';
10
11
  // ------------------------------------------------------------------
11
12
  // Schematics
12
13
  // ------------------------------------------------------------------
@@ -1,5 +1,6 @@
1
1
  // deno-fmt-ignore-file
2
2
  import * as Schema from '../types/index.mjs';
3
+ import * as Unique from './_unique.mjs';
3
4
  import { BuildSchemaPushStack, CheckSchemaPushStack, ErrorSchemaPushStack } from './schema.mjs';
4
5
  import { Guard as G, EmitGuard as E } from '../../guard/index.mjs';
5
6
  // ------------------------------------------------------------------
@@ -44,14 +45,16 @@ function ErrorItemsSized(stack, context, schemaPath, instancePath, schema, value
44
45
  // ------------------------------------------------------------------
45
46
  function BuildItemsUnsizedStandard(stack, context, schema, value) {
46
47
  const offset = Schema.IsPrefixItems(schema) ? schema.prefixItems.length : 0;
47
- const isSchema = BuildSchemaPushStack(stack, context, schema.items, 'element');
48
+ const [item] = [Unique.CreateUnique()];
49
+ const isSchema = BuildSchemaPushStack(stack, context, schema.items, item);
48
50
  const addIndex = context.AddIndex('index');
49
- return E.Every(value, E.Constant(offset), ['element', 'index'], E.And(isSchema, addIndex));
51
+ return E.Every(value, E.Constant(offset), [item, 'index'], E.And(isSchema, addIndex));
50
52
  }
51
53
  function BuildItemsUnsizedFast(stack, context, schema, value) {
52
54
  const offset = Schema.IsPrefixItems(schema) ? schema.prefixItems.length : 0;
53
- const isSchema = BuildSchemaPushStack(stack, context, schema.items, 'element');
54
- return E.Every(value, E.Constant(offset), ['element', 'index'], isSchema);
55
+ const [item] = [Unique.CreateUnique()];
56
+ const isSchema = BuildSchemaPushStack(stack, context, schema.items, item);
57
+ return E.Every(value, E.Constant(offset), [item, 'index'], isSchema);
55
58
  }
56
59
  function BuildItemsUnsized(stack, context, schema, value) {
57
60
  return context.UseUnevaluated()
@@ -1,6 +1,6 @@
1
1
  // deno-fmt-ignore-file
2
2
  import * as Schema from '../types/index.mjs';
3
- import { Unique } from './_unique.mjs';
3
+ import * as Unique from './_unique.mjs';
4
4
  import { Guard as G, EmitGuard as E } from '../../guard/index.mjs';
5
5
  import { BuildSchema, CheckSchema } from './schema.mjs';
6
6
  // ------------------------------------------------------------------
@@ -15,7 +15,7 @@ function IsValid(schema) {
15
15
  export function BuildMaxContains(stack, context, schema, value) {
16
16
  if (!IsValid(schema))
17
17
  return E.Constant(true);
18
- const [item] = [Unique()];
18
+ const [item] = [Unique.CreateUnique()];
19
19
  const count = E.Counted(value, [item, '_'], BuildSchema(stack, context, schema.contains, item));
20
20
  return E.IsLessEqualThan(count, E.Constant(schema.maxContains));
21
21
  }
@@ -1,6 +1,6 @@
1
1
  // deno-fmt-ignore-file
2
2
  import * as Schema from '../types/index.mjs';
3
- import { Unique } from './_unique.mjs';
3
+ import * as Unique from './_unique.mjs';
4
4
  import { Guard as G, EmitGuard as E } from '../../guard/index.mjs';
5
5
  import { BuildSchema, CheckSchema } from './schema.mjs';
6
6
  // ------------------------------------------------------------------
@@ -13,12 +13,12 @@ function IsValid(schema) {
13
13
  // Build
14
14
  // ------------------------------------------------------------------
15
15
  function BuildMinContainsStandard(stack, context, schema, value) {
16
- const [item, index] = [Unique(), Unique()];
16
+ const [item, index] = [Unique.CreateUnique(), Unique.CreateUnique()];
17
17
  const count = E.Counted(value, [item, index], E.And(BuildSchema(stack, context, schema.contains, item), context.AddIndex(index)));
18
18
  return E.IsGreaterEqualThan(count, E.Constant(schema.minContains));
19
19
  }
20
20
  function BuildMinContainsFast(stack, context, schema, value) {
21
- const [item] = [Unique()];
21
+ const [item] = [Unique.CreateUnique()];
22
22
  const count = E.Counted(value, [item, '_'], BuildSchema(stack, context, schema.contains, item));
23
23
  return E.IsGreaterEqualThan(count, E.Constant(schema.minContains));
24
24
  }
@@ -1,6 +1,6 @@
1
1
  // deno-fmt-ignore-file
2
2
  import { Reducer } from './_reducer.mjs';
3
- import { Unique } from './_unique.mjs';
3
+ import * as Unique from './_unique.mjs';
4
4
  import { CheckContext, ErrorContext } from './_context.mjs';
5
5
  import { BuildSchema, CheckSchema, ErrorSchema } from './schema.mjs';
6
6
  import { EmitGuard as E, Guard as G } from '../../guard/index.mjs';
@@ -11,7 +11,7 @@ function BuildOneOfStandard(stack, context, schema, value) {
11
11
  return Reducer(stack, context, schema.oneOf, value, E.IsEqual(E.Member('results', 'length'), E.Constant(1)));
12
12
  }
13
13
  function BuildOneOfFast(stack, context, schema, value) {
14
- const [result] = [Unique()];
14
+ const [result] = [Unique.CreateUnique()];
15
15
  const results = E.ArrayLiteral(schema.oneOf.map((schema) => BuildSchema(stack, context, schema, value)));
16
16
  const count = E.Counted(results, [result, '_'], E.IsEqual(result, E.Constant(true)));
17
17
  return E.IsEqual(count, E.Constant(1));
@@ -1,7 +1,7 @@
1
1
  // deno-fmt-ignore-file
2
+ import * as Unique from './_unique.mjs';
2
3
  import * as Externals from './_externals.mjs';
3
4
  import * as Pathing from './_pathing.mjs';
4
- import { Unique } from './_unique.mjs';
5
5
  import { UnicodeRegExp } from './_regexp.mjs';
6
6
  import { BuildSchemaPushStack, CheckSchemaPushStack, ErrorSchemaPushStack } from './schema.mjs';
7
7
  import { Guard as G, EmitGuard as E } from '../../guard/index.mjs';
@@ -10,7 +10,7 @@ import { Guard as G, EmitGuard as E } from '../../guard/index.mjs';
10
10
  // ------------------------------------------------------------------
11
11
  export function BuildPatternProperties(stack, context, schema, value) {
12
12
  return E.ReduceAnd(G.Entries(schema.patternProperties).map(([pattern, schema]) => {
13
- const [key, prop] = [Unique(), Unique()];
13
+ const [key, prop] = [Unique.CreateUnique(), Unique.CreateUnique()];
14
14
  const regexp = Externals.CreateVariable(UnicodeRegExp(pattern));
15
15
  const notKey = E.Not(E.Call(E.Member(regexp, 'test'), [key]));
16
16
  const isSchema = BuildSchemaPushStack(stack, context, schema, prop);