@tambo-ai/react 0.65.3 → 0.66.1

package/dist/schema/validate.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNoRecordSchema = assertNoRecordSchema;
+const schema_1 = require("./schema");
+const standard_schema_1 = require("./standard-schema");
+/*
+ * Check if a JSON Schema represents a record type (map with dynamic keys).
+ *
+ * For our purposes, any `object` schema with `additionalProperties` defined
+ * as a nested schema (not just `true`/`false`) is treated as a record, even
+ * if it also declares some explicit `properties`.
+ * @param schema - The JSON Schema to check
+ * @returns True if the schema represents a record-like type
+ */
+function isRecordJsonSchema(schema) {
+    return (schema.type === "object" &&
+        typeof schema.additionalProperties === "object" &&
+        schema.additionalProperties !== null);
+}
+/**
+ * Recursively walks a JSON Schema and throws when it encounters a record type.
+ * Records are not supported because they use dynamic keys which don't serialize
+ * well for the Tambo backend.
+ * @param schema - The JSON Schema to check
+ * @param path - Current path in the schema (for error messages)
+ * @param contextName - Human-readable context name for error messages
+ */
+function assertNoRecordInJsonSchema(schema, path, contextName) {
+    if (isRecordJsonSchema(schema)) {
+        const joined = path.length ? path.join(".") : "(root)";
+        throw new Error(`Record types (objects with dynamic keys) are not supported in ${contextName}. ` +
+            `Found at path "${joined}". ` +
+            "Replace it with an object using explicit keys.");
+    }
+    if (schema.properties) {
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            if (typeof propSchema === "object" && propSchema !== null) {
+                assertNoRecordInJsonSchema(propSchema, [...path, key], contextName);
+            }
+        }
+    }
+    if (typeof schema.additionalProperties === "object" &&
+        schema.additionalProperties !== null) {
+        assertNoRecordInJsonSchema(schema.additionalProperties, [...path, "[*]"], contextName);
+    }
+    if (schema.items) {
+        if (Array.isArray(schema.items)) {
+            // Tuple (JSON Schema draft-07): check each item schema
+            schema.items.forEach((itemSchema, index) => {
+                if (typeof itemSchema === "object" && itemSchema !== null) {
+                    assertNoRecordInJsonSchema(itemSchema, [...path, `${index}`], contextName);
+                }
+            });
+        }
+        else if (typeof schema.items === "object") {
+            // Array: check the item schema
+            assertNoRecordInJsonSchema(schema.items, [...path, "[]"], contextName);
+        }
+    }
+    const prefixItems = schema.prefixItems;
+    if (Array.isArray(prefixItems)) {
+        prefixItems.forEach((itemSchema, index) => {
+            if (typeof itemSchema === "object" && itemSchema !== null) {
+                assertNoRecordInJsonSchema(itemSchema, [...path, `${index}`], contextName);
+            }
+        });
+    }
+    if (schema.allOf) {
+        schema.allOf.forEach((subSchema, index) => {
+            if (typeof subSchema === "object" && subSchema !== null) {
+                assertNoRecordInJsonSchema(subSchema, [...path, `&${index}`], contextName);
+            }
+        });
+    }
+    if (schema.anyOf) {
+        schema.anyOf.forEach((subSchema, index) => {
+            if (typeof subSchema === "object" && subSchema !== null) {
+                assertNoRecordInJsonSchema(subSchema, [...path, `|${index}`], contextName);
+            }
+        });
+    }
+    if (schema.oneOf) {
+        schema.oneOf.forEach((subSchema, index) => {
+            if (typeof subSchema === "object" && subSchema !== null) {
+                assertNoRecordInJsonSchema(subSchema, [...path, `|${index}`], contextName);
+            }
+        });
+    }
+    if (typeof schema.not === "object" && schema.not !== null) {
+        assertNoRecordInJsonSchema(schema.not, [...path, "!"], contextName);
+    }
+    if (typeof schema.if === "object" && schema.if !== null) {
+        assertNoRecordInJsonSchema(schema.if, [...path, "if"], contextName);
+    }
+    if (typeof schema.then === "object" && schema.then !== null) {
+        assertNoRecordInJsonSchema(schema.then, [...path, "then"], contextName);
+    }
+    if (typeof schema.else === "object" && schema.else !== null) {
+        assertNoRecordInJsonSchema(schema.else, [...path, "else"], contextName);
+    }
+}
+/**
+ * Asserts that a schema does not contain record types (objects with dynamic keys).
+ * Records are not serializable to JSON Schema in a way that the Tambo backend
+ * understands, so they are disallowed.
+ *
+ * This function accepts Standard Schema validators (Zod, Valibot, ArkType, etc.)
+ * or JSON Schema objects. It converts them to JSON Schema and checks for record patterns.
+ *
+ * For tool schemas that are function types, this extracts and validates the input parameters.
+ * @param schema - The schema to validate (Standard Schema or JSON Schema)
+ * @param contextName - A human-readable label echoed in the error message
+ */
+function assertNoRecordSchema(schema, contextName = "schema") {
+    if (!schema) {
+        return;
+    }
+    let jsonSchema;
+    try {
+        if ((0, standard_schema_1.isStandardSchema)(schema)) {
+            // Handle function schemas specially - extract input parameters
+            const converted = (0, schema_1.schemaToJsonSchema)(schema);
+            // If it's a function schema that couldn't be converted, the input params
+            // were extracted in registry.ts, so we can skip validation here
+            if (!converted || Object.keys(converted).length === 0) {
+                return;
+            }
+            jsonSchema = converted;
+        }
+        else if (typeof schema === "object" &&
+            schema !== null &&
+            "type" in schema) {
+            // Already JSON Schema
+            jsonSchema = schema;
+        }
+        else {
+            // Unknown schema type - skip validation
+            return;
+        }
+    }
+    catch {
+        // If schema conversion fails, skip validation
+        // This can happen for function schemas or other special types
+        return;
+    }
+    assertNoRecordInJsonSchema(jsonSchema, [], contextName);
+}
+//# sourceMappingURL=validate.js.map

