feat: add Typescript support using deno runtime.

Add package.json support.

Author: ryan-gang

compiled_starters/typescript/.gitattributes

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

compiled_starters/typescript/.gitignore

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

compiled_starters/typescript/README.md

@@ -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 `deno (1.42)` 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).

compiled_starters/typescript/app/main.ts

@@ -0,0 +1,19 @@
+const databaseFilePath: string = Deno.args[0];
+const command: string = Deno.args[1];
+
+if (command === ".dbinfo") {
+    const databaseFileHandler = await Deno.open(databaseFilePath, { read: true });
+    const buffer = new Uint8Array(100);
+    await databaseFileHandler.read(buffer);
+
+    // You can use print statements as follows for debugging, they'll be visible when running tests.
+    console.log("Logs from your program will appear here!");
+
+    // Uncomment this to pass the first stage    
+    // const pageSize = new DataView(buffer.buffer, 0, buffer.byteLength).getUint16(16);
+    // console.log(`database page size: ${pageSize}`);
+
+    databaseFileHandler.close();
+} else {
+    throw new Error(`Unknown command ${command}`);
+}

compiled_starters/typescript/codecrafters.yml

@@ -0,0 +1,11 @@
+# Set this to true if you want debug logs.
+#
+# These can be VERY verbose, so we suggest turning them off
+# unless you really need them.
+debug: false
+
+# Use this to change the TypeScript version used to run your code
+# on Codecrafters.
+#
+# Available versions: deno-1.42
+language_pack: deno-1.42

compiled_starters/typescript/download_sample_databases.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+echo "Downloading superheroes.db: ~1MB (used in stage 7)"
+curl -Lo superheroes.db https://raw.githubusercontent.com/codecrafters-io/sample-sqlite-databases/master/superheroes.db
+
+echo "Downloading companies.db: ~7MB (used in stage 8)"
+curl -Lo companies.db https://raw.githubusercontent.com/codecrafters-io/sample-sqlite-databases/master/companies.db
+
+echo "Sample databases downloaded."

compiled_starters/typescript/package.json

@@ -0,0 +1,9 @@
+{
+    "name": "@codecrafters/build-your-own-sqlite",
+    "description": "Build your own SQLite challenge, from CodeCrafters",
+    "type": "module",
+    "scripts": {
+        "dev": "deno run --allow-all app/main.ts"
+    },
+    "dependencies": {}
+}

compiled_starters/typescript/sample.db

@@ -0,0 +1,8 @@
+#!/bin/sh
+#
+# DON'T EDIT THIS!
+#
+# CodeCrafters uses this file to test your code. Don't make any changes here!
+#
+# DON'T EDIT THIS!
+exec deno run --allow-all ./app/main.ts "$@"

compiled_starters/typescript/your_sqlite3.sh

@@ -44,6 +44,8 @@ languages:
   - slug: "zig"
   - slug: "java"
     release_status: "beta"
+  - slug: "typescript"
+    release_status: "beta"
 
 marketing:
   difficulty: hard

course-definition.yml

@@ -0,0 +1,19 @@
+FROM denoland/deno:alpine-1.42.0
+
+ENV CODECRAFTERS_DEPENDENCY_FILE_PATHS="package.json"
+
+WORKDIR /app
+
+COPY package.json ./
+# If users import dependencies in files foo.ts and bar.ts, unless those files are present while running deno cache, these dependencies will not be resolved. 
+# Even if they are present in package.json#dependencies.
+COPY app/ ./app/
+RUN deno cache app/main.ts 
+RUN rm -rf ./app/
+
+RUN mkdir -p /app-cached
+# If the node_modules directory exists, move it to /app-cached
+RUN if [ -d "/app/node_modules" ]; then mv /app/node_modules /app-cached; fi
+
+RUN printf "cd \${CODECRAFTERS_SUBMISSION_DIR} && deno cache app/main.ts" > /codecrafters-precompile.sh
+RUN chmod +x /codecrafters-precompile.sh

dockerfiles/deno-1.42.Dockerfile

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

solutions/typescript/01-init/code/.gitattributes

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

solutions/typescript/01-init/code/.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 `deno (1.42)` 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).

solutions/typescript/01-init/code/README.md

@@ -0,0 +1,15 @@
+const databaseFilePath: string = Deno.args[0];
+const command: string = Deno.args[1];
+
+if (command === ".dbinfo") {
+    const databaseFileHandler = await Deno.open(databaseFilePath, { read: true });
+    const buffer = new Uint8Array(100);
+    await databaseFileHandler.read(buffer);
+
+    const pageSize = new DataView(buffer.buffer, 0, buffer.byteLength).getUint16(16);
+    console.log(`database page size: ${pageSize}`);
+
+    databaseFileHandler.close();
+} else {
+    throw new Error(`Unknown command ${command}`);
+}

