Merge branch 'main' into CC-1158-gleam

Author: ryan-gang

compiled_starters/cpp/CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.13)
-project(git-starter-cpp)
+project(sqlite-starter-cpp)
 set(CMAKE_CXX_STANDARD 20) # Enable the C++20 standard
 
 set(SOURCE_FILES src/Server.cpp)

compiled_starters/csharp/your_sqlite3.sh

@@ -5,4 +5,4 @@
 # CodeCrafters uses this file to test your code. Don't make any changes here!
 #
 # DON'T EDIT THIS!
-exec dotnet run --project . --configuration Release "$@"
+exec dotnet run --project . --configuration Release -- "$@"

compiled_starters/javascript/.gitignore

@@ -1 +1,2 @@
 *.db
+node_modules/

compiled_starters/javascript/README.md

@@ -30,7 +30,7 @@ Time to move on to the next stage!
 
 Note: This section is for stages 2 and beyond.
 
-1. Ensure you have `node (16)` installed locally
+1. Ensure you have `node (21)` installed locally
 1. Run `./your_sqlite3.sh` to run your program, which is implemented in
    `app/main.js`.
 1. Commit your changes and run `git push origin master` to submit your solution

compiled_starters/javascript/codecrafters.yml

@@ -7,5 +7,5 @@ debug: false
 # Use this to change the JavaScript version used to run your code
 # on Codecrafters.
 #
-# Available versions: nodejs-18
-language_pack: nodejs-18
+# Available versions: nodejs-21
+language_pack: nodejs-21

compiled_starters/javascript/package-lock.json

@@ -1,9 +1,16 @@
 {
-  "name": "sqlite-starter-javascript",
-  "version": "1.0.0",
-  "description": "This is a starting point for JavaScript solutions to the Build Your Own SQLite challenge",
-  "main": "app/main.js",
-  "author": "CodeCrafters",
-  "type": "module",
-  "license": "MIT"
-}
+    "name": "@codecrafters/build-your-own-sqlite",
+    "version": "1.0.0",
+    "description": "Build your own SQLite challenge, from CodeCrafters",
+    "main": "main.js",
+    "type": "module",
+    "scripts": {
+        "dev": "node app/main.js"
+    },
+    "keywords": [
+        "build-your-own-x"
+    ],
+    "author": "",
+    "license": "MIT",
+    "dependencies": {}
+}

compiled_starters/javascript/package.json

@@ -0,0 +1 @@
+* text=auto

compiled_starters/typescript/.gitattributes

@@ -0,0 +1 @@
+node_modules/

compiled_starters/typescript/.gitignore

@@ -0,0 +1,77 @@
+![progress-banner](https://codecrafters.io/landing/images/default_progress_banners/sqlite.png)
+
+This is a starting point for TypeScript solutions to the
+["Build Your Own SQLite" Challenge](https://codecrafters.io/challenges/sqlite).
+
+In this challenge, you'll build a barebones SQLite implementation that supports
+basic SQL queries like `SELECT`. Along the way we'll learn about
+[SQLite's file format](https://www.sqlite.org/fileformat.html), how indexed data
+is
+[stored in B-trees](https://jvns.ca/blog/2014/10/02/how-does-sqlite-work-part-2-btrees/)
+and more.
+
+**Note**: If you're viewing this repo on GitHub, head over to
+[codecrafters.io](https://codecrafters.io) to try the challenge.
+
+# Passing the first stage
+
+The entry point for your SQLite implementation is in `app/main.ts`. Study and
+uncomment the relevant code, and push your changes to pass the first stage:
+
+```sh
+git add .
+git commit -m "pass 1st stage" # any msg
+git push origin master
+```
+
+Time to move on to the next stage!
+
+# Stage 2 & beyond
+
+Note: This section is for stages 2 and beyond.
+
+1. Ensure you have `bun (1.1)` installed locally
+1. Run `./your_sqlite3.sh` to run your program, which is implemented in
+   `app/main.ts`.
+1. Commit your changes and run `git push origin master` to submit your solution
+   to CodeCrafters. Test output will be streamed to your terminal.
+
+# Sample Databases
+
+To make it easy to test queries locally, we've added a sample database in the
+root of this repository: `sample.db`.
+
+This contains two tables: `apples` & `oranges`. You can use this to test your
+implementation for the first 6 stages.
+
+You can explore this database by running queries against it like this:
+
+```sh
+$ sqlite3 sample.db "select id, name from apples"
+1|Granny Smith
+2|Fuji
+3|Honeycrisp
+4|Golden Delicious
+```
+
+There are two other databases that you can use:
+
+1. `superheroes.db`:
+   - This is a small version of the test database used in the table-scan stage.
+   - It contains one table: `superheroes`.
+   - It is ~1MB in size.
+1. `companies.db`:
+   - This is a small version of the test database used in the index-scan stage.
+   - It contains one table: `companies`, and one index: `idx_companies_country`
+   - It is ~7MB in size.
+
+These aren't included in the repository because they're large in size. You can
+download them by running this script:
+
+```sh
+./download_sample_databases.sh
+```
+
+If the script doesn't work for some reason, you can download the databases
+directly from
+[codecrafters-io/sample-sqlite-databases](https://github.com/codecrafters-io/sample-sqlite-databases).