kysely 0.27.3 → 0.27.5

package/dist/esm/helpers/mssql.js

@@ -9,8 +9,26 @@ import { sql } from '../raw-builder/sql.js';
  * The plugin can be installed like this:
  *
  * ```ts
- * const db = new Kysely({
- *   dialect: new MssqlDialect(config),
+ * import { Kysely, MssqlDialect, ParseJSONResultsPlugin } from 'kysely'
+ * import * as Tarn from 'tarn'
+ * import * as Tedious from 'tedious'
+ * import type { Database } from 'type-editor' // imaginary module
+ *
+ * const db = new Kysely<Database>({
+ *   dialect: new MssqlDialect({
+ *     tarn: { options: { max: 10, min: 0 }, ...Tarn },
+ *     tedious: {
+ *       ...Tedious,
+ *       connectionFactory: () => new Tedious.Connection({
+ *         authentication: {
+ *           options: { password: 'password', userName: 'sa' },
+ *           type: 'default',
+ *         },
+ *         options: { database: 'test', port: 21433, trustServerCertificate: true },
+ *         server: 'localhost',
+ *       }),
+ *     },
+ *   }),
  *   plugins: [new ParseJSONResultsPlugin()]
  * })
  * ```
@@ -18,6 +36,8 @@ import { sql } from '../raw-builder/sql.js';
  * ### Examples
  *
  * ```ts
+ * import { jsonArrayFrom } from 'kysely/helpers/mssql'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -27,14 +47,14 @@ import { sql } from '../raw-builder/sql.js';
  *         .select(['pet.id as pet_id', 'pet.name'])
  *         .whereRef('pet.owner_id', '=', 'person.id')
  *         .orderBy('pet.name')
- *         .modifyEnd(sql`offset 0 rows`)
+ *         .offset(0)
  *     ).as('pets')
  *   ])
  *   .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 (MS SQL Server):
@@ -46,7 +66,7 @@ import { sql } from '../raw-builder/sql.js';
  *     from "pet"
  *     where "pet"."owner_id" = "person"."id"
  *     order by "pet"."name"
- *     offset 0 rows
+ *     offset @1 rows
  *   ) as "agg" for json path, include_null_values), '[]')
  * ) as "pets"
  * from "person"
@@ -66,8 +86,26 @@ export function jsonArrayFrom(expr) {
  * The plugin can be installed like this:
  *
  * ```ts
