rawsql-ts 0.12.0 → 0.13.0

package/dist/models/BinarySelectQuery.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BinarySelectQuery = void 0;
+const Clause_1 = require("./Clause");
+const SqlComponent_1 = require("./SqlComponent");
+const ValueComponent_1 = require("./ValueComponent");
+const CTENormalizer_1 = require("../transformers/CTENormalizer");
+const SelectQueryParser_1 = require("../parsers/SelectQueryParser");
+const ParameterHelper_1 = require("../utils/ParameterHelper");
+const QueryBuilder_1 = require("../transformers/QueryBuilder");
+/**
+ * Represents a binary SELECT expression (UNION/INTERSECT/EXCEPT) composed from two SelectQuery values.
+ *
+ * @example
+ * ```typescript
+ * const parts = [
+ *   SelectQueryParser.parse('SELECT id, name FROM users').toSimpleQuery(),
+ *   SelectQueryParser.parse('SELECT id, name FROM archived_users').toSimpleQuery()
+ * ];
+ * const unionQuery = QueryBuilder.buildBinaryQuery(parts, 'union');
+ * ```
+ * Related tests: packages/core/tests/models/SelectQueryUnion.test.ts
+ */
+class BinarySelectQuery extends SqlComponent_1.SqlComponent {
+    constructor(left, operator, right) {
+        super();
+        this.__selectQueryType = 'SelectQuery'; // Discriminator for type safety
+        this.headerComments = null; // Comments that appear before the first query
+        this.left = left;
+        this.operator = new ValueComponent_1.RawString(operator);
+        this.right = right;
+    }
+    /**
+     * Appends another query to this binary query using UNION as the operator.
+     * This creates a new BinarySelectQuery where the left side is this binary query
+     * and the right side is the provided query.
+     *
+     * @param query The query to append with UNION
+     * @returns A new BinarySelectQuery representing "(this) UNION query"
+     */
+    union(query) {
+        return this.appendSelectQuery('union', query);
+    }
+    /**
+     * Appends another query to this binary query using UNION ALL as the operator.
+     * This creates a new BinarySelectQuery where the left side is this binary query
+     * and the right side is the provided query.
+     *
+     * @param query The query to append with UNION ALL
+     * @returns A new BinarySelectQuery representing "(this) UNION ALL query"
+     */
+    unionAll(query) {
+        return this.appendSelectQuery('union all', query);
+    }
+    /**
+     * Appends another query to this binary query using INTERSECT as the operator.
+     * This creates a new BinarySelectQuery where the left side is this binary query
+     * and the right side is the provided query.
+     *
+     * @param query The query to append with INTERSECT
+     * @returns A new BinarySelectQuery representing "(this) INTERSECT query"
+     */
+    intersect(query) {
+        return this.appendSelectQuery('intersect', query);
+    }
+    /**
+     * Appends another query to this binary query using INTERSECT ALL as the operator.
+     * This creates a new BinarySelectQuery where the left side is this binary query
+     * and the right side is the provided query.
+     *
+     * @param query The query to append with INTERSECT ALL
+     * @returns A new BinarySelectQuery representing "(this) INTERSECT ALL query"
+     */
+    intersectAll(query) {
+        return this.appendSelectQuery('intersect all', query);
+    }
+    /**
+     * Appends another query to this binary query using EXCEPT as the operator.
+     * This creates a new BinarySelectQuery where the left side is this binary query
+     * and the right side is the provided query.
+     *
+     * @param query The query to append with EXCEPT
+     * @returns A new BinarySelectQuery representing "(this) EXCEPT query"
+     */
+    except(query) {
+        return this.appendSelectQuery('except', query);
+    }
+    /**
+     * Appends another query to this binary query using EXCEPT ALL as the operator.
+     * This creates a new BinarySelectQuery where the left side is this binary query
+     * and the right side is the provided query.
+     *
+     * @param query The query to append with EXCEPT ALL
+     * @returns A new BinarySelectQuery representing "(this) EXCEPT ALL query"
+     */
+    exceptAll(query) {
+        return this.appendSelectQuery('except all', query);
+    }
+    /**
+     * Appends another query to this binary query using the specified operator.
+     * This creates a new BinarySelectQuery where the left side is this binary query
+     * and the right side is the provided query.
+     *
+     * @param operator SQL operator to use (e.g. 'union', 'union all', 'intersect', 'except')
+     * @param query The query to append with the specified operator
+     * @returns A new BinarySelectQuery representing "(this) [operator] query"
+     */
+    appendSelectQuery(operator, query) {
+        this.left = new BinarySelectQuery(this.left, this.operator.value, this.right);
+        this.operator = new ValueComponent_1.RawString(operator);
+        this.right = query;
+        CTENormalizer_1.CTENormalizer.normalize(this);
+        return this;
+    }
+    /**
+     * Appends another query to this binary query using UNION as the operator, accepting a raw SQL string.
+     * This method parses the SQL string and appends the resulting query using UNION.
+     * @param sql The SQL string to parse and union
+     * @returns A new BinarySelectQuery representing "(this) UNION (parsed query)"
+     */
+    unionRaw(sql) {
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
+        return this.union(parsedQuery);
+    }
+    unionAllRaw(sql) {
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
+        return this.unionAll(parsedQuery);
+    }
+    intersectRaw(sql) {
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
+        return this.intersect(parsedQuery);
+    }
+    intersectAllRaw(sql) {
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
+        return this.intersectAll(parsedQuery);
+    }
+    exceptRaw(sql) {
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
+        return this.except(parsedQuery);
+    }
+    exceptAllRaw(sql) {
+        const parsedQuery = SelectQueryParser_1.SelectQueryParser.parse(sql);
+        return this.exceptAll(parsedQuery);
+    }
+    /**
+     * Converts this query into an INSERT statement definition.
+     * @remarks The underlying simple query may be reordered so that column order matches the requested insert columns.
+     */
+    toInsertQuery(options) {
+        return this.toSimpleQuery().toInsertQuery(options);
+    }
+    /**
+     * Converts this query into an UPDATE statement definition.
+     * @remarks The conversion can reorder the SELECT list produced by {@link toSimpleQuery}.
+     */
+    toUpdateQuery(options) {
+        return this.toSimpleQuery().toUpdateQuery(options);
+    }
+    /**
+     * Converts this query into a DELETE statement definition.
+     * @remarks The conversion can reorder the SELECT list produced by {@link toSimpleQuery}.
+     */
+    toDeleteQuery(options) {
+        return this.toSimpleQuery().toDeleteQuery(options);
+    }
+    /**
+     * Converts this query into a MERGE statement definition.
+     * @remarks The conversion can reorder the SELECT list produced by {@link toSimpleQuery}.
+     */
+    toMergeQuery(options) {
+        return this.toSimpleQuery().toMergeQuery(options);
+    }
+    // Returns a SourceExpression wrapping this query as a subquery source.
+    // Optionally takes an alias name (default: "subq")
+    toSource(alias = "subq") {
+        return new Clause_1.SourceExpression(new Clause_1.SubQuerySource(this), new Clause_1.SourceAliasExpression(alias, null));
+    }
+    /**
+     * Sets the value of a parameter by name in this query.
+     * @param name Parameter name
+     * @param value Value to set
+     */
+    setParameter(name, value) {
+        ParameterHelper_1.ParameterHelper.set(this, name, value);
+        return this;
+    }
+    /**
+     * Converts this BinarySelectQuery to a SimpleSelectQuery using QueryBuilder.
+     * This enables CTE management on binary queries by wrapping them as subqueries.
+     * @returns A SimpleSelectQuery representation of this binary query
+     */
+    toSimpleQuery() {
+        return QueryBuilder_1.QueryBuilder.buildSimpleQuery(this);
+    }
+}
+exports.BinarySelectQuery = BinarySelectQuery;
+BinarySelectQuery.kind = Symbol("BinarySelectQuery");
+//# sourceMappingURL=BinarySelectQuery.js.map

