kysely 0.27.0 → 0.27.1

package/dist/esm/query-builder/select-query-builder.js

@@ -2,6 +2,7 @@
 import { AliasNode } from '../operation-node/alias-node.js';
 import { SelectModifierNode } from '../operation-node/select-modifier-node.js';
 import { parseJoin, } from '../parser/join-parser.js';
+import { parseTable } from '../parser/table-parser.js';
 import { parseSelectArg, parseSelectAll, } from '../parser/select-parser.js';
 import { parseReferenceExpressionOrList, } from '../parser/reference-parser.js';
 import { SelectQueryNode } from '../operation-node/select-query-node.js';
@@ -10,13 +11,14 @@ import { parseOrderBy, } from '../parser/order-by-parser.js';
 import { preventAwait } from '../util/prevent-await.js';
 import { LimitNode } from '../operation-node/limit-node.js';
 import { OffsetNode } from '../operation-node/offset-node.js';
-import { freeze } from '../util/object-utils.js';
+import { asArray, freeze } from '../util/object-utils.js';
 import { parseGroupBy } from '../parser/group-by-parser.js';
 import { isNoResultErrorConstructor, NoResultError, } from './no-result-error.js';
 import { IdentifierNode } from '../operation-node/identifier-node.js';
 import { parseSetOperations, } from '../parser/set-operation-parser.js';
 import { parseValueBinaryOperationOrExpression, parseReferentialBinaryOperation, } from '../parser/binary-operation-parser.js';
 import { ExpressionWrapper } from '../expression/expression-wrapper.js';
+import { parseValueExpression, } from '../parser/value-parser.js';
 class SelectQueryBuilderImpl {
     #props;
     constructor(props) {
@@ -82,28 +84,28 @@ class SelectQueryBuilderImpl {
             queryNode: SelectQueryNode.cloneWithFrontModifier(this.#props.queryNode, SelectModifierNode.create('Distinct')),
         });
     }
-    forUpdate() {
+    forUpdate(of) {
         return new SelectQueryBuilderImpl({
             ...this.#props,
-            queryNode: SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, SelectModifierNode.create('ForUpdate')),
+            queryNode: SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, SelectModifierNode.create('ForUpdate', of ? asArray(of).map(parseTable) : undefined)),
         });
     }
-    forShare() {
+    forShare(of) {
         return new SelectQueryBuilderImpl({
             ...this.#props,
-            queryNode: SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, SelectModifierNode.create('ForShare')),
+            queryNode: SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, SelectModifierNode.create('ForShare', of ? asArray(of).map(parseTable) : undefined)),
         });
     }
-    forKeyShare() {
+    forKeyShare(of) {
         return new SelectQueryBuilderImpl({
             ...this.#props,
-            queryNode: SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, SelectModifierNode.create('ForKeyShare')),
+            queryNode: SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, SelectModifierNode.create('ForKeyShare', of ? asArray(of).map(parseTable) : undefined)),
         });
     }