- * const db = new Kysely({
- *   dialect: new MssqlDialect(config),
+ * import { Kysely, MssqlDialect, ParseJSONResultsPlugin } from 'kysely'
+ * import * as Tarn from 'tarn'
+ * import * as Tedious from 'tedious'
+ * import type { Database } from 'type-editor' // imaginary module
+ *
+ * const db = new Kysely<Database>({
+ *   dialect: new MssqlDialect({
+ *     tarn: { options: { max: 10, min: 0 }, ...Tarn },
+ *     tedious: {
+ *       ...Tedious,
+ *       connectionFactory: () => new Tedious.Connection({
+ *         authentication: {
+ *           options: { password: 'password', userName: 'sa' },
+ *           type: 'default',
+ *         },
+ *         options: { database: 'test', port: 21433, trustServerCertificate: true },
+ *         server: 'localhost',
+ *       }),
+ *     },
+ *   }),
  *   plugins: [new ParseJSONResultsPlugin()]
  * })
  * ```
@@ -75,6 +113,8 @@ export function jsonArrayFrom(expr) {
  * ### Examples
  *
  * ```ts
+ * import { jsonObjectFrom } from 'kysely/helpers/mssql'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -88,9 +128,9 @@ export function jsonArrayFrom(expr) {
  *   ])
  *   .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 (MS SQL Server):
@@ -119,8 +159,26 @@ export function jsonObjectFrom(expr) {
  * The plugin can be installed like this:
  *
  * ```ts
- * const db = new Kysely({
- *   dialect: new MssqlDialect(config),
+ * import { Kysely, MssqlDialect, ParseJSONResultsPlugin } from 'kysely'
+ * import * as Tarn from 'tarn'
+ * import * as Tedious from 'tedious'
+ * import type { Database } from 'type-editor' // imaginary module
+ *
+ * const db = new Kysely<Database>({
+ *   dialect: new MssqlDialect({
+ *     tarn: { options: { max: 10, min: 0 }, ...Tarn },
+ *     tedious: {
+ *       ...Tedious,
+ *       connectionFactory: () => new Tedious.Connection({
+ *         authentication: {
+ *           options: { password: 'password', userName: 'sa' },
+ *           type: 'default',
+ *         },
+ *         options: { database: 'test', port: 21433, trustServerCertificate: true },
+ *         server: 'localhost',
+ *       }),
+ *     },
+ *   }),
  *   plugins: [new ParseJSONResultsPlugin()]
  * })
  * ```
@@ -128,6 +186,8 @@ export function jsonObjectFrom(expr) {
  * ### Examples
  *
  * ```ts
+ * import { jsonBuildObject } from 'kysely/helpers/mssql'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [

package/dist/esm/helpers/mysql.d.ts

@@ -6,13 +6,15 @@ import { Simplify } from '../util/type-utils.js';
  * A MySQL helper for aggregating a subquery into a JSON array.
  *
  * NOTE: This helper is only guaranteed to fully work with the built-in `MysqlDialect`.
- * While the produced SQL is compatible with all MySQL databases, some 3rd party dialects
+ * While the produced SQL is compatible with all MySQL databases, some third-party dialects
  * may not parse the nested JSON into arrays. In these cases you can use the built in
  * `ParseJSONResultsPlugin` to parse the results.
  *
  * ### Examples
  *
  * ```ts
+ * import { jsonArrayFrom } from 'kysely/helpers/mysql'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -26,9 +28,9 @@ import { Simplify } from '../util/type-utils.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 (MySQL):
@@ -55,13 +57,15 @@ export declare function jsonArrayFrom<O>(expr: SelectQueryBuilderExpression<O>):
  * The subquery must only return one row.
  *
  * NOTE: This helper is only guaranteed to fully work with the built-in `MysqlDialect`.
- * While the produced SQL is compatible with all MySQL databases, some 3rd party dialects
+ * While the produced SQL is compatible with all MySQL databases, some third-party dialects
  * may not parse the nested JSON into objects. In these cases you can use the built in
  * `ParseJSONResultsPlugin` to parse the results.
  *
  * ### Examples
  *
  * ```ts
+ * import { jsonObjectFrom } from 'kysely/helpers/mysql'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -75,9 +79,9 @@ export declare function jsonArrayFrom<O>(expr: SelectQueryBuilderExpression<O>):
  *   ])
  *   .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 (MySQL):
@@ -102,7 +106,7 @@ export declare function jsonObjectFrom<O>(expr: SelectQueryBuilderExpression<O>)
  * The MySQL `json_object` function.
  *
  * NOTE: This helper is only guaranteed to fully work with the built-in `MysqlDialect`.
- * While the produced SQL is compatible with all MySQL databases, some 3rd party dialects
+ * While the produced SQL is compatible with all MySQL databases, some third-party dialects
  * may not parse the nested JSON into objects. In these cases you can use the built in
  * `ParseJSONResultsPlugin` to parse the results.
  *
@@ -121,10 +125,10 @@ export declare function jsonObjectFrom<O>(expr: SelectQueryBuilderExpression<O>)
  *   ])
  *   .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 (MySQL):

package/dist/esm/helpers/mysql.js

@@ -5,13 +5,15 @@ import { getJsonObjectArgs } from '../util/json-object-args.js';
  * A MySQL helper for aggregating a subquery into a JSON array.
  *
  * NOTE: This helper is only guaranteed to fully work with the built-in `MysqlDialect`.
- * While the produced SQL is compatible with all MySQL databases, some 3rd party dialects
+ * While the produced SQL is compatible with all MySQL databases, some third-party dialects
  * may not parse the nested JSON into arrays. In these cases you can use the built in
  * `ParseJSONResultsPlugin` to parse the results.
  *
  * ### Examples
  *
  * ```ts
+ * import { jsonArrayFrom } from 'kysely/helpers/mysql'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -25,9 +27,9 @@ import { getJsonObjectArgs } from '../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 (MySQL):
@@ -56,13 +58,15 @@ export function jsonArrayFrom(expr) {
  * The subquery must only return one row.
  *
  * NOTE: This helper is only guaranteed to fully work with the built-in `MysqlDialect`.
- * While the produced SQL is compatible with all MySQL databases, some 3rd party dialects
+ * While the produced SQL is compatible with all MySQL databases, some third-party dialects
  * may not parse the nested JSON into objects. In these cases you can use the built in
  * `ParseJSONResultsPlugin` to parse the results.
  *
  * ### Examples
  *
  * ```ts
+ * import { jsonObjectFrom } from 'kysely/helpers/mysql'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -76,9 +80,9 @@ export function jsonArrayFrom(expr) {
  *   ])
  *   .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 (MySQL):
@@ -105,7 +109,7 @@ export function jsonObjectFrom(expr) {
  * The MySQL `json_object` function.
  *
  * NOTE: This helper is only guaranteed to fully work with the built-in `MysqlDialect`.
- * While the produced SQL is compatible with all MySQL databases, some 3rd party dialects
+ * While the produced SQL is compatible with all MySQL databases, some third-party dialects
  * may not parse the nested JSON into objects. In these cases you can use the built in
  * `ParseJSONResultsPlugin` to parse the results.
  *
@@ -124,10 +128,10 @@ export function jsonObjectFrom(expr) {
  *   ])
  *   .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 (MySQL):

package/dist/esm/helpers/postgres.d.ts

@@ -15,7 +15,7 @@ import { Simplify } from '../util/type-utils.js';
  * Please keep in mind that the helpers under the `kysely/helpers` folder, including
  * `jsonArrayFrom`, are not guaranteed to work with third party dialects. In order for
  * them to work, the dialect must automatically parse the `json` data type into
- * javascript JSON values like objects and arrays. Some dialects might simply return
+ * JavaScript JSON values like objects and arrays. Some dialects might simply return
  * the data as a JSON string. In these cases you can use the built in `ParseJSONResultsPlugin`
  * to parse the results.
  *
@@ -65,9 +65,9 @@ export declare function jsonArrayFrom<O>(expr: Expression<O>): RawBuilder<Simpli
  * use the `jsonObjectFrom` helper to fetch person's favorite pet along with the person's id.
  *
  * Please keep in mind that the helpers under the `kysely/helpers` folder, including
- * `jsonObjectFrom`, are not guaranteed to work with 3rd party dialects. In order for
+ * `jsonObjectFrom`, are not guaranteed to work with third-party dialects. In order for
  * them to work, the dialect must automatically parse the `json` data type into
- * javascript JSON values like objects and arrays. Some dialects might simply return
+ * JavaScript JSON values like objects and arrays. Some dialects might simply return
  * the data as a JSON string. In these cases you can use the built in `ParseJSONResultsPlugin`
  * to parse the results.
  *
@@ -107,13 +107,16 @@ export declare function jsonObjectFrom<O>(expr: Expression<O>): RawBuilder<Simpl
  * The PostgreSQL `json_build_object` function.
  *
  * NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
- * While the produced SQL is compatible with all PostgreSQL databases, some 3rd party dialects
+ * While the produced SQL is compatible with all PostgreSQL databases, some third-party dialects
  * may not parse the nested JSON into objects. In these cases you can use the built in
  * `ParseJSONResultsPlugin` to parse the results.
  *
  * ### Examples
  *
  * ```ts
+ * import { sql } from 'kysely'
+ * import { jsonBuildObject } from 'kysely/helpers/postgres'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -126,10 +129,10 @@ export declare function jsonObjectFrom<O>(expr: Expression<O>): RawBuilder<Simpl
  *   ])
  *   .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 (PostgreSQL):

package/dist/esm/helpers/postgres.js

@@ -14,7 +14,7 @@ import { sql } from '../raw-builder/sql.js';
  * Please keep in mind that the helpers under the `kysely/helpers` folder, including
  * `jsonArrayFrom`, are not guaranteed to work with third party dialects. In order for
  * them to work, the dialect must automatically parse the `json` data type into
- * javascript JSON values like objects and arrays. Some dialects might simply return
+ * JavaScript JSON values like objects and arrays. Some dialects might simply return
  * the data as a JSON string. In these cases you can use the built in `ParseJSONResultsPlugin`
  * to parse the results.
  *
@@ -66,9 +66,9 @@ export function jsonArrayFrom(expr) {
  * use the `jsonObjectFrom` helper to fetch person's favorite pet along with the person's id.
  *
  * Please keep in mind that the helpers under the `kysely/helpers` folder, including
- * `jsonObjectFrom`, are not guaranteed to work with 3rd party dialects. In order for
+ * `jsonObjectFrom`, are not guaranteed to work with third-party dialects. In order for
  * them to work, the dialect must automatically parse the `json` data type into
- * javascript JSON values like objects and arrays. Some dialects might simply return
+ * JavaScript JSON values like objects and arrays. Some dialects might simply return
  * the data as a JSON string. In these cases you can use the built in `ParseJSONResultsPlugin`
  * to parse the results.
  *
@@ -110,13 +110,16 @@ export function jsonObjectFrom(expr) {
  * The PostgreSQL `json_build_object` function.
  *
  * NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
- * While the produced SQL is compatible with all PostgreSQL databases, some 3rd party dialects
+ * While the produced SQL is compatible with all PostgreSQL databases, some third-party dialects
  * may not parse the nested JSON into objects. In these cases you can use the built in
  * `ParseJSONResultsPlugin` to parse the results.
  *
  * ### Examples
  *
  * ```ts
+ * import { sql } from 'kysely'
+ * import { jsonBuildObject } from 'kysely/helpers/postgres'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -129,10 +132,10 @@ export function jsonObjectFrom(expr) {
  *   ])
  *   .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 (PostgreSQL):

package/dist/esm/helpers/sqlite.d.ts

@@ -11,8 +11,14 @@ import { Simplify } from '../util/type-utils.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()]
  * })
  * ```
@@ -20,6 +26,8 @@ import { Simplify } from '../util/type-utils.js';
  * ### Examples
  *
  * ```ts
+ * import { jsonArrayFrom } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -33,9 +41,9 @@ import { Simplify } from '../util/type-utils.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):
@@ -67,8 +75,14 @@ export declare function jsonArrayFrom<O>(expr: SelectQueryBuilderExpression<O>):
  * 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()]
  * })
  * ```
@@ -76,6 +90,8 @@ export declare function jsonArrayFrom<O>(expr: SelectQueryBuilderExpression<O>):
  * ### Examples
  *
  * ```ts
+ * import { jsonObjectFrom } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -89,9 +105,9 @@ export declare function jsonArrayFrom<O>(expr: SelectQueryBuilderExpression<O>):
  *   ])
  *   .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):
@@ -121,8 +137,14 @@ export declare function jsonObjectFrom<O>(expr: SelectQueryBuilderExpression<O>)
  * 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()]
  * })
  * ```
@@ -130,6 +152,9 @@ export declare function jsonObjectFrom<O>(expr: SelectQueryBuilderExpression<O>)
  * ### Examples
  *
  * ```ts
+ * import { sql } from 'kysely'
+ * import { jsonBuildObject } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -142,10 +167,10 @@ export declare function jsonObjectFrom<O>(expr: SelectQueryBuilderExpression<O>)
  *   ])
  *   .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):

package/dist/esm/helpers/sqlite.js

@@ -10,8 +10,14 @@ import { getJsonObjectArgs } from '../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()]
  * })
  * ```
@@ -19,6 +25,8 @@ import { getJsonObjectArgs } from '../util/json-object-args.js';
  * ### Examples
  *
  * ```ts
+ * import { jsonArrayFrom } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -32,9 +40,9 @@ import { getJsonObjectArgs } from '../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):
@@ -68,8 +76,14 @@ export function jsonArrayFrom(expr) {
  * 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()]
  * })
  * ```
@@ -77,6 +91,8 @@ export function jsonArrayFrom(expr) {
  * ### Examples
  *
  * ```ts
+ * import { jsonObjectFrom } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -90,9 +106,9 @@ export function jsonArrayFrom(expr) {
  *   ])
  *   .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):
@@ -124,8 +140,14 @@ export function jsonObjectFrom(expr) {
  * 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()]
  * })
  * ```
@@ -133,6 +155,9 @@ export function jsonObjectFrom(expr) {
  * ### Examples
  *
  * ```ts
+ * import { sql } from 'kysely'
+ * import { jsonBuildObject } from 'kysely/helpers/sqlite'
+ *
  * const result = await db
  *   .selectFrom('person')
  *   .select((eb) => [
@@ -145,10 +170,10 @@ export function jsonObjectFrom(expr) {
  *   ])
  *   .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):