@altimateai/altimate-core 0.1.0 → 0.1.2

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.
Files changed (3) hide show
  1. package/index.d.ts +153 -0
  2. package/index.js +615 -0
  3. 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.2' && 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.2 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.0",
3
+ "version": "0.1.2",
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.0",
38
- "@altimateai/altimate-core-darwin-x64": "0.1.0",
39
- "@altimateai/altimate-core-linux-arm64-gnu": "0.1.0",
40
- "@altimateai/altimate-core-linux-x64-gnu": "0.1.0",
41
- "@altimateai/altimate-core-win32-x64-msvc": "0.1.0"
37
+ "@altimateai/altimate-core-darwin-arm64": "0.1.2",
38
+ "@altimateai/altimate-core-darwin-x64": "0.1.2",
39
+ "@altimateai/altimate-core-linux-arm64-gnu": "0.1.2",
40
+ "@altimateai/altimate-core-linux-x64-gnu": "0.1.2",
41
+ "@altimateai/altimate-core-win32-x64-msvc": "0.1.2"
42
42
  },
43
43
  "devDependencies": {
44
44
  "@napi-rs/cli": "^3"