-    forNoKeyUpdate() {
+    forNoKeyUpdate(of) {
         return new SelectQueryBuilderImpl({
             ...this.#props,
-            queryNode: SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, SelectModifierNode.create('ForNoKeyUpdate')),
+            queryNode: SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, SelectModifierNode.create('ForNoKeyUpdate', of ? asArray(of).map(parseTable) : undefined)),
         });
     }
     skipLocked() {
@@ -175,13 +177,13 @@ class SelectQueryBuilderImpl {
     limit(limit) {
         return new SelectQueryBuilderImpl({
             ...this.#props,
-            queryNode: SelectQueryNode.cloneWithLimit(this.#props.queryNode, LimitNode.create(limit)),
+            queryNode: SelectQueryNode.cloneWithLimit(this.#props.queryNode, LimitNode.create(parseValueExpression(limit))),
         });
     }
     offset(offset) {
         return new SelectQueryBuilderImpl({
             ...this.#props,
-            queryNode: SelectQueryNode.cloneWithOffset(this.#props.queryNode, OffsetNode.create(offset)),
+            queryNode: SelectQueryNode.cloneWithOffset(this.#props.queryNode, OffsetNode.create(parseValueExpression(offset))),
         });
     }
     union(expression) {

package/dist/esm/query-builder/update-query-builder.d.ts

@@ -829,10 +829,10 @@ export declare class UpdateQueryBuilder<DB, UT extends keyof DB, TB extends keyo
     /**
      * Change the output type of the query.
      *
-     * You should only use this method as the last resort if the types
-     * don't support your use case.
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of this `UpdateQueryBuilder` with a new output type.
      */
-    $castTo<T>(): UpdateQueryBuilder<DB, UT, TB, T>;
+    $castTo<C>(): UpdateQueryBuilder<DB, UT, TB, C>;
     /**
      * Narrows (parts of) the output type of the query.
      *

package/dist/esm/query-builder/update-query-builder.js

@@ -154,8 +154,8 @@ export class UpdateQueryBuilder {
     /**
      * Change the output type of the query.
      *
-     * You should only use this method as the last resort if the types
-     * don't support your use case.
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of this `UpdateQueryBuilder` with a new output type.
      */
     $castTo() {
         return new UpdateQueryBuilder(this.#props);

package/dist/esm/query-compiler/default-query-compiler.js

@@ -162,6 +162,10 @@ export class DefaultQueryCompiler extends OperationNodeVisitor {
             this.append(' ');
             this.visitNode(node.values);
         }
+        if (node.defaultValues) {
+            this.append(' ');
+            this.append('default values');
+        }
         if (node.onConflict) {
             this.append(' ');
             this.visitNode(node.onConflict);
@@ -867,6 +871,10 @@ export class DefaultQueryCompiler extends OperationNodeVisitor {
         else {
             this.append(SELECT_MODIFIER_SQL[node.modifier]);
         }
+        if (node.of) {
+            this.append(' of ');
+            this.compileList(node.of, ', ');
+        }
     }
     visitCreateType(node) {
         this.append('create type ');

package/dist/esm/raw-builder/raw-builder.d.ts

@@ -130,7 +130,17 @@ export interface RawBuilder<O> extends AliasableExpression<O> {
      * This method call doesn't change the SQL in any way. This methods simply
      * returns a copy of this `RawBuilder` with a new output type.
      */
-    $castTo<T>(): RawBuilder<T>;
+    $castTo<C>(): RawBuilder<C>;
+    /**
+     * Omit null from the expression's type.
+     *
+     * This function can be useful in cases where you know an expression can't be
+     * null, but Kysely is unable to infer it.
+     *
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of `this` with a new output type.
+     */
+    $notNull(): RawBuilder<Exclude<O, null>>;
     /**
      * Adds a plugin for this SQL snippet.
      */

package/dist/esm/raw-builder/raw-builder.js

@@ -22,6 +22,9 @@ class RawBuilderImpl {
     $castTo() {
         return new RawBuilderImpl({ ...this.#props });
     }
+    $notNull() {
+        return new RawBuilderImpl(this.#props);
+    }
     withPlugin(plugin) {
         return new RawBuilderImpl({
             ...this.#props,

package/dist/esm/raw-builder/sql.js

@@ -1,5 +1,6 @@
 /// <reference types="./sql.d.ts" />
 import { IdentifierNode } from '../operation-node/identifier-node.js';
+import { isOperationNodeSource } from '../operation-node/operation-node-source.js';
 import { RawNode } from '../operation-node/raw-node.js';
 import { ValueNode } from '../operation-node/value-node.js';
 import { parseStringReference } from '../parser/reference-parser.js';
@@ -10,7 +11,7 @@ import { createRawBuilder } from './raw-builder.js';
 export const sql = Object.assign((sqlFragments, ...parameters) => {
     return createRawBuilder({
         queryId: createQueryId(),
-        rawNode: RawNode.create(sqlFragments, parameters?.map(parseValueExpression) ?? []),
+        rawNode: RawNode.create(sqlFragments, parameters?.map(parseParameter) ?? []),
     });
 }, {
     ref(columnReference) {
@@ -62,7 +63,7 @@ export const sql = Object.assign((sqlFragments, ...parameters) => {
         const nodes = new Array(2 * array.length - 1);
         const sep = separator.toOperationNode();
         for (let i = 0; i < array.length; ++i) {
-            nodes[2 * i] = parseValueExpression(array[i]);
+            nodes[2 * i] = parseParameter(array[i]);
             if (i !== array.length - 1) {
                 nodes[2 * i + 1] = sep;
             }
@@ -73,3 +74,9 @@ export const sql = Object.assign((sqlFragments, ...parameters) => {
         });
     },
 });
+function parseParameter(param) {
+    if (isOperationNodeSource(param)) {
+        return param.toOperationNode();
+    }
+    return parseValueExpression(param);
+}

package/dist/esm/util/object-utils.d.ts

@@ -16,7 +16,7 @@ export declare function isArrayBufferOrView(obj: unknown): obj is ArrayBuffer |
 export declare function isPlainObject(obj: unknown): obj is Record<string, unknown>;
 export declare function getLast<T>(arr: ArrayLike<T>): T | undefined;
 export declare function freeze<T>(obj: T): Readonly<T>;
-export declare function asArray<T>(arg: T | T[]): T[];
+export declare function asArray<T>(arg: T | ReadonlyArray<T>): ReadonlyArray<T>;
 export declare function asReadonlyArray<T>(arg: T | ReadonlyArray<T>): ReadonlyArray<T>;
 export declare function isReadonlyArray(arg: unknown): arg is ReadonlyArray<unknown>;
 export declare function noop<T>(obj: T): T;

package/dist/esm/util/object-utils.js

@@ -57,7 +57,7 @@ export function freeze(obj) {
     return Object.freeze(obj);
 }
 export function asArray(arg) {
-    if (Array.isArray(arg)) {
+    if (isReadonlyArray(arg)) {
         return arg;
     }
     else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kysely",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Type safe SQL query builder",
   "repository": {
     "type": "git",
@@ -40,14 +40,10 @@
   },
   "scripts": {
     "clean": "rm -rf dist & rm -rf test/node/dist & rm -rf test/browser/bundle.js & rm -rf helpers",
-    "test": "npm run build && npm run test:node:build && concurrently -n node,typings,esmimports \"npm run test:node\" \"npm run test:typings\" \"npm run test:esmimports\"",
+    "test": "npm run build && npm run test:node:build && npm run test:node:run && npm run test:typings && npm run test:esmimports",
     "test:node:build": "tsc -p test/node",
-    "test:node": "concurrently -n postgres,mysql,mssql,sqlite \"npm run test:node:postgres\" \"npm run test:node:mysql\" \"npm run test:node:mssql\" \"npm run test:node:sqlite\"",
-    "test:node:postgres": "cross-env DIALECT=postgres npm run test:node:run",
-    "test:node:mysql": "cross-env DIALECT=mysql npm run test:node:run",
-    "test:node:mssql": "cross-env DIALECT=mssql npm run test:node:run",
-    "test:node:sqlite": "cross-env DIALECT=sqlite npm run test:node:run",
-    "test:node:run": "mocha --reporter min --timeout 15000 test/node/dist/**/*.test.js",
+    "test:node": "npm run build && npm run test:node:build && npm run test:node:run",
+    "test:node:run": "mocha --timeout 15000 test/node/dist/**/*.test.js",
     "test:browser:build": "rm -rf test/browser/bundle.js && esbuild test/browser/main.ts --bundle --outfile=test/browser/bundle.js",
     "test:browser": "npm run build && npm run test:browser:build && node test/browser/test.js",
     "test:bun": "npm run build && cd test/bun && bun install && bun run test",
@@ -57,7 +53,7 @@
     "test:esmimports": "node scripts/check-esm-imports.js",
     "test:esbuild": "esbuild --bundle --platform=node --external:pg-native dist/esm/index.js --outfile=/dev/null",
     "prettier": "prettier --write 'src/**/*.ts' 'test/**/*.ts'",
-    "build": "npm run clean && concurrently -n esm,cjs \"npm run build:esm\" \"npm run build:cjs\" && concurrently -n modulefix,docfix \"npm run script:module-fixup\" \"npm run script:copy-interface-doc\"",
+    "build": "npm run clean && npm run build:esm && npm run build:cjs && npm run script:module-fixup && npm run script:copy-interface-doc",
     "build:esm": "tsc -p tsconfig.json && npm run script:add-deno-type-references",
     "build:cjs": "tsc -p tsconfig-cjs.json",
     "script:module-fixup": "node scripts/module-fixup.js",
@@ -87,8 +83,6 @@
     "chai": "^4.3.7",
     "chai-as-promised": "^7.1.1",
     "chai-subset": "^1.6.0",
-    "concurrently": "^8.1.0",
-    "cross-env": "^7.0.3",
     "esbuild": "^0.17.19",
     "mocha": "^10.2.0",
     "mysql2": "^3.3.3",