blendsdk 5.33.0

package/dist/codegen/generator/type-generator.js

@@ -0,0 +1,249 @@
+import { ObjectSchema, SchemaUtils } from '../schema/index.js';
+import { Generator } from './generator.js';
+/**
+ * TypeScript Type Generator
+ *
+ * Generates TypeScript type definitions from schema objects. This generator converts
+ * schema definitions (primitives, objects, references) into properly formatted TypeScript
+ * types and interfaces with support for:
+ *
+ * - Type aliases and interfaces
+ * - Optional properties
+ * - Nullable types
+ * - Array types
+ * - Partial types
+ * - Reference types
+ * - JSDoc comments and descriptions
+ */
+export class TypeGenerator extends Generator {
+    /**
+     * Creates a new TypeScript type generator instance.
+     *
+     * @param options - Configuration options for the generator (currently unused but reserved for future use)
+     */
+    constructor(options) {
+        super(options);
+    }
+    /**
+     * Renders a reference schema to TypeScript type syntax.
+     *
+     * Reference schemas point to other schema objects and are rendered as type aliases.
+     * If the reference has a parent (is a property), it renders inline without export.
+     * Otherwise, it creates an exported type alias.
+     *
+     * @param obj - The reference schema object to render
+     * @returns Array of TypeScript code lines representing the reference type
+     */
+    renderReferenceSchema(obj) {
+        const lines = [];
+        const data = obj.getData();
+        const typeName = SchemaUtils.getTypeScriptName(obj);
+        if (data.parent) {
+            // Render as inline property type (no export)
+            if (!data.ref?.isRendered()) {
+                if (!data.ref?.getName()) {
+                    throw new Error(`Referenced schema is not named!`);
+                }
+                this.lines.push(...this.renderInternal(data.ref));
+            }
+            lines.push(this.modifiers(data.ref?.getData().tsType || '', obj) || '');
+        }
+        else {
+            // Render as exported type alias
+            this.addDescription(obj, lines);
+            lines.push('export', 'type', typeName, '=', this.modifiers(data.ref?.getData().tsType || '', obj) || '');
+            obj.setData({ rendered: true, tsType: typeName });
+        }
+        return this.sanitize(lines);
+    }
+    /**
+     * Renders an object schema to TypeScript interface or type syntax.
+     *
+     * Object schemas are rendered as either interfaces (preferred for plain objects)
+     * or type aliases (when modifiers like Partial, nullable, or array are applied).
+     * Properties are rendered recursively with proper optional markers and types.
+     *
+     * @param obj - The object schema to render
+     * @returns Array of TypeScript code lines representing the object type
+     */
+    renderObjectSchema(obj) {
+        const lines = [];
+        const data = obj.getData();
+        const props = ['{'];
+        /**
+         * Creates the property definitions for the object.
+         * Iterates through all properties and renders each with:
+         * - JSDoc description (if present)
+         * - Optional marker (?) if property is optional
+         * - Recursively rendered type
+         */
+        const createProps = () => {
+            Object.entries(obj.getProperties()).forEach(([propName, propObj]) => {
+                const { optional } = propObj.getData();
+                this.addDescription(propObj, props, true);
+                props.push(`${propName}${optional ? '?' : ''}:${this.renderInternal(propObj)}`);
+            });
+            props.push('}');
+            return this.sanitize(props, '\n');
+        };
+        if (data.parent) {
+            // Render as inline property type (nested object)
+            const targetType = obj.isRendered()
+                ? this.modifiers(data.tsType, obj)
+                : this.modifiers(createProps(), obj);
+            lines.push(this.sanitize([targetType]));
+        }
+        else {
+            // Render as exported interface or type
+            const { declType, equalSign } = this.getDeclaration(obj);
+            const typeName = SchemaUtils.getTypeScriptName(obj);
+            const targetType = declType === 'type' ? this.modifiers(createProps(), obj) : createProps();
+            this.addDescription(obj, lines);
+            lines.push(this.sanitize(['export', declType, typeName, equalSign, targetType]));
+            obj.setData({ rendered: true, tsType: typeName });
+        }
+        return this.sanitize(lines);
+    }
+    /**
+     * Renders primitive type schemas (string, number, boolean, date, any) to TypeScript.
+     *
+     * Primitive schemas represent basic TypeScript types and are rendered as type aliases
+     * when exported, or inline types when used as properties.
+     *
+     * @param obj - The primitive schema object to render
+     * @returns Array of TypeScript code lines representing the primitive type
+     */
+    renderPrimitiveTypeSchema(obj) {
+        let lines = [];
+        const data = obj.getData();
+        const typeName = SchemaUtils.getTypeScriptName(obj) || data.tsType;
+        const targetType = obj.isRendered()
+            ? data.tsType
+            : this.modifiers(data.primitive ? data.tsType : typeName, obj);
+        const { declType, equalSign } = this.getDeclaration(obj);
+        if (data.parent) {
+            // Render as inline property type
+            lines.push(this.sanitize([targetType]));
+        }
+        else {
+            // Render as exported type alias
+            this.addDescription(obj, lines);
+            lines.push(this.sanitize(['export', declType, typeName, equalSign, targetType]));
+            obj.setData({ rendered: true, tsType: typeName });
+        }
+        return this.sanitize(lines);
+    }
+    /**
+     * Applies TypeScript type modifiers to a base type.
+     *
+     * Modifiers are applied in a specific order to ensure correct TypeScript syntax:
+     * 1. Partial<T> - Makes all properties optional
+     * 2. T[] - Array type
+     * 3. T | null - Nullable type
+     *
+     * @param target - The base type string to apply modifiers to
+     * @param obj - The schema object containing modifier flags
+     * @returns The modified type string with all applicable modifiers applied
+     */
+    modifiers(target, obj) {
+        const { partial, nullable, arrayed, recordOf } = obj.getData();
+        // Apply Partial wrapper first
+        if (partial) {
+            target = `Partial<${target}>`;
+        }
+        // Apply array notation second
+        if (arrayed) {
+            target = `${target}[]`;
+        }
+        if (recordOf) {
+            target = `Record<string,${target}>`;
+        }
+        // Apply nullable union last
+        if (nullable) {
+            target = `${target} | null`;
+        }
+        return target;
+    }
+    /**
+     * Adds JSDoc description comments to the generated TypeScript code.
+     *
+     * This method generates comprehensive JSDoc comments that include:
+     * - Custom description text
+     * - Type metadata (@type, @interface)
+     * - Modifier annotations (@partial, @array, @optional, @nullable)
+     * - Membership information (@memberOf for properties)
+     *
+     * The comments are formatted as multi-line JSDoc blocks for better readability.
+     *
+     * @param obj - The schema object to generate description for
+     * @param lines - Array to append the description lines to
+     * @param isProp - Whether this is a property (affects spacing)
+     */
+    addDescription(obj, lines, isProp) {
+        const data = obj.getData();
+        // Add declaration type annotation
+        if (data.declType) {
+            obj.description(`@${data.declType}`);
+        }
+        // Add modifier annotations
+        if (data.partial) {
+            obj.description(`@partial`);
+        }
+        if (data.arrayed) {
+            obj.description(`@array`);
+        }
+        if (data.optional) {
+            obj.description('@optional');
+        }
+        if (data.nullable) {
+            obj.description('@nullable');
+        }
+        // Add parent membership information for properties
+        if (data.parent) {
+            const parName = SchemaUtils.getTypeScriptName(data.parent) || data.parent.getData().tsType;
+            if (parName) {
+                obj.description(`@memberOf {${parName}}`);
+            }
+        }
+        // Format and add the complete description block
+        if (data.description) {
+            const descr = SchemaUtils.formatMultilineComment(data.description).join('\n');
+            lines.push(descr);
+            if (!isProp) {
+                lines.push('\n');
+            }
+        }
+    }
+    /**
+     * Determines whether to use 'interface' or 'type' declaration for an object schema.
+     *
+     * Decision logic:
+     * - Use 'interface' for plain object schemas without modifiers (preferred in TypeScript)
+     * - Use 'type' for objects with modifiers (Partial, array, nullable) or nested objects
+     *
+     * This ensures idiomatic TypeScript code generation that follows best practices:
+     * - Interfaces for object shapes (extensible, better error messages)
+     * - Types for unions, intersections, and modified types
+     *
+     * @param obj - The schema object to determine declaration type for
+     * @returns Object containing declaration type ('interface' or 'type'), equal sign, and flag
+     */
+    getDeclaration(obj) {
+        const { arrayed, nullable, partial, parent } = obj.getData();
+        const is_object_schema = obj instanceof ObjectSchema;
+        // Check if this is an object type that requires 'type' declaration
+        // (has modifiers or is nested)
+        const is_object_type = is_object_schema && parent === undefined && (arrayed || nullable || partial);
+        if (is_object_schema && !is_object_type) {
+            // Use interface for plain objects (no modifiers, root level)
+            obj.setData({ declType: 'interface' });
+            return { declType: 'interface', equalSign: '', type_declaration: false };
+        }
+        else {
+            // Use type for everything else (primitives, modified objects, nested objects)
+            obj.setData({ declType: 'type' });
+            return { declType: 'type', equalSign: '=', type_declaration: true };
+        }
+    }
+}
+//# sourceMappingURL=type-generator.js.map

