data-finder-ts 0.1.4 → 0.1.5

package/dist/datafinder/sql-generator.d.cts

@@ -1,8 +1,22 @@
 import { Attribute } from './attribute.cjs';
-import { SelectOperation, RelationalOperationElement, Table, SortOperation } from '../model/relational.cjs';
+import { SelectOperation, RelationalOperationElement, Table, SortOperation, Operation, ArithmeticOperation, LogicalOperation } from '../model/relational.cjs';
+import { b as DialectName, S as SqlDialect } from '../dialect-CogGPm_y.cjs';
 
-declare function buildQueryOperation(businessDate: Date | null, processingDatetime: Date | null, columns: (Attribute | RelationalOperationElement)[], table: Table, op: RelationalOperationElement, orderBy?: SortOperation[], groupBy?: Attribute[], limit?: number, businessDateTo?: Date | null): SelectOperation;
-declare function selectSqlToString(selectOperation: SelectOperation): string;
-declare function toSql(businessDate: Date | null, processingDatetime: Date | null, columns: (Attribute | RelationalOperationElement)[], table: Table, op: RelationalOperationElement, orderBy?: SortOperation[], groupBy?: Attribute[], limit?: number, businessDateTo?: Date | null): string;
+/**
+ * Whether `child` must be parenthesised as an operand of `parent`: it binds more loosely than the parent, or it
+ * is the right operand of a - or / and binds equally (a - (b - c) is not a - b - c).
+ */
+declare function arithmeticNeedsParentheses(parent: ArithmeticOperation, child: RelationalOperationElement, onRight: boolean): boolean;
+declare function buildQueryOperation(businessDate: Date | null, processingDatetime: Date | null, columns: (Attribute | RelationalOperationElement)[], table: Table, op: RelationalOperationElement, orderBy?: SortOperation[], groupBy?: Attribute[], limit?: number, businessDateTo?: Date | null, distinct?: boolean, offset?: number, having?: Operation): SelectOperation;
+/**
+ * Whether `child` must be parenthesised where it is an operand of `parent`.
+ *
+ * A logical operation nested in one with a different operator is parenthesised: OR inside AND would
+ * otherwise change meaning, and AND inside OR is easier to read. The same operator needs none, since
+ * AND and OR are associative, so a AND (b AND c) is a AND b AND c.
+ */
+declare function needsParentheses(parent: LogicalOperation, child: RelationalOperationElement): boolean;
+declare function selectSqlToString(selectOperation: SelectOperation, dialect?: DialectName | SqlDialect): string;
+declare function toSql(businessDate: Date | null, processingDatetime: Date | null, columns: (Attribute | RelationalOperationElement)[], table: Table, op: RelationalOperationElement, orderBy?: SortOperation[], groupBy?: Attribute[], limit?: number, businessDateTo?: Date | null, distinct?: boolean, offset?: number, having?: Operation, dialect?: DialectName | SqlDialect): string;
 
-export { buildQueryOperation, selectSqlToString, toSql };
+export { arithmeticNeedsParentheses, buildQueryOperation, needsParentheses, selectSqlToString, toSql };

package/dist/datafinder/sql-generator.d.ts

@@ -1,8 +1,22 @@
 import { Attribute } from './attribute.js';
-import { SelectOperation, RelationalOperationElement, Table, SortOperation } from '../model/relational.js';
+import { SelectOperation, RelationalOperationElement, Table, SortOperation, Operation, ArithmeticOperation, LogicalOperation } from '../model/relational.js';
+import { b as DialectName, S as SqlDialect } from '../dialect-aaG1bDi5.js';
 
-declare function buildQueryOperation(businessDate: Date | null, processingDatetime: Date | null, columns: (Attribute | RelationalOperationElement)[], table: Table, op: RelationalOperationElement, orderBy?: SortOperation[], groupBy?: Attribute[], limit?: number, businessDateTo?: Date | null): SelectOperation;
-declare function selectSqlToString(selectOperation: SelectOperation): string;
-declare function toSql(businessDate: Date | null, processingDatetime: Date | null, columns: (Attribute | RelationalOperationElement)[], table: Table, op: RelationalOperationElement, orderBy?: SortOperation[], groupBy?: Attribute[], limit?: number, businessDateTo?: Date | null): string;
+/**
+ * Whether `child` must be parenthesised as an operand of `parent`: it binds more loosely than the parent, or it
+ * is the right operand of a - or / and binds equally (a - (b - c) is not a - b - c).
+ */
+declare function arithmeticNeedsParentheses(parent: ArithmeticOperation, child: RelationalOperationElement, onRight: boolean): boolean;
+declare function buildQueryOperation(businessDate: Date | null, processingDatetime: Date | null, columns: (Attribute | RelationalOperationElement)[], table: Table, op: RelationalOperationElement, orderBy?: SortOperation[], groupBy?: Attribute[], limit?: number, businessDateTo?: Date | null, distinct?: boolean, offset?: number, having?: Operation): SelectOperation;
+/**
+ * Whether `child` must be parenthesised where it is an operand of `parent`.
+ *
+ * A logical operation nested in one with a different operator is parenthesised: OR inside AND would
+ * otherwise change meaning, and AND inside OR is easier to read. The same operator needs none, since
+ * AND and OR are associative, so a AND (b AND c) is a AND b AND c.
+ */
+declare function needsParentheses(parent: LogicalOperation, child: RelationalOperationElement): boolean;
+declare function selectSqlToString(selectOperation: SelectOperation, dialect?: DialectName | SqlDialect): string;
+declare function toSql(businessDate: Date | null, processingDatetime: Date | null, columns: (Attribute | RelationalOperationElement)[], table: Table, op: RelationalOperationElement, orderBy?: SortOperation[], groupBy?: Attribute[], limit?: number, businessDateTo?: Date | null, distinct?: boolean, offset?: number, having?: Operation, dialect?: DialectName | SqlDialect): string;
 
-export { buildQueryOperation, selectSqlToString, toSql };
+export { arithmeticNeedsParentheses, buildQueryOperation, needsParentheses, selectSqlToString, toSql };

package/dist/datafinder/sql-generator.js

@@ -1,14 +1,18 @@
 import {
+  arithmeticNeedsParentheses,
   buildQueryOperation,
+  needsParentheses,
   selectSqlToString,
   toSql
-} from "../chunk-MH4XMYVB.js";
-import "../chunk-PMPLCEWQ.js";
-import "../chunk-4LNZV6EN.js";
-import "../chunk-4JVW4TAB.js";
-import "../chunk-UYMOE6YU.js";
+} from "../chunk-BKPWV3OF.js";
+import "../chunk-GPHWC533.js";
+import "../chunk-MGEL5RWM.js";
+import "../chunk-BGEX377Q.js";
+import "../chunk-PF6EJZHB.js";
 export {
+  arithmeticNeedsParentheses,
   buildQueryOperation,
+  needsParentheses,
   selectSqlToString,
   toSql
 };