@atomic-ehr/codegen 0.0.1-canary.20250822114054.4ca1428 → 0.0.1-canary.20250822150706.c3b8669

package/dist/api/generators/base/FileManager.js

@@ -0,0 +1,204 @@
+/**
+ * Core file management system with batching and performance optimizations
+ *
+ * This replaces scattered writeFile calls with a comprehensive file management
+ * system that provides better error handling, performance, and maintainability.
+ */
+import { access, mkdir, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
+import { FileOperationError } from "./errors.js";
+/**
+ * High-performance file manager with batching and error recovery
+ *
+ * Features:
+ * - Automatic directory creation
+ * - Batch operations for better performance
+ * - Comprehensive error handling with recovery suggestions
+ * - Import path resolution
+ * - File existence checks
+ */
+export class FileManager {
+    options;
+    logger;
+    constructor(options) {
+        this.options = {
+            overwrite: true,
+            batchSize: 10,
+            ...options,
+        };
+        this.logger = options.logger;
+    }
+    /**
+     * Write a file with automatic directory creation
+     * @param relativePath Path relative to output directory
+     * @param content File content
+     * @param options Write options
+     */
+    async writeFile(relativePath, content, options = {}) {
+        const startTime = performance.now();
+        const fullPath = join(this.options.outputDir, relativePath);
+        const encoding = options.encoding || "utf-8";
+        const overwrite = options.overwrite ?? this.options.overwrite;
+        try {
+            // Check if file exists and overwrite is disabled
+            if (!overwrite) {
+                try {
+                    await access(fullPath);
+                    this.logger.debug(`Skipping existing file: ${relativePath}`);
+                    const stats = await stat(fullPath);
+                    return {
+                        path: fullPath,
+                        size: stats.size,
+                        writeTime: 0,
+                    };
+                }
+                catch {
+                    // File doesn't exist, continue with write
+                }
+            }
+            // Ensure directory exists
+            await this.ensureDirectory(dirname(fullPath));
+            // Write file
+            await writeFile(fullPath, content, encoding);
+            const writeTime = performance.now() - startTime;
+            const size = Buffer.byteLength(content, encoding);
+            this.logger.debug(`Written ${relativePath} (${size} bytes, ${writeTime.toFixed(2)}ms)`);
+            return {
+                path: fullPath,
+                size,
+                writeTime,
+            };
+        }
+        catch (error) {
+            throw new FileOperationError(`Failed to write file '${relativePath}': ${error}`, "write", fullPath, error instanceof Error ? error : undefined, {
+                canRetry: true,
+                alternativePaths: [
+                    join(process.cwd(), "backup-output", relativePath),
+                ],
+            });
+        }
+    }
+    /**
+     * Write multiple files in batch for better performance
+     * @param files Map of relative path to content
+     */
+    async writeBatch(files) {
+        this.logger.debug(`Writing batch of ${files.size} files`);
+        const entries = Array.from(files.entries());
+        const results = [];
+        // Process in batches to avoid overwhelming the filesystem
+        for (let i = 0; i < entries.length; i += this.options.batchSize) {
+            const batch = entries.slice(i, i + this.options.batchSize);
+            const batchPromises = batch.map(([path, content]) => this.writeFile(path, content));
+            const batchResults = await Promise.all(batchPromises);
+            results.push(...batchResults);
+            // Small delay between batches to be filesystem-friendly
+            if (i + this.options.batchSize < entries.length) {
+                await new Promise((resolve) => setTimeout(resolve, 10));
+            }
+        }
+        return results;
+    }
+    /**
+     * Ensure directory exists, creating parent directories as needed
+     * @param dirPath Full directory path
+     */
+    async ensureDirectory(dirPath) {
+        try {
+            await mkdir(dirPath, { recursive: true });
+        }
+        catch (error) {
+            throw new FileOperationError(`Failed to create directory '${dirPath}': ${error}`, "create", dirPath, error instanceof Error ? error : undefined, {
+                canRetry: true,
+                permissionFix: `chmod 755 "${dirname(dirPath)}"`,
+            });
+        }
+    }
+    /**
+     * Clean directory by removing all contents
+     * @param relativePath Path relative to output directory
+     */
+    async cleanDirectory(relativePath = ".") {
+        const fullPath = join(this.options.outputDir, relativePath);
+        try {
+            await access(fullPath);
+            this.logger.debug(`Cleaning directory: ${relativePath}`);
+            await rm(fullPath, { recursive: true, force: true });
+        }
+        catch (error) {
+            // Directory doesn't exist - that's fine
+            if (error?.code !== "ENOENT") {
+                throw new FileOperationError(`Failed to clean directory '${relativePath}': ${error}`, "delete", fullPath, error instanceof Error ? error : undefined, {
+                    canRetry: true,
+                });
+            }
+        }
+    }
+    /**
+     * Get relative import path between two files
+     * @param fromFile Source file path
+     * @param toFile Target file path
+     */
+    getRelativeImportPath(fromFile, toFile) {
+        const from = dirname(join(this.options.outputDir, fromFile));
+        const to = join(this.options.outputDir, toFile);
+        let relativePath = relative(from, to);
+        // Ensure relative imports start with './' or '../'
+        if (!relativePath.startsWith(".")) {
+            relativePath = `./${relativePath}`;
+        }
+        // Remove file extension for imports (handle .d.ts files properly)
+        return relativePath.replace(/\.(d\.ts|ts|tsx|js|jsx)$/, "");
+    }
+    /**
+     * Check if a file would be overwritten
+     * @param relativePath Path relative to output directory
+     */
+    async wouldOverwrite(relativePath) {
+        const fullPath = join(this.options.outputDir, relativePath);
+        try {
+            await access(fullPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get file statistics
+     * @param relativePath Path relative to output directory
+     */
+    async getFileStats(relativePath) {
+        const fullPath = join(this.options.outputDir, relativePath);
+        try {
+            const stats = await stat(fullPath);
+            return {
+                size: stats.size,
+                generationTime: 0, // Will be set by caller
+                writeTime: 0, // Will be set by caller
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get output directory
+     */
+    getOutputDirectory() {
+        return this.options.outputDir;
+    }
+    /**
+     * Set batch size for operations
+     * @param size Batch size
+     */
+    setBatchSize(size) {
+        this.options.batchSize = Math.max(1, Math.min(50, size));
+    }
+    /**
+     * Get current batch size
+     */
+    getBatchSize() {
+        return this.options.batchSize;
+    }
+}

package/dist/api/generators/base/PythonTypeMapper.d.ts

@@ -1,8 +1,8 @@
 /**
  * Python type mapper implementation (basic version)
  */
-import type { TypeSchemaIdentifier } from "../../../typeschema";
-import { type LanguageType, TypeMapper } from "./TypeMapper";
+import type { TypeSchemaIdentifier } from "../../../typeschema/index.js";
+import { type LanguageType, TypeMapper } from "./TypeMapper.js";
 export declare class PythonTypeMapper extends TypeMapper {
     getLanguageName(): string;
     mapPrimitive(fhirType: string): LanguageType;

package/dist/api/generators/base/PythonTypeMapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PythonTypeMapper.d.ts","sourceRoot":"","sources":["../../../../src/api/generators/base/PythonTypeMapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7D,qBAAa,gBAAiB,SAAQ,UAAU;IAC/C,eAAe,IAAI,MAAM;IAIzB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAkB5C,YAAY,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,YAAY;IAS5D,QAAQ,CAAC,WAAW,EAAE,YAAY,GAAG,YAAY;IAUjD,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAG,YAAY;IAUhE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY;IAQvD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQrC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGpC"}
+{"version":3,"file":"PythonTypeMapper.d.ts","sourceRoot":"","sources":["../../../../src/api/generators/base/PythonTypeMapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEhE,qBAAa,gBAAiB,SAAQ,UAAU;IAC/C,eAAe,IAAI,MAAM;IAIzB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAkB5C,YAAY,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,YAAY;IAS5D,QAAQ,CAAC,WAAW,EAAE,YAAY,GAAG,YAAY;IAUjD,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAG,YAAY;IAUhE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY;IAQvD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQrC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGpC"}

package/dist/api/generators/base/PythonTypeMapper.js

@@ -0,0 +1,71 @@
+/**
+ * Python type mapper implementation (basic version)
+ */
+import { TypeMapper } from "./TypeMapper.js";
+export class PythonTypeMapper extends TypeMapper {
+    getLanguageName() {
+        return "Python";
+    }
+    mapPrimitive(fhirType) {
+        const primitiveMap = {
+            string: "str",
+            integer: "int",
+            decimal: "float",
+            boolean: "bool",
+            dateTime: "datetime",
+            date: "date",
+            time: "time",
+        };
+        return {
+            name: primitiveMap[fhirType] || "Any",
+            isPrimitive: true,
+            nullable: false,
+        };
+    }
+    mapReference(_targets) {
+        return {
+            name: "Reference",
+            isPrimitive: false,
+            importPath: ".reference",
+            nullable: false,
+        };
+    }
+    mapArray(elementType) {
+        return {
+            name: `List[${elementType.name}]`,
+            isPrimitive: false,
+            importPath: "typing",
+            isArray: true,
+            nullable: false,
+        };
+    }
+    mapOptional(type, required) {
+        if (required)
+            return type;
+        return {
+            ...type,
+            name: `Optional[${type.name}]`,
+            nullable: true,
+        };
+    }
+    mapEnum(_values, name) {
+        return {
+            name: name ? this.formatTypeName(name) : "Literal",
+            isPrimitive: false,
+            nullable: false,
+        };
+    }
+    formatTypeName(name) {
+        return this.applyNamingConvention(name);
+    }
+    formatFieldName(name) {
+        // Convert camelCase to snake_case
+        return name
+            .replace(/([A-Z])/g, "_$1")
+            .toLowerCase()
+            .replace(/^_/, "");
+    }
+    formatFileName(name) {
+        return this.formatFieldName(name);
+    }
+}

package/dist/api/generators/base/TemplateEngine.d.ts

@@ -7,7 +7,7 @@
  * - Function templates (TypeScript functions)
  * - Inline templates (template literals)
  */
-import type { CodegenLogger } from "../../../utils/codegen-logger";
+import type { CodegenLogger } from "../../../utils/codegen-logger.js";
 /**
  * Template context passed to templates
  */

package/dist/api/generators/base/TemplateEngine.d.ts.map

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

package/dist/api/generators/base/TemplateEngine.js

@@ -0,0 +1,133 @@
+/**
+ * Abstract template engine for code generation
+ *
+ * Supports multiple template formats:
+ * - Handlebars templates (.hbs)
+ * - String templates (.template)
+ * - Function templates (TypeScript functions)
+ * - Inline templates (template literals)
+ */
+import { TemplateError } from "./errors.js";
+/**
+ * Abstract template engine
+ */
+export class TemplateEngine {
+    logger;
+    templates = new Map();
+    templateCache = new Map();
+    helpers = new Map();
+    constructor(options) {
+        this.logger = options.logger;
+        this.registerDefaultHelpers();
+    }
+    // ==========================================
+    // Concrete Methods
+    // ==========================================
+    /**
+     * Register a template helper function
+     * @param name Helper name
+     * @param helper Helper function
+     */
+    registerHelper(name, helper) {
+        this.helpers.set(name, helper);
+        this.logger.debug(`Registered template helper: ${name}`);
+    }
+    /**
+     * Get available template names
+     */
+    getAvailableTemplates() {
+        return Array.from(this.templates.keys()).sort();
+    }
+    /**
+     * Get template information
+     * @param templateName Template name
+     */
+    getTemplateInfo(templateName) {
+        const template = this.templates.get(templateName);
+        if (!template)
+            return undefined;
+        return {
+            name: templateName,
+            format: template.format || "unknown",
+            path: template.path,
+            description: template.description,
+            examples: template.examples || [],
+        };
+    }
+    /**
+     * Check if template exists
+     * @param templateName Template name
+     */
+    hasTemplate(templateName) {
+        return this.templates.has(templateName);
+    }
+    /**
+     * Remove a template
+     * @param templateName Template name
+     */
+    unregisterTemplate(templateName) {
+        const removed = this.templates.delete(templateName);
+        this.templateCache.delete(templateName);
+        if (removed) {
+            this.logger.debug(`Unregistered template: ${templateName}`);
+        }
+        return removed;
+    }
+    /**
+     * Clear all templates and cache
+     */
+    clearTemplates() {
+        this.templates.clear();
+        this.templateCache.clear();
+        this.logger.debug("Cleared all templates");
+    }
+    /**
+     * Validate template context
+     * @param context Template context
+     * @param requiredFields Required context fields
+     */
+    validateContext(context, requiredFields = []) {
+        for (const field of requiredFields) {
+            if (!(field in context)) {
+                throw new TemplateError(`Missing required context field: ${field}`, "unknown", context, {
+                    missingVariables: [field],
+                    availableTemplates: this.getAvailableTemplates(),
+                });
+            }
+        }
+    }
+    /**
+     * Register default template helpers
+     */
+    registerDefaultHelpers() {
+        // String manipulation helpers
+        this.registerHelper("capitalize", (str) => str.charAt(0).toUpperCase() + str.slice(1));
+        this.registerHelper("lowercase", (str) => str.toLowerCase());
+        this.registerHelper("uppercase", (str) => str.toUpperCase());
+        this.registerHelper("camelCase", (str) => str.replace(/[-_\s]+(.)/g, (_, char) => char.toUpperCase()));
+        this.registerHelper("pascalCase", (str) => {
+            const camelCase = str.replace(/[-_\s]+(.)/g, (_, char) => char.toUpperCase());
+            return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);
+        });
+        this.registerHelper("snakeCase", (str) => str
+            .replace(/([A-Z])/g, "_$1")
+            .replace(/[-\s]+/g, "_")
+            .toLowerCase()
+            .replace(/^_/, ""));
+        // Array helpers
+        this.registerHelper("join", (arr, separator = ", ") => Array.isArray(arr) ? arr.join(separator) : "");
+        this.registerHelper("length", (arr) => Array.isArray(arr) ? arr.length : 0);
+        // Logic helpers
+        this.registerHelper("eq", (a, b) => a === b);
+        this.registerHelper("ne", (a, b) => a !== b);
+        this.registerHelper("gt", (a, b) => a > b);
+        this.registerHelper("lt", (a, b) => a < b);
+        // Utility helpers
+        this.registerHelper("json", (obj) => JSON.stringify(obj, null, 2));
+        this.registerHelper("indent", (str, spaces = 2) => str
+            .split("\n")
+            .map((line) => " ".repeat(spaces) + line)
+            .join("\n"));
+        this.registerHelper("timestamp", () => new Date().toISOString());
+    }
+}

package/dist/api/generators/base/TypeMapper.js

@@ -0,0 +1,153 @@
+/**
+ * Abstract base class for language-specific type mapping
+ *
+ * This provides the interface that all language generators must implement
+ * to convert FHIR TypeSchema types into their target language types.
+ */
+/**
+ * Abstract type mapper for language-specific type conversion
+ */
+export class TypeMapper {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            generateNullable: true,
+            strictTypes: true,
+            customMappings: {},
+            preferArraySyntax: true,
+            namingConvention: "PascalCase",
+            ...options,
+        };
+    }
+    // ==========================================
+    // Concrete Methods - Shared functionality
+    // ==========================================
+    /**
+     * Main entry point for type mapping
+     * @param schemaType Type from TypeSchema
+     */
+    mapType(schemaType) {
+        // Handle primitive types
+        if (typeof schemaType === "string") {
+            return this.mapPrimitive(schemaType);
+        }
+        // Handle complex types
+        if (schemaType && typeof schemaType === "object") {
+            const kind = schemaType.kind || schemaType.type;
+            switch (kind) {
+                case "primitive-type":
+                    return this.mapPrimitive(schemaType.name);
+                case "reference":
+                    return this.mapReference(schemaType.targets || []);
+                case "array": {
+                    const elementType = this.mapType(schemaType.element);
+                    return this.mapArray(elementType);
+                }
+                case "enum":
+                case "coded":
+                    return this.mapEnum(schemaType.values || [], schemaType.name);
+                case "complex-type":
+                case "resource":
+                    return this.mapComplexType(schemaType);
+                default:
+                    return this.mapUnknownType(schemaType);
+            }
+        }
+        return this.mapUnknownType(schemaType);
+    }
+    /**
+     * Map a complex type (resource, complex-type)
+     * @param schemaType Complex type from schema
+     */
+    mapComplexType(schemaType) {
+        const typeName = this.formatTypeName(schemaType.name || "Unknown");
+        return {
+            name: typeName,
+            isPrimitive: false,
+            importPath: this.calculateImportPath(schemaType),
+            nullable: !schemaType.required && this.options.generateNullable,
+            metadata: {
+                kind: schemaType.kind,
+                package: schemaType.package,
+            },
+        };
+    }
+    /**
+     * Handle unknown/unmapped types
+     * @param schemaType Unknown type
+     */
+    mapUnknownType(schemaType) {
+        // console.warn(`Unknown type encountered:`, schemaType);
+        return {
+            name: "unknown",
+            isPrimitive: true,
+            nullable: true,
+            metadata: {
+                originalType: schemaType,
+                warning: "unmapped_type",
+            },
+        };
+    }
+    /**
+     * Calculate import path for a type
+     * @param schemaType Type to calculate import for
+     */
+    calculateImportPath(schemaType) {
+        if (!schemaType.name)
+            return undefined;
+        const fileName = this.formatFileName(schemaType.name);
+        return `./${fileName}`;
+    }
+    /**
+     * Apply naming convention to a string
+     * @param name Input name
+     */
+    applyNamingConvention(name) {
+        switch (this.options.namingConvention) {
+            case "camelCase":
+                return toCamelCase(name);
+            case "PascalCase":
+                return toPascalCase(name);
+            case "snake_case":
+                return toSnakeCase(name);
+            case "kebab-case":
+                return toKebabCase(name);
+            default:
+                return name;
+        }
+    }
+    /**
+     * Get custom mapping if available
+     * @param type Original type name
+     */
+    getCustomMapping(type) {
+        return this.options.customMappings[type];
+    }
+    /**
+     * Check if type should be nullable
+     * @param required Whether field is required
+     */
+    shouldBeNullable(required) {
+        return !required && this.options.generateNullable;
+    }
+}
+// ==========================================
+// Utility Functions
+// ==========================================
+function toCamelCase(str) {
+    return str.replace(/[-_\s]+(.)?/g, (_, char) => char?.toUpperCase() || "");
+}
+function toPascalCase(str) {
+    const camelCase = toCamelCase(str);
+    return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);
+}
+function toSnakeCase(str) {
+    return str
+        .replace(/([A-Z])/g, "_$1")
+        .replace(/[-\s]+/g, "_")
+        .toLowerCase()
+        .replace(/^_/, "");
+}
+function toKebabCase(str) {
+    return toSnakeCase(str).replace(/_/g, "-");
+}

package/dist/api/generators/base/TypeScriptTypeMapper.d.ts

@@ -2,7 +2,7 @@
  * TypeScript-specific type mapper implementation
  */
 import type { TypeSchemaIdentifier } from "../../../typeschema/type-schema.types";
-import { type LanguageType, TypeMapper, type TypeMapperOptions } from "./TypeMapper";
+import { type LanguageType, TypeMapper, type TypeMapperOptions } from "./TypeMapper.js";
 /**
  * TypeScript-specific options
  */

package/dist/api/generators/base/TypeScriptTypeMapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TypeScriptTypeMapper.d.ts","sourceRoot":"","sources":["../../../../src/api/generators/base/TypeScriptTypeMapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EACN,KAAK,YAAY,EACjB,UAAU,EACV,KAAK,iBAAiB,EACtB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACrE,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,uDAAuD;IACvD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;gBAEtD,OAAO,GAAE,2BAAgC;IAarD,eAAe,IAAI,MAAM;IAIzB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAgE5C,YAAY,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,YAAY;IA6C3D,QAAQ,CAAC,WAAW,EAAE,YAAY,GAAG,YAAY;IA4BjD,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAG,YAAY;IAmBhE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY;IAiBtD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIrC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC;;;;;OAKG;IACH,sBAAsB,CACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,OAAO,GACf,MAAM;IAOT;;;OAGG;IACH,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAY/D;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE;CAYnD"}
+{"version":3,"file":"TypeScriptTypeMapper.d.ts","sourceRoot":"","sources":["../../../../src/api/generators/base/TypeScriptTypeMapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EACN,KAAK,YAAY,EACjB,UAAU,EACV,KAAK,iBAAiB,EACtB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACrE,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,uDAAuD;IACvD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;gBAEtD,OAAO,GAAE,2BAAgC;IAarD,eAAe,IAAI,MAAM;IAIzB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAgE5C,YAAY,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,YAAY;IA6C3D,QAAQ,CAAC,WAAW,EAAE,YAAY,GAAG,YAAY;IA4BjD,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAG,YAAY;IAmBhE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY;IAiBtD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIrC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC;;;;;OAKG;IACH,sBAAsB,CACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,OAAO,GACf,MAAM;IAOT;;;OAGG;IACH,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAY/D;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE;CAYnD"}