package/dist/schema/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/schema/validate.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from \"json-schema\";\nimport { schemaToJsonSchema } from \"./schema\";\nimport { isStandardSchema } from \"./standard-schema\";\n\n/*\n * Check if a JSON Schema represents a record type (map with dynamic keys).\n *\n * For our purposes, any `object` schema with `additionalProperties` defined\n * as a nested schema (not just `true`/`false`) is treated as a record, even\n * if it also declares some explicit `properties`.\n * @param schema - The JSON Schema to check\n * @returns True if the schema represents a record-like type\n */\nfunction isRecordJsonSchema(schema: JSONSchema7): boolean {\n  return (\n    schema.type === \"object\" &&\n    typeof schema.additionalProperties === \"object\" &&\n    schema.additionalProperties !== null\n  );\n}\n\n/**\n * Recursively walks a JSON Schema and throws when it encounters a record type.\n * Records are not supported because they use dynamic keys which don't serialize\n * well for the Tambo backend.\n * @param schema - The JSON Schema to check\n * @param path - Current path in the schema (for error messages)\n * @param contextName - Human-readable context name for error messages\n */\nfunction assertNoRecordInJsonSchema(\n  schema: JSONSchema7,\n  path: string[],\n  contextName: string,\n): void {\n  if (isRecordJsonSchema(schema)) {\n    const joined = path.length ? path.join(\".\") : \"(root)\";\n    throw new Error(\n      `Record types (objects with dynamic keys) are not supported in ${contextName}. ` +\n        `Found at path \"${joined}\". ` +\n        \"Replace it with an object using explicit keys.\",\n    );\n  }\n  if (schema.properties) {\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      if (typeof propSchema === \"object\" && propSchema !== null) {\n        assertNoRecordInJsonSchema(propSchema, [...path, key], contextName);\n      }\n    }\n  }\n  if (\n    typeof schema.additionalProperties === \"object\" &&\n    schema.additionalProperties !== null\n  ) {\n    assertNoRecordInJsonSchema(\n      schema.additionalProperties,\n      [...path, \"[*]\"],\n      contextName,\n    );\n  }\n  if (schema.items) {\n    if (Array.isArray(schema.items)) {\n      // Tuple (JSON Schema draft-07): check each item schema\n      schema.items.forEach((itemSchema, index) => {\n        if (typeof itemSchema === \"object\" && itemSchema !== null) {\n          assertNoRecordInJsonSchema(\n            itemSchema,\n            [...path, `${index}`],\n            contextName,\n          );\n        }\n      });\n    } else if (typeof schema.items === \"object\") {\n      // Array: check the item schema\n      assertNoRecordInJsonSchema(schema.items, [...path, \"[]\"], contextName);\n    }\n  }\n  const prefixItems = (schema as Record<string, unknown>).prefixItems;\n  if (Array.isArray(prefixItems)) {\n    prefixItems.forEach((itemSchema, index) => {\n      if (typeof itemSchema === \"object\" && itemSchema !== null) {\n        assertNoRecordInJsonSchema(\n          itemSchema as JSONSchema7,\n          [...path, `${index}`],\n          contextName,\n        );\n      }\n    });\n  }\n  if (schema.allOf) {\n    schema.allOf.forEach((subSchema, index) => {\n      if (typeof subSchema === \"object\" && subSchema !== null) {\n        assertNoRecordInJsonSchema(\n          subSchema,\n          [...path, `&${index}`],\n          contextName,\n        );\n      }\n    });\n  }\n  if (schema.anyOf) {\n    schema.anyOf.forEach((subSchema, index) => {\n      if (typeof subSchema === \"object\" && subSchema !== null) {\n        assertNoRecordInJsonSchema(\n          subSchema,\n          [...path, `|${index}`],\n          contextName,\n        );\n      }\n    });\n  }\n  if (schema.oneOf) {\n    schema.oneOf.forEach((subSchema, index) => {\n      if (typeof subSchema === \"object\" && subSchema !== null) {\n        assertNoRecordInJsonSchema(\n          subSchema,\n          [...path, `|${index}`],\n          contextName,\n        );\n      }\n    });\n  }\n  if (typeof schema.not === \"object\" && schema.not !== null) {\n    assertNoRecordInJsonSchema(schema.not, [...path, \"!\"], contextName);\n  }\n  if (typeof schema.if === \"object\" && schema.if !== null) {\n    assertNoRecordInJsonSchema(schema.if, [...path, \"if\"], contextName);\n  }\n  if (typeof schema.then === \"object\" && schema.then !== null) {\n    assertNoRecordInJsonSchema(schema.then, [...path, \"then\"], contextName);\n  }\n  if (typeof schema.else === \"object\" && schema.else !== null) {\n    assertNoRecordInJsonSchema(schema.else, [...path, \"else\"], contextName);\n  }\n}\n\n/**\n * Asserts that a schema does not contain record types (objects with dynamic keys).\n * Records are not serializable to JSON Schema in a way that the Tambo backend\n * understands, so they are disallowed.\n *\n * This function accepts Standard Schema validators (Zod, Valibot, ArkType, etc.)\n * or JSON Schema objects. It converts them to JSON Schema and checks for record patterns.\n *\n * For tool schemas that are function types, this extracts and validates the input parameters.\n * @param schema - The schema to validate (Standard Schema or JSON Schema)\n * @param contextName - A human-readable label echoed in the error message\n */\nexport function assertNoRecordSchema(\n  schema: unknown,\n  contextName = \"schema\",\n): void {\n  if (!schema) {\n    return;\n  }\n\n  let jsonSchema: JSONSchema7;\n\n  try {\n    if (isStandardSchema(schema)) {\n      // Handle function schemas specially - extract input parameters\n      const converted = schemaToJsonSchema(schema);\n\n      // If it's a function schema that couldn't be converted, the input params\n      // were extracted in registry.ts, so we can skip validation here\n      if (!converted || Object.keys(converted).length === 0) {\n        return;\n      }\n\n      jsonSchema = converted;\n    } else if (\n      typeof schema === \"object\" &&\n      schema !== null &&\n      \"type\" in schema\n    ) {\n      // Already JSON Schema\n      jsonSchema = schema as JSONSchema7;\n    } else {\n      // Unknown schema type - skip validation\n      return;\n    }\n  } catch {\n    // If schema conversion fails, skip validation\n    // This can happen for function schemas or other special types\n    return;\n  }\n\n  assertNoRecordInJsonSchema(jsonSchema, [], contextName);\n}\n"]}

