@neo4j-cypher/query-tools 2.0.0-next.37 → 2.0.0-next.39

package/dist/types/vitest.config.d.mts

@@ -1,2 +1,2 @@
-declare const _default: import("vite").UserConfig;
+declare const _default: import("vitest/config").UserWorkspaceConfig;
 export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neo4j-cypher/query-tools",
-  "version": "2.0.0-next.37",
+  "version": "2.0.0-next.39",
   "description": "",
   "bugs": {
     "url": "https://github.com/neo4j/cypher-language-support/issues"
@@ -11,21 +11,22 @@
     "type": "git",
     "url": "git://github.com/neo4j/cypher-language-support.git"
   },
-  "main": "./dist/cjs/src/index.js",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/src/index.js",
   "types": "./dist/types/src/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/esm/index.d.ts",
-      "require": "./dist/cjs/src/index.js",
+      "types": "./dist/types/src/index.d.ts",
+      "require": "./dist/cjs/index.cjs",
       "import": "./dist/esm/src/index.js",
-      "default": "./dist/cjs/src/index.js"
+      "default": "./dist/cjs/index.cjs"
     }
   },
   "dependencies": {
     "ajv": "^8.12.0",
     "neo4j-driver": "6.0.1",
-    "@neo4j-cypher/language-support": "2.0.0-next.37"
+    "@neo4j-cypher/language-support": "2.0.0-next.39"
   },
   "devDependencies": {
     "@testcontainers/neo4j": "^11.5.1"
@@ -35,12 +36,13 @@
   },
   "scripts": {
     "build": "concurrently 'npm:build-esm' 'npm:build-commonjs' 'npm:build-types'",
-    "build-esm": "tsc --module esnext --outDir dist/esm",
-    "build-commonjs": "tsc --module commonjs --moduleResolution node --outDir dist/cjs",
+    "build-esm": "tsc --outDir dist/esm",
+    "build-commonjs": "esbuild ./src/index.ts --bundle --format=cjs --sourcemap --packages=external --outfile=dist/cjs/index.cjs",
     "build-types": "tsc --emitDeclarationOnly --outDir dist/types",
+    "check-api-report": "tsx checkApiReport.ts",
+    "gen-api-report": "pnpm build-types && pnpm check-api-report",
     "dev": "concurrently 'npm:build-esm -- --watch' 'npm:build-commonjs -- --watch'",
-    "clean": "rm -rf {dist,tsconfig.tsbuildinfo}",
-    "test": "vitest run extract-unique-nodes-and-relationships",
-    "test:polling": "vitest run pollingIntegrationTests"
+    "clean": "rm -rf dist tsconfig*.tsbuildinfo",
+    "test": "vitest run"
   }
 }

package/src/connectionErrorHandler.ts

@@ -1,6 +1,9 @@
-import { Neo4jError } from 'neo4j-driver';
+import type { Neo4jError } from 'neo4j-driver';
 
