@veryfront/ext-schema-zod 0.1.985

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,2 @@
+Veryfront Code
+Copyright 2026 Veryfront GmbH

package/README.md

@@ -0,0 +1,85 @@
+# @veryfront/ext-schema-zod
+
+> **Category:** Schema | **Contract:** `SchemaValidator` | **Built-in**
+
+Provides schema validation for Veryfront, backed by [Zod](https://zod.dev/). Once loaded, any module that calls `defineSchema((v) => v.object({...}))` resolves through this extension's Zod-powered adapter.
+
+## How It Works
+
+Core modules never import zod directly. Instead they declare schemas via `defineSchema`:
+
+```ts
+import { defineSchema } from "veryfront/schemas";
+import type { InferSchema } from "veryfront/extensions/schema";
+
+const getUserSchema = defineSchema((v) =>
+  v.object({
+    id: v.string().uuid(),
+    name: v.string().min(1),
+    email: v.string().email().optional(),
+  })
+);
+
+type User = InferSchema<ReturnType<typeof getUserSchema>>;
+
+const user = getUserSchema().parse(input);
+```
+
+The `v` parameter is a `SchemaValidator` instance provided by this extension. It exposes a zod-inspired DSL covering primitives, composites, chainables, and validation methods.
+
+## Registration
+
+ext-schema-zod is registered automatically by `createBuiltinExtensions()` at app bootstrap. It is placed **first** in the builtin chain so that other extensions can use `defineSchema` in their own `setup()` hooks.
+
+### Test Setup
+
+Tests that use `defineSchema` without full app bootstrap need to register the adapter explicitly:
+
+```ts
+import "#veryfront/schemas/_test-setup.ts";
+```
+
+Or manually:
+
+```ts
+import { register } from "veryfront/extensions/contracts";
+import { createZodAdapter } from "@veryfront/ext-schema-zod";
+
+register("SchemaValidator", createZodAdapter());
+```
+
+## Supported DSL
+
+### Primitives
+
+`string()`, `number()`, `boolean()`, `date()`, `null()`, `unknown()`, `any()`, `bigint()`
+
+### Composites
+
+`object(shape)`, `array(schema)`, `record(keys, values)`, `union(schemas)`, `discriminatedUnion(key, schemas)`, `literal(value)`, `enum(values)`, `tuple(items)`, `lazy(factory)`, `instanceof(ctor)`
+
+### Chainables
+
+`.optional()`, `.nullable()`, `.nullish()`, `.default(value)`, `.describe(text)`, `.refine(fn)`, `.superRefine(fn)`, `.transform(fn)`, `.strict()`, `.passthrough()`, `.strip()`, `.partial()`, `.extend(shape)`, `.merge(schema)`, `.omit(keys)`, `.pick(keys)`
+
+### String/Number Refinements
+
+`.min(n)`, `.max(n)`, `.int()`, `.positive()`, `.nonnegative()`, `.regex(pattern)`, `.email()`, `.url()`, `.uuid()`, `.datetime()`
+
+### Coercion
+
+`v.coerce.string()`, `v.coerce.number()`, `v.coerce.boolean()`, `v.coerce.date()`
+
+### Validation
+
+`.parse(data)` throws on failure; `.safeParse(data)` returns `{ success, data }` or `{ success, issues }`.
+
+### JSON Schema
+
+`toJsonSchema(schema)` converts any `Schema<T>` to a JSON Schema object for OpenAPI or tool-call definitions.
+
+## Running Tests
+
+```sh
+deno task test
+```

package/esm/adapter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Zod-backed `SchemaValidator` adapter.
+ *
+ * The default implementation of the `SchemaValidator` contract. It thinly
+ * wraps zod so that core modules can declare schemas through the
+ * extension-neutral DSL while still getting zod's runtime behavior.
+ *
+ * The entire zod surface used by the contract is confined to this file.
+ *
+ * @module extensions/ext-schema-zod/adapter
+ */
+import type { SchemaValidator } from "veryfront/extensions/schema";
+/**
+ * Build a zod-backed `SchemaValidator` instance.
+ *
+ * Stateless — safe to call once at extension setup and pass the returned
+ * value to `ctx.provide("SchemaValidator", …)`. Tests that need to register
+ * the validator without going through full extension bootstrap can call this
+ * factory directly.
+ */
+export declare function createZodAdapter(): SchemaValidator;
+//# sourceMappingURL=adapter.d.ts.map

package/esm/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAKV,eAAe,EAIhB,MAAM,6BAA6B,CAAC;AAiHrC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CA8FlD"}

package/esm/adapter.js

@@ -0,0 +1,159 @@
+/**
+ * Zod-backed `SchemaValidator` adapter.
+ *
+ * The default implementation of the `SchemaValidator` contract. It thinly
+ * wraps zod so that core modules can declare schemas through the
+ * extension-neutral DSL while still getting zod's runtime behavior.
+ *
+ * The entire zod surface used by the contract is confined to this file.
+ *
+ * @module extensions/ext-schema-zod/adapter
+ */
+import { z } from "zod";
+import { isOptionalSchema, zodToJsonSchema } from "./json-schema.js";
+/** Unwrap our opaque Schema<T> back to the underlying zod schema. */
+function toZod(schema) {
+    return schema.__zod;
+}
+/** Wrap a zod schema as an opaque Schema<T> with chainables routed through zod. */
+function wrap(zs) {
+    // The wrapper fakes the full Schema<T> surface; unsupported chainables on
+    // unsuitable kinds (e.g. calling `.email()` on a number) throw at runtime
+    // just like zod would.
+    // deno-lint-ignore no-explicit-any -- safe within this adapter
+    const anyZs = zs;
+    const s = {
+        _output: undefined,
+        optional: () => wrap(zs.optional()),
+        nullable: () => wrap(zs.nullable()),
+        nullish: () => wrap(zs.nullish()),
+        default: (value) => wrap(anyZs.default(value)),
+        describe: (description) => wrap(zs.describe(description)),
+        refine: (check, message) => wrap(zs.refine(check, message)),
+        superRefine: (check) => wrap(
+        // zod v4's `RefinementCtx` extends `ParsePayload` (`{ value, issues }`)
+        // and exposes `addIssue(string | $ZodSuperRefineIssue)`. We bridge to
+        // our path-aware `RefinementCtx` shape: we don't have a stable `path`
+        // from the zod side here (path tracking is per-issue, not per-ctx),
+        // so we emit `[]` and let callers pass their own `path` through
+        // `addIssue({ path })`.
+        anyZs.superRefine((value, zodCtx) => {
+            const ctx = {
+                path: [],
+                addIssue: (issue) => zodCtx.addIssue({
+                    // String literal "custom" replaces the deprecated
+                    // z.ZodIssueCode.custom enum (zod v4 prefers raw codes).
+                    code: issue.code ?? "custom",
+                    message: issue.message,
+                    path: issue.path,
+                }),
+            };
+            check(value, ctx);
+        })),
+        transform: (fn) => wrap(zs.transform(fn)),
+        strict: () => wrap(anyZs.strict()),
+        strip: () => wrap(anyZs.strip()),
+        passthrough: () => wrap(anyZs.passthrough()),
+        partial: () => wrap(anyZs.partial()),
+        extend: (shape) => {
+            const zodShape = toZodShape(shape);
+            return wrap(anyZs.extend(zodShape));
+        },
+        merge: (other) => wrap(anyZs.merge(toZod(other))),
+        omit: (keys) => wrap(anyZs.omit(keys)),
+        pick: (keys) => wrap(anyZs.pick(keys)),
+        min: (value, message) => wrap(anyZs.min(value, message)),
+        max: (value, message) => wrap(anyZs.max(value, message)),
+        int: (message) => wrap(anyZs.int(message)),
+        positive: (message) => wrap(anyZs.positive(message)),
+        nonnegative: (message) => wrap(anyZs.nonnegative(message)),
+        regex: (pattern, message) => wrap(anyZs.regex(pattern, message)),
+        email: (message) => wrap(anyZs.email(message)),
+        url: (message) => wrap(anyZs.url(message)),
+        uuid: (message) => wrap(anyZs.uuid(message)),
+        datetime: (message) => wrap(anyZs.datetime(message)),
+        pipe: (next) => wrap(zs.pipe(toZod(next))),
+        parse: (data) => zs.parse(data),
+        safeParse: (data) => {
+            const res = zs.safeParse(data);
+            if (res.success)
+                return { success: true, data: res.data };
+            const issues = res.error.issues.map((issue) => ({
+                path: issue.path,
+                message: issue.message,
+                code: issue.code,
+            }));
+            return { success: false, issues, error: res.error };
+        },
+    };
+    // Attach the underlying zod schema for adapter round-trips without
+    // widening the public Schema<T> surface.
+    s.__zod = zs;
+    return s;
+}
+function toZodShape(shape) {
+    const out = {};
+    for (const [key, value] of Object.entries(shape)) {
+        out[key] = toZod(value);
+    }
+    return out;
+}
+const coerce = {
+    string: () => wrap(z.coerce.string()),
+    number: () => wrap(z.coerce.number()),
+    boolean: () => wrap(z.coerce.boolean()),
+    date: () => wrap(z.coerce.date()),
+};
+/**
+ * Build a zod-backed `SchemaValidator` instance.
+ *
+ * Stateless — safe to call once at extension setup and pass the returned
+ * value to `ctx.provide("SchemaValidator", …)`. Tests that need to register
+ * the validator without going through full extension bootstrap can call this
+ * factory directly.
+ */
+export function createZodAdapter() {
+    return {
+        string: () => wrap(z.string()),
+        number: () => wrap(z.number()),
+        boolean: () => wrap(z.boolean()),
+        date: () => wrap(z.date()),
+        null: () => wrap(z.null()),
+        unknown: () => wrap(z.unknown()),
+        bigint: () => wrap(z.bigint()),
+        // deno-lint-ignore no-explicit-any -- contract mirrors zod's `any` constructor
+        any: () => wrap(z.any()),
+        function: () => 
+        // zod 4's z.function() is callable without args/returns and produces a
+        // schema accepting any function. We wrap it as Schema<AnyFunction>.
+        wrap(z.function()),
+        object: (shape) => wrap(z.object(toZodShape(shape))),
+        array: (element) => wrap(z.array(toZod(element))),
+        tuple: (items) => {
+            const zodItems = items.map((s) => toZod(s));
+            return wrap(z.tuple(zodItems));
+        },
+        record: (keys, values) => wrap(z.record(toZod(keys), toZod(values))),
+        union: (schemas) => {
+            const zodSchemas = schemas.map((s) => toZod(s));
+            return wrap(z.union(zodSchemas));
+        },
+        discriminatedUnion: (discriminator, schemas) => {
+            const zodSchemas = schemas.map((s) => toZod(s));
+            return wrap(z.discriminatedUnion(discriminator, zodSchemas));
+        },
+        literal: (value) => wrap(z.literal(value)),
+        enum: (values) => wrap(z.enum(values)),
+        lazy: (factory) => wrap(z.lazy(() => toZod(factory()))),
+        instanceof: (ctor) => 
+        // zod 4's z.instanceof expects `typeof Class` (z.core.util.Class). Our
+        // contract uses a slimmer `new`-able shape; bridge with a single cast
+        // through unknown.
+        wrap(z.instanceof(ctor)),
+        custom: (check, message) => wrap(z.custom(check, message)),
+        coerce,
+        validate: (schema, data) => schema.safeParse(data),
+        toJsonSchema: (schema) => zodToJsonSchema(toZod(schema)),
+        isOptional: (schema) => isOptionalSchema(toZod(schema)),
+    };
+}

package/esm/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ext-schema-zod — SchemaValidator implementation backed by zod.
+ *
+ * Provides the `SchemaValidator` contract via a zod-backed adapter. Core
+ * modules declare schemas through `defineSchema((v) => …)` (in
+ * `src/schemas/define.ts`); the lazy factory resolves this contract on first
+ * use and the adapter routes calls into zod.
+ *
+ * Registered automatically by `createBuiltinExtensions()`. Tests that need
+ * the adapter without going through full extension bootstrap can import
+ * `createZodAdapter` directly from this module's `./adapter.ts`.
+ *
+ * @module extensions/ext-schema-zod
+ */
+import type { ExtensionFactory } from "veryfront/extensions";
+declare const extZod: ExtensionFactory;
+export default extZod;
+export { createZodAdapter } from "./adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,QAAA,MAAM,MAAM,EAAE,gBAiBb,CAAC;AAEF,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/esm/index.js

@@ -0,0 +1,35 @@
+/**
+ * ext-schema-zod — SchemaValidator implementation backed by zod.
+ *
+ * Provides the `SchemaValidator` contract via a zod-backed adapter. Core
+ * modules declare schemas through `defineSchema((v) => …)` (in
+ * `src/schemas/define.ts`); the lazy factory resolves this contract on first
+ * use and the adapter routes calls into zod.
+ *
+ * Registered automatically by `createBuiltinExtensions()`. Tests that need
+ * the adapter without going through full extension bootstrap can import
+ * `createZodAdapter` directly from this module's `./adapter.ts`.
+ *
+ * @module extensions/ext-schema-zod
+ */
+import { createZodAdapter } from "./adapter.js";
+const extZod = () => {
+    const impl = createZodAdapter();
+    return {
+        name: "ext-schema-zod",
+        version: "0.1.0",
+        contracts: {
+            provides: ["SchemaValidator"],
+        },
+        capabilities: [],
+        setup(ctx) {
+            ctx.provide("SchemaValidator", impl);
+            ctx.logger.info("[ext-schema-zod] SchemaValidator registered");
+        },
+        teardown() {
+            // No resources to release.
+        },
+    };
+};
+export default extZod;
+export { createZodAdapter } from "./adapter.js";

package/esm/json-schema.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Zod-to-JSON-Schema converter used by the `SchemaValidator` adapter.
+ *
+ * Operates directly on zod's internal `_def` shape (covers both v3 and v4)
+ * because zod ships no first-class JSON-Schema export. Confined to
+ * `extensions/ext-schema-zod/` so the rest of the codebase never has to import zod
+ * to learn what a tool's input schema looks like.
+ *
+ * @module extensions/ext-schema-zod/json-schema
+ */
+import type { z } from "zod";
+import type { JsonSchema } from "veryfront/extensions/schema";
+export declare function zodToJsonSchema(schema: z.ZodTypeAny): JsonSchema;
+export declare function isOptionalSchema(schema: z.ZodTypeAny): boolean;
+//# sourceMappingURL=json-schema.d.ts.map

package/esm/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAgD9D,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAEhE;AAgBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,OAAO,CAE9D"}

package/esm/json-schema.js

@@ -0,0 +1,247 @@
+/**
+ * Zod-to-JSON-Schema converter used by the `SchemaValidator` adapter.
+ *
+ * Operates directly on zod's internal `_def` shape (covers both v3 and v4)
+ * because zod ships no first-class JSON-Schema export. Confined to
+ * `extensions/ext-schema-zod/` so the rest of the codebase never has to import zod
+ * to learn what a tool's input schema looks like.
+ *
+ * @module extensions/ext-schema-zod/json-schema
+ */
+const LITERAL_TYPE_MAP = {
+    string: "string",
+    number: "number",
+    boolean: "boolean",
+};
+function getLiteralType(value) {
+    return LITERAL_TYPE_MAP[typeof value];
+}
+function getDef(schema) {
+    return schema._def;
+}
+/** Get the internal type tag from a zod schema (_def.typeName in v3, _def.type in v4). */
+function getTypeTag(schema) {
+    const def = getDef(schema);
+    return def.typeName ?? def.type;
+}
+export function zodToJsonSchema(schema) {
+    return convertSchema(schema, { seen: new WeakSet() });
+}
+function convertSchema(schema, context) {
+    // Guard against invalid schemas (can happen with different zod instances in npm bundle)
+    if (!schema || typeof schema !== "object" || !("_def" in schema)) {
+        throw new Error("Invalid Zod schema: missing _def property");
+    }
+    const { schema: unwrapped, nullable } = unwrapSchema(schema);
+    const json = convert(unwrapped, context);
+    const description = getDescription(schema) ?? getDescription(unwrapped);
+    if (description && json.description === undefined)
+        json.description = description;
+    return nullable ? { anyOf: [json, { type: "null" }] } : json;
+}
+export function isOptionalSchema(schema) {
+    return unwrapSchema(schema).optional || hasDefaultSchema(schema);
+}
+function convert(schema, context) {
+    if (context.seen.has(schema))
+        return {};
+    context.seen.add(schema);
+    try {
+        return convertInner(schema, context);
+    }
+    finally {
+        context.seen.delete(schema);
+    }
+}
+function convertInner(schema, context) {
+    const tag = getTypeTag(schema);
+    const def = getDef(schema);
+    switch (tag) {
+        case "ZodString":
+        case "string":
+            return { type: "string" };
+        case "ZodNumber":
+        case "number":
+            return { type: "number" };
+        case "ZodBoolean":
+        case "boolean":
+            return { type: "boolean" };
+        case "ZodBigInt":
+        case "bigint":
+            return { type: "integer" };
+        case "ZodLiteral":
+        case "literal": {
+            // v3: _def.value, v4: _def.values (array of accepted values)
+            const literal = def.value ?? (Array.isArray(def.values) ? def.values[0] : def.values);
+            return { const: literal, type: getLiteralType(literal) };
+        }
+        case "ZodEnum":
+        case "ZodNativeEnum":
+        case "enum": {
+            // v3: _def.values (array), v4: _def.entries (object {key: value})
+            const values = def.values ?? (def.entries ? Object.values(def.entries) : []);
+            if (Array.isArray(values)) {
+                return { type: "string", enum: values };
+            }
+            // Native enum: filter out reverse-mapped numeric keys
+            return {
+                enum: Object.values(values).filter((value) => typeof value !== "number"),
+            };
+        }
+        case "ZodObject":
+        case "object": {
+            const shape = typeof def.shape === "function" ? def.shape() : def.shape;
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape ?? {})) {
+                const zodSchema = value;
+                properties[key] = convertSchema(zodSchema, context);
+                if (!isOptionalSchema(zodSchema))
+                    required.push(key);
+            }
+            const json = { type: "object", properties };
+            if (required.length)
+                json.required = required;
+            const additionalProperties = getObjectAdditionalProperties(def, context);
+            if (additionalProperties !== undefined)
+                json.additionalProperties = additionalProperties;
+            return json;
+        }
+        case "ZodArray":
+        case "array": {
+            // v3: _def.type (item schema), v4: _def.element (item schema)
+            const itemType = def.element ?? def.type;
+            if (!itemType || typeof itemType === "string")
+                return { type: "array" };
+            return { type: "array", items: convertSchema(itemType, context) };
+        }
+        case "ZodTuple":
+        case "tuple": {
+            const items = def.items ?? [];
+            return {
+                type: "array",
+                prefixItems: items.map((item) => convertSchema(item, context)),
+                minItems: items.length,
+                maxItems: items.length,
+            };
+        }
+        case "ZodUnion":
+        case "ZodDiscriminatedUnion":
+        case "union": {
+            const options = def.options ?? [];
+            const optionArray = options instanceof Map ? Array.from(options.values()) : options;
+            return { anyOf: optionArray.map((option) => convertSchema(option, context)) };
+        }
+        case "ZodRecord":
+        case "record": {
+            const valueSchema = def.valueType ?? def.element;
+            if (!valueSchema)
+                return { type: "object" };
+            return { type: "object", additionalProperties: convertSchema(valueSchema, context) };
+        }
+        case "ZodDefault":
+        case "default": {
+            const innerType = def.innerType ?? def.schema;
+            if (!innerType)
+                return { type: "object" };
+            const inner = convertSchema(innerType, context);
+            const defaultValue = typeof def.defaultValue === "function"
+                ? def.defaultValue()
+                : def.defaultValue;
+            if (typeof inner === "object" && !("anyOf" in inner) && defaultValue !== undefined) {
+                inner.default = defaultValue;
+            }
+            return inner;
+        }
+        case "ZodLazy":
+        case "lazy":
+            return def.getter ? convert(def.getter(), context) : { type: "object" };
+        case "ZodEffects":
+        case "pipe": {
+            // v3: ZodEffects wraps schema in _def.schema
+            // v4: pipe wraps in _def.in (input schema)
+            const innerSchema = def.schema ?? def.in;
+            return innerSchema ? convert(innerSchema, context) : { type: "object" };
+        }
+        default:
+            return { type: "object" };
+    }
+}
+function getObjectAdditionalProperties(def, context) {
+    if (def.unknownKeys === "passthrough")
+        return true;
+    if (def.unknownKeys === "strict")
+        return false;
+    if (def.unknownKeys === "strip")
+        return undefined;
+    if (!def.catchall)
+        return undefined;
+    const catchallTag = getTypeTag(def.catchall);
+    if (catchallTag === "unknown" || catchallTag === "ZodUnknown")
+        return true;
+    if (catchallTag === "never" || catchallTag === "ZodNever")
+        return false;
+    return convertSchema(def.catchall, context);
+}
+function unwrapSchema(schema) {
+    let current = schema;
+    let nullable = false;
+    let optional = false;
+    while (true) {
+        const tag = getTypeTag(current);
+        const def = getDef(current);
+        switch (tag) {
+            case "ZodNullable":
+            case "nullable":
+                nullable = true;
+                current = (def.innerType ?? def.schema);
+                break;
+            case "ZodOptional":
+            case "optional":
+                optional = true;
+                current = (def.innerType ?? def.schema);
+                break;
+            case "ZodEffects":
+            case "pipe":
+                current = def.schema ?? def.in ?? current;
+                if (current === schema)
+                    return { schema: current, nullable, optional };
+                break;
+            default:
+                return { schema: current, nullable, optional };
+        }
+    }
+}
+function hasDefaultSchema(schema) {
+    let current = schema;
+    while (true) {
+        const tag = getTypeTag(current);
+        const def = getDef(current);
+        switch (tag) {
+            case "ZodDefault":
+            case "default":
+                return true;
+            case "ZodNullable":
+            case "nullable":
+            case "ZodOptional":
+            case "optional":
+            case "ZodEffects":
+            case "pipe": {
+                const inner = def.innerType ?? def.schema ?? def.in;
+                if (!inner || inner === current)
+                    return false;
+                current = inner;
+                break;
+            }
+            default:
+                return false;
+        }
+    }
+}
+function getDescription(schema) {
+    const direct = schema.description;
+    if (typeof direct === "string")
+        return direct;
+    const defDescription = getDef(schema).description;
+    return typeof defDescription === "string" ? defDescription : undefined;
+}

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@veryfront/ext-schema-zod",
+  "version": "0.1.985",
+  "description": "Veryfront first-party extension package for ext-schema-zod",
+  "keywords": [
+    "veryfront",
+    "extension",
+    "ext-schema-zod"
+  ],
+  "author": "Veryfront",
+  "homepage": "https://github.com/veryfront/veryfront-code/tree/main/extensions/ext-schema-zod",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/veryfront/veryfront-code.git",
+    "directory": "extensions/ext-schema-zod"
+  },
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/veryfront/veryfront-code/issues"
+  },
+  "module": "./esm/index.js",
+  "exports": {
+    ".": {
+      "import": "./esm/index.js",
+      "types": "./esm/index.d.ts"
+    }
+  },
+  "scripts": {},
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "veryfront": {
+    "extension": true,
+    "contracts": {
+      "provides": [
+        "SchemaValidator"
+      ]
+    },
+    "capabilities": []
+  },
+  "dependencies": {
+    "zod": "4.3.6"
+  },
+  "peerDependencies": {
+    "veryfront": "^0.1.985"
+  },
+  "type": "module",
+  "types": "./esm/index.d.ts",
+  "files": [
+    "esm",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ]
+}