add support for recursive CTE. closes #39

.github/workflows/test.yml

@@ -12,7 +12,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [14.x, 16.x]
 
     steps:
       - uses: actions/checkout@v2

package.json

@@ -1,13 +1,13 @@
 {
   "name": "kysely",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "description": "Type safe SQL query builder",
   "repository": {
     "type": "git",
     "url": "git://github.com/koskimas/kysely.git"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=14.0.0"
   },
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

scripts/copy-interface-documentation.js

@@ -1,12 +1,14 @@
 /**
  * This script goes through all generated type definition files and copies
- * method documentation from interfaces to the implementing methods IF
- * the implementation doesn't have its own documentation.
+ * method/property documentation from interfaces to the implementing methods
+ * IF the implementation doesn't have its own documentation.
  *
- * This is done for convenience: users can cmd-click method names and they
- * always get to the documentation. If we don't do that, users need to
- * cmd-click the method and then manually find the correct interface that
- * contains the documentation.
+ * This is done for convenience: users can cmd-click method names and immediately
+ * see the documentation. If we don't do that, users need to cmd-click the method
+ * and then manually find the correct interface that contains the documentation.
+ *
+ * Hovering over a method/property works even without this script, but not all
+ * people are happy reading docs from the small hovering window.
  */
 
 const fs = require('fs')
@@ -148,7 +150,7 @@ function parseImplements(line) {
 
   // Strip generics. We need to do this in a loop to strip nested generics.
   while (line.includes('<')) {
-    let strippedLine = line.replaceAll(GENERIC_ARGUMENTS_REGEX, '')
+    let strippedLine = line.replace(GENERIC_ARGUMENTS_REGEX, '')
 
     if (strippedLine === line) {
       console.warn(`unable to strip generics from "${line}"`)

scripts/post-process-docs.js

@@ -8,7 +8,8 @@ const ASSET_PATH = path.join(__dirname, '..', 'assets')
 
 // Files to go through and replace ASSET_URL_BASE with FIXED_ASSET_URL_BASE.
 const ASSET_FIX_FILES = [path.join(DOCS_PATH, 'index.html')]
-const ASSET_URL_BASE = 'https://github.com/koskimas/kysely/blob/master/assets'
+const ASSET_URL_BASE =
+  /https:\/\/github.com\/koskimas\/kysely\/blob\/master\/assets/g
 const FIXED_ASSET_URL_BASE = 'assets'
 
 // Copy all assets to doc assets.
@@ -24,7 +25,7 @@ for (const filePath of ASSET_FIX_FILES) {
   const file = fs
     .readFileSync(filePath)
     .toString()
-    .replaceAll(ASSET_URL_BASE, FIXED_ASSET_URL_BASE)
+    .replace(ASSET_URL_BASE, FIXED_ASSET_URL_BASE)
 
   fs.writeFileSync(filePath, file)
 }

src/index.ts

@@ -88,6 +88,7 @@ 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/constraint-node.js'
 export * from './operation-node/create-index-node.js'
 export * from './operation-node/create-schema-node.js'

src/kysely.ts

@@ -291,6 +291,41 @@ export class Kysely<DB> extends QueryCreator<DB> {
     })
   }
 
+  /**
+   * Returns a copy of this Kysely instance with tables added to its
+   * database type.
+   *
+   * This method only modifies the types and doesn't affect any of the
+   * executed queries in any way.
+   *
+   * ### Examples
+   *
+   * The following example adds and uses a temporary table:
+   *
+   * @example
+   * ```ts
+   * await db.schema
+   *   .createTable('temp_table')
+   *   .temporary()
+   *   .addColumn('some_column', 'integer')
+   *   .execute()
+   *
+   * const tempDb = db.withTables<{
+   *   temp_table: {
+   *     some_column: number
+   *   }
+   * }>()
+   *
+   * await tempDb
+   *   .insertInto('temp_table')
+   *   .values({ some_column: 100 })
+   *   .execute()
+   * ```
+   */
+  withTables<T extends Record<string, Record<string, any>>>(): Kysely<DB & T> {
+    return new Kysely({ ...this.#props })
+  }
+
   /**
    * Releases all resources and disconnects from the database.
    *
@@ -362,6 +397,12 @@ export class Transaction<DB> extends Kysely<DB> {
       executor: this.#props.executor.withoutPlugins(),
     })
   }
+
+  override withTables<
+    T extends Record<string, Record<string, any>>
+  >(): Transaction<DB & T> {
+    return new Transaction({ ...this.#props })
+  }
 }
 
 export interface KyselyProps {