@memberjunction/sqlserver-dataprovider 5.4.1 → 5.5.0

package/dist/queryParameterProcessor.d.ts

@@ -1,59 +0,0 @@
-import { QueryInfo, QueryParameterInfo } from '@memberjunction/core';
-/**
- * Result of parameter validation
- */
-export interface ParameterValidationResult {
-    /**
-     * Whether all parameters passed validation
-     */
-    success: boolean;
-    /**
-     * Error messages for any validation failures
-     */
-    errors: string[];
-    /**
-     * The validated and type-converted parameters
-     */
-    validatedParameters: Record<string, any>;
-}
-/**
- * Result of processing a query template
- */
-export interface QueryProcessingResult {
-    /**
-     * Whether template processing was successful
-     */
-    success: boolean;
-    /**
-     * The processed SQL query with parameters substituted
-     */
-    processedSQL: string;
-    /**
-     * Error message if processing failed
-     */
-    error?: string;
-    /**
-     * The final parameters that were applied, including defaults
-     */
-    appliedParameters: Record<string, any>;
-}
-/**
- * Handles parameter validation and query template processing for parameterized queries.
- * Provides type conversion, validation, and secure template processing using Nunjucks.
- */
-export declare class QueryParameterProcessor {
-    private static _nunjucksEnv;
-    /**
-     * Gets or creates the Nunjucks environment with custom SQL-safe filters
-     */
-    private static get nunjucksEnv();
-    /**
-     * Validates parameters against their definitions
-     */
-    static validateParameters(parameters: Record<string, any> | undefined, parameterDefinitions: QueryParameterInfo[]): ParameterValidationResult;
-    /**
-     * Processes a query template with the provided parameters
-     */
-    static processQueryTemplate(query: QueryInfo, parameters: Record<string, any> | undefined): QueryProcessingResult;
-}
-//# sourceMappingURL=queryParameterProcessor.d.ts.map

package/dist/queryParameterProcessor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queryParameterProcessor.d.ts","sourceRoot":"","sources":["../src/queryParameterProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAA4B,MAAM,sBAAsB,CAAC;AAG/F;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAChC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAElD;;OAEG;IACH,OAAO,CAAC,MAAM,KAAK,WAAW,GAoB7B;IAED;;OAEG;WACW,kBAAkB,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EAC3C,oBAAoB,EAAE,kBAAkB,EAAE,GAC3C,yBAAyB;IA8H5B;;OAEG;WACW,oBAAoB,CAC9B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAC5C,qBAAqB;CAmD3B"}

package/dist/queryParameterProcessor.js

