data-finder-ts 0.1.3 → 0.1.5

package/dist/datafinder/typed-attributes.d.ts

@@ -1,135 +1,3 @@
-import { Attribute } from './attribute.js';
-import { JoinTreeNodeOperation, Operation, DateExtractOperation, DateArithmeticOperation, DateDiffOperation, AggregateOperation, ScalarFunctionOperation } from '../model/relational.js';
-
-declare class StringAttribute extends Attribute {
-    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation);
-    upper(): ScalarFunctionOperation;
-    lower(): ScalarFunctionOperation;
-    strip(): ScalarFunctionOperation;
-    lstrip(): ScalarFunctionOperation;
-    rstrip(): ScalarFunctionOperation;
-    length(): ScalarFunctionOperation;
-    reverse(): ScalarFunctionOperation;
-    left(n: number): ScalarFunctionOperation;
-    right(n: number): ScalarFunctionOperation;
-    repeat(n: number): ScalarFunctionOperation;
-    replace(fromStr: string, toStr: string): ScalarFunctionOperation;
-    substring(start: number, length?: number): ScalarFunctionOperation;
-    eq(value: string): Operation;
-    ne(value: string): Operation;
-    contains(value: string): Operation;
-    startsWith(prefix: string): Operation;
-    endsWith(suffix: string): Operation;
-    notContains(value: string): Operation;
-}
-declare abstract class NumericAttribute extends Attribute {
-    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation);
-    sum(): AggregateOperation;
-    min(): AggregateOperation;
-    max(): AggregateOperation;
-    average(): AggregateOperation;
-    abs(): ScalarFunctionOperation;
-    ceil(): ScalarFunctionOperation;
-    floor(): ScalarFunctionOperation;
-    sqrt(): ScalarFunctionOperation;
-    mod(n: number): ScalarFunctionOperation;
-    power(n: number): ScalarFunctionOperation;
-    round(d?: number): ScalarFunctionOperation;
-}
-declare class DoubleAttribute extends NumericAttribute {
-    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation);
-    eq(value: number): Operation;
-    ne(value: number): Operation;
-    gt(value: number): Operation;
-    lt(value: number): Operation;
-    gte(value: number): Operation;
-    lte(value: number): Operation;
-}
-declare const FloatAttribute: typeof DoubleAttribute;
-type FloatAttribute = DoubleAttribute;
-declare class DecimalAttribute extends NumericAttribute {
-    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation);
-    eq(value: number): Operation;
-    ne(value: number): Operation;
-    gt(value: number): Operation;
-    lt(value: number): Operation;
-    gte(value: number): Operation;
-    lte(value: number): Operation;
-}
-declare class IntegerAttribute extends NumericAttribute {
-    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation);
-    eq(value: number): Operation;
-    ne(value: number): Operation;
-    gt(value: number): Operation;
-    lt(value: number): Operation;
-    gte(value: number): Operation;
-    lte(value: number): Operation;
-}
-declare class BooleanAttribute extends Attribute {
-    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation);
-    eq(value: boolean): Operation;
-    isTrue(): Operation;
-    isFalse(): Operation;
-}
-declare class DateAttribute extends Attribute {
-    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation);
-    eq(value: Date | string): Operation;
-    ne(value: Date | string): Operation;
-    gt(value: Date | string): Operation;
-    lt(value: Date | string): Operation;
-    gte(value: Date | string): Operation;
-    lte(value: Date | string): Operation;
-    year(): DateExtractOperation;
-    month(): DateExtractOperation;
-    day(): DateExtractOperation;
-    quarter(): DateExtractOperation;
-    week(): DateExtractOperation;
-    dayOfWeek(): DateExtractOperation;
-    addDays(n: number): DateArithmeticOperation;
-    addMonths(n: number): DateArithmeticOperation;
-    addYears(n: number): DateArithmeticOperation;
-    subtractDays(n: number): DateArithmeticOperation;
-    subtractMonths(n: number): DateArithmeticOperation;
-    subtractYears(n: number): DateArithmeticOperation;
-    diffDays(other: Date): DateDiffOperation;
-    diffMonths(other: Date): DateDiffOperation;
-    diffYears(other: Date): DateDiffOperation;
-}
-declare class DateTimeAttribute extends Attribute {
-    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation);
-    eq(value: Date | string): Operation;
-    ne(value: Date | string): Operation;
-    gt(value: Date | string): Operation;
-    lt(value: Date | string): Operation;
-    gte(value: Date | string): Operation;
-    lte(value: Date | string): Operation;
-    year(): DateExtractOperation;
-    month(): DateExtractOperation;
-    day(): DateExtractOperation;
-    hour(): DateExtractOperation;
-    minute(): DateExtractOperation;
-    second(): DateExtractOperation;
-    quarter(): DateExtractOperation;
-    week(): DateExtractOperation;
-    dayOfWeek(): DateExtractOperation;
-    addDays(n: number): DateArithmeticOperation;
-    addMonths(n: number): DateArithmeticOperation;
-    addYears(n: number): DateArithmeticOperation;
-    addHours(n: number): DateArithmeticOperation;
-    addMinutes(n: number): DateArithmeticOperation;
-    addSeconds(n: number): DateArithmeticOperation;
-    subtractDays(n: number): DateArithmeticOperation;
-    subtractMonths(n: number): DateArithmeticOperation;
-    subtractYears(n: number): DateArithmeticOperation;
-    subtractHours(n: number): DateArithmeticOperation;
-    subtractMinutes(n: number): DateArithmeticOperation;
-    subtractSeconds(n: number): DateArithmeticOperation;
-    diffDays(other: Date): DateDiffOperation;
-    diffMonths(other: Date): DateDiffOperation;
-    diffYears(other: Date): DateDiffOperation;
-    diffHours(other: Date): DateDiffOperation;
-    diffMinutes(other: Date): DateDiffOperation;
-    diffSeconds(other: Date): DateDiffOperation;
-}
-
-export { BooleanAttribute, DateAttribute, DateTimeAttribute, DecimalAttribute, DoubleAttribute, FloatAttribute, IntegerAttribute, NumericAttribute, StringAttribute };
+import './attribute.js';
+export { B as BooleanAttribute, D as DateAttribute, a as DateTimeAttribute, b as DecimalAttribute, c as DoubleAttribute, F as FloatAttribute, I as IntegerAttribute, N as NumericAttribute, S as StringAttribute } from '../typed-attributes-CUTf_6Ru.js';
+import '../model/relational.js';

