zod-codegen 1.0.3 → 1.1.1

package/examples/pokeapi/custom-client.ts

@@ -0,0 +1,56 @@
+/**
+ * Example showing how to extend the PokéAPI client with custom configuration
+ *
+ * Run with: npx ts-node examples/pokeapi/custom-client.ts
+ */
+
+import {PokAPI, defaultBaseUrl} from './type.js';
+
+class CustomPokeAPIClient extends PokAPI {
+  protected getBaseRequestOptions(): Partial<Omit<RequestInit, 'method' | 'body'>> {
+    const options = super.getBaseRequestOptions();
+    return {
+      ...options,
+      headers: {
+        ...((options.headers as Record<string, string>) || {}),
+        'User-Agent': 'MyPokemonApp/1.0.0 (https://myapp.com)',
+        Accept: 'application/json',
+      },
+      mode: 'cors',
+      cache: 'default',
+    };
+  }
+}
+
+async function main() {
+  const client = new CustomPokeAPIClient(defaultBaseUrl);
+
+  try {
+    console.log('🔍 Fetching Pokémon with custom client...\n');
+
+    // Get Charizard
+    const charizard = await client.getPokemonById('charizard');
+    console.log(`✅ ${charizard.name.toUpperCase()}`);
+    console.log(`   ID: ${charizard.id}`);
+    console.log(`   Height: ${charizard.height} dm`);
+    console.log(`   Weight: ${charizard.weight} hg`);
+
+    if (charizard.abilities && charizard.abilities.length > 0) {
+      console.log('\n   Abilities:');
+      charizard.abilities.forEach((ability, index) => {
+        const abilityName = ability.ability?.name || 'Unknown';
+        const hidden = ability.is_hidden ? ' (hidden)' : '';
+        console.log(`   ${index + 1}. ${abilityName}${hidden}`);
+      });
+    }
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error('❌ Error:', error.message);
+    } else {
+      console.error('❌ Unknown error:', error);
+    }
+    process.exit(1);
+  }
+}
+
+void main();

package/examples/pokeapi/type.ts