package/dist/schema/validate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate.test.d.ts.map

package/dist/schema/validate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.test.d.ts","sourceRoot":"","sources":["../../src/schema/validate.test.ts"],"names":[],"mappings":""}

package/dist/schema/validate.test.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zodInternalAlias_1 = require("zodInternalAlias");
+const validate_1 = require("./validate");
+describe("assertNoRecordSchema", () => {
+    it("should allow valid schemas without records", () => {
+        const schema = zodInternalAlias_1.z.object({
+            name: zodInternalAlias_1.z.string(),
+            age: zodInternalAlias_1.z.number(),
+            tags: zodInternalAlias_1.z.array(zodInternalAlias_1.z.string()),
+            address: zodInternalAlias_1.z.object({
+                street: zodInternalAlias_1.z.string(),
+                city: zodInternalAlias_1.z.string(),
+            }),
+        });
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).not.toThrow();
+    });
+    it("should throw when encountering a record at root level", () => {
+        const schema = zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.string());
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "(root)". Replace it with an object using explicit keys.');
+    });
+    it("should throw when encountering a nested record", () => {
+        const schema = zodInternalAlias_1.z.object({
+            name: zodInternalAlias_1.z.string(),
+            metadata: zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.string()),
+        });
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "metadata". Replace it with an object using explicit keys.');
+    });
+    it("should throw when encountering a record in an array", () => {
+        const schema = zodInternalAlias_1.z.object({
+            items: zodInternalAlias_1.z.array(zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.string())),
+        });
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "items.[]". Replace it with an object using explicit keys.');
+    });
+    it("should throw when encountering a record in a union", () => {
+        const schema = zodInternalAlias_1.z.union([zodInternalAlias_1.z.string(), zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.number())]);
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "|1". Replace it with an object using explicit keys.');
+    });
+    it("should throw when encountering a record in an intersection", () => {
+        const schema = zodInternalAlias_1.z.intersection(zodInternalAlias_1.z.object({ name: zodInternalAlias_1.z.string() }), zodInternalAlias_1.z.object({ metadata: zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.string()) }));
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow(/Record types \(objects with dynamic keys\) are not supported in schema\. Found at path "(&1\.)?metadata"\. Replace it with an object using explicit keys\./);
+    });
+    it("should throw when encountering a record in a discriminated union", () => {
+        const schema = zodInternalAlias_1.z.discriminatedUnion("type", [
+            zodInternalAlias_1.z.object({ type: zodInternalAlias_1.z.literal("string"), value: zodInternalAlias_1.z.string() }),
+            zodInternalAlias_1.z.object({
+                type: zodInternalAlias_1.z.literal("record"),
+                value: zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.number()),
+            }),
+        ]);
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow(/Record types \(objects with dynamic keys\) are not supported in schema\. Found at path "\|1\.value"\. Replace it with an object using explicit keys\./);
+    });
+    it("should throw when encountering a record in an optional field", () => {
+        const schema = zodInternalAlias_1.z.object({
+            optional: zodInternalAlias_1.z.optional(zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.string())),
+        });
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "optional". Replace it with an object using explicit keys.');
+    });
+    it("should throw when encountering a record in a nullable field", () => {
+        const schema = zodInternalAlias_1.z.object({
+            nullable: zodInternalAlias_1.z.nullable(zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.string())),
+        });
+        // Nullable creates a oneOf in JSON Schema, so the path includes the union index
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow(/Record types \(objects with dynamic keys\) are not supported in schema\. Found at path "nullable(\.\|0)?"\. Replace it with an object using explicit keys\./);
+    });
+    it("should throw when encountering a record in a tuple", () => {
+        const schema = zodInternalAlias_1.z.tuple([zodInternalAlias_1.z.string(), zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.number())]);
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "1". Replace it with an object using explicit keys.');
+    });
+    it("should use custom context name in error message", () => {
+        const schema = zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.string());
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema, "mySchema")).toThrow('Record types (objects with dynamic keys) are not supported in mySchema. Found at path "(root)". Replace it with an object using explicit keys.');
+    });
+    it("should handle ZodLazy schemas", () => {
+        const schema = zodInternalAlias_1.z.lazy(() => zodInternalAlias_1.z.record(zodInternalAlias_1.z.string(), zodInternalAlias_1.z.string()));
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "(root)". Replace it with an object using explicit keys.');
+    });
+    it("should allow z.function() with valid arguments", () => {
+        const schema = zodInternalAlias_1.z.function({
+            input: [zodInternalAlias_1.z.string(), zodInternalAlias_1.z.number()],
+            output: zodInternalAlias_1.z.string(),
+        });
+        // Function schemas can't be converted to JSON Schema directly,
+        // so they should not throw (validation happens on the extracted parameters)
+        expect(() => (0, validate_1.assertNoRecordSchema)(schema)).not.toThrow();
+    });
+    it("should allow JSON Schema without records", () => {
+        const jsonSchema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                age: { type: "number" },
+            },
+            required: ["name"],
+        };
+        expect(() => (0, validate_1.assertNoRecordSchema)(jsonSchema)).not.toThrow();
+    });
+    it("should throw when JSON Schema has record pattern", () => {
+        const jsonSchema = {
+            type: "object",
+            additionalProperties: { type: "string" },
+        };
+        expect(() => (0, validate_1.assertNoRecordSchema)(jsonSchema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "(root)". Replace it with an object using explicit keys.');
+    });
+    it("should treat JSON Schema with properties and additionalProperties as a record", () => {
+        const jsonSchema = {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+            },
+            additionalProperties: { type: "number" },
+        };
+        expect(() => (0, validate_1.assertNoRecordSchema)(jsonSchema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "(root)". Replace it with an object using explicit keys.');
+    });
+    it("should throw when nested JSON Schema has record pattern", () => {
+        const jsonSchema = {
+            type: "object",
+            properties: {
+                metadata: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                },
+            },
+        };
+        expect(() => (0, validate_1.assertNoRecordSchema)(jsonSchema)).toThrow('Record types (objects with dynamic keys) are not supported in schema. Found at path "metadata". Replace it with an object using explicit keys.');
+    });
+});
+//# sourceMappingURL=validate.test.js.map