package/dist/models/BinarySelectQuery.js.map

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

package/dist/models/CTEError.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CTENotFoundError = exports.InvalidCTENameError = exports.DuplicateCTEError = void 0;
+/**
+ * Error thrown when a CTE with the same name already exists
+ */
+class DuplicateCTEError extends Error {
+    constructor(cteName) {
+        super(`CTE '${cteName}' already exists in the query`);
+        this.cteName = cteName;
+        this.name = 'DuplicateCTEError';
+    }
+}
+exports.DuplicateCTEError = DuplicateCTEError;
+/**
+ * Error thrown when a CTE name is invalid
+ */
+class InvalidCTENameError extends Error {
+    constructor(cteName, reason) {
+        super(`Invalid CTE name '${cteName}': ${reason}`);
+        this.cteName = cteName;
+        this.name = 'InvalidCTENameError';
+    }
+}
+exports.InvalidCTENameError = InvalidCTENameError;
+/**
+ * Error thrown when trying to operate on a non-existent CTE
+ */
+class CTENotFoundError extends Error {
+    constructor(cteName) {
+        super(`CTE '${cteName}' not found in the query`);
+        this.cteName = cteName;
+        this.name = 'CTENotFoundError';
+    }
+}
+exports.CTENotFoundError = CTENotFoundError;
+//# sourceMappingURL=CTEError.js.map

package/dist/models/CTEError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CTEError.js","sourceRoot":"","sources":["../../src/models/CTEError.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IACxC,YAAmB,OAAe;QAC9B,KAAK,CAAC,QAAQ,OAAO,+BAA+B,CAAC,CAAC;QADvC,YAAO,GAAP,OAAO,CAAQ;QAE9B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ;AALD,8CAKC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC1C,YAAmB,OAAe,EAAE,MAAc;QAC9C,KAAK,CAAC,qBAAqB,OAAO,MAAM,MAAM,EAAE,CAAC,CAAC;QADnC,YAAO,GAAP,OAAO,CAAQ;QAE9B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AALD,kDAKC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACvC,YAAmB,OAAe;QAC9B,KAAK,CAAC,QAAQ,OAAO,0BAA0B,CAAC,CAAC;QADlC,YAAO,GAAP,OAAO,CAAQ;QAE9B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ;AALD,4CAKC"}