-export const FRIENDLY_ERROR_MESSAGES: { [key: string]: string } = {
+export const FRIENDLY_ERROR_MESSAGES: {
+  Default: string;
+  [key: string]: string;
+} = {
   'Neo.ClientError.Security.AuthenticationRateLimit':
     'Double check your username and password',
   'Neo.ClientError.Security.CredentialsExpired':

package/src/cypher-execution/extract-unique-nodes-and-relationships.test.ts

@@ -1,4 +1,4 @@
-import type { Record } from 'neo4j-driver';
+import type { Record as Neo4jRecord } from 'neo4j-driver';
 import { Node, Path, PathSegment, Relationship } from 'neo4j-driver';
 
 import { describe, expect, test } from 'vitest';
@@ -36,11 +36,10 @@ describe('extractNodesAndRels', () => {
     const pathSegment = new PathSegment(startNode, relationship, endNode);
     const path = new Path(startNode, endNode, [pathSegment]);
 
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     const boltRecord = {
       keys: ['p'],
       get: () => path,
-    } as unknown as Record;
+    } as unknown as Neo4jRecord;
 
     const { nodes, relationships } = extractUniqueNodesAndRels([boltRecord]);
 
@@ -104,11 +103,10 @@ describe('extractNodesAndRels', () => {
       'node34',
     );
 
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     const boltRecord = {
       keys: ['n'],
       get: () => [node1, node2, relationship],
-    } as unknown as Record;
+    } as unknown as Neo4jRecord;
 
     const { nodes, relationships, limitHit } = extractUniqueNodesAndRels([
       boltRecord,
@@ -148,11 +146,10 @@ describe('extractNodesAndRels', () => {
     const pathSegment = new PathSegment(startNode, relationship, endNode);
     const path = new Path(startNode, endNode, [pathSegment]);
 
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     const boltRecord = {
       keys: ['p'],
       get: () => path,
-    } as unknown as Record;
+    } as unknown as Neo4jRecord;
 
     const { nodes, relationships, limitHit } = extractUniqueNodesAndRels(
       [boltRecord],
@@ -202,11 +199,10 @@ describe('extractNodesAndRels', () => {
     const pathSegment = new PathSegment(startNode, relationship, endNode);
     const path = new Path(startNode, endNode, [pathSegment]);
 
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     const boltRecord = {
       keys: ['p'],
       get: () => path,
-    } as unknown as Record;
+    } as unknown as Neo4jRecord;
 
     const { nodes, relationships, limitHit } = extractUniqueNodesAndRels(
       [boltRecord],

package/src/cypher-execution/extract-unique-nodes-and-relationships.ts

@@ -7,7 +7,7 @@ import type {
   Relationship,
 } from 'neo4j-driver';
 import { isNode, isPath, isRelationship } from 'neo4j-driver';
-import { CypherProperty } from '../types/cypher-data-types.js';
+import type { CypherProperty } from '../types/cypher-data-types.js';
 
 export type Properties = RecordShape<string, CypherProperty>;
 
@@ -32,9 +32,8 @@ export type DeduplicatedNodesAndRels = {
  * nested objects.
  *
  * @param records - Array of Neo4j records to process
- * @param options - Configuration options for extraction
- * @param options.nodeLimit - Maximum number of unique nodes to extract (optional)
- * @param options.keepDanglingRels - Whether to keep relationships whose start/end nodes are missing (default: false)
+ * @param nodeLimit - Configuration option: Maximum number of unique nodes to extract (optional)
+ * @param keepDanglingRels - Configuration option:  Whether to keep relationships whose start/end nodes are missing (default: false)
  *
  * @returns The {@link DeduplicatedNodesAndRels} containing unique nodes and relationships
  */

package/src/cypher-execution/query-result.ts

@@ -1,3 +1,4 @@
+// oxlint-disable typescript/no-explicit-any
 import type { QueryResult, Record as Neo4jRecord } from 'neo4j-driver';
 import { int, isInt, isVector, types, Vector } from 'neo4j-driver';
 
@@ -28,7 +29,6 @@ export type Neo4jType =
 
 export function addAnnotationProp(
   obj: Record<string, unknown>,
-  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents
   type: string | unknown,
   prop: string = RESERVED_TYPE_PROPERTY_NAME,
 ): Record<string, unknown> {
@@ -73,14 +73,11 @@ function copyAndAnnotate(
   obj: Exclude<Neo4jType | QueryResult, undefined | null | Neo4jType[]>,
 ): Record<string, unknown> {
   return Object.keys(obj).reduce<Record<string, unknown>>((newObj, key) => {
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
     // @ts-ignore TypeScript complains about not being able to use `key` to
     // index `obj`, but we know that `key` exists in `obj` since it's coming
     // from Object.keys.
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     const value = obj[key] as unknown as Neo4jType;
 
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define
     newObj[key] = serializeTypeAnnotations(value);
     return newObj;
   }, {});
@@ -99,11 +96,11 @@ export function serializeTypeAnnotations(
     return item.map((i) => serializeTypeAnnotations(i));
   }
   if (item === null || item === undefined) {
+    // This is needed due to the method overloading types
     return item;
   }
 
   if (item instanceof types.Record) {
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
     // @ts-ignore There are two versions of the type for Record coming from the
     // driver.
     const tmp = copyAndAnnotate(item);
@@ -181,17 +178,10 @@ export function serializeTypeAnnotations(
     return addAnnotationProp(tmp, 'Object');
   }
 
-  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
   // @ts-ignore this type isn't inferred correctly
   return item;
 }
 
-/* eslint-disable @typescript-eslint/no-explicit-any,
-@typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-member-access,
-@typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-assignment,
-no-underscore-dangle, @typescript-eslint/no-redundant-type-constituents
-*/
-
 export function deserializeTypeAnnotations(
   rawItem: Record<string, unknown>,
 ): QueryResult | Neo4jRecord;
@@ -369,7 +359,6 @@ export function deserializeTypeAnnotations(
           break;
         case 'INT64':
           // For INT64, values are stored as strings to avoid BigInt serialization issues
-          // eslint-disable-next-line @typescript-eslint/no-unsafe-call
           typedArray = new BigInt64Array(values.map((v: any) => BigInt(v)));
           break;
         case 'FLOAT32':

package/src/data-transforms/cypher-type-names.ts

@@ -22,7 +22,7 @@ import {
   isInt8Array,
 } from '../types/cypher-data-types.js';
 
-type CypherPropertyName =
+export type CypherPropertyName =
   | 'Float'
   | 'null'
   | 'String'

package/src/data-transforms/record-to-string.ts

@@ -70,7 +70,6 @@ export function propertyToString(
 
   if (typeof property === 'string') {
     if (quoteStrings) {
-      // oxlint-disable-next-line typescript-eslint/restrict-template-expressions
       return `"${property}"`;
     }
     return property;
@@ -88,7 +87,7 @@ const cypherShellStyleStringify = (
   value: Node | Relationship | Path,
   {
     stringStyle,
-    quoteStrings = true,
+    quoteStrings,
   }: { stringStyle: CypherStringStyle; quoteStrings: boolean },
 ): string => {
   const includeIds = stringStyle === 'cypher-with-ids';
@@ -142,7 +141,7 @@ const cypherShellStyleStringify = (
 
     return value.segments
       .map((segment, index) => {
-        const result = [];
+        const result: string[] = [];
 
         if (index === 0) {
           result.push(

package/src/index.ts

@@ -7,7 +7,10 @@ export {
   getCypherTypeName,
   getPropertyTypeDisplayName,
 } from './data-transforms/cypher-type-names.js';
-export type { CypherDataTypeName } from './data-transforms/cypher-type-names.js';
+export type {
+  CypherDataTypeName,
+  CypherPropertyName,
+} from './data-transforms/cypher-type-names.js';
 export * from './data-transforms/record-to-string.js';
 export * from './types/cypher-data-types.js';
 export type {
@@ -18,10 +21,21 @@ export type {
 export type {
   Neo4jConnection,
   QueryResultWithLimit,
+  RunCypherQueryArgs,
+  SdkQueryArgs,
 } from './neo4jConnection.js';
-export type { Database } from './queries/databases.js';
-export { graphResultTransformer } from './result-transformers/graph-result-transformer.js';
+export type { Database, DatabaseStatus } from './queries/databases.js';
+export {
+  graphResultTransformer,
+  GraphResult,
+} from './result-transformers/graph-result-transformer.js';
 export { Neo4jSchemaPoller } from './schemaPoller.js';
 export type { ConnnectionResult } from './schemaPoller.js';
 export type { CypherDataType } from './types/cypher-data-types.js';
 export { getVersion } from './queries/version.js';
+export {
+  ExecuteQueryArgs,
+  QueryType,
+  ExtendedQueryConfig,
+  Result,
+} from './types/sdkTypes.js';

package/src/metadataPoller.ts

@@ -1,19 +1,23 @@
-import type { CypherVersion } from '@neo4j-cypher/language-support';
-import {
-  allCypherVersions,
+import type {
+  CypherVersion,
   DbSchema,
   Neo4jFunction,
   Neo4jProcedure,
 } from '@neo4j-cypher/language-support';
-import { EventEmitter } from 'events';
-import { Neo4jConnection } from './neo4jConnection.js';
-import { Database, listDatabases } from './queries/databases.js';
-import { DataSummary, getDataSummary } from './queries/dataSummary.js';
+import { allCypherVersions } from '@neo4j-cypher/language-support';
+import type { EventEmitter } from 'events';
+import type { Neo4jConnection } from './neo4jConnection.js';
+import type { Database } from './queries/databases.js';
+import { listDatabases } from './queries/databases.js';
+import type { DataSummary } from './queries/dataSummary.js';
+import { getDataSummary } from './queries/dataSummary.js';
 import { listFunctions } from './queries/functions.js';
 import { listProcedures } from './queries/procedures.js';
-import { listRoles, Neo4jRole } from './queries/roles.js';
-import { listUsers, Neo4jUser } from './queries/users.js';
-import { ExecuteQueryArgs } from './types/sdkTypes.js';
+import type { Neo4jRole } from './queries/roles.js';
+import { listRoles } from './queries/roles.js';
+import type { Neo4jUser } from './queries/users.js';
+import { listUsers } from './queries/users.js';
+import type { ExecuteQueryArgs } from './types/sdkTypes.js';
 import { listGraphSchema } from './queries/graphSchema.js';
 
 type PollingStatus = 'not-started' | 'fetching' | 'fetched' | 'error';

package/src/neo4jConnection.ts

@@ -1,4 +1,4 @@
-import {
+import type {
   Driver,
   ManagedTransaction,
   QueryResult,
@@ -6,13 +6,13 @@ import {
   Result,
   Session,
 } from 'neo4j-driver';
-import { version } from '../package.json';
-import { Database } from './queries/databases.js';
-import { ExecuteQueryArgs, QueryType } from './types/sdkTypes.js';
+import packageJson from '../package.json' with { type: 'json' };
+import type { Database } from './queries/databases.js';
+import type { ExecuteQueryArgs, QueryType } from './types/sdkTypes.js';
 
 const METADATA_BASE = {
   app: 'neo4j-sdk',
-  version: version,
+  version: packageJson.version,
 };
 const RECORD_LIMIT = 5000;
 
@@ -33,12 +33,12 @@ function resolveInitialDatabase(
   return home?.name ?? def?.name ?? system?.name ?? databases[0]?.name;
 }
 
-type SdkQueryArgs = {
+export type SdkQueryArgs = {
   queryType: QueryType;
   abortSignal?: AbortSignal;
 };
 
-type RunCypherQueryArgs = {
+export type RunCypherQueryArgs = {
   query: string;
   parameters: Record<string, unknown>;
   database?: string;
@@ -77,7 +77,8 @@ export class Neo4jConnection {
     } else {
       result = tx.run(query, parameters);
     }
-    const records = [];
+    // oxlint-disable-next-line typescript/no-explicit-any
+    const records: Array<any> = [];
     let recordLimitHit = false;
 
     for await (const record of result) {

package/src/queries/dataSummary.ts

@@ -1,5 +1,5 @@
 import { resultTransformers } from 'neo4j-driver';
-import { ExecuteQueryArgs } from '../types/sdkTypes.js';
+import type { ExecuteQueryArgs } from '../types/sdkTypes.js';
 
 export type DataSummary = {
   labels: string[];
@@ -27,9 +27,9 @@ RETURN COLLECT(propertyKey)[..${ITEM_LIMIT}] AS result`;
     },
     collect(results, summary) {
       return {
-        labels: results[0],
-        relationshipTypes: results[1],
-        propertyKeys: results[2],
+        labels: results[0]!,
+        relationshipTypes: results[1]!,
+        propertyKeys: results[2]!,
         summary,
       };
     },

package/src/queries/databases.ts

@@ -1,8 +1,9 @@
 import type { CypherVersion } from '@neo4j-cypher/language-support';
 import { resultTransformers } from 'neo4j-driver';
-import { ExecuteQueryArgs, DbType } from '../types/sdkTypes.js';
+import type { ExecuteQueryArgs } from '../types/sdkTypes.js';
+import { DbType } from '../types/sdkTypes.js';
 
-type DatabaseStatus =
+export type DatabaseStatus =
   | 'online'
   | 'offline'
   | 'starting'
@@ -147,8 +148,6 @@ function getLogicalDatabases(
 
 function sortDatabases(databases: Database[]) {
   function databaseComparator(a: Database, b: Database) {
-    // disable eslint to make code more readable
-    /* eslint-disable curly */
     // home is greater than default
     if (a.default && b.home) return 1;
 
@@ -159,7 +158,6 @@ function sortDatabases(databases: Database[]) {
     // system is less than anything else
     if (a.name === 'system') return 1;
     if (b.name === 'system') return -1;
-    /* eslint-enable curly */
 
     // else sort alphabetically
     return a.name.localeCompare(b.name);

package/src/queries/functions.ts

@@ -1,5 +1,9 @@
-import { CypherVersion, Neo4jFunction } from '@neo4j-cypher/language-support';
-import Ajv, { JSONSchemaType } from 'ajv';
+import type {
+  CypherVersion,
+  Neo4jFunction,
+} from '@neo4j-cypher/language-support';
+import type { JSONSchemaType } from 'ajv';
+import { Ajv } from 'ajv';
 import { resultTransformers } from 'neo4j-driver';
 import {
   cleanType,
@@ -84,7 +88,6 @@ export function listFunctions(
     map(record) {
       const objResult = record.toObject();
       validateFunction(objResult);
-      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
       const result = cleanTypes(objResult as Neo4jFunction);
       return result;
     },

package/src/queries/graphSchema.ts

@@ -1,6 +1,7 @@
 import { resultTransformers } from 'neo4j-driver';
-import { ExecuteQueryArgs } from '../types/sdkTypes.js';
-import Ajv, { JSONSchemaType } from 'ajv';
+import type { ExecuteQueryArgs } from '../types/sdkTypes.js';
+import type { JSONSchemaType } from 'ajv';
+import { Ajv } from 'ajv';
 
 type NeoNode = {
   labels: string[];
@@ -94,16 +95,16 @@ export function extractRelationshipsWithNamedNodes(
   if (graphSchemas.length !== 1) {
     return items;
   }
-  const graphSchema = graphSchemas[0];
+  const graphSchema = graphSchemas[0]!;
   const nodes: Record<string, string> = {};
 
   for (const node of graphSchema.nodes) {
     //Query should only return 1 label
-    nodes[node.elementId] = node.labels[0];
+    nodes[node.elementId] = node.labels[0]!;
   }
   for (const rel of graphSchema.relationships) {
-    const from = nodes[rel.startNodeElementId];
-    const to = nodes[rel.endNodeElementId];
+    const from = nodes[rel.startNodeElementId]!;
+    const to = nodes[rel.endNodeElementId]!;
     const relType = rel.type;
     items.push({ from, to, relType });
   }

package/src/queries/procedures.ts

@@ -1,5 +1,9 @@
-import { CypherVersion, Neo4jProcedure } from '@neo4j-cypher/language-support';
-import Ajv, { JSONSchemaType } from 'ajv';
+import type {
+  CypherVersion,
+  Neo4jProcedure,
+} from '@neo4j-cypher/language-support';
+import type { JSONSchemaType } from 'ajv';
+import { Ajv } from 'ajv';
 import { resultTransformers } from 'neo4j-driver';
 import { cleanTypeDescription } from '../data-transforms/clean-type.js';
 import type { ExecuteQueryArgs } from '../types/sdkTypes.js';
@@ -97,7 +101,6 @@ export function listProcedures(
       const objResult = record.toObject();
       validateProcedure(objResult);
       // Type is verified in integration tests
-      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
       const result = cleanTypes(objResult as Neo4jProcedure);
       return result;
     },

package/src/queries/version.ts

@@ -1,5 +1,5 @@
 import { resultTransformers } from 'neo4j-driver';
-import { ExecuteQueryArgs } from '../types/sdkTypes.js';
+import type { ExecuteQueryArgs } from '../types/sdkTypes.js';
 
 /**
  * Get dbms version

package/src/result-transformers/graph-result-transformer.ts

@@ -1,14 +1,12 @@
-import {
+import type {
   Integer,
-  Record,
+  Record as Neo4jRecord,
   ResultSummary,
-  resultTransformers,
 } from 'neo4j-driver';
+import { resultTransformers } from 'neo4j-driver';
 
-import {
-  DeduplicatedNodesAndRels,
-  extractUniqueNodesAndRels,
-} from '../cypher-execution/extract-unique-nodes-and-relationships.js';
+import type { DeduplicatedNodesAndRels } from '../cypher-execution/extract-unique-nodes-and-relationships.js';
+import { extractUniqueNodesAndRels } from '../cypher-execution/extract-unique-nodes-and-relationships.js';
 
 /**
  * Result type for graph queries that includes deduplicated nodes and relationships
@@ -16,9 +14,9 @@ import {
  *
  * See {@link DeduplicatedNodesAndRels} for the type of the nodes and relationships.
  */
-type GraphResult = DeduplicatedNodesAndRels & {
+export type GraphResult = DeduplicatedNodesAndRels & {
   /** Original Neo4j records returned by the query */
-  records: Record[];
+  records: Neo4jRecord[];
   summary: ResultSummary<Integer>;
 };
 

package/src/schemaPoller.ts

@@ -1,15 +1,16 @@
 import { EventEmitter } from 'events';
-import neo4j, { Config, Driver } from 'neo4j-driver';
+import type { Config, Driver } from 'neo4j-driver';
+import neo4j from 'neo4j-driver';
+import type { ConnectionError } from './connectionErrorHandler.js';
 import {
-  ConnectionError,
   FRIENDLY_ERROR_MESSAGES,
   getConnectionError,
   isRetriableNeo4jError,
 } from './connectionErrorHandler.js';
+import type { MetadataPoller } from './metadataPoller.js';
 import {
   ConnectedMetadataPoller,
   DisconnectedMetadataPoller,
-  MetadataPoller,
 } from './metadataPoller.js';
 import { Neo4jConnection } from './neo4jConnection.js';
 import { listDatabases } from './queries/databases.js';

package/src/{integration-tests → tests/integration}/pollingIntegrationTests.test.ts

@@ -1,11 +1,12 @@
-import { auth, Driver, driver, Session } from 'neo4j-driver';
+import type { Driver, Session } from 'neo4j-driver';
+import { auth, driver } from 'neo4j-driver';
 import { createAndStartTestContainer } from './setupTestContainer.js';
-import { StartedNeo4jContainer } from '@testcontainers/neo4j';
+import type { StartedNeo4jContainer } from '@testcontainers/neo4j';
+import type { GraphSchema } from '../../queries/graphSchema.js';
 import {
   extractRelationshipsWithNamedNodes,
-  GraphSchema,
   validateGraphSchema,
-} from '../queries/graphSchema.js';
+} from '../../queries/graphSchema.js';
 
 describe('Polling integration', () => {
   let session: Session;
@@ -32,14 +33,14 @@ describe('Polling integration', () => {
   test('Polling graph schema query gives results in correct shape', async () => {
     const query = 'CALL db.schema.visualization() YIELD *';
     const result = await session.run(query);
-    validateGraphSchema(result.records[0].toObject());
+    validateGraphSchema(result.records[0]!.toObject());
     expect(validateGraphSchema.errors).toBe(null);
   });
 
   test('Polled graph schema is correctly retrieved from polling query result', async () => {
     const query = 'CALL db.schema.visualization() YIELD *';
     const result = await session.run(query);
-    const actualResult = [result.records[0].toObject()] as GraphSchema[];
+    const actualResult = [result.records[0]!.toObject()] as GraphSchema[];
     validateGraphSchema(actualResult[0]);
     const graphSchema = extractRelationshipsWithNamedNodes(actualResult);
     expect(graphSchema).toContainEqual({

package/src/{integration-tests → tests/integration}/setupTestContainer.ts

@@ -1,4 +1,5 @@
-import { Neo4jContainer, StartedNeo4jContainer } from '@testcontainers/neo4j';
+import type { StartedNeo4jContainer } from '@testcontainers/neo4j';
+import { Neo4jContainer } from '@testcontainers/neo4j';
 
 type ContainerOpts = {
   containerName: string;
@@ -13,7 +14,7 @@ export async function createAndStartTestContainer(
   },
 ): Promise<StartedNeo4jContainer> {
   const password = 'password';
-  const env = { ...(opts.env ?? {}), NEO4J_ACCEPT_LICENSE_AGREEMENT: 'yes' };
+  const env = { ...opts.env, NEO4J_ACCEPT_LICENSE_AGREEMENT: 'yes' };
 
   const container = await new Neo4jContainer(opts.neo4jVersion)
     .withExposedPorts(7474, 7687)

package/src/types/cypher-data-types.ts

@@ -23,7 +23,7 @@ import {
   isTime,
   isVector,
 } from 'neo4j-driver';
-type NumberOrInteger = number | Integer | bigint;
+export type NumberOrInteger = number | Integer | bigint;
 
 /**
       The neo4j driver type mapping - https://neo4j.com/docs/javascript-manual/current/cypher-workflow/#js-driver-type-mapping

package/src/types/sdkTypes.ts

@@ -18,10 +18,10 @@ export type QueryType =
   // Query that has been derived from the user input.
   | 'user-transpiled';
 
-type ExtendedQueryConfig<T> = QueryConfig<T> &
+export type ExtendedQueryConfig<T> = QueryConfig<T> &
   Required<Pick<QueryConfig<T>, 'routing' | 'resultTransformer'>>;
 
-type Result<T> = T & { summary: ResultSummary };
+export type Result<T> = T & { summary: ResultSummary };
 
 export type ExecuteQueryArgs<T> = {
   query: string;

package/tsconfig.json

@@ -2,10 +2,10 @@
   "extends": "../../tsconfig.base.json",
   "include": ["src", "package.json", "vitest.config.mts"],
   "compilerOptions": {
-    "strict": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
     "resolveJsonModule": true,
-    "types": ["vitest/globals"]
+    "types": ["vitest/globals", "node"],
+    "strictNullChecks": true // TODO: Move to tsconfig.base.json
   }
 }