linkgress-orm 0.0.1

package/dist/query/conditions.d.ts

@@ -0,0 +1,222 @@
+/**
+ * SQL condition types
+ */
+export type ConditionOperator = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'notIn' | 'isNull' | 'isNotNull' | 'between';
+/**
+ * Field reference - wraps a database column name with type information
+ * TName: The property name (e.g., 'isActive')
+ * TValueType: The TypeScript type of the column value (e.g., boolean)
+ */
+export interface FieldRef<TName extends string = string, TValueType = any> {
+    readonly __fieldName: TName;
+    readonly __dbColumnName: string;
+    readonly __valueType?: TValueType;
+}
+/**
+ * Extract the field name from a FieldRef or string
+ */
+export type ExtractFieldName<T> = T extends FieldRef<infer N, any> ? N : T extends string ? T : never;
+/**
+ * Extract the value type from a FieldRef
+ */
+export type ExtractValueType<T> = T extends FieldRef<any, infer V> ? V : any;
+/**
+ * Context for building SQL with parameter tracking
+ */
+export interface SqlBuildContext {
+    paramCounter: number;
+    params: any[];
+}
+/**
+ * Base class for all WHERE conditions with helper methods
+ */
+export declare abstract class WhereConditionBase {
+    /**
+     * Build the SQL for this condition
+     */
+    abstract buildSql(context: SqlBuildContext): string;
+    /**
+     * Helper to check if a value is a FieldRef
+     */
+    protected isFieldRef<V>(value: any): value is FieldRef<any, V>;
+    /**
+     * Helper to extract database column name from field reference
+     * Returns the fully qualified column name (with table alias if present)
+     */
+    protected getDbColumnName<T extends string, V = any>(field: FieldRef<T, V> | T): string;
+    /**
+     * Helper to extract value from a FieldRef or constant
+     */
+    protected extractValue<V>(value: FieldRef<any, V> | V): any;
+    /**
+     * Helper to get the right-hand side of a comparison
+     * Returns either a column reference or a parameter placeholder
+     */
+    protected getRightSide<V>(value: FieldRef<any, V> | V, context: SqlBuildContext): string;
+}
+/**
+ * Base class for comparison operations (eq, gt, like, etc.)
+ */
+export declare abstract class WhereComparisonBase<V = any> extends WhereConditionBase {
+    protected field: FieldRef<any, V> | string;
+    protected value?: (FieldRef<any, V> | V) | undefined;
+    constructor(field: FieldRef<any, V> | string, value?: (FieldRef<any, V> | V) | undefined);
+    /**
+     * Get the comparison operator (e.g., '=', '>', 'LIKE')
+     */
+    protected abstract getOperator(): string;
+    /**
+     * Build the comparison SQL
+     * Can be overridden for custom behavior
+     */
+    buildSql(context: SqlBuildContext): string;
+}
+/**
+ * Logical condition (AND, OR, NOT)
+ */
+export declare class LogicalCondition extends WhereConditionBase {
+    private operator;
+    private conditions;
+    constructor(operator: 'and' | 'or' | 'not', conditions: WhereConditionBase[]);
+    buildSql(context: SqlBuildContext): string;
+}
+/**
+ * Raw SQL condition
+ */
+export declare class RawSqlCondition extends WhereConditionBase {
+    private sql;
+    private sqlParams;
+    constructor(sql: string, sqlParams?: any[]);
+    buildSql(context: SqlBuildContext): string;
+}
+export declare class EqComparison<V = any> extends WhereComparisonBase<V> {
+    protected getOperator(): string;
+}
+export declare class NeComparison<V = any> extends WhereComparisonBase<V> {
+    protected getOperator(): string;
+}
+export declare class GtComparison<V = any> extends WhereComparisonBase<V> {
+    protected getOperator(): string;
+}
+export declare class GteComparison<V = any> extends WhereComparisonBase<V> {
+    protected getOperator(): string;
+}
+export declare class LtComparison<V = any> extends WhereComparisonBase<V> {
+    protected getOperator(): string;
+}
+export declare class LteComparison<V = any> extends WhereComparisonBase<V> {
+    protected getOperator(): string;
+}
+export declare class LikeComparison extends WhereComparisonBase<string> {
+    protected getOperator(): string;
+}
+export declare class ILikeComparison extends WhereComparisonBase<string> {
+    protected getOperator(): string;
+}
+export declare class IsNullComparison<V = any> extends WhereComparisonBase<V> {
+    constructor(field: FieldRef<any, V> | string);
+    protected getOperator(): string;
+}
+export declare class IsNotNullComparison<V = any> extends WhereComparisonBase<V> {
+    constructor(field: FieldRef<any, V> | string);
+    protected getOperator(): string;
+}
+/**
+ * IN comparison - handles array of values
+ */
+export declare class InComparison<V = any> extends WhereComparisonBase<V> {
+    private values;
+    constructor(field: FieldRef<any, V> | string, values: V[]);
+    buildSql(context: SqlBuildContext): string;
+    protected getOperator(): string;
+}
+/**
+ * NOT IN comparison
+ */
+export declare class NotInComparison<V = any> extends WhereComparisonBase<V> {
+    private values;
+    constructor(field: FieldRef<any, V> | string, values: V[]);
+    buildSql(context: SqlBuildContext): string;
+    protected getOperator(): string;
+}
+/**
+ * BETWEEN comparison
+ */
+export declare class BetweenComparison<V = any> extends WhereComparisonBase<V> {
+    private min;
+    private max;
+    constructor(field: FieldRef<any, V> | string, min: FieldRef<any, V> | V, max: FieldRef<any, V> | V);
+    buildSql(context: SqlBuildContext): string;
+    protected getOperator(): string;
+}
+/**
+ * Condition type - can be any WHERE condition
+ */
+export type Condition = WhereConditionBase;
+export declare function eq<T extends string, V>(field: FieldRef<T, V> | T, value: FieldRef<any, V> | V): Condition;
+export declare function ne<T extends string, V>(field: FieldRef<T, V> | T, value: FieldRef<any, V> | V): Condition;
+export declare function gt<T extends string, V>(field: FieldRef<T, V> | T, value: FieldRef<any, V> | V): Condition;
+export declare function gte<T extends string, V>(field: FieldRef<T, V> | T, value: FieldRef<any, V> | V): Condition;
+export declare function lt<T extends string, V>(field: FieldRef<T, V> | T, value: FieldRef<any, V> | V): Condition;
+export declare function lte<T extends string, V>(field: FieldRef<T, V> | T, value: FieldRef<any, V> | V): Condition;
+export declare function like<T extends string>(field: FieldRef<T, string> | T, value: FieldRef<any, string> | string): Condition;
+export declare function ilike<T extends string>(field: FieldRef<T, string> | T, value: FieldRef<any, string> | string): Condition;
+export declare function inArray<T extends string, V>(field: FieldRef<T, V> | T, values: V[]): Condition;
+export declare function notInArray<T extends string, V>(field: FieldRef<T, V> | T, values: V[]): Condition;
+export declare function isNull<T extends string, V>(field: FieldRef<T, V> | T): Condition;
+export declare function isNotNull<T extends string, V>(field: FieldRef<T, V> | T): Condition;
+export declare function between<T extends string, V>(field: FieldRef<T, V> | T, min: FieldRef<any, V> | V, max: FieldRef<any, V> | V): Condition;
+export declare function and(...conditions: Condition[]): Condition;
+export declare function or(...conditions: Condition[]): Condition;
+export declare function not(condition: Condition): Condition;
+/**
+ * SQL Fragment - represents a raw SQL expression that can be used in SELECT or WHERE
+ * Supports embedding FieldRef objects
+ * Extends WhereConditionBase so it can be used directly in WHERE clauses
+ */
+export declare class SqlFragment<TValueType = any> extends WhereConditionBase {
+    private sqlParts;
+    private values;
+    private mapper?;
+    private alias?;
+    constructor(parts: string[], values: any[], mapper?: any, alias?: string);
+    /**
+     * Set custom type mapper for bidirectional transformation
+     * Can accept either:
+     * - A function (value: TDriver) => TData for inline transformations
+     * - A CustomTypeBuilder with full toDriver/fromDriver methods
+     */
+    mapWith<TData = TValueType, TDriver = any>(mapper: ((value: TDriver) => TData) | any): SqlFragment<TData>;
+    /**
+     * Set column alias for SELECT clause
+     */
+    as(alias: string): SqlFragment<TValueType>;
+    /**
+     * Get the type mapper (internal use)
+     */
+    getMapper(): any | undefined;
+    /**
+     * Get the alias (internal use)
+     */
+    getAlias(): string | undefined;
+    /**
+     * Build the SQL string with proper parameter placeholders
+     */
+    buildSql(context: SqlBuildContext): string;
+    /**
+     * Get the SQL string with parameters (for debugging)
+     */
+    toString(): string;
+}
+/**
+ * Tagged template literal for creating SQL fragments
+ * Usage: sql`lower(${field})` or sql`${field} = ${value}`
+ */
+export declare function sql<TValueType = any>(strings: TemplateStringsArray, ...values: any[]): SqlFragment<TValueType>;
+export declare class ConditionBuilder {
+    build(condition: Condition, startParam?: number): {
+        sql: string;
+        params: any[];
+    };
+}
+//# sourceMappingURL=conditions.d.ts.map