@@ -0,0 +1,109 @@
+// THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+// Built with zod-codegen@1.0.1
+// Latest edit: Thu, 13 Nov 2025 13:32:35 GMT
+// Source file: ./samples/pokeapi-openapi.json
+/* eslint-disable */
+// @ts-nocheck
+
+// Imports
+import {z} from 'zod';
+
+// Components schemas
+export const NamedAPIResource = z.object({
+  name: z.string(),
+  url: z.string().url(),
+});
+export const PokemonType = z.object({
+  slot: z.number().int().optional(),
+  type: NamedAPIResource.optional(),
+});
+export const PokemonAbility = z.object({
+  ability: NamedAPIResource.optional(),
+  is_hidden: z.boolean().optional(),
+  slot: z.number().int().optional(),
+});
+export const PokemonSprites = z.object({
+  front_default: z.string().url().optional(),
+  front_shiny: z.string().url().optional(),
+  back_default: z.string().url().optional(),
+  back_shiny: z.string().url().optional(),
+});
+export const Pokemon = z.object({
+  id: z.number().int(),
+  name: z.string(),
+  height: z.number().int().optional(),
+  weight: z.number().int().optional(),
+  base_experience: z.number().int().optional(),
+  types: z.array(PokemonType).optional(),
+  abilities: z.array(PokemonAbility).optional(),
+  sprites: PokemonSprites.optional(),
+});
+export const PokemonListResponse = z.object({
+  count: z.number().int(),
+  next: z.string().url().optional(),
+  previous: z.string().url().optional(),
+  results: z.array(NamedAPIResource),
+});
+export const defaultBaseUrl = 'https://pokeapi.co/api/v2';
+
+// Client class
+export class PokAPI {
+  readonly #baseUrl: string;
+  constructor(baseUrl: string = defaultBaseUrl, _?: unknown) {
+    this.#baseUrl = baseUrl;
+  }
+  protected getBaseRequestOptions(): Partial<Omit<RequestInit, 'method' | 'body'>> {
+    return {};
+  }
+  async #makeRequest<T>(
+    method: string,
+    path: string,
+    options: _params___Record_string__string___number___boolean___data___unknown__contentType___string__headers___Record_string__string__ = {},
+  ): Promise<T> {
+    const baseUrl = `${this.#baseUrl}${path}`;
+    const url =
+      options.params && Object.keys(options.params).length > 0
+        ? (() => {
+            Object.entries(options.params).forEach(([key, value]) => {
+              new URL(baseUrl).searchParams.set(key, String(value));
+            });
+            return new URL(baseUrl).toString();
+          })()
+        : new URL(baseUrl).toString();
+    const baseOptions = this.getBaseRequestOptions();
+    const contentType =
+      options.contentType === 'application/x-www-form-urlencoded'
+        ? 'application/x-www-form-urlencoded'
+        : 'application/json';
+    const baseHeaders = baseOptions.headers !== undefined ? baseOptions.headers : {};
+    const headers = Object.assign(
+      {},
+      baseHeaders,
+      {'Content-Type': contentType},
+      options.headers !== undefined ? options.headers : {},
+    );
+    const body =
+      options.data !== undefined
+        ? options.contentType === 'application/x-www-form-urlencoded'
+          ? (() => {
+              const params = new URLSearchParams();
+              Object.entries(options.data).forEach(([key, value]) => {
+                params.set(key, String(value));
+              });
+              return params.toString();
+            })()
+          : JSON.stringify(options.data)
+        : null;
+    const response = await fetch(url, Object.assign({}, baseOptions, {method, headers: headers, body: body}));
+    if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    return await response.json();
+  }
+  async getPokemonById(id: string): Promise<Pokemon> {
+    return Pokemon.parse(await this.#makeRequest('GET', `/pokemon/${id}`, {}));
+  }
+  async getPokemonList(limit?: number, offset?: number): Promise<PokemonListResponse> {
+    return PokemonListResponse.parse(
+      await this.#makeRequest('GET', '/pokemon', {params: {limit: limit, offset: offset}}),
+    );
+  }
+}

package/package.json

@@ -79,8 +79,9 @@
   },
   "scripts": {
     "build": "rm -rf dist && tsc --project tsconfig.json && cp -r src/assets dist/src/ && chmod +x ./dist/src/cli.js",
+    "build:native": "rm -rf dist && npx tsgo --project tsconfig.json && cp -r src/assets dist/src/ && chmod +x ./dist/src/cli.js",
     "build:watch": "tsc --project tsconfig.json --watch",
-    "dev": "npm run build && node ./dist/src/cli.js --input ./samples/saris-openapi.json && npm run format && npm run lint",
+    "dev": "npm run build && node ./dist/src/cli.js --input ./samples/swagger-petstore.yaml --output ./examples/petstore && npm run format && npm run lint",
     "lint": "eslint src --fix",
     "lint:check": "eslint src",
     "format": "prettier src --write --log-level error",
@@ -95,8 +96,9 @@
     "prepublishOnly": "npm run build && npm run test && npm run lint:check && npm run type-check",
     "clean": "rm -rf dist coverage node_modules/.cache",
     "validate": "npm run type-check && npm run lint:check && npm run format:check && npm run test",
+    "validate:examples": "tsc -p ./tsconfig.examples.json --noEmit",
     "release": "semantic-release",
     "release:dry": "semantic-release --dry-run"
   },
-  "version": "1.0.3"
+  "version": "1.1.1"
 }

package/samples/pokeapi-openapi.json