@@ -1,208 +0,0 @@
-import { RunQuerySQLFilterManager } from '@memberjunction/core';
-import nunjucks from 'nunjucks';
-/**
- * Handles parameter validation and query template processing for parameterized queries.
- * Provides type conversion, validation, and secure template processing using Nunjucks.
- */
-export class QueryParameterProcessor {
-    /**
-     * Gets or creates the Nunjucks environment with custom SQL-safe filters
-     */
-    static get nunjucksEnv() {
-        if (!this._nunjucksEnv) {
-            this._nunjucksEnv = new nunjucks.Environment(null, {
-                autoescape: false,
-                throwOnUndefined: true,
-                trimBlocks: true,
-                lstripBlocks: true
-            });
-            // Add custom SQL-safe filters from the RunQuerySQLFilterManager
-            const filterManager = RunQuerySQLFilterManager.Instance;
-            const filters = filterManager.getAllFilters();
-            for (const filter of filters) {
-                if (filter.implementation) {
-                    this._nunjucksEnv.addFilter(filter.name, filter.implementation);
-                }
-            }
-        }
-        return this._nunjucksEnv;
-    }
-    /**
-     * Validates parameters against their definitions
-     */
-    static validateParameters(parameters, parameterDefinitions) {
-        const errors = [];
-        const validatedParams = {};
-        // Process each defined parameter
-        for (const paramDef of parameterDefinitions) {
-            const value = parameters?.[paramDef.Name];
-            // Check required parameters
-            if (paramDef.IsRequired && (value === undefined || value === null || value === '')) {
-                errors.push(`Required parameter '${paramDef.Name}' is missing`);
-                continue;
-            }
-            // Use default value if not provided
-            let finalValue = value;
-            if ((finalValue === undefined || finalValue === null) && paramDef.DefaultValue !== null) {
-                try {
-                    // Parse default value based on type
-                    switch (paramDef.Type) {
-                        case 'number':
-                            finalValue = Number(paramDef.DefaultValue);
-                            break;
-                        case 'boolean':
-                            finalValue = paramDef.DefaultValue.toLowerCase() === 'true';
-                            break;
-                        case 'date':
-                            finalValue = new Date(paramDef.DefaultValue);
-                            break;
-                        case 'array':
-                            finalValue = JSON.parse(paramDef.DefaultValue);
-                            break;
-                        default:
-                            finalValue = paramDef.DefaultValue;
-                    }
-                }
-                catch (e) {
-                    errors.push(`Failed to parse default value for parameter '${paramDef.Name}': ${e.message}`);
-                    continue;
-                }
-            }
-            // Type conversion and validation
-            if (finalValue !== undefined && finalValue !== null) {
-                try {
-                    switch (paramDef.Type) {
-                        case 'string':
-                            validatedParams[paramDef.Name] = String(finalValue);
-                            break;
-                        case 'number':
-                            const num = Number(finalValue);
-                            if (isNaN(num)) {
-                                errors.push(`Parameter '${paramDef.Name}' must be a number`);
-                                continue;
-                            }
-                            validatedParams[paramDef.Name] = num;
-                            break;
-                        case 'date':
-                            const date = finalValue instanceof Date ? finalValue : new Date(finalValue);
-                            if (isNaN(date.getTime())) {
-                                errors.push(`Parameter '${paramDef.Name}' must be a valid date`);
-                                continue;
-                            }
-                            // Store as ISO string for SQL compatibility - Date.toString() produces
-                            // format like "Mon Jan 26 2026..." which SQL Server cannot parse
-                            validatedParams[paramDef.Name] = date.toISOString();
-                            break;
-                        case 'boolean':
-                            // Convert to 0/1 for SQL Server bit fields
-                            // This ensures proper SQL syntax: WHERE BitColumn = 1 (not WHERE BitColumn = true)
-                            if (typeof finalValue === 'boolean') {
-                                validatedParams[paramDef.Name] = finalValue ? 1 : 0;
-                            }
-                            else {
-                                validatedParams[paramDef.Name] = String(finalValue).toLowerCase() === 'true' ? 1 : 0;
-                            }
-                            break;
-                        case 'array':
-                            if (Array.isArray(finalValue)) {
-                                validatedParams[paramDef.Name] = finalValue;
-                            }
-                            else if (typeof finalValue === 'string') {
-                                try {
-                                    validatedParams[paramDef.Name] = JSON.parse(finalValue);
-                                }
-                                catch {
-                                    errors.push(`Parameter '${paramDef.Name}' must be a valid JSON array`);
-                                    continue;
-                                }
-                            }
-                            else {
-                                errors.push(`Parameter '${paramDef.Name}' must be an array`);
-                                continue;
-                            }
-                            break;
-                        default:
-                            validatedParams[paramDef.Name] = finalValue;
-                    }
-                    // Apply validation filters if any
-                    if (paramDef.ValidationFilters) {
-                        const filters = paramDef.ParsedFilters;
-                        for (const filter of filters) {
-                            // This is where custom validation logic would go
-                            // For now, we'll just log that we would apply filters
-                            // In a real implementation, you'd apply the filter rules
-                        }
-                    }
-                }
-                catch (e) {
-                    errors.push(`Error processing parameter '${paramDef.Name}': ${e.message}`);
-                }
-            }
-        }
-        // Check for unknown parameters
-        if (parameters) {
-            const definedParamNames = new Set(parameterDefinitions.map(p => p.Name));
-            for (const key of Object.keys(parameters)) {
-                if (!definedParamNames.has(key)) {
-                    errors.push(`Unknown parameter: '${key}'`);
-                }
-            }
-        }
-        return {
-            success: errors.length === 0,
-            errors,
-            validatedParameters: validatedParams
-        };
-    }
-    /**
-     * Processes a query template with the provided parameters
-     */
-    static processQueryTemplate(query, parameters) {
-        try {
-            // If query doesn't use templates, return the SQL as-is
-            if (!query.UsesTemplate) {
-                return {
-                    success: true,
-                    processedSQL: query.SQL,
-                    appliedParameters: {}
-                };
-            }
-            // Validate parameters
-            const validation = this.validateParameters(parameters, query.Parameters);
-            if (!validation.success) {
-                return {
-                    success: false,
-                    processedSQL: '',
-                    error: `Parameter validation failed: ${validation.errors.join('; ')}`,
-                    appliedParameters: {}
-                };
-            }
-            // Process the template
-            try {
-                const processedSQL = this.nunjucksEnv.renderString(query.SQL, validation.validatedParameters);
-                return {
-                    success: true,
-                    processedSQL,
-                    appliedParameters: validation.validatedParameters
-                };
-            }
-            catch (e) {
-                return {
-                    success: false,
-                    processedSQL: '',
-                    error: `Template processing failed: ${e.message}`,
-                    appliedParameters: validation.validatedParameters
-                };
-            }
-        }
-        catch (e) {
-            return {
-                success: false,
-                processedSQL: '',
-                error: `Unexpected error during query processing: ${e.message}`,
-                appliedParameters: {}
-            };
-        }
-    }
-}
-//# sourceMappingURL=queryParameterProcessor.js.map

package/dist/queryParameterProcessor.js.map

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