package/dist/codegen/generator/type-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-generator.js","sourceRoot":"","sources":["../../src/generator/type-generator.ts"],"names":[],"mappings":"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"}

package/dist/codegen/generator/zod-generator.d.ts

@@ -0,0 +1,15 @@
+import { ObjectSchema, ReferenceSchema } from '../schema/index.js';
+import { SchemaObject } from '../schema/schema-object.js';
+import { Generator, GeneratorOptions } from './generator.js';
+export interface ZodGeneratorOptions extends GeneratorOptions {
+    zodVariablePostfix?: string;
+}
+export declare class ZodGenerator extends Generator<ZodGeneratorOptions> {
+    constructor(options?: ZodGeneratorOptions);
+    protected getZodVariableName(obj: SchemaObject): string;
+    protected renderReferenceSchema(obj: ReferenceSchema): string;
+    protected renderObjectSchema(obj: ObjectSchema): string;
+    protected renderPrimitiveTypeSchema(obj: SchemaObject): string;
+    protected modifiers(target: string | undefined, obj: SchemaObject): string | undefined;
+}
+//# sourceMappingURL=zod-generator.d.ts.map

package/dist/codegen/generator/zod-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-generator.d.ts","sourceRoot":"","sources":["../../src/generator/zod-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAA6B,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,YAAa,SAAQ,SAAS,CAAC,mBAAmB,CAAC;gBAClD,OAAO,CAAC,EAAE,mBAAmB;IASzC,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,YAAY;IAM9C,SAAS,CAAC,qBAAqB,CAAC,GAAG,EAAE,eAAe;IAsBpD,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,YAAY;IAyB9C,SAAS,CAAC,yBAAyB,CAAC,GAAG,EAAE,YAAY;IAcrD,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,YAAY;CAqBlE"}

