Add Claude Code configuration and Docker Compose for InfluxDB 3

.claude/settings.json

@@ -0,0 +1,30 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm:*)",
+      "Bash(yarn:*)",
+      "Bash(npx:*)",
+      "Bash(node:*)",
+      "Bash(curl:*)",
+      "Bash(gh:*)",
+      "Bash(jq:*)",
+      "Bash(mkdir:*)",
+      "Bash(docker:*)",
+      "Bash(docker compose:*)",
+      "Edit",
+      "Read",
+      "Write",
+      "Grep",
+      "Glob",
+      "LS"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./secrets/**)"
+    ],
+    "ask": [
+      "Bash(git push:*)"
+    ]
+  }
+}

.claude/skills/run-tests/SKILL.md

@@ -0,0 +1,195 @@
+---
+name: run-tests
+description: Run API tests against InfluxDB 3 Core. Handles service initialization, database setup, and test execution.
+author: InfluxData
+version: "1.0"
+---
+
+# Run Tests Skill
+
+## Purpose
+
+This skill guides running the IoT API test suite against a local InfluxDB 3 Core instance. It covers service setup, database creation, and test execution.
+
+## Quick Reference
+
+| Task | Command |
+|------|---------|
+| Start InfluxDB 3 | `docker compose up -d influxdb3-core` |
+| Check status | `curl -i http://localhost:8181/health` |
+| Run tests | `yarn test` |
+| View logs | `docker logs influxdb3-core` |
+
+## Complete Setup Workflow
+
+### 1. Initialize InfluxDB 3 Core
+
+```bash
+# Create required directories
+mkdir -p test/.influxdb3/core/data test/.influxdb3/core/plugins
+
+# Generate admin token (first time only)
+openssl rand -hex 32 > test/.influxdb3/core/.token
+chmod 600 test/.influxdb3/core/.token
+
+# Start the container
+docker compose up -d influxdb3-core
+
+# Wait for healthy status
+docker compose ps
+```
+
+### 2. Create Databases
+
+```bash
+# Get the token
+TOKEN=$(cat test/.influxdb3/core/.token)
+
+# Create main database
+curl -X POST "http://localhost:8181/api/v3/configure/database" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"db": "iot_center"}'
+
+# Create auth database
+curl -X POST "http://localhost:8181/api/v3/configure/database" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"db": "iot_center_auth"}'
+
+# Verify databases exist
+curl "http://localhost:8181/api/v3/configure/database?format=json" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### 3. Configure Environment
+
+Create `.env.local` if it doesn't exist:
+
+```bash
+cat > .env.local << EOF
+INFLUX_HOST=http://localhost:8181
+INFLUX_TOKEN=$(cat test/.influxdb3/core/.token)
+INFLUX_DATABASE=iot_center
+INFLUX_DATABASE_AUTH=iot_center_auth
+EOF
+```
+
+### 4. Run Tests
+
+```bash
+# Install dependencies (if needed)
+yarn
+
+# Run the test suite
+yarn test
+
+# Run with verbose output
+yarn test --verbose
+
+# Run specific test file
+yarn test __tests__/api.test.js
+```
+
+## Troubleshooting
+
+### Container Won't Start
+
+**Symptom:** Container exits immediately
+
+**Check:**
+```bash
+# View logs
+docker logs influxdb3-core
+
+# Verify directories exist
+ls -la test/.influxdb3/core/
+
+# Verify token file exists
+cat test/.influxdb3/core/.token
+```
+
+**Common fixes:**
+- Create missing directories: `mkdir -p test/.influxdb3/core/data test/.influxdb3/core/plugins`
+- Generate token: `openssl rand -hex 32 > test/.influxdb3/core/.token`
+
+### 401 Unauthorized
+
+**Symptom:** API calls return 401
+
+**Check:**
+```bash
+# Verify token matches
+echo "Token in file: $(cat test/.influxdb3/core/.token)"
+echo "Token in .env.local: $(grep INFLUX_TOKEN .env.local)"
+
+# Test with token directly
+curl -i http://localhost:8181/api/v3/configure/database \
+  -H "Authorization: Bearer $(cat test/.influxdb3/core/.token)"
+```
+
+### Database Not Found
+
+**Symptom:** Tests fail with "database not found"
+
+**Fix:** Create the required databases:
+```bash
+TOKEN=$(cat test/.influxdb3/core/.token)
+curl -X POST "http://localhost:8181/api/v3/configure/database" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"db": "iot_center"}'
+curl -X POST "http://localhost:8181/api/v3/configure/database" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"db": "iot_center_auth"}'
+```
+
+### Port Already in Use
+
+**Symptom:** "port is already allocated"
+
+**Fix:**
+```bash
+# Find what's using the port
+lsof -i :8181
+
+# Stop existing container
+docker compose down
+```
+
+## Clean Slate
+
+To start fresh:
+
+```bash
+# Stop and remove containers
+docker compose down
+
+# Remove data (WARNING: deletes all data)
+rm -rf test/.influxdb3/core/data/*
+
+# Regenerate token
+openssl rand -hex 32 > test/.influxdb3/core/.token
+
+# Start fresh
+docker compose up -d influxdb3-core
+```
+
+## Test Configuration
+
+The test suite uses these environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `INFLUX_HOST` | `http://localhost:8181` | InfluxDB 3 API URL |
+| `INFLUX_TOKEN` | (from `.env.local`) | Admin token |
+| `INFLUX_DATABASE` | `iot_center` | Main data database |
+| `INFLUX_DATABASE_AUTH` | `iot_center_auth` | Device auth database |
+
+## Related Files
+
+- **Docker Compose**: `compose.yaml`
+- **Test suite**: `__tests__/api.test.js`
+- **Environment defaults**: `.env.development`
+- **Local overrides**: `.env.local` (gitignored)

.github/INSTRUCTIONS.md

@@ -0,0 +1,47 @@
+# AI Instructions Navigation Guide
+
+This repository has multiple instruction files for different AI tools and use cases.
+
+## Quick Navigation
+
+| If you are... | Start here |
+|---------------|------------|
+| **GitHub Copilot** | [../AGENTS.md](../AGENTS.md) |
+| **Claude, ChatGPT, Gemini** | [../AGENTS.md](../AGENTS.md) |
+| **Claude with MCP** | [../CLAUDE.md](../CLAUDE.md) |
+
+## File Organization
+
+```
+iot-api-js/
+├── docs/                             # Detailed documentation
+│   ├── architecture.md               # System design, project structure
+│   ├── development.md                # Setup, testing, debugging
+│   ├── api-reference.md              # API endpoints
+│   ├── code-patterns.md              # InfluxDB client usage
+│   └── contributing.md               # Style guidelines
+├── .claude/
+│   ├── settings.json                 # Claude permissions
+│   └── skills/run-tests/SKILL.md     # Test execution workflow
+├── .github/
+│   └── INSTRUCTIONS.md               # THIS FILE
+├── AGENTS.md                         # AI assistant quick reference
+├── CLAUDE.md                         # Claude with MCP quick reference
+└── README.md                         # User-facing documentation
+```
+
+## Documentation
+
+| Topic | Location |
+|-------|----------|
+| System architecture | [../docs/architecture.md](../docs/architecture.md) |
+| Development setup | [../docs/development.md](../docs/development.md) |
+| API endpoints | [../docs/api-reference.md](../docs/api-reference.md) |
+| Code patterns | [../docs/code-patterns.md](../docs/code-patterns.md) |
+| Contributing | [../docs/contributing.md](../docs/contributing.md) |
+
+## Getting Started
+
+1. **New to the repository?** Start with [../README.md](../README.md)
+2. **Using AI assistants?** Read [../AGENTS.md](../AGENTS.md) then explore [../docs/](../docs/)
+3. **Using Claude with MCP?** Check [../CLAUDE.md](../CLAUDE.md) and [../.claude/](../.claude/)

.gitignore

@@ -28,3 +28,9 @@ yarn-error.log*
 .env.development.local
 .env.test.local
 .env.production.local
+
+# InfluxDB 3 local data
+test/.influxdb3/
+
+# Git worktrees
+.worktrees/

AGENTS.md

@@ -0,0 +1,40 @@
+# IoT API JS - AI Assistant Guide
+
+Sample application for InfluxData tutorials demonstrating REST APIs with InfluxDB 3 Core.
+
+**Target audience:** Developers learning to build IoT applications with InfluxDB 3.
+
+## Quick Reference
+
+| Task | Command |
+|------|---------|
+| Install | `yarn` |
+| Dev server | `yarn dev -p 5200` |
+| Run tests | `yarn test` |
+| Start InfluxDB | `docker compose up -d influxdb3-core` |
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| `lib/influxdb.js` | InfluxDB client factory and helpers |
+| `pages/api/devices/create.js` | Device registration endpoint |
+| `pages/api/devices/_devices.js` | Shared device query logic |
+| `pages/api/devices/[[...deviceParams]].js` | Device CRUD operations |
+| `__tests__/api.test.js` | API integration tests |
+
+## Documentation
+
+| Topic | Location |
+|-------|----------|
+| System architecture | [docs/architecture.md](docs/architecture.md) |
+| Development setup | [docs/development.md](docs/development.md) |
+| API endpoints | [docs/api-reference.md](docs/api-reference.md) |
+| Code patterns | [docs/code-patterns.md](docs/code-patterns.md) |
+| Contributing | [docs/contributing.md](docs/contributing.md) |
+
+## Other Resources
+
+- [CLAUDE.md](CLAUDE.md) - For Claude with MCP
+- [README.md](README.md) - User-facing documentation
+- [.github/INSTRUCTIONS.md](.github/INSTRUCTIONS.md) - Navigation guide

CLAUDE.md

@@ -0,0 +1,38 @@
+# IoT API JS - Claude Instructions
+
+Next.js REST API demonstrating InfluxDB 3 Core integration for IoT device data.
+
+## Quick Reference
+
+| Task | Command |
+|------|---------|
+| Install | `yarn` |
+| Dev server | `yarn dev -p 5200` |
+| Run tests | `yarn test` |
+| Start InfluxDB | `docker compose up -d influxdb3-core` |
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| `lib/influxdb.js` | Client factory and query/write helpers |
+| `pages/api/devices/create.js` | Device registration |
+| `pages/api/devices/_devices.js` | Shared device queries |
+| `pages/api/devices/[[...deviceParams]].js` | Device CRUD + measurements |
+
+## Documentation
+
+| Topic | Location |
+|-------|----------|
+| System architecture | [docs/architecture.md](docs/architecture.md) |
+| Development setup | [docs/development.md](docs/development.md) |
+| API endpoints | [docs/api-reference.md](docs/api-reference.md) |
+| Code patterns | [docs/code-patterns.md](docs/code-patterns.md) |
+| Contributing | [docs/contributing.md](docs/contributing.md) |
+| Testing workflow | [.claude/skills/run-tests/SKILL.md](.claude/skills/run-tests/SKILL.md) |
+
+## Other Resources
+
+- [AGENTS.md](AGENTS.md) - Guide for general AI assistants
+- [.github/INSTRUCTIONS.md](.github/INSTRUCTIONS.md) - Navigation guide
+- [.claude/](.claude/) - Claude Code settings and skills

babel.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  presets: [
+    ['@babel/preset-env', { targets: { node: 'current' } }],
+  ],
+};