package/dist/schema/validate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.test.js","sourceRoot":"","sources":["../../src/schema/validate.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zodInternalAlias\";\nimport { assertNoRecordSchema } from \"./validate\";\n\ndescribe(\"assertNoRecordSchema\", () => {\n  it(\"should allow valid schemas without records\", () => {\n    const schema = z.object({\n      name: z.string(),\n      age: z.number(),\n      tags: z.array(z.string()),\n      address: z.object({\n        street: z.string(),\n        city: z.string(),\n      }),\n    });\n\n    expect(() => assertNoRecordSchema(schema)).not.toThrow();\n  });\n\n  it(\"should throw when encountering a record at root level\", () => {\n    const schema = z.record(z.string(), z.string());\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"(root)\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should throw when encountering a nested record\", () => {\n    const schema = z.object({\n      name: z.string(),\n      metadata: z.record(z.string(), z.string()),\n    });\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"metadata\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should throw when encountering a record in an array\", () => {\n    const schema = z.object({\n      items: z.array(z.record(z.string(), z.string())),\n    });\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"items.[]\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should throw when encountering a record in a union\", () => {\n    const schema = z.union([z.string(), z.record(z.string(), z.number())]);\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"|1\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should throw when encountering a record in an intersection\", () => {\n    const schema = z.intersection(\n      z.object({ name: z.string() }),\n      z.object({ metadata: z.record(z.string(), z.string()) }),\n    );\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      /Record types \\(objects with dynamic keys\\) are not supported in schema\\. Found at path \"(&1\\.)?metadata\"\\. Replace it with an object using explicit keys\\./,\n    );\n  });\n\n  it(\"should throw when encountering a record in a discriminated union\", () => {\n    const schema = z.discriminatedUnion(\"type\", [\n      z.object({ type: z.literal(\"string\"), value: z.string() }),\n      z.object({\n        type: z.literal(\"record\"),\n        value: z.record(z.string(), z.number()),\n      }),\n    ]);\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      /Record types \\(objects with dynamic keys\\) are not supported in schema\\. Found at path \"\\|1\\.value\"\\. Replace it with an object using explicit keys\\./,\n    );\n  });\n\n  it(\"should throw when encountering a record in an optional field\", () => {\n    const schema = z.object({\n      optional: z.optional(z.record(z.string(), z.string())),\n    });\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"optional\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should throw when encountering a record in a nullable field\", () => {\n    const schema = z.object({\n      nullable: z.nullable(z.record(z.string(), z.string())),\n    });\n\n    // Nullable creates a oneOf in JSON Schema, so the path includes the union index\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      /Record types \\(objects with dynamic keys\\) are not supported in schema\\. Found at path \"nullable(\\.\\|0)?\"\\. Replace it with an object using explicit keys\\./,\n    );\n  });\n\n  it(\"should throw when encountering a record in a tuple\", () => {\n    const schema = z.tuple([z.string(), z.record(z.string(), z.number())]);\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"1\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should use custom context name in error message\", () => {\n    const schema = z.record(z.string(), z.string());\n\n    expect(() => assertNoRecordSchema(schema, \"mySchema\")).toThrow(\n      'Record types (objects with dynamic keys) are not supported in mySchema. Found at path \"(root)\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should handle ZodLazy schemas\", () => {\n    const schema = z.lazy(() => z.record(z.string(), z.string()));\n\n    expect(() => assertNoRecordSchema(schema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"(root)\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should allow z.function() with valid arguments\", () => {\n    const schema = z.function({\n      input: [z.string(), z.number()],\n      output: z.string(),\n    });\n\n    // Function schemas can't be converted to JSON Schema directly,\n    // so they should not throw (validation happens on the extracted parameters)\n    expect(() => assertNoRecordSchema(schema)).not.toThrow();\n  });\n\n  it(\"should allow JSON Schema without records\", () => {\n    const jsonSchema = {\n      type: \"object\" as const,\n      properties: {\n        name: { type: \"string\" as const },\n        age: { type: \"number\" as const },\n      },\n      required: [\"name\"],\n    };\n\n    expect(() => assertNoRecordSchema(jsonSchema)).not.toThrow();\n  });\n\n  it(\"should throw when JSON Schema has record pattern\", () => {\n    const jsonSchema = {\n      type: \"object\" as const,\n      additionalProperties: { type: \"string\" as const },\n    };\n\n    expect(() => assertNoRecordSchema(jsonSchema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"(root)\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should treat JSON Schema with properties and additionalProperties as a record\", () => {\n    const jsonSchema = {\n      type: \"object\" as const,\n      properties: {\n        id: { type: \"string\" as const },\n      },\n      additionalProperties: { type: \"number\" as const },\n    };\n\n    expect(() => assertNoRecordSchema(jsonSchema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"(root)\". Replace it with an object using explicit keys.',\n    );\n  });\n\n  it(\"should throw when nested JSON Schema has record pattern\", () => {\n    const jsonSchema = {\n      type: \"object\" as const,\n      properties: {\n        metadata: {\n          type: \"object\" as const,\n          additionalProperties: { type: \"string\" as const },\n        },\n      },\n    };\n\n    expect(() => assertNoRecordSchema(jsonSchema)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in schema. Found at path \"metadata\". Replace it with an object using explicit keys.',\n    );\n  });\n});\n"]}

