kysely 0.27.3 → 0.27.5

package/dist/cjs/helpers/sqlite.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.jsonBuildObject = exports.jsonObjectFrom = exports.jsonArrayFrom = void 0;
+exports.jsonArrayFrom = jsonArrayFrom;
+exports.jsonObjectFrom = jsonObjectFrom;
+exports.jsonBuildObject = jsonBuildObject;
 const sql_js_1 = require("../raw-builder/sql.js");
 const json_object_args_js_1 = require("../util/json-object-args.js");
 /**
@@ -12,8 +14,14 @@ const json_object_args_js_1 = require("../util/json-object-args.js");
  * The plugin can be installed like this:
  *
  * ```ts
- * const db = new Kysely({
- *   dialect: new SqliteDialect(config),
+ * import * as Sqlite from 'better-sqlite3'
+ * import { Kysely, ParseJSONResultsPlugin, SqliteDialect } from 'kysely'
+ * import type { Database } from 'type-editor' // imaginary module
+ *
+ * const db = new Kysely<Database>({
+ *   dialect: new SqliteDialect({
+ *     database: new Sqlite(':memory:')
+ *   }),
  *   plugins: [new ParseJSONResultsPlugin()]
  * })
  * ```
@@ -21,6 +29,8 @@ const json_object_args_js_1 = require("../util/json-object-args.js");
  * ### Examples
  *
  * ```ts
+ * import { jsonArrayFrom } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -34,9 +44,9 @@ const json_object_args_js_1 = require("../util/json-object-args.js");
  *   ])
  *   .execute()
  *
- * result[0].id
- * result[0].pets[0].pet_id
- * result[0].pets[0].name
+ * result[0]?.id
+ * result[0]?.pets[0].pet_id
+ * result[0]?.pets[0].name
  * ```
  *
  * The generated SQL (SQLite):
@@ -59,7 +69,6 @@ const json_object_args_js_1 = require("../util/json-object-args.js");
 function jsonArrayFrom(expr) {
     return (0, sql_js_1.sql) `(select coalesce(json_group_array(json_object(${sql_js_1.sql.join(getSqliteJsonObjectArgs(expr.toOperationNode(), 'agg'))})), '[]') from ${expr} as agg)`;
 }
-exports.jsonArrayFrom = jsonArrayFrom;
 /**
  * A SQLite helper for turning a subquery into a JSON object.
  *
@@ -71,8 +80,14 @@ exports.jsonArrayFrom = jsonArrayFrom;
  * The plugin can be installed like this:
  *
  * ```ts
- * const db = new Kysely({
- *   dialect: new SqliteDialect(config),
+ * import * as Sqlite from 'better-sqlite3'
+ * import { Kysely, ParseJSONResultsPlugin, SqliteDialect } from 'kysely'
+ * import type { Database } from 'type-editor' // imaginary module
+ *
+ * const db = new Kysely<Database>({
+ *   dialect: new SqliteDialect({
+ *     database: new Sqlite(':memory:')
+ *   }),
  *   plugins: [new ParseJSONResultsPlugin()]
  * })
  * ```
@@ -80,6 +95,8 @@ exports.jsonArrayFrom = jsonArrayFrom;
  * ### Examples
  *
  * ```ts
+ * import { jsonObjectFrom } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -93,9 +110,9 @@ exports.jsonArrayFrom = jsonArrayFrom;
  *   ])
  *   .execute()
  *
- * result[0].id
- * result[0].favorite_pet.pet_id
- * result[0].favorite_pet.name
+ * result[0]?.id
+ * result[0]?.favorite_pet?.pet_id
+ * result[0]?.favorite_pet?.name
  * ```
  *
  * The generated SQL (SQLite):
@@ -118,7 +135,6 @@ exports.jsonArrayFrom = jsonArrayFrom;
 function jsonObjectFrom(expr) {
     return (0, sql_js_1.sql) `(select json_object(${sql_js_1.sql.join(getSqliteJsonObjectArgs(expr.toOperationNode(), 'obj'))}) from ${expr} as obj)`;
 }
-exports.jsonObjectFrom = jsonObjectFrom;
 /**
  * The SQLite `json_object` function.
  *
@@ -128,8 +144,14 @@ exports.jsonObjectFrom = jsonObjectFrom;
  * The plugin can be installed like this:
  *
  * ```ts
- * const db = new Kysely({
- *   dialect: new SqliteDialect(config),
+ * import * as Sqlite from 'better-sqlite3'
+ * import { Kysely, ParseJSONResultsPlugin, SqliteDialect } from 'kysely'
+ * import type { Database } from 'type-editor' // imaginary module
+ *
+ * const db = new Kysely<Database>({
+ *   dialect: new SqliteDialect({
+ *     database: new Sqlite(':memory:')
+ *   }),
  *   plugins: [new ParseJSONResultsPlugin()]
  * })
  * ```
@@ -137,6 +159,9 @@ exports.jsonObjectFrom = jsonObjectFrom;
  * ### Examples
  *
  * ```ts
+ * import { sql } from 'kysely'
+ * import { jsonBuildObject } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -149,10 +174,10 @@ exports.jsonObjectFrom = jsonObjectFrom;
  *   ])
  *   .execute()
  *
- * result[0].id
- * result[0].name.first
- * result[0].name.last
- * result[0].name.full
+ * result[0]?.id
+ * result[0]?.name.first
+ * result[0]?.name.last
+ * result[0]?.name.full
  * ```
  *
  * The generated SQL (SQLite):
@@ -169,7 +194,6 @@ exports.jsonObjectFrom = jsonObjectFrom;
 function jsonBuildObject(obj) {
     return (0, sql_js_1.sql) `json_object(${sql_js_1.sql.join(Object.keys(obj).flatMap((k) => [sql_js_1.sql.lit(k), obj[k]]))})`;
 }
-exports.jsonBuildObject = jsonBuildObject;
 function getSqliteJsonObjectArgs(node, table) {
     try {
         return (0, json_object_args_js_1.getJsonObjectArgs)(node, table);

package/dist/cjs/index.d.ts

@@ -5,6 +5,7 @@ export { ExpressionBuilder, expressionBuilder, } from './expression/expression-b
 export * from './expression/expression-wrapper.js';
 export * from './query-builder/where-interface.js';
 export * from './query-builder/returning-interface.js';
+export * from './query-builder/output-interface.js';
 export * from './query-builder/having-interface.js';
 export * from './query-builder/select-query-builder.js';
 export * from './query-builder/insert-query-builder.js';
@@ -91,17 +92,21 @@ export * from './plugin/with-schema/with-schema-plugin.js';
 export * from './plugin/parse-json-results/parse-json-results-plugin.js';
 export * from './operation-node/add-column-node.js';
 export * from './operation-node/add-constraint-node.js';
+export * from './operation-node/add-index-node.js';
+export * from './operation-node/aggregate-function-node.js';
 export * from './operation-node/alias-node.js';
 export * from './operation-node/alter-column-node.js';
 export * from './operation-node/alter-table-node.js';
 export * from './operation-node/and-node.js';
+export * from './operation-node/binary-operation-node.js';
 export * from './operation-node/case-node.js';
+export * from './operation-node/cast-node.js';
 export * from './operation-node/check-constraint-node.js';
 export * from './operation-node/column-definition-node.js';
 export * from './operation-node/column-node.js';
 export * from './operation-node/column-update-node.js';
-export * from './operation-node/common-table-expression-node.js';
 export * from './operation-node/common-table-expression-name-node.js';
+export * from './operation-node/common-table-expression-node.js';
 export * from './operation-node/constraint-node.js';
 export * from './operation-node/create-index-node.js';
 export * from './operation-node/create-schema-node.js';
@@ -109,6 +114,7 @@ export * from './operation-node/create-table-node.js';
 export * from './operation-node/create-type-node.js';
 export * from './operation-node/create-view-node.js';
 export * from './operation-node/data-type-node.js';
+export * from './operation-node/default-insert-value-node.js';
 export * from './operation-node/default-value-node.js';
 export * from './operation-node/delete-query-node.js';
 export * from './operation-node/drop-column-node.js';
@@ -118,8 +124,11 @@ export * from './operation-node/drop-schema-node.js';
 export * from './operation-node/drop-table-node.js';
 export * from './operation-node/drop-type-node.js';
 export * from './operation-node/drop-view-node.js';
+export * from './operation-node/explain-node.js';
+export * from './operation-node/fetch-node.js';
 export * from './operation-node/foreign-key-constraint-node.js';
 export * from './operation-node/from-node.js';
+export * from './operation-node/function-node.js';
 export * from './operation-node/generated-node.js';
 export * from './operation-node/group-by-item-node.js';
 export * from './operation-node/group-by-node.js';
@@ -127,8 +136,14 @@ export * from './operation-node/having-node.js';
 export * from './operation-node/identifier-node.js';
 export * from './operation-node/insert-query-node.js';
 export * from './operation-node/join-node.js';
+export * from './operation-node/json-operator-chain-node.js';
+export * from './operation-node/json-path-leg-node.js';
+export * from './operation-node/json-path-node.js';
+export * from './operation-node/json-reference-node.js';
 export * from './operation-node/limit-node.js';
 export * from './operation-node/list-node.js';
+export * from './operation-node/matched-node.js';
+export * from './operation-node/merge-query-node.js';
 export * from './operation-node/modify-column-node.js';
 export * from './operation-node/offset-node.js';
 export * from './operation-node/on-conflict-node.js';
@@ -142,7 +157,11 @@ export * from './operation-node/operator-node.js';
 export * from './operation-node/or-node.js';
 export * from './operation-node/order-by-item-node.js';
 export * from './operation-node/order-by-node.js';
+export * from './operation-node/output-node.js';
+export * from './operation-node/over-node.js';
 export * from './operation-node/parens-node.js';
+export * from './operation-node/partition-by-item-node.js';
+export * from './operation-node/partition-by-node.js';
 export * from './operation-node/primary-constraint-node.js';
 export * from './operation-node/primitive-value-list-node.js';
 export * from './operation-node/query-node.js';
@@ -151,38 +170,26 @@ export * from './operation-node/reference-node.js';
 export * from './operation-node/references-node.js';
 export * from './operation-node/rename-column-node.js';
 export * from './operation-node/returning-node.js';
+export * from './operation-node/schemable-identifier-node.js';
 export * from './operation-node/select-all-node.js';
-export * from './operation-node/select-query-node.js';
+export * from './operation-node/select-modifier-node.js';
 export * from './operation-node/select-query-node.js';
 export * from './operation-node/selection-node.js';
+export * from './operation-node/set-operation-node.js';
+export * from './operation-node/simple-reference-expression-node.js';
 export * from './operation-node/table-node.js';
+export * from './operation-node/top-node.js';
+export * from './operation-node/tuple-node.js';
+export * from './operation-node/unary-operation-node.js';
 export * from './operation-node/unique-constraint-node.js';
 export * from './operation-node/update-query-node.js';
+export * from './operation-node/using-node.js';
 export * from './operation-node/value-list-node.js';
 export * from './operation-node/value-node.js';
 export * from './operation-node/values-node.js';
 export * from './operation-node/when-node.js';
 export * from './operation-node/where-node.js';
 export * from './operation-node/with-node.js';
-export * from './operation-node/explain-node.js';
-export * from './operation-node/default-insert-value-node.js';
-export * from './operation-node/aggregate-function-node.js';
-export * from './operation-node/over-node.js';
-export * from './operation-node/partition-by-node.js';
-export * from './operation-node/partition-by-item-node.js';
-export * from './operation-node/set-operation-node.js';
-export * from './operation-node/binary-operation-node.js';
-export * from './operation-node/unary-operation-node.js';
-export * from './operation-node/using-node.js';
-export * from './operation-node/json-reference-node.js';
-export * from './operation-node/json-path-leg-node.js';
-export * from './operation-node/json-path-node.js';
-export * from './operation-node/json-operator-chain-node.js';
-export * from './operation-node/tuple-node.js';
-export * from './operation-node/merge-query-node.js';
-export * from './operation-node/matched-node.js';
-export * from './operation-node/fetch-node.js';
-export * from './operation-node/top-node.js';
 export * from './util/column-type.js';
 export * from './util/compilable.js';
 export * from './util/explainable.js';

package/dist/cjs/index.js

@@ -23,6 +23,7 @@ Object.defineProperty(exports, "expressionBuilder", { enumerable: true, get: fun
 __exportStar(require("./expression/expression-wrapper.js"), exports);
 __exportStar(require("./query-builder/where-interface.js"), exports);
 __exportStar(require("./query-builder/returning-interface.js"), exports);
+__exportStar(require("./query-builder/output-interface.js"), exports);
 __exportStar(require("./query-builder/having-interface.js"), exports);
 __exportStar(require("./query-builder/select-query-builder.js"), exports);
 __exportStar(require("./query-builder/insert-query-builder.js"), exports);
@@ -109,17 +110,21 @@ __exportStar(require("./plugin/with-schema/with-schema-plugin.js"), exports);
 __exportStar(require("./plugin/parse-json-results/parse-json-results-plugin.js"), exports);
 __exportStar(require("./operation-node/add-column-node.js"), exports);
 __exportStar(require("./operation-node/add-constraint-node.js"), exports);
+__exportStar(require("./operation-node/add-index-node.js"), exports);
+__exportStar(require("./operation-node/aggregate-function-node.js"), exports);
 __exportStar(require("./operation-node/alias-node.js"), exports);
 __exportStar(require("./operation-node/alter-column-node.js"), exports);
 __exportStar(require("./operation-node/alter-table-node.js"), exports);
 __exportStar(require("./operation-node/and-node.js"), exports);
+__exportStar(require("./operation-node/binary-operation-node.js"), exports);
 __exportStar(require("./operation-node/case-node.js"), exports);
+__exportStar(require("./operation-node/cast-node.js"), exports);
 __exportStar(require("./operation-node/check-constraint-node.js"), exports);
 __exportStar(require("./operation-node/column-definition-node.js"), exports);
 __exportStar(require("./operation-node/column-node.js"), exports);
 __exportStar(require("./operation-node/column-update-node.js"), exports);
-__exportStar(require("./operation-node/common-table-expression-node.js"), exports);
 __exportStar(require("./operation-node/common-table-expression-name-node.js"), exports);
+__exportStar(require("./operation-node/common-table-expression-node.js"), exports);
 __exportStar(require("./operation-node/constraint-node.js"), exports);
 __exportStar(require("./operation-node/create-index-node.js"), exports);
 __exportStar(require("./operation-node/create-schema-node.js"), exports);
@@ -127,6 +132,7 @@ __exportStar(require("./operation-node/create-table-node.js"), exports);
 __exportStar(require("./operation-node/create-type-node.js"), exports);
 __exportStar(require("./operation-node/create-view-node.js"), exports);
 __exportStar(require("./operation-node/data-type-node.js"), exports);
+__exportStar(require("./operation-node/default-insert-value-node.js"), exports);
 __exportStar(require("./operation-node/default-value-node.js"), exports);
 __exportStar(require("./operation-node/delete-query-node.js"), exports);
 __exportStar(require("./operation-node/drop-column-node.js"), exports);
@@ -136,8 +142,11 @@ __exportStar(require("./operation-node/drop-schema-node.js"), exports);
 __exportStar(require("./operation-node/drop-table-node.js"), exports);
 __exportStar(require("./operation-node/drop-type-node.js"), exports);
 __exportStar(require("./operation-node/drop-view-node.js"), exports);
+__exportStar(require("./operation-node/explain-node.js"), exports);
+__exportStar(require("./operation-node/fetch-node.js"), exports);
 __exportStar(require("./operation-node/foreign-key-constraint-node.js"), exports);
 __exportStar(require("./operation-node/from-node.js"), exports);
+__exportStar(require("./operation-node/function-node.js"), exports);
 __exportStar(require("./operation-node/generated-node.js"), exports);
 __exportStar(require("./operation-node/group-by-item-node.js"), exports);
 __exportStar(require("./operation-node/group-by-node.js"), exports);
@@ -145,8 +154,14 @@ __exportStar(require("./operation-node/having-node.js"), exports);
 __exportStar(require("./operation-node/identifier-node.js"), exports);
 __exportStar(require("./operation-node/insert-query-node.js"), exports);
 __exportStar(require("./operation-node/join-node.js"), exports);
+__exportStar(require("./operation-node/json-operator-chain-node.js"), exports);
+__exportStar(require("./operation-node/json-path-leg-node.js"), exports);
+__exportStar(require("./operation-node/json-path-node.js"), exports);
+__exportStar(require("./operation-node/json-reference-node.js"), exports);
 __exportStar(require("./operation-node/limit-node.js"), exports);
 __exportStar(require("./operation-node/list-node.js"), exports);
+__exportStar(require("./operation-node/matched-node.js"), exports);
+__exportStar(require("./operation-node/merge-query-node.js"), exports);
 __exportStar(require("./operation-node/modify-column-node.js"), exports);
 __exportStar(require("./operation-node/offset-node.js"), exports);
 __exportStar(require("./operation-node/on-conflict-node.js"), exports);
@@ -160,7 +175,11 @@ __exportStar(require("./operation-node/operator-node.js"), exports);
 __exportStar(require("./operation-node/or-node.js"), exports);
 __exportStar(require("./operation-node/order-by-item-node.js"), exports);
 __exportStar(require("./operation-node/order-by-node.js"), exports);
+__exportStar(require("./operation-node/output-node.js"), exports);
+__exportStar(require("./operation-node/over-node.js"), exports);
 __exportStar(require("./operation-node/parens-node.js"), exports);
+__exportStar(require("./operation-node/partition-by-item-node.js"), exports);
+__exportStar(require("./operation-node/partition-by-node.js"), exports);
 __exportStar(require("./operation-node/primary-constraint-node.js"), exports);
 __exportStar(require("./operation-node/primitive-value-list-node.js"), exports);
 __exportStar(require("./operation-node/query-node.js"), exports);
@@ -169,38 +188,26 @@ __exportStar(require("./operation-node/reference-node.js"), exports);
 __exportStar(require("./operation-node/references-node.js"), exports);
 __exportStar(require("./operation-node/rename-column-node.js"), exports);
 __exportStar(require("./operation-node/returning-node.js"), exports);
+__exportStar(require("./operation-node/schemable-identifier-node.js"), exports);
 __exportStar(require("./operation-node/select-all-node.js"), exports);
-__exportStar(require("./operation-node/select-query-node.js"), exports);
+__exportStar(require("./operation-node/select-modifier-node.js"), exports);
 __exportStar(require("./operation-node/select-query-node.js"), exports);
 __exportStar(require("./operation-node/selection-node.js"), exports);
+__exportStar(require("./operation-node/set-operation-node.js"), exports);
+__exportStar(require("./operation-node/simple-reference-expression-node.js"), exports);
 __exportStar(require("./operation-node/table-node.js"), exports);
+__exportStar(require("./operation-node/top-node.js"), exports);
+__exportStar(require("./operation-node/tuple-node.js"), exports);
+__exportStar(require("./operation-node/unary-operation-node.js"), exports);
 __exportStar(require("./operation-node/unique-constraint-node.js"), exports);
 __exportStar(require("./operation-node/update-query-node.js"), exports);
+__exportStar(require("./operation-node/using-node.js"), exports);
 __exportStar(require("./operation-node/value-list-node.js"), exports);
 __exportStar(require("./operation-node/value-node.js"), exports);
 __exportStar(require("./operation-node/values-node.js"), exports);
 __exportStar(require("./operation-node/when-node.js"), exports);
 __exportStar(require("./operation-node/where-node.js"), exports);
 __exportStar(require("./operation-node/with-node.js"), exports);
-__exportStar(require("./operation-node/explain-node.js"), exports);
-__exportStar(require("./operation-node/default-insert-value-node.js"), exports);
-__exportStar(require("./operation-node/aggregate-function-node.js"), exports);
-__exportStar(require("./operation-node/over-node.js"), exports);
-__exportStar(require("./operation-node/partition-by-node.js"), exports);
-__exportStar(require("./operation-node/partition-by-item-node.js"), exports);
-__exportStar(require("./operation-node/set-operation-node.js"), exports);
-__exportStar(require("./operation-node/binary-operation-node.js"), exports);
-__exportStar(require("./operation-node/unary-operation-node.js"), exports);
-__exportStar(require("./operation-node/using-node.js"), exports);
-__exportStar(require("./operation-node/json-reference-node.js"), exports);
-__exportStar(require("./operation-node/json-path-leg-node.js"), exports);
-__exportStar(require("./operation-node/json-path-node.js"), exports);
-__exportStar(require("./operation-node/json-operator-chain-node.js"), exports);
-__exportStar(require("./operation-node/tuple-node.js"), exports);
-__exportStar(require("./operation-node/merge-query-node.js"), exports);
-__exportStar(require("./operation-node/matched-node.js"), exports);
-__exportStar(require("./operation-node/fetch-node.js"), exports);
-__exportStar(require("./operation-node/top-node.js"), exports);
 __exportStar(require("./util/column-type.js"), exports);
 __exportStar(require("./util/compilable.js"), exports);
 __exportStar(require("./util/explainable.js"), exports);