@altimateai/altimate-core 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/index.d.ts +153 -0
- package/index.js +615 -0
- package/package.json +6 -6
package/index.d.ts
ADDED
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
// ── sqlguard TypeScript type definitions ────────────────────────────── // These interfaces mirror the JSON shapes returned by sqlguard-core. // All field names are snake_case (Rust default serialization). // ── Shared / Utility ────────────────────────────────────────────────── export interface SourceLocation { line: number column: number } // ── Validation ──────────────────────────────────────────────────────── export type ErrorCode = 'E000' | 'E001' | 'E002' | 'E003' | 'E004' | 'E005' | 'E006' | 'E099' export type ErrorKind = | { type: 'SyntaxError' } | { type: 'TableNotFound'; table: string } | { type: 'ColumnNotFound'; table: string | null; column: string } | { type: 'TypeMismatch'; expected: string; found: string } | { type: 'AmbiguousColumn'; column: string; candidates: string[] } | { type: 'InvalidJoin'; reason: string } | { type: 'UnsupportedDialectFeature'; feature: string; dialect: string } | { type: 'Other'; detail: string } export type SuggestionKind = | { type: 'DidYouMean'; name: string } | { type: 'AddQualification'; qualified: string } | { type: 'UseAlternative'; alternative: string } export interface Suggestion { kind: SuggestionKind message: string confidence: number } export interface ValidationError { code: ErrorCode kind: ErrorKind message: string location: SourceLocation | null suggestions: Suggestion[] } export interface ValidationWarning { code: string message: string location: SourceLocation | null } export type Complexity = 'low' | 'medium' | 'high' export interface QueryMetadata { tables_referenced: string[] join_count: number has_aggregation: boolean has_subquery: boolean complexity: Complexity } export interface ValidationResult { valid: boolean errors: ValidationError[] warnings: ValidationWarning[] metadata: QueryMetadata } // ── Explanation ─────────────────────────────────────────────────────── export type JoinKind = | 'inner' | 'left' | 'right' | 'full' | 'cross' | 'left_semi' | 'left_anti' | 'right_semi' | 'right_anti' export interface SortKey { column: string direction: 'asc' | 'desc' nulls_first: boolean } export type PlanOperation = | { type: 'table_scan'; table: string; columns_read: string[]; filters: string[] } | { type: 'join'; join_type: JoinKind; left: string; right: string; condition: string } | { type: 'filter'; predicate: string } | { type: 'aggregate'; group_by: string[]; functions: string[] } | { type: 'sort'; order_by: SortKey[] } | { type: 'limit'; limit?: number; offset?: number } | { type: 'projection'; columns: string[] } | { type: 'window'; function: string; partition_by: string[]; order_by: string[] } | { type: 'subquery'; alias: string; inner_steps: PlanStep[] } | { type: 'union'; all: boolean; branches: number } | { type: 'distinct' } | { type: 'empty_relation' } export interface PlanStep { step: number operation: PlanOperation notes?: string } export interface ColumnRef { table: string column: string } export type ColumnSource = | { type: 'direct_ref'; table: string; column: string } | { type: 'aggregation'; function: string } | { type: 'expression'; expr: string } | { type: 'window_function'; function: string } | { type: 'literal'; value: string } export interface OutputColumn { alias: string source: ColumnSource } export interface JoinEdge { left_table: string right_table: string join_type: JoinKind on_columns: [string, string][] } export interface QueryLineage { tables: string[] columns_read: ColumnRef[] columns_output: OutputColumn[] join_graph: JoinEdge[] } export type QueryComplexity = 'low' | 'moderate' | 'high' | 'extreme' export type RiskSeverity = 'info' | 'warning' | 'critical' export interface RiskFlag { severity: RiskSeverity flag: string detail: string } export type SuggestionType = | 'add_filter' | 'add_limit' | 'avoid_cross_join' | 'remove_select_star' | 'use_specific_columns' | 'remove_redundant_distinct' | 'consider_index' export type SuggestionPriority = 'low' | 'medium' | 'high' export interface OptimizationSuggestion { kind: SuggestionType message: string priority: SuggestionPriority } export interface CostSignals { complexity: QueryComplexity complexity_score: number join_count: number has_aggregation: boolean has_subquery: boolean has_window_function: boolean has_limit: boolean has_cross_join: boolean uses_select_star: boolean has_distinct: boolean has_union: boolean table_count: number filter_count: number unfiltered_scans: string[] risk_flags: RiskFlag[] cost_estimate?: CostEstimate complexity_score_v2?: ComplexityScoreV2 } export interface QueryExplanation { summary: string plan_steps: PlanStep[] lineage: QueryLineage cost_signals: CostSignals suggestions: OptimizationSuggestion[] } export interface ValidationSummary { error_count: number warning_count: number errors: ValidationError[] warnings: ValidationWarning[] } export interface AnalysisMetadata { dialect: string plan_node_count: number analysis_time_ms: number } export interface ExplanationResult { valid: boolean explanation?: QueryExplanation validation: ValidationSummary metadata: AnalysisMetadata } // ── Fix ─────────────────────────────────────────────────────────────── export type FixActionType = | 'replace_table' | 'replace_column' | 'qualify_column' | 'remove_alias' | 'add_alias' | 'use_alternative' export interface FixAction { action: FixActionType original: string replacement: string confidence: number explanation: string location?: SourceLocation } export interface UnfixableError { error: ValidationError reason: string } export interface FixResult { original_sql: string fixed: boolean fixed_sql: string fixes_applied: FixAction[] unfixable_errors: UnfixableError[] post_fix_valid: boolean iterations: number fix_time_ms: number } // ── Policy / Guardrails ─────────────────────────────────────────────── export type PolicyCategory = 'cost_control' | 'data_protection' | 'query_patterns' | 'tag_rules' | 'custom' export type ViolationSeverity = 'error' | 'warning' | 'info' export type ViolationDetail = | { type: 'blocked_column'; table: string; column: string } | { type: 'blocked_table'; table: string } | { type: 'exceeded_limit'; metric: string; limit: number; actual: number } | { type: 'blocked_statement'; statement: string } | { type: 'blocked_pattern'; pattern: string } | { type: 'tag_violation'; tag: string; table: string; column: string } | { type: 'custom_rule'; detail: string } export interface PolicyViolation { rule: string category: PolicyCategory severity: ViolationSeverity message: string remediation?: string detail: ViolationDetail } export interface PolicyWarning { rule: string category: PolicyCategory message: string } export interface AuditEntry { timestamp: string sql_hash: string allowed: boolean violation_count: number warning_count: number policies_checked: number evaluation_time_ms: number } export interface PolicyResult { allowed: boolean violations: PolicyViolation[] warnings: PolicyWarning[] policies_evaluated: number audit: AuditEntry } // ── Lint ────────────────────────────────────────────────────────────── export type LintSeverity = 'error' | 'warning' | 'info' export interface LintFinding { code: string rule: string severity: LintSeverity message: string suggestion?: string line?: number column?: number } export interface LintResult { sql: string findings: LintFinding[] error_count: number warning_count: number clean: boolean } // ── Safety ──────────────────────────────────────────────────────────── export type SafetyRule = | 'multi_statement' | 'union_injection' | 'comment_injection' | 'transaction_escape' | 'stacked_queries' | 'tautology_attack' | 'sleep_attack' | 'info_schema_probe' | 'string_concat_predicate' | 'encoding_bypass' export type SafetySeverity = 'low' | 'medium' | 'high' | 'critical' export interface ThreatFinding { rule: SafetyRule severity: SafetySeverity message: string detail: string location?: [number, number] matched_pattern: string } export interface SafetyScanResult { safe: boolean threats: ThreatFinding[] risk_score: number statement_count: number statement_types: string[] } // ── PII ─────────────────────────────────────────────────────────────── export type PiiClassification = | 'Email' | 'Phone' | 'SSN' | 'Name' | 'Address' | 'Financial' | 'Health' | 'DateOfBirth' | 'IPAddress' | { Custom: string } | 'None' export type PiiRiskLevel = 'None' | 'Low' | 'Medium' | 'High' export interface PiiColumnResult { table: string column: string classification: PiiClassification confidence: number detection_method: string suggested_masking: string | null } export interface PiiReport { columns: PiiColumnResult[] pii_count: number total_columns: number risk_level: PiiRiskLevel } export interface PiiColumnAccess { table: string column: string classification: PiiClassification suggested_masking: string | null } export interface PiiQueryResult { accesses_pii: boolean pii_columns: PiiColumnAccess[] suggested_alternatives: string[] risk_level: PiiRiskLevel } // ── Semantic ────────────────────────────────────────────────────────── export type SemanticSeverity = 'error' | 'warning' | 'info' export interface SemanticFinding { rule: string severity: SemanticSeverity message: string explanation: string suggestion?: string confidence: number } export interface SemanticResult { valid: boolean semantic_score: number findings: SemanticFinding[] passed_checks: string[] validation_errors: string[] } // ── Cost / Complexity ───────────────────────────────────────────────── export type CostTier = 'cheap' | 'moderate' | 'expensive' | 'dangerous' | 'unknown' export type EstimationConfidence = 'high' | 'medium' | 'low' export type EstimationMethod = 'historical_median' | 'explain_corrected' | 'static_analysis' | 'mixed' export type RecommendationPriority = 'high' | 'medium' | 'low' export interface CostRange { low: number expected: number high: number } export interface TableCostBreakdown { table: string bytes_scanned: number estimated_rows: number selectivity: number has_statistics: boolean } export interface CostRecommendation { action: string detail: string estimated_savings_pct: number priority: RecommendationPriority } export interface TimeCostEstimate { estimated_execution_secs: number billable_secs: number warehouse_size: string credits: number cost_usd: number query_type: string query_type_multiplier: number } export interface CostEstimate { bytes_scanned: number cost_usd: number cost_tier: CostTier table_breakdown: TableCostBreakdown[] warnings: string[] disclaimer?: string cost_range?: CostRange recommendations?: CostRecommendation[] confidence: EstimationConfidence confidence_factors?: string[] estimation_method?: EstimationMethod time_based_cost?: TimeCostEstimate } export type ComplexityTier = 'simple' | 'moderate' | 'complex' | 'very_complex' | 'extreme' export interface DimensionScore { score: number max: number factors: string[] } export interface ComplexityFactor { name: string points: number description: string } export interface ComplexityScoreV2 { total: number structural: DimensionScore semantic: DimensionScore cost: DimensionScore tier: ComplexityTier factors: ComplexityFactor[] } // ── Equivalence ─────────────────────────────────────────────────────── export type DiffSeverity = 'structural' | 'semantic' | 'minor' export interface EquivalenceDiff { aspect: string description: string severity: DiffSeverity } export interface EquivalenceResult { equivalent: boolean confidence: number differences: EquivalenceDiff[] output_compatible: boolean validation_errors: string[] } // ── Correction ──────────────────────────────────────────────────────── export type CorrectionStatus = 'already_valid' | 'fixed' | 'partial_fix' | 'unfixable' export type IterationResult = 'fixed' | 'still_invalid' | 'new_errors' | 'skipped' export interface CorrectionIteration { iteration: number input_sql: string validation_errors: string[] fix_applied?: string fix_description?: string result: IterationResult } export interface QualityScore { syntax_valid: boolean lint_score: number safety_score: number complexity_score: number overall: number } export interface CorrectionResult { status: CorrectionStatus original_sql: string corrected_sql?: string iterations: CorrectionIteration[] final_validation?: any final_score: QualityScore total_time_ms: number } // ── Evaluation / Observability ──────────────────────────────────────── export type Grade = 'A' | 'B' | 'C' | 'D' | 'F' export interface QualityScorecard { syntax: number style: number safety: number complexity: number overall: number } export interface EvalResult { sql: string scores: QualityScorecard validation?: any lint?: any safety?: any explain?: any overall_grade: Grade total_time_ms: number } // ── Polyglot ────────────────────────────────────────────────────────── export interface TranspileResult { original_sql: string source_dialect: string target_dialect: string transpiled_sql: string[] success: boolean error?: string } export interface FormatResult { original_sql: string formatted_sql: string dialect: string success: boolean error?: string } export interface ExtractResult { tables: string[] columns: string[] functions: string[] has_subqueries: boolean has_aggregation: boolean has_window_functions: boolean node_count: number } export interface DiffEntry { change_type: string description: string } export interface CompareResult { identical: boolean diff_count: number diffs: DiffEntry[] } // ── Completion ──────────────────────────────────────────────────────── export type CompletionKind = 'table' | 'column' | 'function' | 'keyword' | 'alias' | 'join_condition' | 'schema' export interface CompletionItem { label: string kind: CompletionKind detail: string documentation?: string score: number } export interface CompletionResult { cursor_offset: number context: string items: CompletionItem[] } // ── Rewrite ─────────────────────────────────────────────────────────── export interface RewriteSuggestion { rule: string explanation: string rewritten_sql: string improvement: string confidence: number } export interface IndexSuggestion { table: string columns: string[] reason: string ddl: string } export interface RewriteResult { original_sql: string suggestions: RewriteSuggestion[] index_suggestions: IndexSuggestion[] } // ── Test Generation ─────────────────────────────────────────────────── export type TestExpectation = 'returns_rows' | 'returns_empty' | 'should_error' | { row_count: number } export interface TestInput { column: string value: string data_type: string } export interface TestCase { name: string category: string description: string inputs: TestInput[] expected: TestExpectation } export interface TestGenResult { sql: string test_cases: TestCase[] columns_analyzed: string[] tables_referenced: string[] } // ── Migration ───────────────────────────────────────────────────────── export type MigrationRisk = 'safe' | 'caution' | 'dangerous' | 'destructive' export interface MigrationFinding { risk: MigrationRisk operation: string message: string mitigation?: string rollback_sql?: string } export interface MigrationResult { sql: string overall_risk: MigrationRisk findings: MigrationFinding[] safe: boolean rollback_sql?: string } // ── dbt ─────────────────────────────────────────────────────────────── export interface DbtSourceRef { source_name: string table_name: string } export interface DbtModel { name: string path: string sql: string raw_sql: string materialization?: string description?: string refs: string[] sources: DbtSourceRef[] } export interface DbtProject { name: string models: DbtModel[] build_order: string[] warnings: string[] } // ── Lineage ─────────────────────────────────────────────────────────── export type LineageType = 'direct' | 'indirect' export type LensClassification = 'Original' | 'Alias' | 'Transformation' | 'Not sure' | 'Non select' export interface LensStep { expression: string step_type: string } export interface LineageEntry { source: string target: string lineage_type: LineageType lens_type: LensClassification lens_code: LensStep[] } export interface CompleteLineageResult { column_dict: Record<string, string[]> column_lineage: LineageEntry[] source_tables: string[] errors: string[] default_database: string | null default_schema: string | null } export interface LineageColumnRef { table: string column: string } export interface LineageEdge { source: LineageColumnRef target: LineageColumnRef transform_type: string } export interface LineageQueryInfo { source_tables: string[] target_tables: string[] edges: LineageEdge[] output_columns: string[] } export interface ImpactEntry { source: LineageColumnRef affected: LineageColumnRef[] } export interface LineageResult { queries: LineageQueryInfo[] dependency_order: string[] impact_map: ImpactEntry[] } // ── Context ─────────────────────────────────────────────────────────── export type DisclosureLevel = 'fingerprint' | 'table_list' | 'column_names' | 'full_relevant' | 'full' export interface ContextResult { compressed_schema: string level_used: DisclosureLevel estimated_tokens: number tables_included: number tables_total: number compression_ratio: number fingerprint: string } // ── Schema Diff ─────────────────────────────────────────────────────── export type SchemaChange = | { type: 'table_added'; table: string } | { type: 'table_removed'; table: string } | { type: 'column_added'; table: string; column: string; data_type: string } | { type: 'column_removed'; table: string; column: string } | { type: 'column_type_changed'; table: string; column: string; old_type: string; new_type: string } | { type: 'nullability_changed'; table: string; column: string; old_nullable: boolean; new_nullable: boolean } export interface SchemaDiff { changes: SchemaChange[] has_breaking_changes: boolean summary: string } // ── Schema Definition (pruned) ──────────────────────────────────────── export interface McvEntry { value: string frequency: number } export interface ColumnStatistics { n_distinct?: number null_fraction?: number min_value?: string max_value?: string most_common_values?: McvEntry[] avg_bytes?: number compression_ratio?: number } export interface ForeignKeyRef { table: string columns: string[] } export interface ForeignKeyDef { columns: string[] references: ForeignKeyRef } export interface TableStatistics { row_count?: number avg_row_bytes?: number partitioned?: boolean partition_columns?: string[] correlated_columns?: string[][] partition_count?: number total_bytes?: number historical_scan_median?: number } export interface ColumnDef { name: string type: string nullable: boolean description?: string tags?: string[] synonyms?: string[] statistics?: ColumnStatistics } export interface TableDef { description?: string database?: string schema?: string columns: ColumnDef[] primary_key?: string[] foreign_keys?: ForeignKeyDef[] statistics?: TableStatistics clustering_keys?: string[] } export interface SchemaDefinition { version: string dialect: string database: string | null schema_name: string | null tables: Record<string, TableDef> glossary?: any } // ── Introspection ───────────────────────────────────────────────────── export interface IntrospectionSql { database_type: string columns_query: string primary_keys_query: string foreign_keys_query: string } // ── Glossary ────────────────────────────────────────────────────────── export interface ColumnReference { table: string column: string } export type MatchSource = 'ExactTerm' | 'Synonym' | 'Description' | 'FuzzyName' | 'ColumnSynonym' export interface GlossaryMatch { term: string matched_column: ColumnReference | null matched_definition: string | null confidence: number source: MatchSource }/**
|
|
2
|
+
* Schema definition for SQL validation.
|
|
3
|
+
*
|
|
4
|
+
* Load from YAML, JSON, file, or DDL. Pass to validation functions.
|
|
5
|
+
*/
|
|
6
|
+
export declare class Schema {
|
|
7
|
+
/** Load schema from a YAML string. */
|
|
8
|
+
static fromYaml(yamlStr: string): Schema
|
|
9
|
+
/** Load schema from a JSON string. */
|
|
10
|
+
static fromJson(jsonStr: string): Schema
|
|
11
|
+
/** Load schema from a YAML or JSON file (auto-detected by extension). */
|
|
12
|
+
static fromFile(path: string): Schema
|
|
13
|
+
/** Load schema from a YAML file. */
|
|
14
|
+
static fromYamlFile(path: string): Schema
|
|
15
|
+
/** Parse DDL statements into a schema. */
|
|
16
|
+
static fromDdl(ddl: string, dialect?: string | undefined | null): Schema
|
|
17
|
+
/** Return all table names in the schema. */
|
|
18
|
+
tableNames(): Array<string>
|
|
19
|
+
/** Return column names for a specific table, or null if table not found. */
|
|
20
|
+
columnNames(table: string): Array<string> | null
|
|
21
|
+
/** Serialize the schema to a JSON object. */
|
|
22
|
+
toJson(): SchemaDefinition
|
|
23
|
+
/** Serialize the schema to a JSON string. */
|
|
24
|
+
toString(): string
|
|
25
|
+
/** Number of tables in the schema. */
|
|
26
|
+
get length(): number
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/** Analyze migration safety (data loss, type narrowing, missing defaults). */
|
|
30
|
+
export declare function analyzeMigration(sql: string, schema: Schema): MigrationResult
|
|
31
|
+
|
|
32
|
+
/** Check two SQL queries for semantic equivalence. */
|
|
33
|
+
export declare function checkEquivalence(sqlA: string, sqlB: string, schema: Schema): Promise<EquivalenceResult>
|
|
34
|
+
|
|
35
|
+
/** Check SQL against policy guardrails. `policyJson` is a JSON string of PolicyConfig. */
|
|
36
|
+
export declare function checkPolicy(sql: string, schema: Schema, policyJson: string): Promise<PolicyResult>
|
|
37
|
+
|
|
38
|
+
/** Check if a query accesses PII columns. */
|
|
39
|
+
export declare function checkQueryPii(sql: string, schema: Schema): PiiQueryResult
|
|
40
|
+
|
|
41
|
+
/** Run semantic validation rules (cartesian products, wrong JOINs, NULL misuse). */
|
|
42
|
+
export declare function checkSemantics(sql: string, schema: Schema): Promise<SemanticResult>
|
|
43
|
+
|
|
44
|
+
/** Classify schema columns for PII exposure. */
|
|
45
|
+
export declare function classifyPii(schema: Schema): PiiReport
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Compute column-level lineage for a SQL query.
|
|
49
|
+
*
|
|
50
|
+
* Returns an object with `column_dict` (output->sources mapping) and
|
|
51
|
+
* `column_lineage` (detailed edge list).
|
|
52
|
+
*
|
|
53
|
+
* Pass `defaultDatabase` and `defaultSchema` to qualify unqualified table
|
|
54
|
+
* references (important for Snowflake lineage matching).
|
|
55
|
+
*/
|
|
56
|
+
export declare function columnLineage(sql: string, dialect?: string | undefined | null, schema?: Schema | undefined | null, defaultDatabase?: string | undefined | null, defaultSchema?: string | undefined | null): CompleteLineageResult
|
|
57
|
+
|
|
58
|
+
/** Compare two SQL queries structurally. */
|
|
59
|
+
export declare function compareQueries(leftSql: string, rightSql: string, dialect?: string | undefined | null): CompareResult
|
|
60
|
+
|
|
61
|
+
/** SQL completion engine: suggest tables, columns, functions, keywords at cursor position. */
|
|
62
|
+
export declare function complete(sql: string, cursorPos: number, schema: Schema): CompletionResult
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Compute a multi-dimensional complexity score (0-100) for a SQL query.
|
|
66
|
+
*
|
|
67
|
+
* Combines structural, semantic, and cost dimensions. Returns tier classification
|
|
68
|
+
* (Trivial, Simple, Moderate, Complex, VeryComplex).
|
|
69
|
+
*/
|
|
70
|
+
export declare function complexityScore(sql: string, schema: Schema): Promise<ComplexityScoreV2>
|
|
71
|
+
|
|
72
|
+
/** Iterative correction protocol: propose-verify-refine loop. */
|
|
73
|
+
export declare function correct(sql: string, schema: Schema): Promise<CorrectionResult>
|
|
74
|
+
|
|
75
|
+
/** Diff two schemas with breaking change detection. */
|
|
76
|
+
export declare function diffSchemas(oldSchema: Schema, newSchema: Schema): SchemaDiff
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Estimate bytes scanned and USD cost for a SQL query.
|
|
80
|
+
*
|
|
81
|
+
* Internally runs `explain` to get plan steps, then feeds them to the cost
|
|
82
|
+
* estimator. The `dialect` determines pricing model (BigQuery, Snowflake, etc.).
|
|
83
|
+
*/
|
|
84
|
+
export declare function estimateCost(sql: string, schema: Schema, dialect?: string | undefined | null): Promise<CostEstimate>
|
|
85
|
+
|
|
86
|
+
/** SQL quality scoring and grading (A-F scale). */
|
|
87
|
+
export declare function evaluate(sql: string, schema: Schema): Promise<EvalResult>
|
|
88
|
+
|
|
89
|
+
/** Explain a SQL query: plan steps, column lineage, cost signals. */
|
|
90
|
+
export declare function explain(sql: string, schema: Schema): Promise<ExplanationResult>
|
|
91
|
+
|
|
92
|
+
/** Export schema as CREATE TABLE DDL statements. */
|
|
93
|
+
export declare function exportDdl(schema: Schema): string
|
|
94
|
+
|
|
95
|
+
/** Extract metadata (tables, columns, functions) from SQL. */
|
|
96
|
+
export declare function extractMetadata(sql: string, dialect?: string | undefined | null): ExtractResult
|
|
97
|
+
|
|
98
|
+
/** Extract the output column names from a SQL SELECT list. */
|
|
99
|
+
export declare function extractOutputColumns(sql: string, dialect?: string | undefined | null): string[]
|
|
100
|
+
|
|
101
|
+
/** Auto-fix SQL errors using fuzzy matching and iterative re-validation. */
|
|
102
|
+
export declare function fix(sql: string, schema: Schema, maxIterations?: number | undefined | null): Promise<FixResult>
|
|
103
|
+
|
|
104
|
+
/** Format / pretty-print SQL for a dialect. */
|
|
105
|
+
export declare function formatSql(sql: string, dialect?: string | undefined | null): FormatResult
|
|
106
|
+
|
|
107
|
+
/** Generate test cases for a SQL query (boundary values, NULLs, edge cases). */
|
|
108
|
+
export declare function generateTests(sql: string, schema: Schema): TestGenResult
|
|
109
|
+
|
|
110
|
+
/** Import DDL into a Schema. */
|
|
111
|
+
export declare function importDdl(ddl: string, dialect?: string | undefined | null): Schema
|
|
112
|
+
|
|
113
|
+
/** Generate INFORMATION_SCHEMA introspection queries for a database. */
|
|
114
|
+
export declare function introspectionSql(dbType: string, database: string, schemaName?: string | undefined | null): IntrospectionSql
|
|
115
|
+
|
|
116
|
+
/** Quick boolean check: is this SQL safe from injection? */
|
|
117
|
+
export declare function isSafe(sql: string): boolean
|
|
118
|
+
|
|
119
|
+
/** Lint SQL for anti-patterns (SELECT *, missing WHERE, etc.). */
|
|
120
|
+
export declare function lint(sql: string, schema: Schema): LintResult
|
|
121
|
+
|
|
122
|
+
/** Optimize schema for context window (5-level progressive disclosure). */
|
|
123
|
+
export declare function optimizeContext(schema: Schema): ContextResult
|
|
124
|
+
|
|
125
|
+
/** Optimize schema for a specific query (prune to relevant tables/columns). */
|
|
126
|
+
export declare function optimizeForQuery(sql: string, schema: Schema): ContextResult
|
|
127
|
+
|
|
128
|
+
/** Parse a dbt project directory. */
|
|
129
|
+
export declare function parseDbtProject(projectDir: string): DbtProject
|
|
130
|
+
|
|
131
|
+
/** Prune schema to only tables/columns referenced by a SQL query. */
|
|
132
|
+
export declare function pruneSchema(sql: string, schema: Schema): SchemaDefinition
|
|
133
|
+
|
|
134
|
+
/** Resolve a business term to schema elements via fuzzy matching. */
|
|
135
|
+
export declare function resolveTerm(term: string, schema: Schema): GlossaryMatch
|
|
136
|
+
|
|
137
|
+
/** Suggest query rewrites and optimizations. */
|
|
138
|
+
export declare function rewrite(sql: string, schema: Schema): RewriteResult
|
|
139
|
+
|
|
140
|
+
/** Scan SQL for injection threats (10 detection rules). */
|
|
141
|
+
export declare function scanSql(sql: string): SafetyScanResult
|
|
142
|
+
|
|
143
|
+
/** Compute a SHA-256 fingerprint of the schema (for caching/change detection). */
|
|
144
|
+
export declare function schemaFingerprint(schema: Schema): string
|
|
145
|
+
|
|
146
|
+
/** Track column-level lineage across multiple queries. */
|
|
147
|
+
export declare function trackLineage(queries: Array<string>, schema: Schema): LineageResult
|
|
148
|
+
|
|
149
|
+
/** Transpile SQL from one dialect to another. */
|
|
150
|
+
export declare function transpile(sql: string, source: string, target: string): TranspileResult
|
|
151
|
+
|
|
152
|
+
/** Validate SQL against a schema. Returns an object with `valid`, `errors`, `warnings`. */
|
|
153
|
+
export declare function validate(sql: string, schema: Schema): Promise<ValidationResult>
|
package/index.js
ADDED
|
@@ -0,0 +1,615 @@
|
|
|
1
|
+
// prettier-ignore
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
// @ts-nocheck
|
|
4
|
+
/* auto-generated by NAPI-RS */
|
|
5
|
+
|
|
6
|
+
const { readFileSync } = require('node:fs')
|
|
7
|
+
let nativeBinding = null
|
|
8
|
+
const loadErrors = []
|
|
9
|
+
|
|
10
|
+
const isMusl = () => {
|
|
11
|
+
let musl = false
|
|
12
|
+
if (process.platform === 'linux') {
|
|
13
|
+
musl = isMuslFromFilesystem()
|
|
14
|
+
if (musl === null) {
|
|
15
|
+
musl = isMuslFromReport()
|
|
16
|
+
}
|
|
17
|
+
if (musl === null) {
|
|
18
|
+
musl = isMuslFromChildProcess()
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
return musl
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
|
|
25
|
+
|
|
26
|
+
const isMuslFromFilesystem = () => {
|
|
27
|
+
try {
|
|
28
|
+
return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
|
|
29
|
+
} catch {
|
|
30
|
+
return null
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
const isMuslFromReport = () => {
|
|
35
|
+
let report = null
|
|
36
|
+
if (typeof process.report?.getReport === 'function') {
|
|
37
|
+
process.report.excludeNetwork = true
|
|
38
|
+
report = process.report.getReport()
|
|
39
|
+
}
|
|
40
|
+
if (!report) {
|
|
41
|
+
return null
|
|
42
|
+
}
|
|
43
|
+
if (report.header && report.header.glibcVersionRuntime) {
|
|
44
|
+
return false
|
|
45
|
+
}
|
|
46
|
+
if (Array.isArray(report.sharedObjects)) {
|
|
47
|
+
if (report.sharedObjects.some(isFileMusl)) {
|
|
48
|
+
return true
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
return false
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
const isMuslFromChildProcess = () => {
|
|
55
|
+
try {
|
|
56
|
+
return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
|
|
57
|
+
} catch (e) {
|
|
58
|
+
// If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
|
|
59
|
+
return false
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
function requireNative() {
|
|
64
|
+
if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
|
|
65
|
+
try {
|
|
66
|
+
return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
|
|
67
|
+
} catch (err) {
|
|
68
|
+
loadErrors.push(err)
|
|
69
|
+
}
|
|
70
|
+
} else if (process.platform === 'android') {
|
|
71
|
+
if (process.arch === 'arm64') {
|
|
72
|
+
try {
|
|
73
|
+
return require('./altimate-core.android-arm64.node')
|
|
74
|
+
} catch (e) {
|
|
75
|
+
loadErrors.push(e)
|
|
76
|
+
}
|
|
77
|
+
try {
|
|
78
|
+
const binding = require('@altimateai/altimate-core-android-arm64')
|
|
79
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-android-arm64/package.json').version
|
|
80
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
81
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
82
|
+
}
|
|
83
|
+
return binding
|
|
84
|
+
} catch (e) {
|
|
85
|
+
loadErrors.push(e)
|
|
86
|
+
}
|
|
87
|
+
} else if (process.arch === 'arm') {
|
|
88
|
+
try {
|
|
89
|
+
return require('./altimate-core.android-arm-eabi.node')
|
|
90
|
+
} catch (e) {
|
|
91
|
+
loadErrors.push(e)
|
|
92
|
+
}
|
|
93
|
+
try {
|
|
94
|
+
const binding = require('@altimateai/altimate-core-android-arm-eabi')
|
|
95
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-android-arm-eabi/package.json').version
|
|
96
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
97
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
98
|
+
}
|
|
99
|
+
return binding
|
|
100
|
+
} catch (e) {
|
|
101
|
+
loadErrors.push(e)
|
|
102
|
+
}
|
|
103
|
+
} else {
|
|
104
|
+
loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
|
|
105
|
+
}
|
|
106
|
+
} else if (process.platform === 'win32') {
|
|
107
|
+
if (process.arch === 'x64') {
|
|
108
|
+
if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
|
|
109
|
+
try {
|
|
110
|
+
return require('./altimate-core.win32-x64-gnu.node')
|
|
111
|
+
} catch (e) {
|
|
112
|
+
loadErrors.push(e)
|
|
113
|
+
}
|
|
114
|
+
try {
|
|
115
|
+
const binding = require('@altimateai/altimate-core-win32-x64-gnu')
|
|
116
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-win32-x64-gnu/package.json').version
|
|
117
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
118
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
119
|
+
}
|
|
120
|
+
return binding
|
|
121
|
+
} catch (e) {
|
|
122
|
+
loadErrors.push(e)
|
|
123
|
+
}
|
|
124
|
+
} else {
|
|
125
|
+
try {
|
|
126
|
+
return require('./altimate-core.win32-x64-msvc.node')
|
|
127
|
+
} catch (e) {
|
|
128
|
+
loadErrors.push(e)
|
|
129
|
+
}
|
|
130
|
+
try {
|
|
131
|
+
const binding = require('@altimateai/altimate-core-win32-x64-msvc')
|
|
132
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-win32-x64-msvc/package.json').version
|
|
133
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
134
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
135
|
+
}
|
|
136
|
+
return binding
|
|
137
|
+
} catch (e) {
|
|
138
|
+
loadErrors.push(e)
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
} else if (process.arch === 'ia32') {
|
|
142
|
+
try {
|
|
143
|
+
return require('./altimate-core.win32-ia32-msvc.node')
|
|
144
|
+
} catch (e) {
|
|
145
|
+
loadErrors.push(e)
|
|
146
|
+
}
|
|
147
|
+
try {
|
|
148
|
+
const binding = require('@altimateai/altimate-core-win32-ia32-msvc')
|
|
149
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-win32-ia32-msvc/package.json').version
|
|
150
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
151
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
152
|
+
}
|
|
153
|
+
return binding
|
|
154
|
+
} catch (e) {
|
|
155
|
+
loadErrors.push(e)
|
|
156
|
+
}
|
|
157
|
+
} else if (process.arch === 'arm64') {
|
|
158
|
+
try {
|
|
159
|
+
return require('./altimate-core.win32-arm64-msvc.node')
|
|
160
|
+
} catch (e) {
|
|
161
|
+
loadErrors.push(e)
|
|
162
|
+
}
|
|
163
|
+
try {
|
|
164
|
+
const binding = require('@altimateai/altimate-core-win32-arm64-msvc')
|
|
165
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-win32-arm64-msvc/package.json').version
|
|
166
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
167
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
168
|
+
}
|
|
169
|
+
return binding
|
|
170
|
+
} catch (e) {
|
|
171
|
+
loadErrors.push(e)
|
|
172
|
+
}
|
|
173
|
+
} else {
|
|
174
|
+
loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
|
|
175
|
+
}
|
|
176
|
+
} else if (process.platform === 'darwin') {
|
|
177
|
+
try {
|
|
178
|
+
return require('./altimate-core.darwin-universal.node')
|
|
179
|
+
} catch (e) {
|
|
180
|
+
loadErrors.push(e)
|
|
181
|
+
}
|
|
182
|
+
try {
|
|
183
|
+
const binding = require('@altimateai/altimate-core-darwin-universal')
|
|
184
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-darwin-universal/package.json').version
|
|
185
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
186
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
187
|
+
}
|
|
188
|
+
return binding
|
|
189
|
+
} catch (e) {
|
|
190
|
+
loadErrors.push(e)
|
|
191
|
+
}
|
|
192
|
+
if (process.arch === 'x64') {
|
|
193
|
+
try {
|
|
194
|
+
return require('./altimate-core.darwin-x64.node')
|
|
195
|
+
} catch (e) {
|
|
196
|
+
loadErrors.push(e)
|
|
197
|
+
}
|
|
198
|
+
try {
|
|
199
|
+
const binding = require('@altimateai/altimate-core-darwin-x64')
|
|
200
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-darwin-x64/package.json').version
|
|
201
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
202
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
203
|
+
}
|
|
204
|
+
return binding
|
|
205
|
+
} catch (e) {
|
|
206
|
+
loadErrors.push(e)
|
|
207
|
+
}
|
|
208
|
+
} else if (process.arch === 'arm64') {
|
|
209
|
+
try {
|
|
210
|
+
return require('./altimate-core.darwin-arm64.node')
|
|
211
|
+
} catch (e) {
|
|
212
|
+
loadErrors.push(e)
|
|
213
|
+
}
|
|
214
|
+
try {
|
|
215
|
+
const binding = require('@altimateai/altimate-core-darwin-arm64')
|
|
216
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-darwin-arm64/package.json').version
|
|
217
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
218
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
219
|
+
}
|
|
220
|
+
return binding
|
|
221
|
+
} catch (e) {
|
|
222
|
+
loadErrors.push(e)
|
|
223
|
+
}
|
|
224
|
+
} else {
|
|
225
|
+
loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
|
|
226
|
+
}
|
|
227
|
+
} else if (process.platform === 'freebsd') {
|
|
228
|
+
if (process.arch === 'x64') {
|
|
229
|
+
try {
|
|
230
|
+
return require('./altimate-core.freebsd-x64.node')
|
|
231
|
+
} catch (e) {
|
|
232
|
+
loadErrors.push(e)
|
|
233
|
+
}
|
|
234
|
+
try {
|
|
235
|
+
const binding = require('@altimateai/altimate-core-freebsd-x64')
|
|
236
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-freebsd-x64/package.json').version
|
|
237
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
238
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
239
|
+
}
|
|
240
|
+
return binding
|
|
241
|
+
} catch (e) {
|
|
242
|
+
loadErrors.push(e)
|
|
243
|
+
}
|
|
244
|
+
} else if (process.arch === 'arm64') {
|
|
245
|
+
try {
|
|
246
|
+
return require('./altimate-core.freebsd-arm64.node')
|
|
247
|
+
} catch (e) {
|
|
248
|
+
loadErrors.push(e)
|
|
249
|
+
}
|
|
250
|
+
try {
|
|
251
|
+
const binding = require('@altimateai/altimate-core-freebsd-arm64')
|
|
252
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-freebsd-arm64/package.json').version
|
|
253
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
254
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
255
|
+
}
|
|
256
|
+
return binding
|
|
257
|
+
} catch (e) {
|
|
258
|
+
loadErrors.push(e)
|
|
259
|
+
}
|
|
260
|
+
} else {
|
|
261
|
+
loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
|
|
262
|
+
}
|
|
263
|
+
} else if (process.platform === 'linux') {
|
|
264
|
+
if (process.arch === 'x64') {
|
|
265
|
+
if (isMusl()) {
|
|
266
|
+
try {
|
|
267
|
+
return require('./altimate-core.linux-x64-musl.node')
|
|
268
|
+
} catch (e) {
|
|
269
|
+
loadErrors.push(e)
|
|
270
|
+
}
|
|
271
|
+
try {
|
|
272
|
+
const binding = require('@altimateai/altimate-core-linux-x64-musl')
|
|
273
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-x64-musl/package.json').version
|
|
274
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
275
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
276
|
+
}
|
|
277
|
+
return binding
|
|
278
|
+
} catch (e) {
|
|
279
|
+
loadErrors.push(e)
|
|
280
|
+
}
|
|
281
|
+
} else {
|
|
282
|
+
try {
|
|
283
|
+
return require('./altimate-core.linux-x64-gnu.node')
|
|
284
|
+
} catch (e) {
|
|
285
|
+
loadErrors.push(e)
|
|
286
|
+
}
|
|
287
|
+
try {
|
|
288
|
+
const binding = require('@altimateai/altimate-core-linux-x64-gnu')
|
|
289
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-x64-gnu/package.json').version
|
|
290
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
291
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
292
|
+
}
|
|
293
|
+
return binding
|
|
294
|
+
} catch (e) {
|
|
295
|
+
loadErrors.push(e)
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
} else if (process.arch === 'arm64') {
|
|
299
|
+
if (isMusl()) {
|
|
300
|
+
try {
|
|
301
|
+
return require('./altimate-core.linux-arm64-musl.node')
|
|
302
|
+
} catch (e) {
|
|
303
|
+
loadErrors.push(e)
|
|
304
|
+
}
|
|
305
|
+
try {
|
|
306
|
+
const binding = require('@altimateai/altimate-core-linux-arm64-musl')
|
|
307
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-arm64-musl/package.json').version
|
|
308
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
309
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
310
|
+
}
|
|
311
|
+
return binding
|
|
312
|
+
} catch (e) {
|
|
313
|
+
loadErrors.push(e)
|
|
314
|
+
}
|
|
315
|
+
} else {
|
|
316
|
+
try {
|
|
317
|
+
return require('./altimate-core.linux-arm64-gnu.node')
|
|
318
|
+
} catch (e) {
|
|
319
|
+
loadErrors.push(e)
|
|
320
|
+
}
|
|
321
|
+
try {
|
|
322
|
+
const binding = require('@altimateai/altimate-core-linux-arm64-gnu')
|
|
323
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-arm64-gnu/package.json').version
|
|
324
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
325
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
326
|
+
}
|
|
327
|
+
return binding
|
|
328
|
+
} catch (e) {
|
|
329
|
+
loadErrors.push(e)
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
} else if (process.arch === 'arm') {
|
|
333
|
+
if (isMusl()) {
|
|
334
|
+
try {
|
|
335
|
+
return require('./altimate-core.linux-arm-musleabihf.node')
|
|
336
|
+
} catch (e) {
|
|
337
|
+
loadErrors.push(e)
|
|
338
|
+
}
|
|
339
|
+
try {
|
|
340
|
+
const binding = require('@altimateai/altimate-core-linux-arm-musleabihf')
|
|
341
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-arm-musleabihf/package.json').version
|
|
342
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
343
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
344
|
+
}
|
|
345
|
+
return binding
|
|
346
|
+
} catch (e) {
|
|
347
|
+
loadErrors.push(e)
|
|
348
|
+
}
|
|
349
|
+
} else {
|
|
350
|
+
try {
|
|
351
|
+
return require('./altimate-core.linux-arm-gnueabihf.node')
|
|
352
|
+
} catch (e) {
|
|
353
|
+
loadErrors.push(e)
|
|
354
|
+
}
|
|
355
|
+
try {
|
|
356
|
+
const binding = require('@altimateai/altimate-core-linux-arm-gnueabihf')
|
|
357
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-arm-gnueabihf/package.json').version
|
|
358
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
359
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
360
|
+
}
|
|
361
|
+
return binding
|
|
362
|
+
} catch (e) {
|
|
363
|
+
loadErrors.push(e)
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
} else if (process.arch === 'loong64') {
|
|
367
|
+
if (isMusl()) {
|
|
368
|
+
try {
|
|
369
|
+
return require('./altimate-core.linux-loong64-musl.node')
|
|
370
|
+
} catch (e) {
|
|
371
|
+
loadErrors.push(e)
|
|
372
|
+
}
|
|
373
|
+
try {
|
|
374
|
+
const binding = require('@altimateai/altimate-core-linux-loong64-musl')
|
|
375
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-loong64-musl/package.json').version
|
|
376
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
377
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
378
|
+
}
|
|
379
|
+
return binding
|
|
380
|
+
} catch (e) {
|
|
381
|
+
loadErrors.push(e)
|
|
382
|
+
}
|
|
383
|
+
} else {
|
|
384
|
+
try {
|
|
385
|
+
return require('./altimate-core.linux-loong64-gnu.node')
|
|
386
|
+
} catch (e) {
|
|
387
|
+
loadErrors.push(e)
|
|
388
|
+
}
|
|
389
|
+
try {
|
|
390
|
+
const binding = require('@altimateai/altimate-core-linux-loong64-gnu')
|
|
391
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-loong64-gnu/package.json').version
|
|
392
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
393
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
394
|
+
}
|
|
395
|
+
return binding
|
|
396
|
+
} catch (e) {
|
|
397
|
+
loadErrors.push(e)
|
|
398
|
+
}
|
|
399
|
+
}
|
|
400
|
+
} else if (process.arch === 'riscv64') {
|
|
401
|
+
if (isMusl()) {
|
|
402
|
+
try {
|
|
403
|
+
return require('./altimate-core.linux-riscv64-musl.node')
|
|
404
|
+
} catch (e) {
|
|
405
|
+
loadErrors.push(e)
|
|
406
|
+
}
|
|
407
|
+
try {
|
|
408
|
+
const binding = require('@altimateai/altimate-core-linux-riscv64-musl')
|
|
409
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-riscv64-musl/package.json').version
|
|
410
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
411
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
412
|
+
}
|
|
413
|
+
return binding
|
|
414
|
+
} catch (e) {
|
|
415
|
+
loadErrors.push(e)
|
|
416
|
+
}
|
|
417
|
+
} else {
|
|
418
|
+
try {
|
|
419
|
+
return require('./altimate-core.linux-riscv64-gnu.node')
|
|
420
|
+
} catch (e) {
|
|
421
|
+
loadErrors.push(e)
|
|
422
|
+
}
|
|
423
|
+
try {
|
|
424
|
+
const binding = require('@altimateai/altimate-core-linux-riscv64-gnu')
|
|
425
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-riscv64-gnu/package.json').version
|
|
426
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
427
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
428
|
+
}
|
|
429
|
+
return binding
|
|
430
|
+
} catch (e) {
|
|
431
|
+
loadErrors.push(e)
|
|
432
|
+
}
|
|
433
|
+
}
|
|
434
|
+
} else if (process.arch === 'ppc64') {
|
|
435
|
+
try {
|
|
436
|
+
return require('./altimate-core.linux-ppc64-gnu.node')
|
|
437
|
+
} catch (e) {
|
|
438
|
+
loadErrors.push(e)
|
|
439
|
+
}
|
|
440
|
+
try {
|
|
441
|
+
const binding = require('@altimateai/altimate-core-linux-ppc64-gnu')
|
|
442
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-ppc64-gnu/package.json').version
|
|
443
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
444
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
445
|
+
}
|
|
446
|
+
return binding
|
|
447
|
+
} catch (e) {
|
|
448
|
+
loadErrors.push(e)
|
|
449
|
+
}
|
|
450
|
+
} else if (process.arch === 's390x') {
|
|
451
|
+
try {
|
|
452
|
+
return require('./altimate-core.linux-s390x-gnu.node')
|
|
453
|
+
} catch (e) {
|
|
454
|
+
loadErrors.push(e)
|
|
455
|
+
}
|
|
456
|
+
try {
|
|
457
|
+
const binding = require('@altimateai/altimate-core-linux-s390x-gnu')
|
|
458
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-linux-s390x-gnu/package.json').version
|
|
459
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
460
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
461
|
+
}
|
|
462
|
+
return binding
|
|
463
|
+
} catch (e) {
|
|
464
|
+
loadErrors.push(e)
|
|
465
|
+
}
|
|
466
|
+
} else {
|
|
467
|
+
loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
|
|
468
|
+
}
|
|
469
|
+
} else if (process.platform === 'openharmony') {
|
|
470
|
+
if (process.arch === 'arm64') {
|
|
471
|
+
try {
|
|
472
|
+
return require('./altimate-core.openharmony-arm64.node')
|
|
473
|
+
} catch (e) {
|
|
474
|
+
loadErrors.push(e)
|
|
475
|
+
}
|
|
476
|
+
try {
|
|
477
|
+
const binding = require('@altimateai/altimate-core-openharmony-arm64')
|
|
478
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-openharmony-arm64/package.json').version
|
|
479
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
480
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
481
|
+
}
|
|
482
|
+
return binding
|
|
483
|
+
} catch (e) {
|
|
484
|
+
loadErrors.push(e)
|
|
485
|
+
}
|
|
486
|
+
} else if (process.arch === 'x64') {
|
|
487
|
+
try {
|
|
488
|
+
return require('./altimate-core.openharmony-x64.node')
|
|
489
|
+
} catch (e) {
|
|
490
|
+
loadErrors.push(e)
|
|
491
|
+
}
|
|
492
|
+
try {
|
|
493
|
+
const binding = require('@altimateai/altimate-core-openharmony-x64')
|
|
494
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-openharmony-x64/package.json').version
|
|
495
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
496
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
497
|
+
}
|
|
498
|
+
return binding
|
|
499
|
+
} catch (e) {
|
|
500
|
+
loadErrors.push(e)
|
|
501
|
+
}
|
|
502
|
+
} else if (process.arch === 'arm') {
|
|
503
|
+
try {
|
|
504
|
+
return require('./altimate-core.openharmony-arm.node')
|
|
505
|
+
} catch (e) {
|
|
506
|
+
loadErrors.push(e)
|
|
507
|
+
}
|
|
508
|
+
try {
|
|
509
|
+
const binding = require('@altimateai/altimate-core-openharmony-arm')
|
|
510
|
+
const bindingPackageVersion = require('@altimateai/altimate-core-openharmony-arm/package.json').version
|
|
511
|
+
if (bindingPackageVersion !== '0.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
512
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
513
|
+
}
|
|
514
|
+
return binding
|
|
515
|
+
} catch (e) {
|
|
516
|
+
loadErrors.push(e)
|
|
517
|
+
}
|
|
518
|
+
} else {
|
|
519
|
+
loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
|
|
520
|
+
}
|
|
521
|
+
} else {
|
|
522
|
+
loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
|
|
523
|
+
}
|
|
524
|
+
}
|
|
525
|
+
|
|
526
|
+
nativeBinding = requireNative()
|
|
527
|
+
|
|
528
|
+
if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
|
|
529
|
+
let wasiBinding = null
|
|
530
|
+
let wasiBindingError = null
|
|
531
|
+
try {
|
|
532
|
+
wasiBinding = require('./altimate-core.wasi.cjs')
|
|
533
|
+
nativeBinding = wasiBinding
|
|
534
|
+
} catch (err) {
|
|
535
|
+
if (process.env.NAPI_RS_FORCE_WASI) {
|
|
536
|
+
wasiBindingError = err
|
|
537
|
+
}
|
|
538
|
+
}
|
|
539
|
+
if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
|
|
540
|
+
try {
|
|
541
|
+
wasiBinding = require('@altimateai/altimate-core-wasm32-wasi')
|
|
542
|
+
nativeBinding = wasiBinding
|
|
543
|
+
} catch (err) {
|
|
544
|
+
if (process.env.NAPI_RS_FORCE_WASI) {
|
|
545
|
+
if (!wasiBindingError) {
|
|
546
|
+
wasiBindingError = err
|
|
547
|
+
} else {
|
|
548
|
+
wasiBindingError.cause = err
|
|
549
|
+
}
|
|
550
|
+
loadErrors.push(err)
|
|
551
|
+
}
|
|
552
|
+
}
|
|
553
|
+
}
|
|
554
|
+
if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
|
|
555
|
+
const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
|
|
556
|
+
error.cause = wasiBindingError
|
|
557
|
+
throw error
|
|
558
|
+
}
|
|
559
|
+
}
|
|
560
|
+
|
|
561
|
+
if (!nativeBinding) {
|
|
562
|
+
if (loadErrors.length > 0) {
|
|
563
|
+
throw new Error(
|
|
564
|
+
`Cannot find native binding. ` +
|
|
565
|
+
`npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
|
|
566
|
+
'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
|
|
567
|
+
{
|
|
568
|
+
cause: loadErrors.reduce((err, cur) => {
|
|
569
|
+
cur.cause = err
|
|
570
|
+
return cur
|
|
571
|
+
}),
|
|
572
|
+
},
|
|
573
|
+
)
|
|
574
|
+
}
|
|
575
|
+
throw new Error(`Failed to load native binding`)
|
|
576
|
+
}
|
|
577
|
+
|
|
578
|
+
module.exports = nativeBinding
|
|
579
|
+
module.exports.Schema = nativeBinding.Schema
|
|
580
|
+
module.exports.analyzeMigration = nativeBinding.analyzeMigration
|
|
581
|
+
module.exports.checkEquivalence = nativeBinding.checkEquivalence
|
|
582
|
+
module.exports.checkPolicy = nativeBinding.checkPolicy
|
|
583
|
+
module.exports.checkQueryPii = nativeBinding.checkQueryPii
|
|
584
|
+
module.exports.checkSemantics = nativeBinding.checkSemantics
|
|
585
|
+
module.exports.classifyPii = nativeBinding.classifyPii
|
|
586
|
+
module.exports.columnLineage = nativeBinding.columnLineage
|
|
587
|
+
module.exports.compareQueries = nativeBinding.compareQueries
|
|
588
|
+
module.exports.complete = nativeBinding.complete
|
|
589
|
+
module.exports.complexityScore = nativeBinding.complexityScore
|
|
590
|
+
module.exports.correct = nativeBinding.correct
|
|
591
|
+
module.exports.diffSchemas = nativeBinding.diffSchemas
|
|
592
|
+
module.exports.estimateCost = nativeBinding.estimateCost
|
|
593
|
+
module.exports.evaluate = nativeBinding.evaluate
|
|
594
|
+
module.exports.explain = nativeBinding.explain
|
|
595
|
+
module.exports.exportDdl = nativeBinding.exportDdl
|
|
596
|
+
module.exports.extractMetadata = nativeBinding.extractMetadata
|
|
597
|
+
module.exports.extractOutputColumns = nativeBinding.extractOutputColumns
|
|
598
|
+
module.exports.fix = nativeBinding.fix
|
|
599
|
+
module.exports.formatSql = nativeBinding.formatSql
|
|
600
|
+
module.exports.generateTests = nativeBinding.generateTests
|
|
601
|
+
module.exports.importDdl = nativeBinding.importDdl
|
|
602
|
+
module.exports.introspectionSql = nativeBinding.introspectionSql
|
|
603
|
+
module.exports.isSafe = nativeBinding.isSafe
|
|
604
|
+
module.exports.lint = nativeBinding.lint
|
|
605
|
+
module.exports.optimizeContext = nativeBinding.optimizeContext
|
|
606
|
+
module.exports.optimizeForQuery = nativeBinding.optimizeForQuery
|
|
607
|
+
module.exports.parseDbtProject = nativeBinding.parseDbtProject
|
|
608
|
+
module.exports.pruneSchema = nativeBinding.pruneSchema
|
|
609
|
+
module.exports.resolveTerm = nativeBinding.resolveTerm
|
|
610
|
+
module.exports.rewrite = nativeBinding.rewrite
|
|
611
|
+
module.exports.scanSql = nativeBinding.scanSql
|
|
612
|
+
module.exports.schemaFingerprint = nativeBinding.schemaFingerprint
|
|
613
|
+
module.exports.trackLineage = nativeBinding.trackLineage
|
|
614
|
+
module.exports.transpile = nativeBinding.transpile
|
|
615
|
+
module.exports.validate = nativeBinding.validate
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@altimateai/altimate-core",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Type-check your SQL. No database required.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"main": "index.js",
|
|
@@ -34,11 +34,11 @@
|
|
|
34
34
|
"build:debug": "napi build --platform --dts-header \"$(cat types-preamble.d.ts)\""
|
|
35
35
|
},
|
|
36
36
|
"optionalDependencies": {
|
|
37
|
-
"@altimateai/altimate-core-darwin-arm64": "0.1.
|
|
38
|
-
"@altimateai/altimate-core-darwin-x64": "0.1.
|
|
39
|
-
"@altimateai/altimate-core-linux-arm64-gnu": "0.1.
|
|
40
|
-
"@altimateai/altimate-core-linux-x64-gnu": "0.1.
|
|
41
|
-
"@altimateai/altimate-core-win32-x64-msvc": "0.1.
|
|
37
|
+
"@altimateai/altimate-core-darwin-arm64": "0.1.1",
|
|
38
|
+
"@altimateai/altimate-core-darwin-x64": "0.1.1",
|
|
39
|
+
"@altimateai/altimate-core-linux-arm64-gnu": "0.1.1",
|
|
40
|
+
"@altimateai/altimate-core-linux-x64-gnu": "0.1.1",
|
|
41
|
+
"@altimateai/altimate-core-win32-x64-msvc": "0.1.1"
|
|
42
42
|
},
|
|
43
43
|
"devDependencies": {
|
|
44
44
|
"@napi-rs/cli": "^3"
|