package/dist/codegen/generator/zod-generator.js

@@ -0,0 +1,86 @@
+import { SchemaUtils } from '../schema/index.js';
+import { Generator } from './generator.js';
+export class ZodGenerator extends Generator {
+    constructor(options) {
+        options = {
+            zodVariablePostfix: 'schema',
+            ...(options || {}),
+        };
+        super(options);
+        this.lines.push(`import * as z from 'zod';`);
+    }
+    getZodVariableName(obj) {
+        return SchemaUtils.snakeToPascalCase(this.sanitize([obj.getNamedScoped(), this.options.zodVariablePostfix], '_'));
+    }
+    renderReferenceSchema(obj) {
+        const lines = [];
+        const data = obj.getData();
+        if (!data.ref?.isRendered()) {
+            if (!data.ref?.getName()) {
+                throw new Error(`Referenced schema is not named!`);
+            }
+        }
+        const zodType = this.modifiers(this.getZodVariableName(data.ref), obj);
+        if (data.parent) {
+            lines.push(zodType);
+        }
+        else {
+            const varName = this.modifiers(this.getZodVariableName(data.ref), obj);
+            lines.push(this.sanitize(['export', 'const', varName, '=', zodType]));
+        }
+        obj.setData({ rendered: true });
+        return this.sanitize(lines);
+    }
+    renderObjectSchema(obj) {
+        const lines = [];
+        const props = [];
+        const data = obj.getData();
+        const createProps = () => {
+            Object.entries(obj.getProperties()).forEach(([propName, propObj]) => {
+                props.push(`${propName}:${this.renderInternal(propObj)}`);
+            });
+            return this.sanitize(props, ',\n');
+        };
+        const zodType = this.modifiers(`z.${data.zodType}({${createProps()}})`, obj);
+        if (data.parent) {
+            lines.push(zodType);
+        }
+        else {
+            const varName = this.getZodVariableName(obj);
+            lines.push(this.sanitize(['export', 'const', varName, '=', zodType]));
+        }
+        obj.setData({ rendered: true });
+        return this.sanitize(lines);
+    }
+    renderPrimitiveTypeSchema(obj) {
+        let lines = [];
+        const data = obj.getData();
+        const zodType = this.modifiers(`z.${data.zodType}()`, obj);
+        if (data.parent) {
+            lines.push(zodType);
+        }
+        else {
+            const varName = this.getZodVariableName(obj);
+            lines.push(this.sanitize(['export', 'const', varName, '=', zodType]));
+        }
+        obj.setData({ rendered: true });
+        return this.sanitize(lines);
+    }
+    modifiers(target, obj) {
+        const { optional, partial, nullable } = obj.getData();
+        if (partial) {
+            target = `${target}.partial()`;
+        }
+        if (optional) {
+            target = `${target}.optional()`;
+        }
+        // else if (obj instanceof StringSchema) {
+        //   target = `${target}.nonempty()`;
+        // }
+        if (nullable) {
+            target = `${target}.nullable()`;
+        }
+        return target;
+    }
+}
+//# sourceMappingURL=zod-generator.js.map