package/dist/schema/zod.d.ts

@@ -0,0 +1,54 @@
+import { ZodFunction, ZodTuple, ZodTupleItems, ZodType, ZodTypeAny } from "zod/v3";
+import { $ZodFunction, $ZodType } from "zod/v4/core";
+/**
+ * @returns True if the schema is a Zod 3 function schema
+ */
+export declare function isZod3FunctionSchema(schema: unknown): schema is ZodFunction<ZodTuple<ZodTupleItems, any>, ZodTypeAny>;
+/**
+ * @returns True if the schema is a Zod 4 function schema
+ */
+export declare function isZod4FunctionSchema(schema: unknown): schema is $ZodFunction;
+/**
+ * Checks if a schema is a Zod function schema (Zod 3 or Zod 4).
+ * @param schema - The schema to check
+ * @returns True if the schema is a Zod function schema
+ */
+export declare function isZodFunctionSchema(schema: unknown): schema is ZodFunction<ZodTuple<ZodTupleItems, any>, ZodTypeAny> | $ZodFunction<import("zod/v4/core").$ZodFunctionArgs, import("zod/v4/core").$ZodFunctionOut>;
+/**
+ * Extracts the args schema from a Zod function schema.
+ * @param schema - The Zod function schema
+ * @returns The args schema, or undefined if not a Zod function schema
+ */
+export declare function getZodFunctionArgs(schema: unknown): import("zod/v4/core").$ZodFunctionArgs | ZodTuple<ZodTupleItems, any>;
+/**
+ * Extracts the return schema from a Zod 3 or Zod 4 function schema.
+ * @param schema - The Zod function schema
+ * @returns The return schema, or undefined if not a Zod function schema
+ */
+export declare function getZodFunctionReturns(schema: unknown): any;
+/**
+ * Handles conversion of Zod schemas to JSON Schema.
+ * Supports both Zod 3 (via zod-to-json-schema) and Zod 4 (native).
+ * @param schema - The Zod schema to convert
+ * @returns The JSON Schema representation
+ */
+export declare function handleZodSchemaToJson(schema: unknown): any;
+/**
+ * Checks if a schema is probably a Zod 3 schema.
+ * @param schema - The schema to check
+ * @returns True if the schema looks like a Zod 3 schema
+ */
+export declare function isZod3Schema(schema: unknown): schema is ZodType;
+/**
+ * Detects if a schema is Zod 4 by checking for def.type property.
+ * Zod 4 uses `def.type` with lowercase type names like "object", "string".
+ * @returns True if the schema appears to be Zod 4 style
+ */
+export declare function isZod4Schema(schema: unknown): schema is $ZodType;
+/**
+ * Checks if a schema is a Zod schema
+ * @param schema - The schema to check
+ * @returns True if the schema is a Zod schema
+ */
+export declare function isZodSchema(schema: unknown): ReturnType<typeof isZod3Schema> | ReturnType<typeof isZod4Schema>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/schema/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/schema/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,QAAQ,EACR,aAAa,EACb,OAAO,EACP,UAAU,EACX,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,YAAY,EACZ,QAAQ,EAET,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,CAMjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,YAAY,CAoB5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,iKAElD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,yEAWjD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,OAWpD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,OAkBpD;AAaD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,OAAO,CAE/D;AAUD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,QAAQ,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,OAAO,GACd,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAEnE"}

