Remove unused exports and dependencies

packages/graphql/knip.json

@@ -0,0 +1,18 @@
+{
+    "$schema": "https://unpkg.com/knip@5/schema.json",
+    "ignoreExportsUsedInFile": {
+        "interface": false,
+        "type": false
+    },
+    "tags": ["-lintignore"],
+    "ignoreFiles": [
+        "tests/performance/**",
+        "tests/utils/**",
+        "tests/integration/teardown.ts",
+        "tests/e2e/**",
+        "jest-*-setup.js"
+    ],
+    "ignoreBinaries": [],
+    "ignoreDependencies": ["jest", "rimraf", "ts-node"],
+    "treatConfigHintsAsErrors": true
+}

packages/graphql/package.json

@@ -41,13 +41,13 @@
         "test:schema": "jest tests/schema -c jest.minimal.config.js",
         "test:tck": "jest tests/tck -c jest.minimal.config.js",
         "test:unit": "jest src --coverage=true -c jest.minimal.config.js",
-        "test": "jest"
+        "test": "jest",
+        "knip": "knip"
     },
     "author": "Neo4j Inc.",
     "devDependencies": {
         "@apollo/gateway": "2.12.1",
         "@apollo/server": "5.2.0",
-        "@types/deep-equal": "1.0.4",
         "@types/is-uuid": "1.0.2",
         "@types/jest": "30.0.0",
         "@types/jsonwebtoken": "9.0.10",
@@ -65,11 +65,11 @@
         "jest-extended": "7.0.0",
         "jsonwebtoken": "9.0.2",
         "jwks-rsa": "3.2.0",
+        "knip": "5.70.2",
         "koa": "3.1.1",
         "koa-jwt": "4.0.4",
         "koa-router": "14.0.0",
         "mock-jwks": "3.3.5",
-        "nock": "14.0.10",
         "randomstring": "1.3.1",
         "rimraf": "6.1.2",
         "supertest": "7.1.4",

packages/graphql/src/classes/subscription/cdc/cdc-types.ts

@@ -19,6 +19,22 @@
 
 import type { DateTime } from "neo4j-driver";
 
+export type CDCNodeEvent = {
+    elementId: string;
+    eventType: "n";
+    state: {
+        before?: CDCEventState;
+        after?: CDCEventState;
+    };
+    operation: CDCOperation;
+    labels: string[];
+};
+export type CDCQueryResponse = {
+    id: string;
+    event: CDCEvent;
+    metadata: CDCMetadata;
+};
+
 type CDCEventState = {
     properties: Record<string, unknown>;
     labels: string[];
@@ -34,7 +50,7 @@ type CDCRelationshipNode = {
 
 type CDCOperation = "c" | "d" | "u";
 
-export type CDCRelationshipEvent = {
+type CDCRelationshipEvent = {
     elementId: string;
     eventType: "r";
     start: CDCRelationshipNode;
@@ -47,26 +63,9 @@ export type CDCRelationshipEvent = {
     type: string;
 };
 
-export type CDCNodeEvent = {
-    elementId: string;
-    eventType: "n";
-    state: {
-        before?: CDCEventState;
-        after?: CDCEventState;
-    };
-    operation: CDCOperation;
-    labels: string[];
-};
-
-export type CDCMetadata = {
+type CDCMetadata = {
     txStartTime: DateTime;
     // Other metadata is ignored here
 };
 
-export type CDCEvent = CDCNodeEvent | CDCRelationshipEvent;
-
-export type CDCQueryResponse = {
-    id: string;
-    event: CDCEvent;
-    metadata: CDCMetadata;
-};
+type CDCEvent = CDCNodeEvent | CDCRelationshipEvent;

packages/graphql/src/classes/utils/asserts-indexes-and-constraints.ts

@@ -26,10 +26,6 @@ import type { Neo4jGraphQLSessionConfig } from "../Executor";
 
 const debug = Debug(DEBUG_EXECUTE);
 
-export interface AssertIndexesAndConstraintsOptions {
-    create?: boolean;
-}
-
 export async function assertIndexesAndConstraints({
     driver,
     sessionConfig,

packages/graphql/src/constants.ts

@@ -29,7 +29,6 @@ export const AUTHORIZATION_UNAUTHENTICATED = "Unauthenticated";
 export const DEBUG_ALL = `${DEBUG_PREFIX}:*`;
 export const DEBUG_AUTH = `${DEBUG_PREFIX}:auth`;
 export const DEBUG_EXECUTE = `${DEBUG_PREFIX}:execution`;
-export const DEBUG_GENERATE = `${DEBUG_PREFIX}:generate`;
 export const DEBUG_GRAPHQL = `${DEBUG_PREFIX}:graphql`;
 export const DEBUG_TRANSLATE = `${DEBUG_PREFIX}:translate`;
 
@@ -87,9 +86,6 @@ export enum RelationshipNestedOperationsOption {
     DISCONNECT = "DISCONNECT",
 }
 
-export const META_CYPHER_VARIABLE = "meta";
-export const META_OLD_PROPS_CYPHER_VARIABLE = "oldProps";
-
 export const DBMS_COMPONENTS_QUERY =
     "CALL dbms.components() YIELD versions, edition UNWIND versions AS version RETURN version, edition";
 

packages/graphql/src/graphql/directives/declare-relationship.ts

@@ -21,7 +21,7 @@ import { DirectiveLocation, GraphQLBoolean, GraphQLDirective, GraphQLList, Graph
 import { RelationshipNestedOperationsOption } from "../../constants";
 import { RelationshipNestedOperationsEnum } from "./arguments/enums/RelationshipNestedOperations";
 
-export const defaultNestedOperations = [
+const defaultNestedOperations = [
     RelationshipNestedOperationsOption.CREATE,
     RelationshipNestedOperationsOption.UPDATE,
     RelationshipNestedOperationsOption.DELETE,

packages/graphql/src/graphql/directives/relationship.ts

@@ -30,7 +30,7 @@ import { RelationshipDirectionEnum } from "./arguments/enums/RelationshipDirecti
 import { RelationshipNestedOperationsEnum } from "./arguments/enums/RelationshipNestedOperations";
 import { RelationshipQueryDirectionEnum } from "./arguments/enums/RelationshipQueryDirection";
 
-export const defaultNestedOperations = [
+const defaultNestedOperations = [
     RelationshipNestedOperationsOption.CREATE,
     RelationshipNestedOperationsOption.UPDATE,
     RelationshipNestedOperationsOption.DELETE,

packages/graphql/src/graphql/directives/vector.ts

@@ -27,7 +27,7 @@ import {
     GraphQLString,
 } from "graphql";
 
-export const vectorProviderNames = {
+const vectorProviderNames = {
     VERTEX_AI: "VertexAI",
     OPEN_AI: "OpenAI",
     AZURE_OPEN_AI: "AzureOpenAI",

packages/graphql/src/graphql/scalars/Duration.ts

@@ -36,14 +36,14 @@ const DURATION_REGEX_NO_DELIMITERS =
 
 // Normalized components per https://neo4j.com/docs/cypher-manual/current/syntax/operators/#cypher-ordering
 export const MONTHS_PER_YEAR = 12;
-export const DAYS_PER_YEAR = 365.2425;
-export const DAYS_PER_MONTH = DAYS_PER_YEAR / MONTHS_PER_YEAR;
+const DAYS_PER_YEAR = 365.2425;
+const DAYS_PER_MONTH = DAYS_PER_YEAR / MONTHS_PER_YEAR;
 export const DAYS_PER_WEEK = 7;
-export const HOURS_PER_DAY = 24;
-export const MINUTES_PER_HOUR = 60;
+const HOURS_PER_DAY = 24;
+const MINUTES_PER_HOUR = 60;
 export const SECONDS_PER_MINUTE = 60;
 export const SECONDS_PER_HOUR = SECONDS_PER_MINUTE * MINUTES_PER_HOUR;
-export const NANOSECONDS_PER_SECOND = 1000000000;
+const NANOSECONDS_PER_SECOND = 1000000000;
 
 export const parseDuration = (
     value: string

packages/graphql/src/graphql/scalars/LocalTime.ts

@@ -21,7 +21,7 @@ import type { ValueNode } from "graphql";
 import { GraphQLError, GraphQLScalarType, Kind } from "graphql";
 import neo4j, { isLocalTime } from "neo4j-driver";
 
-export const LOCAL_TIME_REGEX =
+const LOCAL_TIME_REGEX =
     /^(?<hour>[01]\d|2[0-3]):(?<minute>[0-5]\d):(?<second>[0-5]\d)(\.(?<fraction>\d{1}(?:\d{0,8})))?$/;
 
 type LocalTimeMatchGroups = {

packages/graphql/src/graphql/scalars/Time.ts

@@ -21,7 +21,7 @@ import type { ValueNode } from "graphql";
 import { GraphQLError, GraphQLScalarType, Kind } from "graphql";
 import neo4j from "neo4j-driver";
 
-export const TIME_REGEX =
+const TIME_REGEX =
     /^(?<hour>[01]\d|2[0-3]):(?<minute>[0-5]\d)(:(?<second>[0-5]\d)(\.(?<fraction>\d{1}(?:\d{0,8})))?((?:[Zz])|((?<offsetDirection>[-|+])(?<offsetHour>[01]\d|2[0-3]):(?<offsetMinute>[0-5]\d)))?)?$/;
 
 export const validateTime = (value: unknown): string => {

packages/graphql/src/schema-model/annotation/Annotation.ts

@@ -105,7 +105,7 @@ export type Annotations = CheckAnnotationName<{
     timestamp: TimestampAnnotation;
 }>;
 
-export type AnnotationParser<T extends Annotation> = (
+type AnnotationParser<T extends Annotation> = (
     firstDirective: DirectiveNode,
     directives: readonly DirectiveNode[]
 ) => T;

packages/graphql/src/schema-model/entity/model-adapters/ImplementingEntityOperations.ts

@@ -50,7 +50,7 @@ type SubscriptionEvents = {
     delete_relationship: string;
 };
 
-export type UpdateMutationArgumentNames = {
+type UpdateMutationArgumentNames = {
     connect: string;
     disconnect: string;
     create: string;
@@ -59,7 +59,7 @@ export type UpdateMutationArgumentNames = {
     where: string;
 };
 
-export type CreateMutationArgumentNames = {
+type CreateMutationArgumentNames = {
     input: string;
 };
 

packages/graphql/src/schema-model/library-directives.ts

@@ -39,7 +39,7 @@ export const LIBRARY_DIRECTIVES = [
     ...additionalDirectives,
 ] as const satisfies readonly LibraryDirectives[];
 
-export const SCHEMA_CONFIGURATION_FIELD_DIRECTIVES = [
+const SCHEMA_CONFIGURATION_FIELD_DIRECTIVES = [
     "filterable",
     "selectable",
     "settable",
@@ -72,6 +72,7 @@ export const SCHEMA_CONFIGURATION_OBJECT_DIRECTIVES = [
     "subscription",
 ] as const satisfies readonly LibraryDirectives[];
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 const OBJECT_DIRECTIVES = [
     "authentication",
     "authorization",
@@ -88,8 +89,10 @@ const OBJECT_DIRECTIVES = [
 ] as const satisfies readonly LibraryDirectives[];
 export type ObjectDirective = ValueOf<typeof OBJECT_DIRECTIVES>;
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 const INTERFACE_DIRECTIVES = ["query", "plural", "limit"] as const satisfies readonly LibraryDirectives[];
 export type InterfaceDirective = ValueOf<typeof INTERFACE_DIRECTIVES>;
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 const UNION_DIRECTIVES = ["query", "plural"] as const satisfies readonly LibraryDirectives[];
 export type UnionDirective = ValueOf<typeof UNION_DIRECTIVES>;

packages/graphql/src/schema-model/parser/parse-attribute.ts

@@ -17,6 +17,7 @@
  * limitations under the License.
  */
 
+import type { IResolvers } from "@graphql-tools/utils";
 import type { FieldDefinitionNode, InputValueDefinitionNode, TypeNode } from "graphql";
 import { Kind } from "graphql";
 import { aliasDirective } from "../../graphql/directives";
@@ -44,7 +45,6 @@ import type { DefinitionCollection } from "./definition-collection";
 import { parseAnnotations } from "./parse-annotation";
 import { parseArguments } from "./parse-arguments";
 import { findDirective } from "./utils";
-import type { IResolvers } from "@graphql-tools/utils";
 
 export function parseAttributeArguments(
     fieldArgs: readonly InputValueDefinitionNode[],
@@ -144,15 +144,15 @@ function isUnion(definitionCollection: DefinitionCollection, name: string): bool
     return definitionCollection.unionTypes.has(name);
 }
 
-export function isEnum(definitionCollection: DefinitionCollection, name: string): boolean {
+function isEnum(definitionCollection: DefinitionCollection, name: string): boolean {
     return definitionCollection.enumTypes.has(name);
 }
 
-export function isUserScalar(definitionCollection: DefinitionCollection, name: string) {
+function isUserScalar(definitionCollection: DefinitionCollection, name: string) {
     return definitionCollection.scalarTypes.has(name);
 }
 
-export function isObject(definitionCollection: DefinitionCollection, name: string) {
+function isObject(definitionCollection: DefinitionCollection, name: string) {
     return definitionCollection.objectTypes.has(name);
 }
 
@@ -168,11 +168,11 @@ function isCartesianPoint(value: string): boolean {
     return isNeo4jGraphQLSpatialType(value) && value === Neo4jGraphQLSpatialType.CartesianPoint;
 }
 
-export function isNeo4jGraphQLSpatialType(value: string): value is Neo4jGraphQLSpatialType {
+function isNeo4jGraphQLSpatialType(value: string): value is Neo4jGraphQLSpatialType {
     return Object.values<string>(Neo4jGraphQLSpatialType).includes(value);
 }
 
-export function isScalarType(value: string): value is GraphQLBuiltInScalarType | Neo4jGraphQLScalarType {
+function isScalarType(value: string): value is GraphQLBuiltInScalarType | Neo4jGraphQLScalarType {
     return isGraphQLBuiltInScalar(value) || isNeo4jGraphQLNumberType(value) || isNeo4jGraphQLTemporalType(value);
 }
 

packages/graphql/src/schema/constants.ts

@@ -18,10 +18,6 @@
  */
 
 import { DEPRECATED } from "../constants";
-import type { ConcreteEntityAdapter } from "../schema-model/entity/model-adapters/ConcreteEntityAdapter";
-import type { InterfaceEntityAdapter } from "../schema-model/entity/model-adapters/InterfaceEntityAdapter";
-import type { RelationshipAdapter } from "../schema-model/relationship/model-adapters/RelationshipAdapter";
-import type { RelationshipDeclarationAdapter } from "../schema-model/relationship/model-adapters/RelationshipDeclarationAdapter";
 
 // TODO: Add constant deprecations here
 
@@ -65,33 +61,3 @@ export function DEPRECATE_AGGREGATION_FILTERS(name: string, aggregationOperation
         },
     };
 }
-
-export function DEPRECATE_AGGREGATION(entity: ConcreteEntityAdapter | InterfaceEntityAdapter) {
-    return {
-        name: DEPRECATED,
-        args: {
-            reason: `Please use the explicit field "aggregate" inside "${entity.operations.rootTypeFieldNames.connection}" instead`,
-        },
-    };
-}
-
-export function DEPRECATE_NESTED_AGGREGATION(relationship: RelationshipAdapter | RelationshipDeclarationAdapter) {
-    return {
-        name: DEPRECATED,
-        args: {
-            reason: `Please use field "aggregate" inside "${relationship.operations.connectionFieldName}" instead`,
-        },
-    };
-}
-
-export function DEPRECATE_UPDATE_WHERE(
-    relationship: RelationshipAdapter | RelationshipDeclarationAdapter,
-    ifUnionMemberEntity?: ConcreteEntityAdapter
-) {
-    return {
-        name: DEPRECATED,
-        args: {
-            reason: `Please use field "where" inside "${relationship.operations.getUpdateConnectionInputTypename(ifUnionMemberEntity)}" instead`,
-        },
-    };
-}

packages/graphql/src/schema/generation/connect-input.ts

@@ -33,7 +33,7 @@ import type { RelationshipDeclarationAdapter } from "../../schema-model/relation
 import { relationshipTargetHasRelationshipWithNestedOperation } from "./utils";
 import { withConnectWhereFieldInputType } from "./where-input";
 
-export function withConnectInputType({
+function withConnectInputType({
     entityAdapter,
     composer,
 }: {

packages/graphql/src/schema/generation/delete-input.ts

@@ -34,7 +34,7 @@ import type { Neo4jFeaturesSettings } from "../../types";
 import { withConnectionWhereInputType } from "./connection-where-input";
 import { relationshipTargetHasRelationshipWithNestedOperation } from "./utils";
 
-export function withDeleteInputType({
+function withDeleteInputType({
     entityAdapter,
     composer,
 }: {
@@ -125,7 +125,7 @@ function makeDeleteInputTypeRelationshipField({
     };
 }
 
-export function withUnionDeleteInputType({
+function withUnionDeleteInputType({
     relationshipAdapter,
     composer,
     deprecatedDirectives,

packages/graphql/src/schema/generation/disconnect-input.ts

@@ -34,7 +34,7 @@ import type { Neo4jFeaturesSettings } from "../../types";
 import { withConnectionWhereInputType } from "./connection-where-input";
 import { relationshipTargetHasRelationshipWithNestedOperation } from "./utils";
 
-export function withDisconnectInputType({
+function withDisconnectInputType({
     entityAdapter,
     composer,
 }: {