package/dist/codegen/generator/zod-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-generator.js","sourceRoot":"","sources":["../../src/generator/zod-generator.ts"],"names":[],"mappings":"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"}

package/dist/codegen/generator/zod-to-openapi.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Zod v4 → OpenAPI JSON Schema converter.
+ *
+ * Converts Zod v4 schemas into OpenAPI v3.1 JSON Schema objects by
+ * introspecting Zod's internal `_zod.def` structure. This custom converter
+ * is necessary because existing zod-to-openapi libraries do not support
+ * Zod v4's changed internals.
+ *
+ * @remarks
+ * Zod v4 stores schema metadata in `schema._zod.def`:
+ * - `def.type` — the Zod type name (string, number, boolean, object, array, etc.)
+ * - `def.checks` — array of validation checks (min_length, max_length, etc.)
+ * - `def.shape` — object property schemas (each value is a `_zod` internal object)
+ * - `def.element` — array item schema (`_zod` internal object)
+ * - `def.innerType` — wrapped schema for optional/nullable/default (`_zod` internal object)
+ * - `def.entries` — enum values as Record<string, string>
+ * - `def.values` — literal values as array
+ * - `def.options` — union member schemas (array of `_zod` internal objects)
+ * - `def.defaultValue` — the default value for default-wrapped schemas
+ * - `def.coerce` — boolean flag for coerced types
+ *
+ * @module
+ */
+import type { OpenAPISchema, OpenAPIParameter } from './openapi-types.js';
+/**
+ * Convert a Zod v4 schema to an OpenAPI JSON Schema object.
+ *
+ * This is the main entry point for schema conversion. It extracts the
+ * internal `_zod` node from the schema and delegates to the recursive
+ * node converter.
+ *
+ * @param zodSchema - Any Zod v4 schema instance (z.string(), z.object(), etc.)
+ * @returns An OpenAPI-compatible JSON Schema object
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ * import { zodToOpenAPISchema } from './zod-to-openapi.js';
+ *
+ * const schema = z.object({ name: z.string().min(1), age: z.number().int() });
+ * const openApiSchema = zodToOpenAPISchema(schema);
+ * // { type: 'object', properties: { name: { type: 'string', minLength: 1 }, age: { type: 'integer' } }, required: ['name', 'age'] }
+ * ```
+ */
+export declare function zodToOpenAPISchema(zodSchema: unknown): OpenAPISchema;
+/**
+ * Convert a Zod v4 object schema into an array of OpenAPI query parameters.
+ *
+ * Each top-level property of the Zod object becomes a separate query parameter.
+ * Optional properties become non-required parameters. Default values are included.
+ *
+ * @param zodSchema - A Zod v4 object schema (z.object({ ... }))
+ * @returns Array of OpenAPI parameter objects with `in: 'query'`
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({
+ *   page: z.coerce.number().default(1),
+ *   search: z.string().optional(),
+ * });
+ * const params = zodToQueryParameters(schema);
+ * // [
+ * //   { name: 'page', in: 'query', schema: { type: 'number', default: 1 } },
+ * //   { name: 'search', in: 'query', schema: { type: 'string' } },
+ * // ]
+ * ```
+ */
+export declare function zodToQueryParameters(zodSchema: unknown): OpenAPIParameter[];
+//# sourceMappingURL=zod-to-openapi.d.ts.map

package/dist/codegen/generator/zod-to-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-openapi.d.ts","sourceRoot":"","sources":["../../src/generator/zod-to-openapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAwF1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,GAAG,aAAa,CAOpE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAgC3E"}