package/dist/schema/zod.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isZod3FunctionSchema = isZod3FunctionSchema;
+exports.isZod4FunctionSchema = isZod4FunctionSchema;
+exports.isZodFunctionSchema = isZodFunctionSchema;
+exports.getZodFunctionArgs = getZodFunctionArgs;
+exports.getZodFunctionReturns = getZodFunctionReturns;
+exports.handleZodSchemaToJson = handleZodSchemaToJson;
+exports.isZod3Schema = isZod3Schema;
+exports.isZod4Schema = isZod4Schema;
+exports.isZodSchema = isZodSchema;
+const core_1 = require("zod/v4/core");
+const zodInternalAlias_1 = require("zodInternalAlias");
+/**
+ * @returns True if the schema is a Zod 3 function schema
+ */
+function isZod3FunctionSchema(schema) {
+    if (!isZod3Schema(schema)) {
+        return false;
+    }
+    return "typeName" in schema._def && schema._def.typeName === "ZodFunction";
+}
+/**
+ * @returns True if the schema is a Zod 4 function schema
+ */
+function isZod4FunctionSchema(schema) {
+    if (!isZod4Schema(schema)) {
+        return false;
+    }
+    // $ZodFunctions in zod 4.0 most certainly do have .def.type === "function"
+    // but the type definitions do not reflect this because $ZodFunction does not
+    // extend $ZodType. This is corrected in zod 4.1, but zod 3 does not include
+    // the types for 4.1 yet (and might not ever).
+    // See: https://github.com/colinhacks/zod/blob/463f03eb8183dcdcdf735b180f2bf40883e66220/packages/zod/src/v4/core/function.ts#L48
+    if ("def" in schema && typeof schema.def !== "object" && schema.def) {
+        if (schema.def?.type === "function") {
+            return true;
+        }
+    }
+    // We're casting as string here because zod 4.0 types don't include "function"
+    // literal in the union for `_zod.def.type`. The optional chaining is because
+    // _zod does not exist on zod 4 objects from zod 3.
+    return schema._zod?.def?.type === "function";
+}
+/**
+ * Checks if a schema is a Zod function schema (Zod 3 or Zod 4).
+ * @param schema - The schema to check
+ * @returns True if the schema is a Zod function schema
+ */
+function isZodFunctionSchema(schema) {
+    return isZod3FunctionSchema(schema) || isZod4FunctionSchema(schema);
+}
+/**
+ * Extracts the args schema from a Zod function schema.
+ * @param schema - The Zod function schema
+ * @returns The args schema, or undefined if not a Zod function schema
+ */
+function getZodFunctionArgs(schema) {
+    if (isZod3FunctionSchema(schema)) {
+        return schema._def.args;
+    }
+    if (isZod4FunctionSchema(schema)) {
+        // @ts-expect-error -- Error in Zod types for v3 vs v4.0
+        return schema?.def?.input ?? schema._zod?.def?.input;
+    }
+    throw new Error("Unable to determine parameters from zod function schema");
+}
+/**
+ * Extracts the return schema from a Zod 3 or Zod 4 function schema.
+ * @param schema - The Zod function schema
+ * @returns The return schema, or undefined if not a Zod function schema
+ */
+function getZodFunctionReturns(schema) {
+    if (isZod3FunctionSchema(schema)) {
+        return schema._def.returns;
+    }
+    if (isZod4FunctionSchema(schema)) {
+        // @ts-expect-error -- Error in Zod types for v3 vs v4
+        return schema._zod.def.output;
+    }
+    throw new Error("Unable to determine return type from zod function schema");
+}
+/**
+ * Handles conversion of Zod schemas to JSON Schema.
+ * Supports both Zod 3 (via zod-to-json-schema) and Zod 4 (native).
+ * @param schema - The Zod schema to convert
+ * @returns The JSON Schema representation
+ */
+function handleZodSchemaToJson(schema) {
+    // If Zod4 schema detected, use the toJSONSchema function from "zod/v4/core"
+    if (isZod4Schema(schema))
+        return (0, core_1.toJSONSchema)(schema);
+    try {
+        // Dynamic require for optional peer dependency
+        // eslint-disable-next-line @typescript-eslint/no-require-imports -- need require because zod-to-json-schema may be missing
+        const { zodToJsonSchema } = require("zod-to-json-schema");
+        return zodToJsonSchema(schema);
+    }
+    catch (error) {
+        throw new Error("Zod 3 requires 'zod-to-json-schema' package for JSON Schema conversion. " +
+            "Install it with: npm install zod-to-json-schema", {
+            cause: error,
+        });
+    }
+}
+// Zod 3 schemas have _def with typeName and ~standard with vendor "zod"
+// Use looseObject to allow any _def shape (different for each type)
+const zod3SchemaType = zodInternalAlias_1.z.object({
+    _def: zodInternalAlias_1.z.looseObject({
+        typeName: zodInternalAlias_1.z.string().optional(),
+    }),
+    "~standard": zodInternalAlias_1.z.looseObject({
+        vendor: zodInternalAlias_1.z.literal("zod"),
+    }),
+});
+/**
+ * Checks if a schema is probably a Zod 3 schema.
+ * @param schema - The schema to check
+ * @returns True if the schema looks like a Zod 3 schema
+ */
+function isZod3Schema(schema) {
+    return zod3SchemaType.safeParse(schema).success;
+}
+const zod4SchemaType = zodInternalAlias_1.z.object({
+    def: zodInternalAlias_1.z.object(),
+    _zod: zodInternalAlias_1.z.looseObject({
+        def: zodInternalAlias_1.z.looseObject({}),
+    }),
+    "~standard": zodInternalAlias_1.z.looseObject({}),
+});
+/**
+ * Detects if a schema is Zod 4 by checking for def.type property.
+ * Zod 4 uses `def.type` with lowercase type names like "object", "string".
+ * @returns True if the schema appears to be Zod 4 style
+ */
+function isZod4Schema(schema) {
+    return zod4SchemaType.safeParse(schema).success;
+}
+/**
+ * Checks if a schema is a Zod schema
+ * @param schema - The schema to check
+ * @returns True if the schema is a Zod schema
+ */
+function isZodSchema(schema) {
+    return isZod3Schema(schema) || isZod4Schema(schema);
+}
+//# sourceMappingURL=zod.js.map

