neo4j-driver-javascript-skill

What problem does it solve?

It solves the challenge of reliably wiring the official Neo4j JavaScript/TypeScript driver into a Node.js or browser app, including correct query execution patterns, safe transaction handling, and the tricky conversion of Neo4j types like Integer for JSON and APIs.

Core Features & Use Cases

• Driver lifecycle and connection setup: Create a single shared driver, choose the right URI scheme (including Aura vs local), and verify connectivity on startup.
• Safe query execution APIs: Use executeQuery for most cases, executeRead/executeWrite for managed transactions with auto-retry, and session.run for implicit transaction scenarios like LOAD CSV.
• Correct result consumption and data handling: Access records via record.get, consume streams inside transaction callbacks, and avoid common pitfalls with JSON serialization of Integer and temporal types.
• TypeScript support and errors: Apply key TypeScript types (Driver, Session, ManagedTransaction, Node<Integer>) and handle Neo4jError codes like SERVICE_UNAVAILABLE and constraint validation failures.
• Batch operations: Perform efficient batch writes using UNWIND with proper parameter handling for integers.

Quick Start

Use the neo4j-driver-javascript-skill to write a minimal JS/TS example that connects to Neo4j with executeQuery, retrieves record values with record.get, and safely converts Neo4j Integers for JSON output.