@dbsp/nql 1.5.0 → 1.7.0

package/dist/index.d.ts

@@ -402,21 +402,64 @@ interface NqlAssignment {
     value: NqlExpression;
 }
 
+/**
+ * NQL Error Types
+ *
+ * Structured error types for lexer, parser, and semantic errors.
+ */
+/** Source location for error reporting */
+interface SourceLocation {
+    line: number;
+    column: number;
+    offset: number;
+}
+/** Base error interface for all NQL errors */
+interface NqlError {
+    code: string;
+    message: string;
+    location?: SourceLocation | undefined;
+    suggestion?: string | undefined;
+}
+/** Parser errors (syntax errors) */
+interface NqlParseError extends NqlError {
+    code: `ERR-PARSE-${string}`;
+    expected?: string[] | undefined;
+    found?: string | undefined;
+}
+/** Semantic errors (validation failures) */
+interface NqlSemanticError extends NqlError {
+    code: `ERR-SEM-${string}`;
+    relatedSymbol?: string | undefined;
+}
+/** Warning (non-fatal issues) */
+interface NqlWarning {
+    code: string;
+    message: string;
+    location?: SourceLocation | undefined;
+    suggestion?: string | undefined;
+}
+
 type CompileResult = CompiledNqlQuery;
 
 /**
  * Duck-type interface for schema-based column validation.
  * Loose coupling: ModelIR from @dbsp/core satisfies this shape without direct import.
  */
+interface ColumnValidatorPseudoColumn {
+    readonly table?: string;
+    readonly foreignKeyColumn?: string;
+    readonly targetColumn?: string;
+    readonly parentRole: string;
+    readonly childRole: string;
+    readonly ascendantKeyword?: string;
+    readonly descendantKeyword?: string;
+}
 interface ColumnValidatorSchema {
     getTable(name: string): {
         readonly columns: readonly {
             readonly name: string;
         }[];
-        readonly pseudoColumns?: readonly {
-            readonly parentRole: string;
-            readonly childRole: string;
-        }[];
+        readonly pseudoColumns?: readonly ColumnValidatorPseudoColumn[];
     } | undefined;
     getRelationsFrom(sourceTable: string): readonly ColumnValidatorRelation[];
     getRelation?(qualifiedName: string): ColumnValidatorRelation | undefined;
@@ -427,8 +470,13 @@ interface ColumnValidatorRelation {
     readonly target: string;
     readonly type?: 'hasOne' | 'hasMany' | 'belongsTo' | 'belongsToMany';
     readonly foreignKey?: string | readonly string[] | undefined;
-    readonly sourceKey?: string | undefined;
-    readonly targetKey?: string | undefined;
+    readonly through?: string | undefined;
+    readonly otherKey?: string | readonly string[] | undefined;
+    readonly throughSourceKey?: string | undefined;
+    readonly throughTargetKey?: string | undefined;
+    readonly recursive?: unknown;
+    readonly sourceKey?: string | readonly string[] | undefined;
+    readonly targetKey?: string | readonly string[] | undefined;
 }
 /**
  * Options for the NQL compiler.
@@ -477,43 +525,6 @@ declare class NqlCompiler {
  */
 declare function createCompiler(options?: NqlCompilerOptions, schema?: ColumnValidatorSchema): NqlCompiler;
 
-/**
- * NQL Error Types
- *
- * Structured error types for lexer, parser, and semantic errors.
- */
-/** Source location for error reporting */
-interface SourceLocation {
-    line: number;
-    column: number;
-    offset: number;
-}
-/** Base error interface for all NQL errors */
-interface NqlError {
-    code: string;
-    message: string;
-    location?: SourceLocation | undefined;
-    suggestion?: string | undefined;
-}
-/** Parser errors (syntax errors) */
-interface NqlParseError extends NqlError {
-    code: `ERR-PARSE-${string}`;
-    expected?: string[] | undefined;
-    found?: string | undefined;
-}
-/** Semantic errors (validation failures) */
-interface NqlSemanticError extends NqlError {
-    code: `ERR-SEM-${string}`;
-    relatedSymbol?: string | undefined;
-}
-/** Warning (non-fatal issues) */
-interface NqlWarning {
-    code: string;
-    message: string;
-    location?: SourceLocation | undefined;
-    suggestion?: string | undefined;
-}
-
 declare const allTokens: chevrotain.TokenType[];
 declare const NqlLexer: Lexer;