package/dist/schema/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/schema/zod.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ZodFunction,\n  ZodTuple,\n  ZodTupleItems,\n  ZodType,\n  ZodTypeAny,\n} from \"zod/v3\";\nimport {\n  $ZodFunction,\n  $ZodType,\n  toJSONSchema as zod4ToJSONSchema,\n} from \"zod/v4/core\";\nimport { z } from \"zodInternalAlias\";\n\n/**\n * @returns True if the schema is a Zod 3 function schema\n */\nexport function isZod3FunctionSchema(\n  schema: unknown,\n): schema is ZodFunction<ZodTuple<ZodTupleItems, any>, ZodTypeAny> {\n  if (!isZod3Schema(schema)) {\n    return false;\n  }\n\n  return \"typeName\" in schema._def && schema._def.typeName === \"ZodFunction\";\n}\n\n/**\n * @returns True if the schema is a Zod 4 function schema\n */\nexport function isZod4FunctionSchema(schema: unknown): schema is $ZodFunction {\n  if (!isZod4Schema(schema)) {\n    return false;\n  }\n\n  // $ZodFunctions in zod 4.0 most certainly do have .def.type === \"function\"\n  // but the type definitions do not reflect this because $ZodFunction does not\n  // extend $ZodType. This is corrected in zod 4.1, but zod 3 does not include\n  // the types for 4.1 yet (and might not ever).\n  // See: https://github.com/colinhacks/zod/blob/463f03eb8183dcdcdf735b180f2bf40883e66220/packages/zod/src/v4/core/function.ts#L48\n  if (\"def\" in schema && typeof schema.def !== \"object\" && schema.def) {\n    if ((schema.def as { type: string })?.type === \"function\") {\n      return true;\n    }\n  }\n\n  // We're casting as string here because zod 4.0 types don't include \"function\"\n  // literal in the union for `_zod.def.type`. The optional chaining is because\n  // _zod does not exist on zod 4 objects from zod 3.\n  return (schema._zod?.def?.type as string) === \"function\";\n}\n\n/**\n * Checks if a schema is a Zod function schema (Zod 3 or Zod 4).\n * @param schema - The schema to check\n * @returns True if the schema is a Zod function schema\n */\nexport function isZodFunctionSchema(schema: unknown) {\n  return isZod3FunctionSchema(schema) || isZod4FunctionSchema(schema);\n}\n\n/**\n * Extracts the args schema from a Zod function schema.\n * @param schema - The Zod function schema\n * @returns The args schema, or undefined if not a Zod function schema\n */\nexport function getZodFunctionArgs(schema: unknown) {\n  if (isZod3FunctionSchema(schema)) {\n    return schema._def.args;\n  }\n\n  if (isZod4FunctionSchema(schema)) {\n    // @ts-expect-error -- Error in Zod types for v3 vs v4.0\n    return schema?.def?.input ?? schema._zod?.def?.input;\n  }\n\n  throw new Error(\"Unable to determine parameters from zod function schema\");\n}\n\n/**\n * Extracts the return schema from a Zod 3 or Zod 4 function schema.\n * @param schema - The Zod function schema\n * @returns The return schema, or undefined if not a Zod function schema\n */\nexport function getZodFunctionReturns(schema: unknown) {\n  if (isZod3FunctionSchema(schema)) {\n    return schema._def.returns;\n  }\n\n  if (isZod4FunctionSchema(schema)) {\n    // @ts-expect-error -- Error in Zod types for v3 vs v4\n    return schema._zod.def.output;\n  }\n\n  throw new Error(\"Unable to determine return type from zod function schema\");\n}\n\n/**\n * Handles conversion of Zod schemas to JSON Schema.\n * Supports both Zod 3 (via zod-to-json-schema) and Zod 4 (native).\n * @param schema - The Zod schema to convert\n * @returns The JSON Schema representation\n */\nexport function handleZodSchemaToJson(schema: unknown) {\n  // If Zod4 schema detected, use the toJSONSchema function from \"zod/v4/core\"\n  if (isZod4Schema(schema)) return zod4ToJSONSchema(schema);\n\n  try {\n    // Dynamic require for optional peer dependency\n    // eslint-disable-next-line @typescript-eslint/no-require-imports -- need require because zod-to-json-schema may be missing\n    const { zodToJsonSchema } = require(\"zod-to-json-schema\");\n    return zodToJsonSchema(schema);\n  } catch (error) {\n    throw new Error(\n      \"Zod 3 requires 'zod-to-json-schema' package for JSON Schema conversion. \" +\n        \"Install it with: npm install zod-to-json-schema\",\n      {\n        cause: error,\n      },\n    );\n  }\n}\n\n// Zod 3 schemas have _def with typeName and ~standard with vendor \"zod\"\n// Use looseObject to allow any _def shape (different for each type)\nconst zod3SchemaType = z.object({\n  _def: z.looseObject({\n    typeName: z.string().optional(),\n  }),\n  \"~standard\": z.looseObject({\n    vendor: z.literal(\"zod\"),\n  }),\n});\n\n/**\n * Checks if a schema is probably a Zod 3 schema.\n * @param schema - The schema to check\n * @returns True if the schema looks like a Zod 3 schema\n */\nexport function isZod3Schema(schema: unknown): schema is ZodType {\n  return zod3SchemaType.safeParse(schema).success;\n}\n\nconst zod4SchemaType = z.object({\n  def: z.object(),\n  _zod: z.looseObject({\n    def: z.looseObject({}),\n  }),\n  \"~standard\": z.looseObject({}),\n});\n\n/**\n * Detects if a schema is Zod 4 by checking for def.type property.\n * Zod 4 uses `def.type` with lowercase type names like \"object\", \"string\".\n * @returns True if the schema appears to be Zod 4 style\n */\nexport function isZod4Schema(schema: unknown): schema is $ZodType {\n  return zod4SchemaType.safeParse(schema).success;\n}\n\n/**\n * Checks if a schema is a Zod schema\n * @param schema - The schema to check\n * @returns True if the schema is a Zod schema\n */\nexport function isZodSchema(\n  schema: unknown,\n): ReturnType<typeof isZod3Schema> | ReturnType<typeof isZod4Schema> {\n  return isZod3Schema(schema) || isZod4Schema(schema);\n}\n"]}

