feat: add Dockerfile and devcontainer configuration for Node SQLite development environment

Author: mceachen

.devcontainer/Dockerfile

@@ -0,0 +1,32 @@
+# Use the official Node.js dev container base image
+FROM mcr.microsoft.com/devcontainers/javascript-node:1-20-bookworm
+
+# Install additional dependencies for building native modules
+RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get -y install --no-install-recommends \
+    build-essential \
+    python3 \
+    python3-pip \
+    python3-dev \
+    cmake \
+    ninja-build \
+    ccache \
+    clang-tidy \
+    clang-format \
+    valgrind \
+    gdb \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install node-gyp globally
+RUN npm install -g node-gyp@latest
+
+# Set up ccache for faster C++ compilation
+ENV PATH="/usr/lib/ccache:${PATH}"
+ENV CCACHE_DIR="/workspaces/.ccache"
+
+# Configure git to trust the workspace directory
+RUN git config --global --add safe.directory /workspaces/*
+
+# Set the default shell to zsh
+ENV SHELL=/bin/zsh

.devcontainer/devcontainer.json

@@ -0,0 +1,73 @@
+{
+  "name": "Node SQLite Development Container",
+  "dockerFile": "Dockerfile",
+
+  // Features to add to the dev container
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainers/features/common-utils:2": {
+      "configureZshAsDefaultShell": true
+    },
+    "ghcr.io/devcontainers/features/python:1": {
+      "version": "3.11"
+    }
+  },
+
+  // Configure tool-specific properties
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "dbaeumer.vscode-eslint",
+        "esbenp.prettier-vscode",
+        "ms-vscode.cpptools",
+        "ms-vscode.cpptools-extension-pack",
+        "streetsidesoftware.code-spell-checker",
+        "wayou.vscode-todo-highlight",
+        "gruntfuggly.todo-tree",
+        "yzhang.markdown-all-in-one",
+        "bierner.markdown-mermaid",
+        "usernamehw.errorlens"
+      ],
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "zsh",
+        "editor.formatOnSave": true,
+        "editor.codeActionsOnSave": {
+          "source.fixAll.eslint": "explicit"
+        },
+        "eslint.validate": [
+          "javascript",
+
+          "javascriptreact",
+          "typescript",
+          "typescriptreact"
+        ],
+        "files.associations": {
+          "*.gyp": "python",
+          "*.gypi": "python"
+        },
+        "C_Cpp.default.configurationProvider": "ms-vscode.cmake-tools"
+      }
+    }
+  },
+
+  // Use 'forwardPorts' to make a list of ports inside the container available locally
+  "forwardPorts": [],
+
+  // Use 'postCreateCommand' to run commands after the container is created
+  "postCreateCommand": "bash .devcontainer/post-create.sh",
+
+  // Set environment variables
+  "containerEnv": {
+    "NODE_ENV": "development"
+  },
+
+  // Configure mounts
+  "mounts": [
+    // Mount npm cache for faster rebuilds
+    "source=${localEnv:HOME}/.npm,target=/home/vscode/.npm,type=bind,consistency=cached"
+  ],
+
+  // Run as non-root user
+  "remoteUser": "vscode"
+}

.devcontainer/post-create.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -e
+
+echo "🚀 Setting up Node SQLite development environment..."
+
+# Install npm dependencies
+echo "📦 Installing npm dependencies..."
+npm install
+
+# Build the native module
+echo "🔨 Building native module..."
+npm run build:native
+
+# Run initial build
+echo "🏗️ Running TypeScript build..."
+npm run build
+
+# Set up git hooks if available
+if [ -f "scripts/precommit.ts" ]; then
+    echo "🪝 Setting up git hooks..."
+    npx husky install 2>/dev/null || true
+fi
+
+# Create ccache directory if it doesn't exist
+mkdir -p /workspaces/.ccache
+
+echo "✅ Development environment setup complete!"
+echo ""
+echo "Available npm scripts:"
+echo "  npm test          - Run tests"
+echo "  npm run build     - Build TypeScript and native code"
+echo "  npm run lint      - Run linter"
+echo "  npm run docs      - Generate documentation"
+echo ""
+echo "For more information, see README.md"