@@ -0,0 +1,212 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "PokéAPI",
+    "version": "2.0.0",
+    "description": "PokéAPI is a RESTful API that provides data about Pokémon"
+  },
+  "servers": [
+    {
+      "url": "https://pokeapi.co/api/v2",
+      "description": "PokéAPI production server"
+    }
+  ],
+  "paths": {
+    "/pokemon/{id}": {
+      "get": {
+        "operationId": "getPokemonById",
+        "summary": "Get Pokémon by ID or name",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "Pokémon ID or name",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Pokémon data",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pokemon"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/pokemon": {
+      "get": {
+        "operationId": "getPokemonList",
+        "summary": "Get list of Pokémon",
+        "parameters": [
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "default": 20
+            }
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "default": 0
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of Pokémon",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PokemonListResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "Pokemon": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Pokémon ID"
+          },
+          "name": {
+            "type": "string",
+            "description": "Pokémon name"
+          },
+          "height": {
+            "type": "integer",
+            "description": "Height in decimeters"
+          },
+          "weight": {
+            "type": "integer",
+            "description": "Weight in hectograms"
+          },
+          "base_experience": {
+            "type": "integer",
+            "description": "Base experience"
+          },
+          "types": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/PokemonType"
+            }
+          },
+          "abilities": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/PokemonAbility"
+            }
+          },
+          "sprites": {
+            "$ref": "#/components/schemas/PokemonSprites"
+          }
+        },
+        "required": ["id", "name"]
+      },
+      "PokemonType": {
+        "type": "object",
+        "properties": {
+          "slot": {
+            "type": "integer"
+          },
+          "type": {
+            "$ref": "#/components/schemas/NamedAPIResource"
+          }
+        }
+      },
+      "PokemonAbility": {
+        "type": "object",
+        "properties": {
+          "ability": {
+            "$ref": "#/components/schemas/NamedAPIResource"
+          },
+          "is_hidden": {
+            "type": "boolean"
+          },
+          "slot": {
+            "type": "integer"
+          }
+        }
+      },
+      "PokemonSprites": {
+        "type": "object",
+        "properties": {
+          "front_default": {
+            "type": "string",
+            "format": "uri"
+          },
+          "front_shiny": {
+            "type": "string",
+            "format": "uri"
+          },
+          "back_default": {
+            "type": "string",
+            "format": "uri"
+          },
+          "back_shiny": {
+            "type": "string",
+            "format": "uri"
+          }
+        }
+      },
+      "NamedAPIResource": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string",
+            "format": "uri"
+          }
+        },
+        "required": ["name", "url"]
+      },
+      "PokemonListResponse": {
+        "type": "object",
+        "properties": {
+          "count": {
+            "type": "integer"
+          },
+          "next": {
+            "type": "string",
+            "format": "uri",
+            "nullable": true
+          },
+          "previous": {
+            "type": "string",
+            "format": "uri",
+            "nullable": true
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/NamedAPIResource"
+            }
+          }
+        },
+        "required": ["count", "results"]
+      }
+    }
+  }
+}

package/samples/server-variables-example.yaml

@@ -0,0 +1,49 @@
+openapi: 3.0.0
+info:
+  title: Server Variables Example API
+  version: 1.0.0
+  description: Example API demonstrating server variables for different environments
+servers:
+  - url: https://{environment}.example.com:{port}/v{version}
+    description: Main API server with templated variables
+    variables:
+      environment:
+        default: api
+        enum:
+          - api
+          - api.dev
+          - api.staging
+        description: The environment to use (api, api.dev, api.staging)
+      port:
+        default: '443'
+        enum:
+          - '443'
+          - '8443'
+        description: The port number
+      version:
+        default: '2'
+        description: API version
+  - url: https://api.production.example.com/v2
+    description: Production server (no variables)
+paths:
+  /users:
+    get:
+      operationId: getUsers
+      summary: Get list of users
+      responses:
+        '200':
+          description: Success
+          content:
+            'application/json':
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: integer
+                    name:
+                      type: string
+                  required:
+                    - id
+                    - name