rawsql-ts 0.10.9-beta → 0.11.1-beta

package/dist/src/transformers/TypeTransformationPostProcessor.js

@@ -0,0 +1,351 @@
+"use strict";
+/**
+ * Post-processor for transforming database values to appropriate TypeScript types
+ * after JSON serialization from PostgreSQL
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeTransformers = exports.TypeTransformationPostProcessor = void 0;
+exports.transformDatabaseResult = transformDatabaseResult;
+/**
+ * Applies type transformations to JSON results from PostgreSQL
+ */
+class TypeTransformationPostProcessor {
+    constructor(config = {}) {
+        this.config = {
+            enableValueBasedDetection: true,
+            strictDateDetection: false,
+            ...config
+        };
+    }
+    /**
+     * Transform a single result object
+     * @param result The result object from PostgreSQL JSON query
+     * @returns Transformed result with proper TypeScript types
+     */
+    transformResult(result) {
+        if (result === null || result === undefined) {
+            return result;
+        }
+        if (Array.isArray(result)) {
+            return result.map(item => this.transformSingleObject(item));
+        }
+        return this.transformSingleObject(result);
+    }
+    /**
+     * Transform a single object recursively
+     */
+    transformSingleObject(obj) {
+        var _a;
+        if (obj === null || obj === undefined || typeof obj !== 'object') {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(item => this.transformSingleObject(item));
+        }
+        const transformed = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (value === null || value === undefined) {
+                transformed[key] = value;
+                continue;
+            } // Check for column-specific transformation first (takes precedence)
+            const columnTransform = (_a = this.config.columnTransformations) === null || _a === void 0 ? void 0 : _a[key];
+            if (columnTransform) {
+                transformed[key] = this.applyTransformation(value, columnTransform);
+                continue;
+            }
+            // Only apply value-based detection if enabled and no column mapping exists
+            if (this.config.enableValueBasedDetection) {
+                const detectedTransform = this.detectValueBasedTransformation(value);
+                if (detectedTransform) {
+                    transformed[key] = this.applyTransformation(value, detectedTransform);
+                    continue;
+                }
+            }
+            // Apply global transformations based on SQL type (if available)
+            const globalTransform = this.config.globalTransformations &&
+                this.getGlobalTransformationForValue(value);
+            if (globalTransform) {
+                transformed[key] = this.applyTransformation(value, globalTransform);
+                continue;
+            }
+            // Recursively transform nested objects
+            if (typeof value === 'object' && !Array.isArray(value)) {
+                transformed[key] = this.transformSingleObject(value);
+                continue;
+            }
+            if (Array.isArray(value)) {
+                transformed[key] = value.map(item => typeof item === 'object' ? this.transformSingleObject(item) : item);
+                continue;
+            }
+            // No transformation needed
+            transformed[key] = value;
+        }
+        return transformed;
+    }
+    /**
+     * Detect value type and create appropriate transformation based on value characteristics
+     * This is the core value-based detection logic
+     */
+    detectValueBasedTransformation(value) {
+        // Date string detection
+        if (typeof value === 'string' && this.isDateString(value)) {
+            return {
+                sourceType: 'TIMESTAMP',
+                targetType: 'Date',
+                handleNull: true,
+                validator: (v) => typeof v === 'string' && !isNaN(Date.parse(v))
+            };
+        }
+        // BigInt detection (number > MAX_SAFE_INTEGER)
+        if (typeof value === 'number' && !Number.isSafeInteger(value)) {
+            return {
+                sourceType: 'BIGINT',
+                targetType: 'bigint',
+                handleNull: true,
+                validator: (v) => {
+                    try {
+                        BigInt(v);
+                        return true;
+                    }
+                    catch {
+                        return false;
+                    }
+                }
+            };
+        }
+        // Large string number detection (potential BIGINT)
+        if (typeof value === 'string' && /^\d{16,}$/.test(value)) {
+            return {
+                sourceType: 'BIGINT',
+                targetType: 'bigint',
+                handleNull: true,
+                validator: (v) => {
+                    try {
+                        BigInt(v);
+                        return true;
+                    }
+                    catch {
+                        return false;
+                    }
+                }
+            };
+        }
+        return null;
+    }
+    /**
+     * Get global transformation for a specific value (if any match)
+     * This is separate from value-based detection and relies on configured global rules
+     */
+    getGlobalTransformationForValue(value) {
+        if (!this.config.globalTransformations) {
+            return null;
+        }
+        // This could be extended to match values against configured global rules
+        // For now, it's a placeholder for future SQL-type-based global transformations
+        return null;
+    }
+    /**
+     * @deprecated Use detectValueBasedTransformation instead
+     * Detect value type and get appropriate global transformation
+     */
+    detectAndGetGlobalTransformation(value) {
+        return this.detectValueBasedTransformation(value);
+    }
+    /**
+     * Check if string is a valid date string
+     * Supports both strict (ISO 8601 with T separator) and loose detection
+     */
+    isDateString(value) {
+        if (this.config.strictDateDetection) {
+            // Strict: Only ISO 8601 with T separator (safer for user input)
+            const strictIsoPattern = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?(?:Z|[+-]\d{2}:\d{2})?$/;
+            if (!strictIsoPattern.test(value)) {
+                return false;
+            }
+        }
+        else {
+            // Loose: ISO 8601 date pattern (includes date-only strings)
+            const isoDatePattern = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}:\d{2}(?:\.\d{3})?(?:Z|[+-]\d{2}:\d{2})?)?$/;
+            if (!isoDatePattern.test(value)) {
+                return false;
+            }
+        }
+        const date = new Date(value);
+        return !isNaN(date.getTime());
+    }
+    /**
+     * Apply a specific transformation to a value
+     */
+    applyTransformation(value, transformation) {
+        var _a;
+        // Handle null values
+        if (value === null || value === undefined) {
+            return transformation.handleNull !== false ? value : null;
+        }
+        // Validate value if validator is provided
+        if (transformation.validator && !transformation.validator(value)) {
+            console.warn(`TypeTransformationPostProcessor: Value validation failed for ${value}`);
+            return value;
+        }
+        try {
+            switch (transformation.targetType) {
+                case 'Date':
+                    return new Date(value);
+                case 'bigint':
+                    // Handle both string and number inputs for BIGINT
+                    // For scientific notation numbers, convert to integer first
+                    if (typeof value === 'number') {
+                        // Convert scientific notation to integer string
+                        const integerValue = Math.trunc(value);
+                        return BigInt(integerValue.toString());
+                    }
+                    return BigInt(value);
+                case 'string':
+                    return value.toString();
+                case 'number':
+                    return typeof value === 'string' ? parseFloat(value) : Number(value);
+                case 'object':
+                    return typeof value === 'string' ? JSON.parse(value) : value;
+                case 'custom':
+                    if (transformation.customTransformer &&
+                        ((_a = this.config.customTransformers) === null || _a === void 0 ? void 0 : _a[transformation.customTransformer])) {
+                        return this.config.customTransformers[transformation.customTransformer](value);
+                    }
+                    break;
+                default:
+                    return value;
+            }
+        }
+        catch (error) {
+            console.warn(`TypeTransformationPostProcessor: Transformation failed for ${value}:`, error);
+            return value;
+        }
+        return value;
+    }
+    /**
+     * Create a default configuration for common PostgreSQL types
+     * Enables value-based detection with loose date detection by default
+     */
+    static createDefaultConfig() {
+        return {
+            enableValueBasedDetection: true,
+            strictDateDetection: false,
+            globalTransformations: {
+                'DATE': {
+                    sourceType: 'DATE',
+                    targetType: 'Date',
+                    handleNull: true,
+                    validator: (value) => typeof value === 'string' && !isNaN(Date.parse(value))
+                },
+                'TIMESTAMP': {
+                    sourceType: 'TIMESTAMP',
+                    targetType: 'Date',
+                    handleNull: true,
+                    validator: (value) => typeof value === 'string' && !isNaN(Date.parse(value))
+                },
+                'BIGINT': {
+                    sourceType: 'BIGINT',
+                    targetType: 'bigint',
+                    handleNull: true,
+                    validator: (value) => {
+                        try {
+                            BigInt(value);
+                            return true;
+                        }
+                        catch {
+                            return false;
+                        }
+                    }
+                }
+            }
+        };
+    }
+    /**
+     * Create a safe configuration for handling user input
+     * Disables value-based detection and uses strict date detection
+     */
+    static createSafeConfig(columnMappings) {
+        return {
+            enableValueBasedDetection: false,
+            strictDateDetection: true,
+            columnTransformations: columnMappings || {},
+            globalTransformations: {
+                'DATE': {
+                    sourceType: 'DATE',
+                    targetType: 'Date',
+                    handleNull: true,
+                    validator: (value) => typeof value === 'string' && !isNaN(Date.parse(value))
+                },
+                'TIMESTAMP': {
+                    sourceType: 'TIMESTAMP',
+                    targetType: 'Date',
+                    handleNull: true,
+                    validator: (value) => typeof value === 'string' && !isNaN(Date.parse(value))
+                },
+                'BIGINT': {
+                    sourceType: 'BIGINT',
+                    targetType: 'bigint',
+                    handleNull: true,
+                    validator: (value) => {
+                        try {
+                            BigInt(value);
+                            return true;
+                        }
+                        catch {
+                            return false;
+                        }
+                    }
+                }
+            }
+        };
+    }
+}
+exports.TypeTransformationPostProcessor = TypeTransformationPostProcessor;
+/**
+ * Convenience function to create and apply transformations
+ */
+function transformDatabaseResult(result, config) {
+    const processor = new TypeTransformationPostProcessor(config || TypeTransformationPostProcessor.createDefaultConfig());
+    return processor.transformResult(result);
+}
+/**
+ * Type-safe transformation helpers
+ */
+exports.TypeTransformers = {
+    /**
+     * Transform date string to Date object
+     */
+    toDate: (value) => {
+        if (value === null || value === undefined)
+            return null;
+        const date = new Date(value);
+        return isNaN(date.getTime()) ? null : date;
+    },
+    /**
+     * Transform numeric string to BigInt
+     */
+    toBigInt: (value) => {
+        if (value === null || value === undefined)
+            return null;
+        try {
+            return BigInt(value);
+        }
+        catch {
+            return null;
+        }
+    },
+    /**
+     * Transform JSON string to object
+     */
+    toObject: (value) => {
+        if (value === null || value === undefined)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+};
+//# sourceMappingURL=TypeTransformationPostProcessor.js.map

package/dist/src/transformers/TypeTransformationPostProcessor.js.map

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

package/dist/src/transformers/UnifiedJsonMapping.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Enhanced JSON mapping structure that integrates column mapping and type protection configuration.
+ * This unified approach eliminates the need for separate .types.json files.
+ */
+import { JsonMapping } from './PostgresJsonQueryBuilder';
+/**
+ * Supported column type enforcement options.
+ */
+export type ColumnType = 'string' | 'auto';
+/**
+ * Column configuration that can either be a simple string mapping or an enhanced mapping with type control.
+ */
+export type ColumnMappingConfig = string | {
+    column: string;
+    type?: ColumnType;
+};
+/**
+ * Enhanced JSON mapping configuration with integrated type protection.
+ */
+export interface UnifiedJsonMapping {
+    rootName: string;
+    typeInfo?: {
+        interface: string;
+        importPath: string;
+    };
+    rootEntity: {
+        id: string;
+        name: string;
+        columns: Record<string, ColumnMappingConfig>;
+    };
+    nestedEntities?: Array<{
+        id: string;
+        name: string;
+        parentId: string;
+        propertyName: string;
+        relationshipType: 'object' | 'array';
+        columns: Record<string, ColumnMappingConfig>;
+    }>;
+}
+/**
+ * Type protection configuration extracted from the unified mapping.
+ */
+export interface TypeProtectionConfig {
+    protectedStringFields: string[];
+}
+/**
+ * Convert a unified JSON mapping to separate JsonMapping and TypeProtectionConfig.
+ * This enables backward compatibility with existing code while supporting the new unified structure.
+ */
+export declare function convertUnifiedMapping(unified: UnifiedJsonMapping): {
+    jsonMapping: JsonMapping;
+    typeProtection: TypeProtectionConfig;
+};

package/dist/src/transformers/UnifiedJsonMapping.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Enhanced JSON mapping structure that integrates column mapping and type protection configuration.
+ * This unified approach eliminates the need for separate .types.json files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertUnifiedMapping = convertUnifiedMapping;
+/**
+ * Convert a unified JSON mapping to separate JsonMapping and TypeProtectionConfig.
+ * This enables backward compatibility with existing code while supporting the new unified structure.
+ */
+function convertUnifiedMapping(unified) {
+    const protectedStringFields = [];
+    // Helper function to process columns and extract string protection settings
+    const processColumns = (columns) => {
+        const result = {};
+        for (const [key, config] of Object.entries(columns)) {
+            if (typeof config === 'string') {
+                result[key] = config;
+            }
+            else {
+                result[key] = config.column;
+                if (config.type === 'string') {
+                    protectedStringFields.push(config.column);
+                }
+            }
+        }
+        return result;
+    };
+    // Convert the unified mapping to traditional JsonMapping
+    const jsonMapping = {
+        rootName: unified.rootName,
+        rootEntity: {
+            id: unified.rootEntity.id,
+            name: unified.rootEntity.name, columns: processColumns(unified.rootEntity.columns)
+        },
+        nestedEntities: [] // Initialize as empty array
+    };
+    // Add typeInfo if it exists
+    if (unified.typeInfo) {
+        // Note: JsonMapping doesn't have typeInfo in core, but we preserve it for backward compatibility
+        jsonMapping.typeInfo = unified.typeInfo;
+    }
+    // Process nested entities if they exist
+    if (unified.nestedEntities) {
+        jsonMapping.nestedEntities = unified.nestedEntities.map(entity => ({
+            id: entity.id,
+            name: entity.name,
+            parentId: entity.parentId,
+            propertyName: entity.propertyName,
+            relationshipType: entity.relationshipType,
+            columns: processColumns(entity.columns)
+        }));
+    }
+    return {
+        jsonMapping,
+        typeProtection: { protectedStringFields }
+    };
+}
+//# sourceMappingURL=UnifiedJsonMapping.js.map

package/dist/src/transformers/UnifiedJsonMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnifiedJsonMapping.js","sourceRoot":"","sources":["../../../src/transformers/UnifiedJsonMapping.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAmDH,sDAwDC;AA5DD;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,OAA2B;IAI7D,MAAM,qBAAqB,GAAa,EAAE,CAAC;IAE3C,4EAA4E;IAC5E,MAAM,cAAc,GAAG,CAAC,OAA4C,EAA0B,EAAE;QAC5F,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAClD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC5B,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC3B,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9C,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IAEF,yDAAyD;IACzD,MAAM,WAAW,GAAgB;QAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE;YACR,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE;YACzB,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;SACrF;QACD,cAAc,EAAE,EAAE,CAAE,4BAA4B;KACnD,CAAC;IAEF,4BAA4B;IAC5B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,iGAAiG;QAChG,WAAmB,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACrD,CAAC;IAED,wCAAwC;IACxC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QACzB,WAAW,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/D,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC;SAC1C,CAAC,CAAC,CAAC;IACR,CAAC;IAED,OAAO;QACH,WAAW;QACX,cAAc,EAAE,EAAE,qBAAqB,EAAE;KAC5C,CAAC;AACN,CAAC"}

package/dist/src/transformers/UpstreamSelectQueryFinder.d.ts

@@ -3,7 +3,11 @@ import { SelectQuery, SimpleSelectQuery } from "../models/SelectQuery";
  * UpstreamSelectQueryFinder searches upstream queries for the specified columns.
  * If a query (including its upstream CTEs or subqueries) contains all columns,
  * it returns the highest such SelectQuery. Otherwise, it searches downstream.
- * For UNION queries, it checks each branch independently.
+ *
+ * For BinarySelectQuery (UNION/INTERSECT/EXCEPT), this finder processes each branch
+ * independently, as SelectableColumnCollector is designed for SimpleSelectQuery only.
+ * This approach ensures accurate column detection within individual SELECT branches
+ * while maintaining compatibility with compound query structures.
  */
 export declare class UpstreamSelectQueryFinder {
     private options;

package/dist/src/transformers/UpstreamSelectQueryFinder.js

@@ -9,7 +9,11 @@ const CTECollector_1 = require("./CTECollector");
  * UpstreamSelectQueryFinder searches upstream queries for the specified columns.
  * If a query (including its upstream CTEs or subqueries) contains all columns,
  * it returns the highest such SelectQuery. Otherwise, it searches downstream.
- * For UNION queries, it checks each branch independently.
+ *
+ * For BinarySelectQuery (UNION/INTERSECT/EXCEPT), this finder processes each branch
+ * independently, as SelectableColumnCollector is designed for SimpleSelectQuery only.
+ * This approach ensures accurate column detection within individual SELECT branches
+ * while maintaining compatibility with compound query structures.
  */
 class UpstreamSelectQueryFinder {
     constructor(tableColumnResolver, options) {
@@ -122,6 +126,9 @@ class UpstreamSelectQueryFinder {
             return [];
         }
         else if (query instanceof SelectQuery_1.BinarySelectQuery) {
+            // Process BinarySelectQuery by decomposing into individual branches.
+            // SelectableColumnCollector is designed for SimpleSelectQuery only,
+            // so we handle UNION/INTERSECT/EXCEPT by processing left and right branches separately.
             const left = this.findUpstream(query.left, columnNames, cteMap);
             const right = this.findUpstream(query.right, columnNames, cteMap);
             return [...left, ...right];

package/dist/src/transformers/UpstreamSelectQueryFinder.js.map

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

package/dist/src/utils/JsonSchemaValidator.d.ts

@@ -0,0 +1,81 @@
+import { JsonMapping } from '../transformers/PostgresJsonQueryBuilder';
+/**
+ * Represents the structure extracted from JsonMapping analysis
+ */
+export type ExtractedStructure = 'primitive' | {
+    [key: string]: ExtractedStructure;
+} | ExtractedStructure[];
+/**
+ * Represents the expected type structure for validation
+ */
+export type ExpectedTypeStructure = 'primitive' | {
+    [key: string]: ExpectedTypeStructure;
+} | ExpectedTypeStructure[];
+/**
+ * Result of JsonMapping validation
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    missingProperties: string[];
+    extraProperties: string[];
+}
+export declare class JsonSchemaValidator {
+    /**
+     * Validates JsonMapping structure against an expected type structure.
+     * Checks if the JsonMapping covers all required properties and relationships.
+     *
+     * @param jsonMapping The JsonMapping configuration to validate
+     * @param expectedStructure The expected type structure to validate against
+     * @returns ValidationResult containing validation status and detailed errors
+     */
+    static validate(jsonMapping: JsonMapping, expectedStructure: ExpectedTypeStructure): ValidationResult;
+    /**
+     * Validates JsonMapping structure and throws an error if validation fails.
+     * Convenience method for strict validation scenarios.
+     *
+     * @param jsonMapping The JsonMapping configuration to validate
+     * @param expectedStructure The expected type structure to validate against
+     * @throws Error if validation fails with detailed error messages
+     */
+    static validateStrict(jsonMapping: JsonMapping, expectedStructure: ExpectedTypeStructure): void;
+    /**
+     * Extracts structure information from JsonMapping configuration.
+     * Analyzes rootEntity and nestedEntities to build complete structure map.
+     *
+     * @param jsonMapping The JsonMapping to analyze
+     * @returns ExtractedStructure representing the mapping structure
+     */
+    private static extractStructureFromJsonMapping; /**
+     * Extracts structure from a nested entity, including its children.
+     */
+    private static extractNestedEntityStructure; /**
+     * Compares extracted structure with expected structure with proper type guards.
+     */
+    private static compareStructures;
+    /**
+     * Validates JsonMapping structure against a sample object that implements the expected type.
+     * This method extracts structure from the sample object and compares it with JsonMapping.
+     *
+     * @param jsonMapping The JsonMapping configuration to validate
+     * @param sampleObject A sample object that implements the expected interface/type
+     * @returns ValidationResult containing validation status and detailed errors
+     */
+    static validateAgainstSample<T>(jsonMapping: JsonMapping, sampleObject: T): ValidationResult;
+    /**
+     * Validates JsonMapping structure against a sample object and throws an error if validation fails.
+     * Convenience method for strict validation scenarios with sample objects.
+     *
+     * @param jsonMapping The JsonMapping configuration to validate
+     * @param sampleObject A sample object that implements the expected interface/type
+     * @throws Error if validation fails with detailed error messages
+     */
+    static validateAgainstSampleStrict<T>(jsonMapping: JsonMapping, sampleObject: T): void; /**
+     * Extracts structure information from a sample object.
+     * Recursively analyzes the object properties to build a structure map.
+     *
+     * @param sampleObject The sample object to analyze
+     * @returns ExpectedTypeStructure representing the object structure
+     */
+    private static extractStructureFromSample;
+}