solutions/typescript/01-init/code/app/main.ts

@@ -0,0 +1,11 @@
+# Set this to true if you want debug logs.
+#
+# These can be VERY verbose, so we suggest turning them off
+# unless you really need them.
+debug: false
+
+# Use this to change the TypeScript version used to run your code
+# on Codecrafters.
+#
+# Available versions: deno-1.42
+language_pack: deno-1.42

solutions/typescript/01-init/code/codecrafters.yml

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+echo "Downloading superheroes.db: ~1MB (used in stage 7)"
+curl -Lo superheroes.db https://raw.githubusercontent.com/codecrafters-io/sample-sqlite-databases/master/superheroes.db
+
+echo "Downloading companies.db: ~7MB (used in stage 8)"
+curl -Lo companies.db https://raw.githubusercontent.com/codecrafters-io/sample-sqlite-databases/master/companies.db
+
+echo "Sample databases downloaded."

solutions/typescript/01-init/code/download_sample_databases.sh

@@ -0,0 +1,9 @@
+{
+    "name": "@codecrafters/build-your-own-sqlite",
+    "description": "Build your own SQLite challenge, from CodeCrafters",
+    "type": "module",
+    "scripts": {
+        "dev": "deno run --allow-all app/main.ts"
+    },
+    "dependencies": {}
+}

solutions/typescript/01-init/code/package.json

@@ -0,0 +1,8 @@
+#!/bin/sh
+#
+# DON'T EDIT THIS!
+#
+# CodeCrafters uses this file to test your code. Don't make any changes here!
+#
+# DON'T EDIT THIS!
+exec deno run --allow-all ./app/main.ts "$@"

solutions/typescript/01-init/code/sample.db

@@ -0,0 +1,22 @@
+@@ -1,19 +1,15 @@
+ const databaseFilePath: string = Deno.args[0];
+ const command: string = Deno.args[1];
+
+ if (command === ".dbinfo") {
+     const databaseFileHandler = await Deno.open(databaseFilePath, { read: true });
+     const buffer = new Uint8Array(100);
+     await databaseFileHandler.read(buffer);
+
+-    // You can use print statements as follows for debugging, they'll be visible when running tests.
+-    console.log("Logs from your program will appear here!");
+-
+-    // Uncomment this to pass the first stage    
+-    // const pageSize = new DataView(buffer.buffer, 0, buffer.byteLength).getUint16(16);
+-    // console.log(`database page size: ${pageSize}`);
++    const pageSize = new DataView(buffer.buffer, 0, buffer.byteLength).getUint16(16);
++    console.log(`database page size: ${pageSize}`);
+
+     databaseFileHandler.close();
+ } else {
+     throw new Error(`Unknown command ${command}`);
+ }

solutions/typescript/01-init/code/your_sqlite3.sh

@@ -0,0 +1,17 @@
+The entry point for your SQLite implementation is in `app/main.ts`.
+
+Study and uncomment the relevant code: 
+
+```typescript
+// Uncomment this to pass the first stage
+const pageSize = new DataView(buffer.buffer, 0, buffer.byteLength).getUint16(16);
+console.log(`database page size: ${pageSize}`);
+```
+
+Push your changes to pass the first stage:
+
+```
+git add .
+git commit -m "pass 1st stage" # any msg
+git push origin master
+```

solutions/typescript/01-init/diff/app/main.ts.diff

@@ -255,3 +255,28 @@
   template_attributes:
     required_executable: "java (21)"
     user_editable_file: "src/main/java/Main.java"
+
+- language: typescript
+  file_mappings:
+    - source: starter_templates/README.md
+      target: README.md
+    - source: starter_templates/codecrafters.yml
+      target: codecrafters.yml
+    - source: starter_templates/sample.db
+      target: sample.db
+      should_skip_template_evaluation: true
+    - source: starter_templates/download_sample_databases.sh
+      target: download_sample_databases.sh
+    - source: starter_templates/typescript/app/main.ts
+      target: app/main.ts
+    - source: starter_templates/typescript/package.json
+      target: package.json
+    - source: starter_templates/typescript/your_sqlite3.sh
+      target: your_sqlite3.sh
+    - source: starter_templates/.gitattributes
+      target: .gitattributes
+    - source: starter_templates/typescript/.gitignore
+      target: .gitignore
+  template_attributes:
+    required_executable: "deno (1.42)"
+    user_editable_file: "app/main.ts"

solutions/typescript/01-init/explanation.md

@@ -79,3 +79,7 @@ language_pack: cpp-20
 # Available versions: zig-0.11
 language_pack: zig-0.11
 {{/language_is_zig}}
+{{#language_is_typescript}}
+# Available versions: deno-1.42
+language_pack: deno-1.42
+{{/language_is_typescript}}

starter-repository-definitions.yml

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