kysely 0.27.5 → 0.27.6

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,183 @@
+# ~~Contributor Covenant Code of Conduct~~ Kysely Code of Conduct
+
+## Our Pledge
+
+~~We as members, contributors, and leaders pledge to make participation in our~~
+~~community a harassment-free experience for everyone, regardless of age, body~~
+~~size, visible or invisible disability, ethnicity, sex characteristics, gender~~
+~~identity and expression, level of experience, education, socio-economic status,~~
+~~nationality, personal appearance, race, religion, or sexual identity~~
+~~and orientation.~~
+
+~~We pledge to act and interact in ways that contribute to an open, welcoming,~~
+~~diverse, inclusive, and healthy community.~~
+
+Don't be an asshole.
+You are not entitled to other people's time, energy, or attention.
+
+That's it. That's the pledge.
+
+## Our Standards
+
+~~Examples of behavior that contributes to a positive environment for our~~
+~~community include:~~
+
+~~* Demonstrating empathy and kindness toward other people~~
+~~* Being respectful of differing opinions, viewpoints, and experiences~~
+~~* Giving and gracefully accepting constructive feedback~~
+~~* Accepting responsibility and apologizing to those affected by our mistakes,~~
+  ~~and learning from the experience~~
+~~* Focusing on what is best not just for us as individuals, but for the~~
+  ~~overall community~~
+
+~~Examples of unacceptable behavior include:~~
+
+~~* The use of sexualized language or imagery, and sexual attention or~~
+  ~~advances of any kind~~
+~~* Trolling, insulting or derogatory comments, and personal or political attacks~~
+~~* Public or private harassment~~
+~~* Publishing others' private information, such as a physical or email~~
+  ~~address, without their explicit permission~~
+~~* Other conduct which could reasonably be considered inappropriate in a~~
+  ~~professional setting~~
+
+Don't be an asshole.
+You are not entitled to other people's time, energy, or attention.
+
+Examples of being an asshole or entitled include:
+
+* Probably not the best idea to come in complaining and not having minimal respect to develop some basic sentences.
+  > what is the migration_lock ?? why we have this in the database - https://github.com/kysely-org/kysely/issues/973
+* Probably not the best idea to attack the maintainer after he answered succinctly (out of character) for whatever reason (context switch? busy?).
+  > You got any more of them there examples buster? - https://github.com/kysely-org/kysely/issues/677#issuecomment-2019876074
+* Probably not the best idea to come in all yelling and demanding stuff.
+  > NO documentation about error handling!!!!
+  > I am really confused that the docs doesnt have anything about error handling
+  > this is a mandataory things to add!! - https://github.com/kysely-org/kysely/issues/1217
+* Probably not the best idea to tone police the maintainer after he spent time explaining library philosophy, and to publicly refuse to contribute something you demanded.
+  > I'm sorry fella but with your tone I really don't feel like it. Good luck - https://github.com/kysely-org/kysely/issues/709#issuecomment-1727617260
+* Probably not the best idea to question the maintainer's decisions after properly answering your question, and to be entitled for JavaScript skill issue help after the issue is closed.
+  > I don't understand your answer and closing the issue. - https://github.com/kysely-org/kysely/issues/527#issuecomment-1577383794
+* Probably not the best idea to jump into closed issues and be entitled to other people's efforts.
+  > why on earth there is no mention of this in the documentation? - https://github.com/kysely-org/kysely/issues/649#issuecomment-2430854835
+* Probably not the best idea to not search existing issues, and then ask the maintainer to spend time doing it.
+  > could you please provide numbers of duplicated issues to explore the topic? - https://github.com/kysely-org/kysely/issues/762#issuecomment-1801951960
+* Probably not the best idea to sarcastically suggest the maintainer is not helpful while using his hard work for free.
+  > Most helpful man in the world - https://github.com/kysely-org/kysely/issues/762#issuecomment-2404599281
+* Probably not the best idea to side with the asshole/entitled by upvoting them or downvoting us.
+
+  ![image](https://github.com/user-attachments/assets/ca6efd57-d8db-428a-a274-7b45b380887f)
+  ![image](https://github.com/user-attachments/assets/62356fa3-7cea-4b82-9967-d56c76f0beee)
+
+
+
+## Enforcement Responsibilities
+
+~~Community leaders are responsible for clarifying and enforcing our standards of~~
+~~acceptable behavior and will take appropriate and fair corrective action in~~
+~~response to any behavior that they deem inappropriate, threatening, offensive,~~
+~~or harmful.~~
+
+~~Community leaders have the right and responsibility to remove, edit, or reject~~
+~~comments, commits, code, wiki edits, issues, and other contributions that are~~
+~~not aligned to this Code of Conduct, and will communicate reasons for moderation~~
+~~decisions when appropriate.~~
+
+We are here in our free time. We are not getting paid to serve and please you.
+
+We will not tolerate assholes or entitled behavior.
+
+We are capable of banning you from the GitHub organization, Discord server, or any 
+other community space we manage. Don't make us do it.
+
+## Scope
+
+~~This Code of Conduct applies within all community spaces, and also applies when~~
+~~an individual is officially representing the community in public spaces.~~
+~~Examples of representing our community include using an official e-mail address,~~
+~~posting via an official social media account, or acting as an appointed~~
+~~representative at an online or offline event.~~
+
+Relevant to all repositories in the Kysely GitHub organization, the Kysely Discord 
+server, and any other community space managed by Kysely.
+
+## Enforcement
+
+~~Instances of abusive, harassing, or otherwise unacceptable behavior may be~~
+~~reported to the community leaders responsible for enforcement at~~
+~~Kysely's GitHub repositories and Discord server.~~
+~~All complaints will be reviewed and investigated promptly and fairly.~~
+
+~~All community leaders are obligated to respect the privacy and security of the~~
+~~reporter of any incident.~~
+
+Report to us anyone who is being an asshole or entitled.
+We will take appropriate action if necessary.
+
+## Enforcement Guidelines
+
+~~Community leaders will follow these Community Impact Guidelines in determining~~
+~~the consequences for any action they deem in violation of this Code of Conduct:~~
+
+We might do these things:
+
+~~### 1. Correction~~
+
+**Community Impact**: ~~Use of inappropriate language or other behavior deemed~~
+~~unprofessional or unwelcome in the community.~~
+
+Someone being an asshole or entitled.
+
+**Consequence**: ~~A private, written warning from community leaders, providing~~
+~~clarity around the nature of the violation and an explanation of why the~~
+~~behavior was inappropriate. A public apology may be requested.~~
+
+We might return the favor (we're not perfect), ignore you, edit/close/lock/delete 
+your post/comment, or ban you. There is no strike system.
+
+~~### 2. Warning~~
+
+~~**Community Impact**: A violation through a single incident or series~~
+~~of actions.~~
+
+~~**Consequence**: A warning with consequences for continued behavior. No~~
+~~interaction with the people involved, including unsolicited interaction with~~
+~~those enforcing the Code of Conduct, for a specified period of time. This~~
+~~includes avoiding interactions in community spaces as well as external channels~~
+~~like social media. Violating these terms may lead to a temporary or~~
+~~permanent ban.~~
+
+~~### 3. Temporary Ban~~
+
+~~**Community Impact**: A serious violation of community standards, including~~
+~~sustained inappropriate behavior.~~
+
+~~**Consequence**: A temporary ban from any sort of interaction or public~~
+~~communication with the community for a specified period of time. No public or~~
+~~private interaction with the people involved, including unsolicited interaction~~
+~~with those enforcing the Code of Conduct, is allowed during this period.~~
+~~Violating these terms may lead to a permanent ban.~~
+
+~~### 4. Permanent Ban~~
+
+~~**Community Impact**: Demonstrating a pattern of violation of community~~
+~~standards, including sustained inappropriate behavior,  harassment of an~~
+~~individual, or aggression toward or disparagement of classes of individuals.~~
+
+~~**Consequence**: A permanent ban from any sort of public interaction within~~
+~~the community.~~
+
+## ~~Attribution~~
+
+~~This Code of Conduct is adapted from the [Contributor Covenant][homepage],~~
+~~version 2.0, available at~~
+~~https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.~~
+
+~~Community Impact Guidelines were inspired by [Mozilla's code of conduct~~
+~~enforcement ladder](https://github.com/mozilla/diversity).~~
+
+~~[homepage]: https://www.contributor-covenant.org~~
+
+~~For answers to common questions about this code of conduct, see the FAQ at~~
+~~https://www.contributor-covenant.org/faq. Translations are available at~~
+~~https://www.contributor-covenant.org/translations.~~

package/CONTRIBUTING.md

@@ -1,17 +1,115 @@
-Would love to contribute to Kysely?
+# Contribution Guidelines
 
-Awesome! We are not very organized yet. We don't have a plan or a roadmap.
+Wanna contribute to Kysely or other libraries within the [kysely-org](https://github.com/kysely-org) organization?
 
-Probably the best way to get going is to watch the issue list.
-An issue with a `greenlit` label, has been acknowledged by the team and is ready for development.
-Find such an issue you'd like to tackle and ask to be assigned to it in the comment section.
-Feel free to open an issue if you found a bug or a missing feature you'd like to work on,
-and there aren't any issues mentioning it.
+You're awesome! 🤗
 
-If you start working on something larger, it's a good idea to create a draft (WIP) PR at 
-an early stage so that we can guide you to the right direction.
+## 😕 How Can I Contribute?
 
-There are quite a few guidelines to keep in mind:
+## 📢 By Spreading the Word
+
+If you like what we're building here, please: 
+
+1. Tell your friends, co-workers, family, neighbors, followers, etc.
+1. Speak about it in meetups and conferences. (if you need help with the presentation, please ask on Discord!).
+
+There is no company behind this organization and project. We do this in our free time and cannot advertise it
+all by ourselves. Companies have dedicated devrel teams doing all that work, other projects might have community
+managers or full-time developers with the capacity to also handle social media and meetups with higher frequency.
+
+More people using Kysely eventually means:
+
+1. less bugs left unreported and unsolved.
+1. high chance people share workarounds.
+1. more data points for innovation.
+1. more people who might contribute and push this thing even further.
+1. it becomes a standard part of the Node.js/Bun/Deno developer's toolbox so you'll happily stumble upon it
+   in future codebases you'll join, or it'll be easier to get buy-in from co-workers/leadership.
+
+## 🤝 By Helping People in Issues or on Discord
+
+We need all the help we can get with supporting the community, answering questions, triaging! 
+
+If you've been using the library for a while, or know a thing or two about SQL, and specific databases, don't 
+be shy about it!
+
+## 🐛 By Submitting Issues (Bugs, Enhancement Ideas, Questions) or Opening threads on Discord
+
+Please use search and make sure an existing **open** issue or thread doesn't exist before submitting. If an existing
+issue is only somewhat relevant, please submit a new issue and reference the old one instead of commenting
+on the existing one. Let us label your new issue as `duplicate` if it is the same thing - it's fine! If it's not 
+the same thing and you commented on another issue, it makes it harder to track on our end.
+
+If possible/relevant, please provide a [playground link](https://kyse.link), Stackblitz OR a public git repository that 
+reproduces the issue.
+
+Please provide the exact error/warning texts you're getting. "this doesn't work" or "this throws an error"
+are not helping us help you.
+
+Don't be an asshole. Don't demand support/service from us.
+
+## ⌨️ With Code!
+
+### 📘 Documentation Code Contributions
+
+Pull requests are always welcome! 
+
+The [kysely.dev](https://kysely.dev) application is located @ [/site](https://github.com/kysely-org/kysely/tree/master/site).
+
+It is a pretty standard [docusaurus](https://docusaurus.io/) application.
+
+The code examples are extracted, using a custom script (see `"script:generate-site-examples"` @ [package.json](https://github.com/kysely-org/kysely/blob/master/package.json)), 
+and custom annotations, from [JSDocs](https://jsdoc.app/) comments in the source code @ [/src](https://github.com/kysely-org/kysely/tree/master/src).
+If you need to change an existing code example, please do so in the source code AND then run the script.
+_TODO: explain how to add a new code example._
+
+If it is a big change (lots of lines of code OR files involved), please get a conversation going on an issue or on 
+Discord before starting work on it.
+
+### 🧙 Implementation Code Contributions (Bugfixes, Enhancements [Existing or New Features])
+
+Pull requests (PRs) are welcome, BUT since:
+
+1. Our time and capacity as maintainers are limited.
+1. Your time is limited.
+1. Your motivation and morale is important to us.
+1. Onboarding in a new highly opinionated open-source project can be challenging.
+
+We need a process in place:
+
+1. To make sure only things that have a good chance of being accepted are worked on. We hate saying "no".
+1. To make sure that things that are being worked on don't result in too much back-and-forth between authors and maintainers.
+   We hate seeing these things drag on for a long time, and we know how frustrating it is on your end.
+1. To make sure there's no pressure on you when you take on a task.
+1. To make sure there's a clear understanding of who is working on what to avoid redundancies and conflicts.
+
+#### The Process
+
+Here is the gist of it:
+
+1. If an issue on the subject **doesn't exist** yet, **submit** one. If you want to work on it, **ask** to be **assigned**
+   to it in the issue **description**, in the **comments**, OR on **Discord**.
+1. If an issue on the subject **exists** and is labeled with `bug` OR (`enhancement` AND `greenlit`\* OR even `good first issue`\**):
+   1. If there is a pull request (**PR**) **linked** to it:
+      1. If the **PR** is **stale** (a few months without new commits or comments from the PR author OR Kysely maintainers),
+         **ask** to be **assigned** to it and continue work on the PR.
+      1. If the **PR** is **not stale**, you can still offer some review comments, or **ask** to **pair** up with the PR author.
+   1. If there is **no PR linked** to it and a person is **already assigned** to it:
+      1. If the assignment is stale (a few weeks without a PR opened after the person was assigned to the issue), ask
+         to be assigned to the issue in the comments OR on Discord.
+      1. If the assignment is not stale, it's OK to ask the assignee if they'll be willing to pair up.
+   1. If there is no PR linked to it and no assignee, ask to be assigned to it in the comments OR on Discord.
+   
+_\* an issue that was reviewed by the maintainers and would be nice to get a pull request for from the community._
+
+_\** an issue that was reviewed by the maintainers and would be a nice opportunity to onboard an open-source newbie
+  into the codebase._
+
+Once you're assigned to an issue, you can start working on your code changes. It's best to ask questions
+in the issue or on Discord as early as possible, and even share your progress with the maintainers and community via a 
+draft (WIP) pull request.
+
+#### Style/Design Philosophy
 
 * Kysely should have zero dependencies.
 
@@ -40,31 +138,31 @@ for all cases, are best left for consumers to implement.
 
 * Most features should have escape hatches.
 
-# Getting started
+#### Getting Started
 
 1. fork kysely.
 
-2. clone your fork.
+1. clone your fork.
 
-3. install node.js (preferable latest LTS).
+1. install node.js (preferably the latest even-numbered version).
 
-4. run `npm i` in your terminal to install dev dependencies.
+1. run `npm i` in your terminal to install dependencies.
 
-5. create a branch.
+1. create a branch (we don't care about naming).
 
-6. create a draft pull request. link the relevant issue by referring to it in the 
+1. create a draft pull request. link the relevant issue by referring to it in the 
 PR's description. E.g. `closes #123` will link the PR to issue/pull request #123.
 
-7. implement your changes.
+1. implement your changes.
 
-# Testing
+#### Testing
 
-1. write functionality tests in `test/node`.
+1. write functionality tests @ [/test/node](https://github.com/kysely-org/kysely/tree/master/test/node).
 
-2. write typings tests in `test/typings/test-d`
+1. write typings tests @ [/test/typings](https://github.com/kysely-org/kysely/tree/master/test/typings)
 
-3. install docker.
+1. install docker.
 
-4. run `docker-compose up` in your terminal to spin up database instances.
+1. run `docker compose up` in your terminal to spin up database instances.
 
-5. run `npm test` in your terminal to run tests.
+1. run `npm test` in another terminal to run tests.

package/FUNDING.md

@@ -0,0 +1,25 @@
+# Funding
+
+Kysely is an MIT-licensed open-source project and is completely free to use - and will remain so.
+
+Kysely is a labor of love. We do this in our free time.
+
+We do not accept donations.
+
+- Getting paid for open-source won't make us put more time and effort into open-source.
+  We have family, friends, and other hobbies and interests.
+
+- We work in the tech industry, full-time, as software developers. We are comfortable as-is.
+
+- We don't believe in freelance open-source as a stable source of income for the long term.
+  We have mouths to feed, and careers to maintain.
+
+- Sponsored projects tend to be affected by big sponsors. We want to keep Kysely away
+  from companies' and VCs' opinions and business needs.
+
+- Kysely is escapism for us. We don't want it to feel like another job.
+
+
+Instead of donating to us, we encourage you to support meaningful causes or other open-source projects in need of funding.
+
+Thank you for supporting Kysely through your usage, contributions, and feedback.

package/README.md

@@ -1,13 +1,24 @@
 [![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://stand-with-ukraine.pp.ua)
 
-[![Discord](https://img.shields.io/discord/890118421587578920?logo=discord&style=flat)](https://discord.gg/xyBJ3GwvAm)
+[![NPM Version](https://img.shields.io/npm/v/kysely?style=flat&label=latest)](https://github.com/kysely-org/kysely/releases/latest)
 [![Tests](https://github.com/kysely-org/kysely/actions/workflows/test.yml/badge.svg)](https://github.com/kysely-org/kysely)
 [![License](https://img.shields.io/github/license/kysely-org/kysely?style=flat)](https://github.com/kysely-org/kysely/blob/master/LICENSE)
 [![Issues](https://img.shields.io/github/issues-closed/kysely-org/kysely?logo=github)](https://github.com/kysely-org/kysely/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)
 [![Pull Requests](https://img.shields.io/github/issues-pr-closed/kysely-org/kysely?label=PRs&logo=github&style=flat)](https://github.com/kysely-org/kysely/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-desc)
+![GitHub contributors](https://img.shields.io/github/contributors/kysely-org/kysely)
 [![Downloads](https://img.shields.io/npm/dw/kysely?logo=npm)](https://www.npmjs.com/package/kysely)
 [![Bundle Size](https://img.shields.io/bundlephobia/minzip/kysely?label=size&logo=npm)](https://bundlephobia.com/package/kysely)
-[![Social](https://img.shields.io/twitter/follow/kysely_?style=social)](https://twitter.com/kysely_)
+
+###### Join the discussion ⠀⠀⠀⠀⠀⠀⠀ 
+[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=flat&logo=discord&logoColor=white)](https://discord.gg/xyBJ3GwvAm)
+[![Bluesky](https://img.shields.io/badge/Bluesky-0285FF?style=flat&logo=Bluesky&logoColor=white)](https://bsky.app/profile/kysely.dev)
+
+###### Get started
+[![Postgres](https://img.shields.io/badge/postgres-%23316192.svg?style=flat&logo=postgresql&logoColor=white)](https://kysely.dev/docs/getting-started?dialect=postgresql)
+[![MySQL](https://img.shields.io/badge/mysql-4479A1.svg?style=flat&logo=mysql&logoColor=white)](https://kysely.dev/docs/getting-started?dialect=mysql)
+[![MicrosoftSQLServer](https://img.shields.io/badge/Microsoft%20SQL%20Server-CC2927?style=flat&logo=microsoft%20sql%20server&logoColor=white)](https://kysely.dev/docs/getting-started?dialect=mssql)
+[![SQLite](https://img.shields.io/badge/sqlite-%2307405e.svg?style=flat&logo=sqlite&logoColor=white)](https://kysely.dev/docs/getting-started?dialect=sqlite)
+& more!
 
 # [Kysely](https://kysely.dev)
 

package/dist/cjs/dialect/sqlite/sqlite-introspector.js

@@ -13,59 +13,81 @@ class SqliteIntrospector {
         return [];
     }
     async getTables(options = { withInternalKyselyTables: false }) {
-        let query = this.#db
+        return await this.#getTableMetadata(options);
+    }
+    async getMetadata(options) {
+        return {
+            tables: await this.getTables(options),
+        };
+    }
+    #tablesQuery(qb, options) {
+        let tablesQuery = qb
             .selectFrom('sqlite_master')
             .where('type', 'in', ['table', 'view'])
             .where('name', 'not like', 'sqlite_%')
-            .select('name')
-            .orderBy('name')
-            .$castTo();
+            .select(['name', 'sql', 'type'])
+            .orderBy('name');
         if (!options.withInternalKyselyTables) {
-            query = query
+            tablesQuery = tablesQuery
                 .where('name', '!=', migrator_js_1.DEFAULT_MIGRATION_TABLE)
                 .where('name', '!=', migrator_js_1.DEFAULT_MIGRATION_LOCK_TABLE);
         }
-        const tables = await query.execute();
-        return Promise.all(tables.map(({ name }) => this.#getTableMetadata(name)));
+        return tablesQuery;
     }
-    async getMetadata(options) {
-        return {
-            tables: await this.getTables(options),
-        };
-    }
-    async #getTableMetadata(table) {
-        const db = this.#db;
-        // Get the SQL that was used to create the table.
-        const tableDefinition = await db
-            .selectFrom('sqlite_master')
-            .where('name', '=', table)
-            .select(['sql', 'type'])
-            .$castTo()
-            .executeTakeFirstOrThrow();
-        // Try to find the name of the column that has `autoincrement` 🤦
-        const autoIncrementCol = tableDefinition.sql
-            ?.split(/[\(\),]/)
-            ?.find((it) => it.toLowerCase().includes('autoincrement'))
-            ?.trimStart()
-            ?.split(/\s+/)?.[0]
-            ?.replace(/["`]/g, '');
-        const columns = await db
-            .selectFrom((0, sql_js_1.sql) `pragma_table_info(${table})`.as('table_info'))
-            .select(['name', 'type', 'notnull', 'dflt_value'])
-            .orderBy('cid')
+    async #getTableMetadata(options) {
+        const tablesResult = await this.#tablesQuery(this.#db, options).execute();
+        const tableMetadata = await this.#db
+            .with('table_list', (qb) => this.#tablesQuery(qb, options))
+            .selectFrom([
+            'table_list as tl',
+            (0, sql_js_1.sql) `pragma_table_info(tl.name)`.as('p'),
+        ])
+            .select([
+            'tl.name as table',
+            'p.cid',
+            'p.name',
+            'p.type',
+            'p.notnull',
+            'p.dflt_value',
+            'p.pk',
+        ])
+            .orderBy(['tl.name', 'p.cid'])
             .execute();
-        return {
-            name: table,
-            isView: tableDefinition.type === 'view',
-            columns: columns.map((col) => ({
-                name: col.name,
-                dataType: col.type,
-                isNullable: !col.notnull,
-                isAutoIncrementing: col.name === autoIncrementCol,
-                hasDefaultValue: col.dflt_value != null,
-                comment: undefined,
-            })),
-        };
+        const columnsByTable = {};
+        for (const row of tableMetadata) {
+            columnsByTable[row.table] ??= [];
+            columnsByTable[row.table].push(row);
+        }
+        return tablesResult.map(({ name, sql, type }) => {
+            // // Try to find the name of the column that has `autoincrement` 🤦
+            let autoIncrementCol = sql
+                ?.split(/[\(\),]/)
+                ?.find((it) => it.toLowerCase().includes('autoincrement'))
+                ?.trimStart()
+                ?.split(/\s+/)?.[0]
+                ?.replace(/["`]/g, '');
+            const columns = columnsByTable[name] ?? [];
+            // Otherwise, check for an INTEGER PRIMARY KEY
+            // https://www.sqlite.org/autoinc.html
+            if (!autoIncrementCol) {
+                const pkCols = columns.filter((r) => r.pk > 0);
+                if (pkCols.length === 1 && pkCols[0].type.toLowerCase() === 'integer') {
+                    autoIncrementCol = pkCols[0].name;
+                }
+            }
+            return {
+                name: name,
+                isView: type === 'view',
+                columns: columns.map((col) => ({
+                    name: col.name,
+                    dataType: col.type,
+                    isNullable: !col.notnull,
+                    isAutoIncrementing: col.name === autoIncrementCol,
+                    hasDefaultValue: col.dflt_value != null,
+                    comment: undefined,
+                })),
+            };
+        });
     }
 }
 exports.SqliteIntrospector = SqliteIntrospector;

package/dist/cjs/expression/expression-builder.d.ts

@@ -444,6 +444,8 @@ export interface ExpressionBuilder<DB, TB extends keyof DB> {
      * inner join "pet" on "pet"."owner_id" = "person"."id"
      * group by "person"."id"
      * ```
+     *
+     * If you need a column reference, use {@link ref}.
      */
     table<T extends TB & string>(table: T): ExpressionWrapper<DB, TB, Selectable<DB[T]>>;
     /**

package/dist/cjs/migration/migrator.d.ts

@@ -271,7 +271,7 @@ export interface MigratorProps {
      *
      * When false, migrations must be run in their exact alpha-numeric order.
      * This is checked against the migrations already run in the database
-     * (`migrationTableName'). This ensures your migrations are always run in
+     * (`migrationTableName`). This ensures your migrations are always run in
      * the same order and is the safest option.
      *
      * When true, migrations are still run in alpha-numeric order, but
@@ -280,6 +280,13 @@ export interface MigratorProps {
      * order.
      */
     readonly allowUnorderedMigrations?: boolean;
+    /**
+     * A function that compares migration names, used when sorting migrations in
+     * ascending order.
+     *
+     * Default is `name0.localeCompare(name1)`.
+     */
+    readonly nameComparator?: (name0: string, name1: string) => number;
 }
 /**
  * All migration methods ({@link Migrator.migrateTo | migrateTo},

package/dist/cjs/migration/migrator.js

@@ -63,6 +63,7 @@ class Migrator {
                 .withPlugin(this.#schemaPlugin)
                 .selectFrom(this.#migrationTable)
                 .select(['name', 'timestamp'])
+                .$narrowType()
                 .execute()
             : [];
         const migrations = await this.#resolveMigrations();
@@ -465,10 +466,19 @@ class Migrator {
         const executedMigrations = await db
             .withPlugin(this.#schemaPlugin)
             .selectFrom(this.#migrationTable)
-            .select('name')
-            .orderBy(['timestamp', 'name'])
+            .select(['name', 'timestamp'])
+            .$narrowType()
             .execute();
-        return executedMigrations.map((it) => it.name);
+        const nameComparator = this.#props.nameComparator || ((a, b) => a.localeCompare(b));
+        return (executedMigrations
+            // https://github.com/kysely-org/kysely/issues/843
+            .sort((a, b) => {
+            if (a.timestamp === b.timestamp) {
+                return nameComparator(a.name, b.name);
+            }
+            return (new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        })
+            .map((it) => it.name));
     }
     #ensureNoMissingMigrations(migrations, executedMigrations) {
         // Ensure all executed migrations exist in the `migrations` list.

package/dist/cjs/parser/insert-values-parser.js

@@ -42,9 +42,11 @@ function parseRowValues(row, columns) {
         length: columns.size,
     });
     let hasUndefinedOrComplexColumns = false;
+    let indexedRowColumns = rowColumns.length;
     for (const col of rowColumns) {
         const columnIdx = columns.get(col);
         if ((0, object_utils_js_1.isUndefined)(columnIdx)) {
+            indexedRowColumns--;
             continue;
         }
         const value = row[col];
@@ -53,7 +55,7 @@ function parseRowValues(row, columns) {
         }
         rowValues[columnIdx] = value;
     }
-    const hasMissingColumns = rowColumns.length < columns.size;
+    const hasMissingColumns = indexedRowColumns < columns.size;
     if (hasMissingColumns || hasUndefinedOrComplexColumns) {
         const defaultValue = default_insert_value_node_js_1.DefaultInsertValueNode.create();
         return value_list_node_js_1.ValueListNode.create(rowValues.map((it) => (0, object_utils_js_1.isUndefined)(it) ? defaultValue : (0, value_parser_js_1.parseValueExpression)(it)));

package/dist/cjs/plugin/camel-case/camel-case.js

@@ -23,7 +23,10 @@ function createSnakeCaseMapper({ upperCase = false, underscoreBeforeDigits = fal
             // If underScoreBeforeDigits is true then, well, insert an underscore
             // before digits :). Only the first digit gets an underscore if
             // there are multiple.
-            if (underscoreBeforeDigits && isDigit(char) && !isDigit(prevChar)) {
+            if (underscoreBeforeDigits &&
+                isDigit(char) &&
+                !isDigit(prevChar) &&
+                !out.endsWith('_')) {
                 out += '_' + char;
                 continue;
             }

package/dist/cjs/plugin/with-schema/with-schema-transformer.d.ts

@@ -1,3 +1,5 @@
+import { AggregateFunctionNode } from '../../operation-node/aggregate-function-node.js';
+import { FunctionNode } from '../../operation-node/function-node.js';
 import { OperationNodeTransformer } from '../../operation-node/operation-node-transformer.js';
 import { OperationNode } from '../../operation-node/operation-node.js';
 import { ReferencesNode } from '../../operation-node/references-node.js';
@@ -8,4 +10,6 @@ export declare class WithSchemaTransformer extends OperationNodeTransformer {
     protected transformNodeImpl<T extends OperationNode>(node: T): T;
     protected transformSchemableIdentifier(node: SchemableIdentifierNode): SchemableIdentifierNode;
     protected transformReferences(node: ReferencesNode): ReferencesNode;
+    protected transformAggregateFunction(node: AggregateFunctionNode): AggregateFunctionNode;
+    protected transformFunction(node: FunctionNode): FunctionNode;
 }

package/dist/cjs/plugin/with-schema/with-schema-transformer.js

@@ -31,6 +31,10 @@ const ROOT_OPERATION_NODES = (0, object_utils_js_1.freeze)({
     UpdateQueryNode: true,
     MergeQueryNode: true,
 });
+const SCHEMALESS_FUNCTIONS = {
+    json_agg: true,
+    to_json: true,
+};
 class WithSchemaTransformer extends operation_node_transformer_js_1.OperationNodeTransformer {
     #schema;
     #schemableIds = new Set();
@@ -80,6 +84,28 @@ class WithSchemaTransformer extends operation_node_transformer_js_1.OperationNod
             table: table_node_js_1.TableNode.createWithSchema(this.#schema, transformed.table.table.identifier.name),
         };
     }
+    transformAggregateFunction(node) {
+        return {
+            ...super.transformAggregateFunction({ ...node, aggregated: [] }),
+            aggregated: this.#transformTableArgsWithoutSchemas(node, 'aggregated'),
+        };
+    }
+    transformFunction(node) {
+        return {
+            ...super.transformFunction({ ...node, arguments: [] }),
+            arguments: this.#transformTableArgsWithoutSchemas(node, 'arguments'),
+        };
+    }
+    #transformTableArgsWithoutSchemas(node, argsKey) {
+        return SCHEMALESS_FUNCTIONS[node.func]
+            ? node[argsKey].map((arg) => !table_node_js_1.TableNode.is(arg) || arg.table.schema
+                ? this.transformNode(arg)
+                : {
+                    ...arg,
+                    table: this.transformIdentifier(arg.table.identifier),
+                })
+            : this.transformNodeList(node[argsKey]);
+    }
     #isRootOperationNode(node) {
         return node.kind in ROOT_OPERATION_NODES;
     }

package/dist/cjs/raw-builder/sql.d.ts

@@ -199,7 +199,7 @@ export interface Sql {
      * select first_name from "person"
      * ```
      *
-     * The refefences can also include a schema on supported databases:
+     * The references can also include a schema on supported databases:
      *
      * ```ts
      * const table = 'public.person'

package/dist/esm/dialect/sqlite/sqlite-introspector.js

@@ -11,58 +11,80 @@ export class SqliteIntrospector {
         return [];
     }
     async getTables(options = { withInternalKyselyTables: false }) {
-        let query = this.#db
+        return await this.#getTableMetadata(options);
+    }
+    async getMetadata(options) {
+        return {
+            tables: await this.getTables(options),
+        };
+    }
+    #tablesQuery(qb, options) {
+        let tablesQuery = qb
             .selectFrom('sqlite_master')
             .where('type', 'in', ['table', 'view'])
             .where('name', 'not like', 'sqlite_%')
-            .select('name')
-            .orderBy('name')
-            .$castTo();
+            .select(['name', 'sql', 'type'])
+            .orderBy('name');
         if (!options.withInternalKyselyTables) {
-            query = query
+            tablesQuery = tablesQuery
                 .where('name', '!=', DEFAULT_MIGRATION_TABLE)
                 .where('name', '!=', DEFAULT_MIGRATION_LOCK_TABLE);
         }
-        const tables = await query.execute();
-        return Promise.all(tables.map(({ name }) => this.#getTableMetadata(name)));
+        return tablesQuery;
     }
-    async getMetadata(options) {
-        return {
-            tables: await this.getTables(options),
-        };
-    }
-    async #getTableMetadata(table) {
-        const db = this.#db;
-        // Get the SQL that was used to create the table.
-        const tableDefinition = await db
-            .selectFrom('sqlite_master')
-            .where('name', '=', table)
-            .select(['sql', 'type'])
-            .$castTo()
-            .executeTakeFirstOrThrow();
-        // Try to find the name of the column that has `autoincrement` 🤦
-        const autoIncrementCol = tableDefinition.sql
-            ?.split(/[\(\),]/)
-            ?.find((it) => it.toLowerCase().includes('autoincrement'))
-            ?.trimStart()
-            ?.split(/\s+/)?.[0]
-            ?.replace(/["`]/g, '');
-        const columns = await db
-            .selectFrom(sql `pragma_table_info(${table})`.as('table_info'))
-            .select(['name', 'type', 'notnull', 'dflt_value'])
-            .orderBy('cid')
+    async #getTableMetadata(options) {
+        const tablesResult = await this.#tablesQuery(this.#db, options).execute();
+        const tableMetadata = await this.#db
+            .with('table_list', (qb) => this.#tablesQuery(qb, options))
+            .selectFrom([
+            'table_list as tl',
+            sql `pragma_table_info(tl.name)`.as('p'),
+        ])
+            .select([
+            'tl.name as table',
+            'p.cid',
+            'p.name',
+            'p.type',
+            'p.notnull',
+            'p.dflt_value',
+            'p.pk',
+        ])
+            .orderBy(['tl.name', 'p.cid'])
             .execute();
-        return {
-            name: table,
-            isView: tableDefinition.type === 'view',
-            columns: columns.map((col) => ({
-                name: col.name,
-                dataType: col.type,
-                isNullable: !col.notnull,
-                isAutoIncrementing: col.name === autoIncrementCol,
-                hasDefaultValue: col.dflt_value != null,
-                comment: undefined,
-            })),
-        };
+        const columnsByTable = {};
+        for (const row of tableMetadata) {
+            columnsByTable[row.table] ??= [];
+            columnsByTable[row.table].push(row);
+        }
+        return tablesResult.map(({ name, sql, type }) => {
+            // // Try to find the name of the column that has `autoincrement` 🤦
+            let autoIncrementCol = sql
+                ?.split(/[\(\),]/)
+                ?.find((it) => it.toLowerCase().includes('autoincrement'))
+                ?.trimStart()
+                ?.split(/\s+/)?.[0]
+                ?.replace(/["`]/g, '');
+            const columns = columnsByTable[name] ?? [];
+            // Otherwise, check for an INTEGER PRIMARY KEY
+            // https://www.sqlite.org/autoinc.html
+            if (!autoIncrementCol) {
+                const pkCols = columns.filter((r) => r.pk > 0);
+                if (pkCols.length === 1 && pkCols[0].type.toLowerCase() === 'integer') {
+                    autoIncrementCol = pkCols[0].name;
+                }
+            }
+            return {
+                name: name,
+                isView: type === 'view',
+                columns: columns.map((col) => ({
+                    name: col.name,
+                    dataType: col.type,
+                    isNullable: !col.notnull,
+                    isAutoIncrementing: col.name === autoIncrementCol,
+                    hasDefaultValue: col.dflt_value != null,
+                    comment: undefined,
+                })),
+            };
+        });
     }
 }

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

@@ -444,6 +444,8 @@ export interface ExpressionBuilder<DB, TB extends keyof DB> {
      * inner join "pet" on "pet"."owner_id" = "person"."id"
      * group by "person"."id"
      * ```
+     *
+     * If you need a column reference, use {@link ref}.
      */
     table<T extends TB & string>(table: T): ExpressionWrapper<DB, TB, Selectable<DB[T]>>;
     /**

package/dist/esm/migration/migrator.d.ts

@@ -271,7 +271,7 @@ export interface MigratorProps {
      *
      * When false, migrations must be run in their exact alpha-numeric order.
      * This is checked against the migrations already run in the database
-     * (`migrationTableName'). This ensures your migrations are always run in
+     * (`migrationTableName`). This ensures your migrations are always run in
      * the same order and is the safest option.
      *
      * When true, migrations are still run in alpha-numeric order, but
@@ -280,6 +280,13 @@ export interface MigratorProps {
      * order.
      */
     readonly allowUnorderedMigrations?: boolean;
+    /**
+     * A function that compares migration names, used when sorting migrations in
+     * ascending order.
+     *
+     * Default is `name0.localeCompare(name1)`.
+     */
+    readonly nameComparator?: (name0: string, name1: string) => number;
 }
 /**
  * All migration methods ({@link Migrator.migrateTo | migrateTo},

package/dist/esm/migration/migrator.js

@@ -61,6 +61,7 @@ export class Migrator {
                 .withPlugin(this.#schemaPlugin)
                 .selectFrom(this.#migrationTable)
                 .select(['name', 'timestamp'])
+                .$narrowType()
                 .execute()
             : [];
         const migrations = await this.#resolveMigrations();
@@ -463,10 +464,19 @@ export class Migrator {
         const executedMigrations = await db
             .withPlugin(this.#schemaPlugin)
             .selectFrom(this.#migrationTable)
-            .select('name')
-            .orderBy(['timestamp', 'name'])
+            .select(['name', 'timestamp'])
+            .$narrowType()
             .execute();
-        return executedMigrations.map((it) => it.name);
+        const nameComparator = this.#props.nameComparator || ((a, b) => a.localeCompare(b));
+        return (executedMigrations
+            // https://github.com/kysely-org/kysely/issues/843
+            .sort((a, b) => {
+            if (a.timestamp === b.timestamp) {
+                return nameComparator(a.name, b.name);
+            }
+            return (new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        })
+            .map((it) => it.name));
     }
     #ensureNoMissingMigrations(migrations, executedMigrations) {
         // Ensure all executed migrations exist in the `migrations` list.

package/dist/esm/parser/insert-values-parser.js

@@ -40,9 +40,11 @@ function parseRowValues(row, columns) {
         length: columns.size,
     });
     let hasUndefinedOrComplexColumns = false;
+    let indexedRowColumns = rowColumns.length;
     for (const col of rowColumns) {
         const columnIdx = columns.get(col);
         if (isUndefined(columnIdx)) {
+            indexedRowColumns--;
             continue;
         }
         const value = row[col];
@@ -51,7 +53,7 @@ function parseRowValues(row, columns) {
         }
         rowValues[columnIdx] = value;
     }
-    const hasMissingColumns = rowColumns.length < columns.size;
+    const hasMissingColumns = indexedRowColumns < columns.size;
     if (hasMissingColumns || hasUndefinedOrComplexColumns) {
         const defaultValue = DefaultInsertValueNode.create();
         return ValueListNode.create(rowValues.map((it) => isUndefined(it) ? defaultValue : parseValueExpression(it)));

package/dist/esm/plugin/camel-case/camel-case.js

@@ -20,7 +20,10 @@ export function createSnakeCaseMapper({ upperCase = false, underscoreBeforeDigit
             // If underScoreBeforeDigits is true then, well, insert an underscore
             // before digits :). Only the first digit gets an underscore if
             // there are multiple.
-            if (underscoreBeforeDigits && isDigit(char) && !isDigit(prevChar)) {
+            if (underscoreBeforeDigits &&
+                isDigit(char) &&
+                !isDigit(prevChar) &&
+                !out.endsWith('_')) {
                 out += '_' + char;
                 continue;
             }

package/dist/esm/plugin/with-schema/with-schema-transformer.d.ts

@@ -1,3 +1,5 @@
+import { AggregateFunctionNode } from '../../operation-node/aggregate-function-node.js';
+import { FunctionNode } from '../../operation-node/function-node.js';
 import { OperationNodeTransformer } from '../../operation-node/operation-node-transformer.js';
 import { OperationNode } from '../../operation-node/operation-node.js';
 import { ReferencesNode } from '../../operation-node/references-node.js';
@@ -8,4 +10,6 @@ export declare class WithSchemaTransformer extends OperationNodeTransformer {
     protected transformNodeImpl<T extends OperationNode>(node: T): T;
     protected transformSchemableIdentifier(node: SchemableIdentifierNode): SchemableIdentifierNode;
     protected transformReferences(node: ReferencesNode): ReferencesNode;
+    protected transformAggregateFunction(node: AggregateFunctionNode): AggregateFunctionNode;
+    protected transformFunction(node: FunctionNode): FunctionNode;
 }

package/dist/esm/plugin/with-schema/with-schema-transformer.js

@@ -29,6 +29,10 @@ const ROOT_OPERATION_NODES = freeze({
     UpdateQueryNode: true,
     MergeQueryNode: true,
 });
+const SCHEMALESS_FUNCTIONS = {
+    json_agg: true,
+    to_json: true,
+};
 export class WithSchemaTransformer extends OperationNodeTransformer {
     #schema;
     #schemableIds = new Set();
@@ -78,6 +82,28 @@ export class WithSchemaTransformer extends OperationNodeTransformer {
             table: TableNode.createWithSchema(this.#schema, transformed.table.table.identifier.name),
         };
     }
+    transformAggregateFunction(node) {
+        return {
+            ...super.transformAggregateFunction({ ...node, aggregated: [] }),
+            aggregated: this.#transformTableArgsWithoutSchemas(node, 'aggregated'),
+        };
+    }
+    transformFunction(node) {
+        return {
+            ...super.transformFunction({ ...node, arguments: [] }),
+            arguments: this.#transformTableArgsWithoutSchemas(node, 'arguments'),
+        };
+    }
+    #transformTableArgsWithoutSchemas(node, argsKey) {
+        return SCHEMALESS_FUNCTIONS[node.func]
+            ? node[argsKey].map((arg) => !TableNode.is(arg) || arg.table.schema
+                ? this.transformNode(arg)
+                : {
+                    ...arg,
+                    table: this.transformIdentifier(arg.table.identifier),
+                })
+            : this.transformNodeList(node[argsKey]);
+    }
     #isRootOperationNode(node) {
         return node.kind in ROOT_OPERATION_NODES;
     }

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

@@ -199,7 +199,7 @@ export interface Sql {
      * select first_name from "person"
      * ```
      *
-     * The refefences can also include a schema on supported databases:
+     * The references can also include a schema on supported databases:
      *
      * ```ts
      * const table = 'public.person'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kysely",
-  "version": "0.27.5",
+  "version": "0.27.6",
   "description": "Type safe SQL query builder",
   "repository": {
     "type": "git",