package/dist/testing/tools.d.ts

@@ -1,25 +1,39 @@
-import { TamboComponent } from "../providers";
+import { TamboToolWithToolSchema } from "../model/component-metadata";
+import { TamboComponent, TamboTool } from "../providers";
 /**
- * Serializes the registry for testing purposes
+ * Serializes the registry for testing purposes.
+ * Converts Standard Schema validators to JSON Schema format.
+ * Uses the same logic as production code via mapTamboToolToContextTool.
  * @param mockRegistry - The registry to serialize
- * @returns The serialized registry
+ * @returns The serialized registry with JSON Schema representations
  */
 export declare function serializeRegistry(mockRegistry: TamboComponent[]): {
-    props: import("zod-to-json-schema").JsonSchema7Type & {
-        $schema?: string | undefined;
-        definitions?: {
-            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
-        } | undefined;
-    };
-    contextTools: {
-        parameters: any;
-        name: string;
-        description: string;
-        transformToContent?: ((result: any) => Promise<import("@tambo-ai/typescript-sdk/resources/beta").ChatCompletionContentPart[]> | import("@tambo-ai/typescript-sdk/resources/beta").ChatCompletionContentPart[]) | undefined;
-    }[] | undefined;
+    props: import("json-schema").JSONSchema7 | undefined;
+    contextTools: import("../model/component-metadata").ComponentContextToolMetadata[] | undefined;
     name: string;
     description: string;
     propsDefinition?: any;
     loadingComponent?: import("react").ComponentType<any>;
 }[];
+interface CreateMockToolOptions {
+    inputSchema: TamboTool["inputSchema"];
+    outputSchema?: TamboTool["outputSchema"];
+}
+/**
+ * Creates a mock TamboTool with the given input schema for testing purposes.
+ * Accepts either an inputSchema directly or an options object with inputSchema and outputSchema.
+ * @param schemaOrOptions - The input schema or options object
+ * @returns A mock TamboTool instance
+ * @internal
+ */
+export declare function createMockTool(schemaOrOptions: TamboTool["inputSchema"] | CreateMockToolOptions): TamboTool;
+/**
+ * Creates a mock TamboToolWithToolSchema for testing purposes.
+ * Does NOT adapt to inputSchema format - preserves the deprecated toolSchema interface.
+ * @param toolSchema - The tool schema for the tool
+ * @returns A mock TamboToolWithToolSchema instance (NOT adapted)
+ * @internal
+ */
+export declare function createMockToolWithToolSchema(toolSchema: TamboToolWithToolSchema["toolSchema"]): TamboToolWithToolSchema;
+export {};
 //# sourceMappingURL=tools.d.ts.map

package/dist/testing/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/testing/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,cAAc,EAAE;;;;;;;;;;;;;;;;;IA0B/D"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/testing/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAOzD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,cAAc,EAAE;;;;;;;IAiB/D;AAED,UAAU,qBAAqB;IAC7B,WAAW,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;CAC1C;AAGD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,SAAS,CAAC,aAAa,CAAC,GAAG,qBAAqB,GAChE,SAAS,CAiCX;AAGD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,uBAAuB,CAAC,YAAY,CAAC,GAChD,uBAAuB,CAOzB"}