package/dist/datafinder/typed-attributes.js

@@ -8,9 +8,9 @@ import {
   IntegerAttribute,
   NumericAttribute,
   StringAttribute
-} from "../chunk-5K2Z3YDY.js";
-import "../chunk-V647VNMY.js";
-import "../chunk-3SSWFES4.js";
+} from "../chunk-MGEL5RWM.js";
+import "../chunk-BGEX377Q.js";
+import "../chunk-PF6EJZHB.js";
 export {
   BooleanAttribute,
   DateAttribute,

package/dist/dialect-CogGPm_y.d.cts

@@ -0,0 +1,38 @@
+import { SortDirection, DatePart } from './model/relational.cjs';
+
+/**
+ * The SQL a query is written in. The generator writes Postgres by default; a dialect says where another database
+ * differs, so the same query can be sent to DuckDB or Databricks.
+ *
+ * Only what differs is here. Everything the databases share (joins, CASE, window functions, COUNT(DISTINCT), LIKE ...
+ * ESCAPE, `||`, typed date literals, `INTERVAL '7' DAY`, ...) is written once by the generator.
+ */
+
+type DialectName = 'postgres' | 'duckdb' | 'databricks';
+interface SqlDialect {
+    readonly name: DialectName;
+    /** A name as an identifier, used for the names of the result's columns. */
+    quoteIdentifier(name: string): string;
+    /** A string as a literal that can never end early, whatever it holds. */
+    stringLiteral(value: string): string;
+    /**
+     * ` ASC` or ` DESC`, with the null placement spelled out where the database's default differs from Postgres
+     * (nulls last when ascending, first when descending), so a sort gives the same order everywhere.
+     */
+    orderDirection(direction: SortDirection): string;
+    /** The type a float constant is cast to, so it comes back as a double and not a decimal. */
+    readonly doubleType: string;
+    /** The day of the week of a date or timestamp, 0 = Sunday through 6 = Saturday. */
+    dayOfWeek(expression: string): string;
+    /** Whole `unit`s from `from` to `to`; both are SQL expressions. */
+    dateDiff(unit: DatePart, from: string, to: string): string;
+    /** The values of a group joined with `separator` (an SQL literal), in the order given (each with its direction). */
+    stringAgg(expression: string, separator: string, orderBy: string[]): string;
+}
+declare const POSTGRES: SqlDialect;
+declare const DUCKDB: SqlDialect;
+declare const DATABRICKS: SqlDialect;
+/** A dialect by name, or as given. */
+declare function dialectOf(dialect: DialectName | SqlDialect): SqlDialect;
+
+export { DATABRICKS as D, POSTGRES as P, type SqlDialect as S, DUCKDB as a, type DialectName as b, dialectOf as d };

package/dist/dialect-aaG1bDi5.d.ts

@@ -0,0 +1,38 @@
+import { SortDirection, DatePart } from './model/relational.js';
+
+/**
+ * The SQL a query is written in. The generator writes Postgres by default; a dialect says where another database
+ * differs, so the same query can be sent to DuckDB or Databricks.
+ *
+ * Only what differs is here. Everything the databases share (joins, CASE, window functions, COUNT(DISTINCT), LIKE ...
+ * ESCAPE, `||`, typed date literals, `INTERVAL '7' DAY`, ...) is written once by the generator.
+ */
+
+type DialectName = 'postgres' | 'duckdb' | 'databricks';
+interface SqlDialect {
+    readonly name: DialectName;
+    /** A name as an identifier, used for the names of the result's columns. */
+    quoteIdentifier(name: string): string;
+    /** A string as a literal that can never end early, whatever it holds. */
+    stringLiteral(value: string): string;
+    /**
+     * ` ASC` or ` DESC`, with the null placement spelled out where the database's default differs from Postgres
+     * (nulls last when ascending, first when descending), so a sort gives the same order everywhere.
+     */
+    orderDirection(direction: SortDirection): string;
+    /** The type a float constant is cast to, so it comes back as a double and not a decimal. */
+    readonly doubleType: string;
+    /** The day of the week of a date or timestamp, 0 = Sunday through 6 = Saturday. */
+    dayOfWeek(expression: string): string;
+    /** Whole `unit`s from `from` to `to`; both are SQL expressions. */
+    dateDiff(unit: DatePart, from: string, to: string): string;
+    /** The values of a group joined with `separator` (an SQL literal), in the order given (each with its direction). */
+    stringAgg(expression: string, separator: string, orderBy: string[]): string;
+}
+declare const POSTGRES: SqlDialect;
+declare const DUCKDB: SqlDialect;
+declare const DATABRICKS: SqlDialect;
+/** A dialect by name, or as given. */
+declare function dialectOf(dialect: DialectName | SqlDialect): SqlDialect;
+
+export { DATABRICKS as D, POSTGRES as P, type SqlDialect as S, DUCKDB as a, type DialectName as b, dialectOf as d };