package/dist/query/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../src/query/conditions.ts"],"names":[],"mappings":"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"}

package/dist/query/conditions.js

@@ -0,0 +1,446 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionBuilder = exports.SqlFragment = exports.BetweenComparison = exports.NotInComparison = exports.InComparison = exports.IsNotNullComparison = exports.IsNullComparison = exports.ILikeComparison = exports.LikeComparison = exports.LteComparison = exports.LtComparison = exports.GteComparison = exports.GtComparison = exports.NeComparison = exports.EqComparison = exports.RawSqlCondition = exports.LogicalCondition = exports.WhereComparisonBase = exports.WhereConditionBase = void 0;
+exports.eq = eq;
+exports.ne = ne;
+exports.gt = gt;
+exports.gte = gte;
+exports.lt = lt;
+exports.lte = lte;
+exports.like = like;
+exports.ilike = ilike;
+exports.inArray = inArray;
+exports.notInArray = notInArray;
+exports.isNull = isNull;
+exports.isNotNull = isNotNull;
+exports.between = between;
+exports.and = and;
+exports.or = or;
+exports.not = not;
+exports.sql = sql;
+/**
+ * Base class for all WHERE conditions with helper methods
+ */
+class WhereConditionBase {
+    /**
+     * Helper to check if a value is a FieldRef
+     */
+    isFieldRef(value) {
+        return typeof value === 'object' && value !== null && '__dbColumnName' in value;
+    }
+    /**
+     * Helper to extract database column name from field reference
+     * Returns the fully qualified column name (with table alias if present)
+     */
+    getDbColumnName(field) {
+        if (typeof field === 'object' && '__dbColumnName' in field) {
+            // Check if field has a table alias
+            if ('__tableAlias' in field && field.__tableAlias) {
+                // Return fully quoted table.column
+                return `"${field.__tableAlias}"."${field.__dbColumnName}"`;
+            }
+            // Return just the quoted column name
+            return `"${field.__dbColumnName}"`;
+        }
+        // For string fields, quote them
+        return `"${field}"`;
+    }
+    /**
+     * Helper to extract value from a FieldRef or constant
+     */
+    extractValue(value) {
+        if (this.isFieldRef(value)) {
+            return value.__dbColumnName;
+        }
+        return value;
+    }
+    /**
+     * Helper to get the right-hand side of a comparison
+     * Returns either a column reference or a parameter placeholder
+     */
+    getRightSide(value, context) {
+        if (this.isFieldRef(value)) {
+            // Value is a field reference, use it with table alias if present
+            if ('__tableAlias' in value && value.__tableAlias) {
+                return `"${value.__tableAlias}"."${value.__dbColumnName}"`;
+            }
+            return `"${value.__dbColumnName}"`;
+        }
+        else {
+            // Value is a literal, use a parameter
+            context.params.push(value);
+            return `$${context.paramCounter++}`;
+        }
+    }
+}
+exports.WhereConditionBase = WhereConditionBase;
+/**
+ * Base class for comparison operations (eq, gt, like, etc.)
+ */
+class WhereComparisonBase extends WhereConditionBase {
+    constructor(field, value) {
+        super();
+        this.field = field;
+        this.value = value;
+    }
+    /**
+     * Build the comparison SQL
+     * Can be overridden for custom behavior
+     */
+    buildSql(context) {
+        const fieldName = this.getDbColumnName(this.field); // Returns already quoted name
+        const operator = this.getOperator();
+        if (this.value !== undefined) {
+            const rightSide = this.getRightSide(this.value, context);
+            return `${fieldName} ${operator} ${rightSide}`;
+        }
+        else {
+            // For operators like IS NULL that don't have a value
+            return `${fieldName} ${operator}`;
+        }
+    }
+}
+exports.WhereComparisonBase = WhereComparisonBase;
+/**
+ * Logical condition (AND, OR, NOT)
+ */
+class LogicalCondition extends WhereConditionBase {
+    constructor(operator, conditions) {
+        super();
+        this.operator = operator;
+        this.conditions = conditions;
+    }
+    buildSql(context) {
+        if (this.conditions.length === 0) {
+            return '1=1';
+        }
+        const parts = this.conditions.map(c => c.buildSql(context));
+        switch (this.operator) {
+            case 'and':
+                return parts.length === 1 ? parts[0] : `(${parts.join(' AND ')})`;
+            case 'or':
+                return parts.length === 1 ? parts[0] : `(${parts.join(' OR ')})`;
+            case 'not':
+                return `NOT (${parts[0]})`;
+            default:
+                throw new Error(`Unknown logical operator: ${this.operator}`);
+        }
+    }
+}
+exports.LogicalCondition = LogicalCondition;
+/**
+ * Raw SQL condition
+ */
+class RawSqlCondition extends WhereConditionBase {
+    constructor(sql, sqlParams = []) {
+        super();
+        this.sql = sql;
+        this.sqlParams = sqlParams;
+    }
+    buildSql(context) {
+        if (this.sqlParams.length > 0) {
+            context.params.push(...this.sqlParams);
+        }
+        return this.sql;
+    }
+}
+exports.RawSqlCondition = RawSqlCondition;
+// ============================================================================
+// Specific comparison implementations
+// ============================================================================
+class EqComparison extends WhereComparisonBase {
+    getOperator() {
+        return '=';
+    }
+}
+exports.EqComparison = EqComparison;
+class NeComparison extends WhereComparisonBase {
+    getOperator() {
+        return '!=';
+    }
+}
+exports.NeComparison = NeComparison;
+class GtComparison extends WhereComparisonBase {
+    getOperator() {
+        return '>';
+    }
+}
+exports.GtComparison = GtComparison;
+class GteComparison extends WhereComparisonBase {
+    getOperator() {
+        return '>=';
+    }
+}
+exports.GteComparison = GteComparison;
+class LtComparison extends WhereComparisonBase {
+    getOperator() {
+        return '<';
+    }
+}
+exports.LtComparison = LtComparison;
+class LteComparison extends WhereComparisonBase {
+    getOperator() {
+        return '<=';
+    }
+}
+exports.LteComparison = LteComparison;
+class LikeComparison extends WhereComparisonBase {
+    getOperator() {
+        return 'LIKE';
+    }
+}
+exports.LikeComparison = LikeComparison;
+class ILikeComparison extends WhereComparisonBase {
+    getOperator() {
+        return 'ILIKE';
+    }
+}
+exports.ILikeComparison = ILikeComparison;
+class IsNullComparison extends WhereComparisonBase {
+    constructor(field) {
+        super(field, undefined);
+    }
+    getOperator() {
+        return 'IS NULL';
+    }
+}
+exports.IsNullComparison = IsNullComparison;
+class IsNotNullComparison extends WhereComparisonBase {
+    constructor(field) {
+        super(field, undefined);
+    }
+    getOperator() {
+        return 'IS NOT NULL';
+    }
+}
+exports.IsNotNullComparison = IsNotNullComparison;
+/**
+ * IN comparison - handles array of values
+ */
+class InComparison extends WhereComparisonBase {
+    constructor(field, values) {
+        super(field, undefined);
+        this.values = values;
+    }
+    buildSql(context) {
+        const fieldName = this.getDbColumnName(this.field); // Returns already quoted name
+        if (!Array.isArray(this.values) || this.values.length === 0) {
+            return '1=0'; // No matches
+        }
+        const params = this.values.map(() => `$${context.paramCounter++}`).join(', ');
+        context.params.push(...this.values);
+        return `${fieldName} IN (${params})`;
+    }
+    getOperator() {
+        return 'IN';
+    }
+}
+exports.InComparison = InComparison;
+/**
+ * NOT IN comparison
+ */
+class NotInComparison extends WhereComparisonBase {
+    constructor(field, values) {
+        super(field, undefined);
+        this.values = values;
+    }
+    buildSql(context) {
+        const fieldName = this.getDbColumnName(this.field); // Returns already quoted name
+        if (!Array.isArray(this.values) || this.values.length === 0) {
+            return '1=1'; // All match
+        }
+        const params = this.values.map(() => `$${context.paramCounter++}`).join(', ');
+        context.params.push(...this.values);
+        return `${fieldName} NOT IN (${params})`;
+    }
+    getOperator() {
+        return 'NOT IN';
+    }
+}
+exports.NotInComparison = NotInComparison;
+/**
+ * BETWEEN comparison
+ */
+class BetweenComparison extends WhereComparisonBase {
+    constructor(field, min, max) {
+        super(field, undefined);
+        this.min = min;
+        this.max = max;
+    }
+    buildSql(context) {
+        const fieldName = this.getDbColumnName(this.field); // Returns already quoted name
+        const minSide = this.getRightSide(this.min, context);
+        const maxSide = this.getRightSide(this.max, context);
+        return `${fieldName} BETWEEN ${minSide} AND ${maxSide}`;
+    }
+    getOperator() {
+        return 'BETWEEN';
+    }
+}
+exports.BetweenComparison = BetweenComparison;
+// ============================================================================
+// Condition factory functions
+// These are type-safe and return class instances
+// ============================================================================
+function eq(field, value) {
+    return new EqComparison(field, value);
+}
+function ne(field, value) {
+    return new NeComparison(field, value);
+}
+function gt(field, value) {
+    return new GtComparison(field, value);
+}
+function gte(field, value) {
+    return new GteComparison(field, value);
+}
+function lt(field, value) {
+    return new LtComparison(field, value);
+}
+function lte(field, value) {
+    return new LteComparison(field, value);
+}
+function like(field, value) {
+    return new LikeComparison(field, value);
+}
+function ilike(field, value) {
+    return new ILikeComparison(field, value);
+}
+function inArray(field, values) {
+    return new InComparison(field, values);
+}
+function notInArray(field, values) {
+    return new NotInComparison(field, values);
+}
+function isNull(field) {
+    return new IsNullComparison(field);
+}
+function isNotNull(field) {
+    return new IsNotNullComparison(field);
+}
+function between(field, min, max) {
+    return new BetweenComparison(field, min, max);
+}
+function and(...conditions) {
+    return new LogicalCondition('and', conditions);
+}
+function or(...conditions) {
+    return new LogicalCondition('or', conditions);
+}
+function not(condition) {
+    return new LogicalCondition('not', [condition]);
+}
+// ============================================================================
+// SQL Fragment - for use in SELECT projections and WHERE conditions
+// ============================================================================
+/**
+ * SQL Fragment - represents a raw SQL expression that can be used in SELECT or WHERE
+ * Supports embedding FieldRef objects
+ * Extends WhereConditionBase so it can be used directly in WHERE clauses
+ */
+class SqlFragment extends WhereConditionBase {
+    constructor(parts, values, mapper, alias) {
+        super();
+        this.sqlParts = parts;
+        this.values = values;
+        this.mapper = mapper;
+        this.alias = alias;
+    }
+    /**
+     * Set custom type mapper for bidirectional transformation
+     * Can accept either:
+     * - A function (value: TDriver) => TData for inline transformations
+     * - A CustomTypeBuilder with full toDriver/fromDriver methods
+     */
+    mapWith(mapper) {
+        // If mapper is a function, wrap it in a simple mapper object
+        const normalizedMapper = typeof mapper === 'function'
+            ? { fromDriver: mapper }
+            : mapper;
+        return new SqlFragment(this.sqlParts, this.values, normalizedMapper, this.alias);
+    }
+    /**
+     * Set column alias for SELECT clause
+     */
+    as(alias) {
+        return new SqlFragment(this.sqlParts, this.values, this.mapper, alias);
+    }
+    /**
+     * Get the type mapper (internal use)
+     */
+    getMapper() {
+        return this.mapper;
+    }
+    /**
+     * Get the alias (internal use)
+     */
+    getAlias() {
+        return this.alias;
+    }
+    /**
+     * Build the SQL string with proper parameter placeholders
+     */
+    buildSql(context) {
+        let sql = '';
+        for (let i = 0; i < this.sqlParts.length; i++) {
+            sql += this.sqlParts[i];
+            if (i < this.values.length) {
+                const value = this.values[i];
+                // Check if value is a FieldRef
+                if (this.isFieldRef(value)) {
+                    // It's a field reference - use the database column name with table alias if present
+                    if ('__tableAlias' in value && value.__tableAlias) {
+                        sql += `"${value.__tableAlias}"."${value.__dbColumnName}"`;
+                    }
+                    else {
+                        sql += `"${value.__dbColumnName}"`;
+                    }
+                }
+                else if (value instanceof SqlFragment) {
+                    // It's a nested SQL fragment
+                    sql += value.buildSql(context);
+                }
+                else if (typeof value === 'object' && value !== null && 'buildSql' in value && typeof value.buildSql === 'function') {
+                    // It's a Subquery (or any object with buildSql method)
+                    sql += `(${value.buildSql(context)})`;
+                }
+                else {
+                    // It's a literal value - use a parameter
+                    sql += `$${context.paramCounter++}`;
+                    context.params.push(value);
+                }
+            }
+        }
+        return sql;
+    }
+    /**
+     * Get the SQL string with parameters (for debugging)
+     */
+    toString() {
+        const context = { paramCounter: 1, params: [] };
+        return this.buildSql(context);
+    }
+}
+exports.SqlFragment = SqlFragment;
+/**
+ * Tagged template literal for creating SQL fragments
+ * Usage: sql`lower(${field})` or sql`${field} = ${value}`
+ */
+function sql(strings, ...values) {
+    return new SqlFragment(Array.from(strings), values);
+}
+// ============================================================================
+// SQL builder for conditions
+// ============================================================================
+class ConditionBuilder {
+    build(condition, startParam = 1) {
+        const context = {
+            paramCounter: startParam,
+            params: [],
+        };
+        const sql = condition.buildSql(context);
+        return { sql, params: context.params };
+    }
+}
+exports.ConditionBuilder = ConditionBuilder;
+//# sourceMappingURL=conditions.js.map