@flink-app/ts-source-to-json-schema 0.1.0

package/dist/ast.d.ts.map

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

package/dist/ast.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// AST Node Types - The intermediate representation between parsing and emission
+// ============================================================================
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E"}

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for ts-source-to-json-schema
+ *
+ * Usage:
+ *   ts-source-to-json-schema <file.ts> [options]
+ *   npx ts-source-to-json-schema src/types.ts --rootType User
+ *
+ * Reads a TypeScript file and outputs JSON Schema to stdout.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/dist/cli.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for ts-source-to-json-schema
+ *
+ * Usage:
+ *   ts-source-to-json-schema <file.ts> [options]
+ *   npx ts-source-to-json-schema src/types.ts --rootType User
+ *
+ * Reads a TypeScript file and outputs JSON Schema to stdout.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { toJsonSchema, toJsonSchemaFromFile } from './index.js';
+const version = '0.1.0'; // TODO: Read from package.json
+function showHelp() {
+    console.log(`
+ts-source-to-json-schema v${version}
+
+USAGE:
+  ts-source-to-json-schema <file.ts> [options]
+
+DESCRIPTION:
+  Convert TypeScript type definitions to JSON Schema (2020-12 draft).
+
+OPTIONS:
+  -h, --help                     Show this help message
+  -v, --version                  Show version number
+      --doctor                   Output diagnostic information for debugging
+
+  -r, --rootType <name>          Emit this type as root (others in $defs)
+  -s, --includeSchema <bool>     Include $schema property (default: true)
+      --schemaVersion <url>      Custom $schema URL
+      --strictObjects            Set additionalProperties: false globally
+      --additionalProperties     Set additionalProperties default (true/false)
+      --includeJSDoc <bool>      Include JSDoc comments (default: true)
+
+  --followImports <mode>         Follow imports: none, local, all (default: local)
+  --baseDir <path>               Base directory for resolving imports
+
+EXAMPLES:
+  # Convert all types in a file
+  ts-source-to-json-schema src/types.ts
+
+  # Convert a specific root type
+  ts-source-to-json-schema src/api.ts --rootType ApiResponse
+
+  # Follow local imports (default)
+  ts-source-to-json-schema src/api.ts --followImports local
+
+  # Single file, no imports
+  ts-source-to-json-schema src/types.ts --followImports none
+
+  # Strict object mode (no additional properties)
+  ts-source-to-json-schema src/config.ts --strictObjects
+
+  # Disable JSDoc processing
+  ts-source-to-json-schema src/types.ts --includeJSDoc false
+
+  # Combine options
+  ts-source-to-json-schema src/user.ts -r User --strictObjects --followImports local
+`);
+}
+function parseArgs(args) {
+    const options = {};
+    let filePath = null;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '-h' || arg === '--help') {
+            options.help = true;
+        }
+        else if (arg === '-v' || arg === '--version') {
+            options.version = true;
+        }
+        else if (arg === '--doctor') {
+            options.doctor = true;
+        }
+        else if (arg === '-r' || arg === '--rootType') {
+            options.rootType = args[++i];
+        }
+        else if (arg === '-s' || arg === '--includeSchema') {
+            options.includeSchema = parseBoolean(args[++i]);
+        }
+        else if (arg === '--schemaVersion') {
+            options.schemaVersion = args[++i];
+        }
+        else if (arg === '--strictObjects') {
+            options.strictObjects = true;
+        }
+        else if (arg === '--additionalProperties') {
+            options.additionalProperties = parseBoolean(args[++i]);
+        }
+        else if (arg === '--includeJSDoc') {
+            options.includeJSDoc = parseBoolean(args[++i]);
+        }
+        else if (arg === '--followImports') {
+            const mode = args[++i];
+            if (!['none', 'local', 'all'].includes(mode)) {
+                console.error(`Invalid followImports mode: ${mode}`);
+                console.error('Valid options: none, local, all');
+                process.exit(1);
+            }
+            options.followImports = mode;
+        }
+        else if (arg === '--baseDir') {
+            options.baseDir = args[++i];
+        }
+        else if (arg.startsWith('-')) {
+            console.error(`Unknown option: ${arg}`);
+            console.error('Run with --help to see available options');
+            process.exit(1);
+        }
+        else {
+            // First non-flag argument is the file path
+            if (!filePath) {
+                filePath = arg;
+            }
+            else {
+                console.error(`Unexpected argument: ${arg}`);
+                process.exit(1);
+            }
+        }
+    }
+    return { filePath, options };
+}
+function parseBoolean(value) {
+    const lower = value.toLowerCase();
+    if (lower === 'true' || lower === '1' || lower === 'yes') {
+        return true;
+    }
+    if (lower === 'false' || lower === '0' || lower === 'no') {
+        return false;
+    }
+    console.error(`Invalid boolean value: ${value}`);
+    console.error('Use: true/false, yes/no, or 1/0');
+    process.exit(1);
+}
+function main() {
+    const args = process.argv.slice(2);
+    // Handle no arguments
+    if (args.length === 0) {
+        showHelp();
+        process.exit(0);
+    }
+    const { filePath, options } = parseArgs(args);
+    // Handle special flags
+    if (options.help) {
+        showHelp();
+        process.exit(0);
+    }
+    if (options.version) {
+        console.log(version);
+        process.exit(0);
+    }
+    // Validate file path
+    if (!filePath) {
+        console.error('Error: No input file specified');
+        console.error('Usage: ts-source-to-json-schema <file.ts> [options]');
+        console.error('Run with --help for more information');
+        process.exit(1);
+    }
+    // Resolve file path
+    const absolutePath = path.resolve(process.cwd(), filePath);
+    // Check if file exists (skip in doctor mode to provide diagnostics)
+    if (!fs.existsSync(absolutePath) && !options.doctor) {
+        console.error(`Error: File not found: ${filePath}`);
+        process.exit(1);
+    }
+    // Read TypeScript source
+    let source;
+    let readError = null;
+    try {
+        source = fs.readFileSync(absolutePath, 'utf-8');
+    }
+    catch (error) {
+        readError = error instanceof Error ? error : new Error(String(error));
+        if (!options.doctor) {
+            console.error(`Error reading file: ${readError.message}`);
+            process.exit(1);
+        }
+        source = ''; // For doctor mode
+    }
+    // Doctor mode: output comprehensive diagnostics
+    if (options.doctor) {
+        const { help, version, doctor, ...emitterOptions } = options;
+        const inputInfo = {
+            filePath: filePath,
+            absolutePath: absolutePath,
+            fileExists: fs.existsSync(absolutePath),
+        };
+        // Add file stats if file exists
+        if (fs.existsSync(absolutePath)) {
+            try {
+                const stats = fs.statSync(absolutePath);
+                inputInfo.fileSize = stats.size;
+                inputInfo.modified = stats.mtime.toISOString();
+            }
+            catch (error) {
+                // Ignore stat errors
+            }
+        }
+        const diagnostics = {
+            timestamp: new Date().toISOString(),
+            version: version,
+            environment: {
+                nodeVersion: process.version,
+                platform: process.platform,
+                arch: process.arch,
+                cwd: process.cwd(),
+            },
+            input: inputInfo,
+            options: emitterOptions,
+        };
+        // Add read error if present
+        if (readError) {
+            diagnostics.readError = {
+                message: readError.message,
+                stack: readError.stack,
+            };
+        }
+        else {
+            // Add source content and length
+            inputInfo.sourceLength = source.length;
+            inputInfo.sourceLines = source.split('\n').length;
+            inputInfo.source = source;
+            // Try to convert and capture result or error
+            try {
+                const schema = toJsonSchema(source, emitterOptions);
+                diagnostics.conversionResult = {
+                    success: true,
+                    schema: schema,
+                };
+            }
+            catch (error) {
+                const conversionError = error instanceof Error ? error : new Error(String(error));
+                diagnostics.conversionResult = {
+                    success: false,
+                    error: {
+                        message: conversionError.message,
+                        stack: conversionError.stack,
+                    },
+                };
+            }
+        }
+        console.log(JSON.stringify(diagnostics, null, 2));
+        process.exit(0);
+    }
+    // Convert to JSON Schema
+    let schema;
+    try {
+        // Remove help, version, doctor from emitter options
+        const { help, version, doctor, ...emitterOptions } = options;
+        // Determine followImports mode (default to 'local' in CLI)
+        const followMode = emitterOptions.followImports ?? 'local';
+        if (followMode !== 'none') {
+            // Use file-based API with import resolution
+            const baseDir = emitterOptions.baseDir ?? path.dirname(absolutePath);
+            schema = toJsonSchemaFromFile(absolutePath, {
+                ...emitterOptions,
+                baseDir,
+                followImports: followMode,
+            });
+        }
+        else {
+            // Use string-based API (single file, no imports)
+            schema = toJsonSchema(source, emitterOptions);
+        }
+    }
+    catch (error) {
+        console.error(`Error converting to JSON Schema: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    // Output JSON Schema to stdout
+    console.log(JSON.stringify(schema, null, 2));
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/emitter.d.ts

@@ -0,0 +1,120 @@
+import type { Declaration } from "./ast.js";
+export interface JSONSchema {
+    $schema?: string;
+    $ref?: string;
+    $defs?: Record<string, JSONSchema>;
+    type?: string | string[];
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    additionalProperties?: boolean | JSONSchema;
+    items?: JSONSchema;
+    prefixItems?: JSONSchema[];
+    minItems?: number;
+    maxItems?: number;
+    anyOf?: JSONSchema[];
+    allOf?: JSONSchema[];
+    oneOf?: JSONSchema[];
+    const?: unknown;
+    enum?: unknown[];
+    description?: string;
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    deprecated?: boolean;
+    readOnly?: boolean;
+    examples?: unknown[];
+    title?: string;
+    [key: string]: unknown;
+}
+export interface EmitterOptions {
+    /** Include $schema in the root. Default: true */
+    includeSchema?: boolean;
+    /** JSON Schema draft. Default: "https://json-schema.org/draft/2020-12/schema" */
+    schemaVersion?: string;
+    /** Set additionalProperties: false on all objects. Default: false */
+    strictObjects?: boolean;
+    /** Name of the root type to emit. If not set, emits all types under $defs */
+    rootType?: string;
+    /** Include JSDoc descriptions and tags in the schema. Default: true */
+    includeJSDoc?: boolean;
+    /** Default value for additionalProperties if not specified via JSDoc or index signature */
+    additionalProperties?: boolean;
+    /** Follow import statements: "none" (default in API), "local" (default in CLI), "all" */
+    followImports?: "none" | "local" | "all";
+    /** Base directory for resolving imports. Default: dirname(entryPath) or cwd */
+    baseDir?: string;
+}
+export declare class Emitter {
+    private declarations;
+    private options;
+    constructor(declarations: Declaration[], options?: EmitterOptions);
+    emit(): JSONSchema;
+    /**
+     * Emits schemas for all declarations at once.
+     * More efficient than calling emit() multiple times.
+     * Each schema is standalone with only its transitively referenced types in definitions.
+     */
+    emitAll(): Record<string, JSONSchema>;
+    /**
+     * Emits a declaration as a standalone schema with minimal definitions.
+     * Only includes types that are transitively referenced.
+     * Uses "definitions" (draft-07 style) instead of "$defs" for compatibility.
+     */
+    private emitDeclarationStandalone;
+    /**
+     * Recursively collects all type names that are transitively referenced by a given type.
+     */
+    private collectTransitiveReferences;
+    /**
+     * Finds all direct type references in a declaration.
+     */
+    private findDirectReferences;
+    /**
+     * Checks if a type name refers to a built-in type that shouldn't be in definitions.
+     */
+    private isBuiltInType;
+    /**
+     * Recursively converts $ref paths from #/$defs/ to #/definitions/ in a schema.
+     */
+    private convertRefsToDefinitions;
+    /**
+     * Checks if a schema contains a reference to a specific type name.
+     * Used to detect self-referential types.
+     */
+    private containsReference;
+    /**
+     * Checks if a type is transitively self-referential.
+     * This includes both direct recursion (A → A) and mutual recursion (A → B → A).
+     */
+    private isTransitivelySelfReferential;
+    /**
+     * Extracts all type names referenced in a schema.
+     */
+    private getReferencedTypes;
+    private emitDeclaration;
+    private emitInterface;
+    private emitTypeAlias;
+    private emitEnum;
+    private emitType;
+    private emitPrimitive;
+    private emitObjectType;
+    private emitTuple;
+    private emitUnion;
+    private flattenUnion;
+    private emitIntersection;
+    private emitReference;
+    private emitRecord;
+    private resolveUtilityType;
+    private resolvePartial;
+    private resolveRequired;
+    private resolvePick;
+    private resolveOmit;
+    private extractKeyNames;
+    private getProperties;
+    private applyJSDocTags;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/emitter.d.ts.map

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