diff --git a/modules/ROOT/pages/authentication-and-authorization/index.adoc b/modules/ROOT/pages/authentication-and-authorization/index.adoc index c27729a0..ec871c89 100644 --- a/modules/ROOT/pages/authentication-and-authorization/index.adoc +++ b/modules/ROOT/pages/authentication-and-authorization/index.adoc @@ -3,7 +3,7 @@ :page-aliases: auth/index.adoc, auth/setup.adoc, auth/authentication.adoc, \ auth/authorization.adoc, auth/auth-directive.adoc, auth/subscriptions.adoc, \ auth/authorization/allow.adoc, auth/authorization/bind.adoc, auth/authorization/roles.adoc, \ -auth/authorization/where.adoc, guides/v4-migration/authorization.adoc +auth/authorization/where.adoc [WARNING] ==== diff --git a/modules/ROOT/pages/getting-started/index.adoc b/modules/ROOT/pages/getting-started/index.adoc index 9af02117..b55a1fe1 100644 --- a/modules/ROOT/pages/getting-started/index.adoc +++ b/modules/ROOT/pages/getting-started/index.adoc @@ -1,5 +1,6 @@ [[getting-started]] = Getting started +:page-aliases: getting-started.adoc :description: This section describes how to get started with the Neo4j GraphQL Library. diff --git a/modules/ROOT/pages/migration/index.adoc b/modules/ROOT/pages/migration/index.adoc index a1ce65e4..0c2da31e 100644 --- a/modules/ROOT/pages/migration/index.adoc +++ b/modules/ROOT/pages/migration/index.adoc @@ -1,7 +1,8 @@ [[migration-guide]] :description: This page lists the breaking changes from version 3.0.0 to 4.0.0 and describes how to update. = Migration to 4.0.0 -:page-aliases: guides/index.adoc, guides/migration-guide/index.adoc, guides/migration-guide/server.adoc, guides/migration-guide/type-definitions.adoc, guides/migration-guide/mutations.adoc +:page-aliases: guides/index.adoc, guides/migration-guide/index.adoc, guides/migration-guide/server.adoc, \ +guides/migration-guide/queries.adoc, guides/migration-guide/type-definitions.adoc, guides/migration-guide/mutations.adoc This page lists all breaking changes from the Neo4j GraphQL Library version 3.x to 4.x and how to update it. diff --git a/modules/ROOT/pages/ogm/installation.adoc b/modules/ROOT/pages/ogm/installation.adoc index c4cd6989..557e28e2 100644 --- a/modules/ROOT/pages/ogm/installation.adoc +++ b/modules/ROOT/pages/ogm/installation.adoc @@ -1,6 +1,7 @@ [[ogm-installation]] :description: This page describes how to install the OGM in Neo4j GraphQL and includes examples of how to use it. = Installation +:page-aliases: ogm/examples/index.adoc The OGM can be installed into a new or existing Node.js project in a similar way to the installation of the Neo4j GraphQL Library. As such, it requires some dependencies to be included: diff --git a/modules/ROOT/pages/queries-aggregations/queries.adoc b/modules/ROOT/pages/queries-aggregations/queries.adoc index 35fc6ccd..360feede 100644 --- a/modules/ROOT/pages/queries-aggregations/queries.adoc +++ b/modules/ROOT/pages/queries-aggregations/queries.adoc @@ -1,6 +1,5 @@ [[queries]] = Queries -:page-aliases: guides/migration-guide/queries.adoc :description: This page describes how to read or fetch values in the Neo4j GraphQL Library. diff --git a/modules/ROOT/pages/reference/api-reference/index.adoc b/modules/ROOT/pages/reference/api-reference/index.adoc deleted file mode 100644 index 67c79342..00000000 --- a/modules/ROOT/pages/reference/api-reference/index.adoc +++ /dev/null @@ -1,6 +0,0 @@ -[[api-reference]] -= API Reference -:page-aliases: api-reference/index.adoc - -- xref::reference/api-reference/neo4jgraphql.adoc[`Neo4jGraphQL`] -- xref::reference/api-reference/ogm.adoc[`@neo4j/graphql-ogm`] \ No newline at end of file diff --git a/modules/ROOT/pages/reference/api-reference/neo4jgraphql.adoc b/modules/ROOT/pages/reference/api-reference/neo4jgraphql.adoc deleted file mode 100644 index ac5692ab..00000000 --- a/modules/ROOT/pages/reference/api-reference/neo4jgraphql.adoc +++ /dev/null @@ -1,274 +0,0 @@ -[[api-reference-neo4jgraphql]] -= `Neo4jGraphQL` -:page-aliases: api-reference/neo4jgraphql.adoc - -== `constructor` - -Returns a `Neo4jGraphQL` instance. - -Takes an `input` object as a parameter, the supported fields of which are described below. - -=== Example - -[source, javascript, indent=0] ----- -const neoSchema = new Neo4jGraphQL({ - typeDefs, -}); ----- - -[[api-reference-neo4jgraphql-input]] -=== Input - -Accepts all of the options from https://www.graphql-tools.com/docs/generate-schema#makeexecutableschemaoptions[`makeExecutableSchema`], plus the additional arguments below: - -|=== -|Name and Type |Description - -|`driver` + - + - Type: https://neo4j.com/docs/javascript-manual/current/[`Driver`] -|An instance of a Neo4j driver. - -|`features` + - + - Type: xref::reference/api-reference/neo4jgraphql.adoc#api-reference-neo4jgraphql-input-neo4jfeaturessettings[`Neo4jFeaturesSettings`] -|Could be used for configure/enable/disable specific features. -|=== - -[[api-reference-neo4jgraphql-input-neo4jfeaturessettings]] -==== `Neo4jFeaturesSettings` - -|=== -|Name and Type |Description - -|`filters` + - + - Type: xref::reference/api-reference/neo4jgraphql.adoc#api-reference-neo4jgraphql-input-neo4jfilterssettings[`Neo4jFiltersSettings`] -|Additional configuration for filters. -|=== - -[[api-reference-neo4jgraphql-input-neo4jfilterssettings]] -==== `Neo4jFiltersSettings` - -|=== -|Name and Type |Description - -|`String` + - + - Type: xref::reference/api-reference/neo4jgraphql.adoc#api-reference-neo4jgraphql-input-neo4jstringfilterssettings[`Neo4jStringFiltersSettings`] -|Additional configuration for String filters. -|`ID` + - + - Type: xref::reference/api-reference/neo4jgraphql.adoc#api-reference-neo4jgraphql-input-neo4jidfilterssettings[`Neo4jIDFiltersSettings`] -|Additional configuration for String filters. -|=== - -[[api-reference-neo4jgraphql-input-neo4jstringfilterssettings]] -==== `Neo4jStringFiltersSettings` - -|=== -|Name and Type |Description - -|`GT` + - + - Type: `boolean` -| Enables GT comparator. - -|`GTE` + - + - Type: `boolean` -| Enables GTE comparator. - -|`LT` + - + - Type: `boolean` -| Enables LT comparator. - -|`LTE` + - + - Type: `boolean` -| Enables LTE comparator. - -|`MATCHES` + - + - Type: `boolean` -| Enables MATCHES comparator. - -|=== - -[[api-reference-neo4jgraphql-input-neo4jidfilterssettings]] -==== `Neo4jIDFiltersSettings` - -|=== -|Name and Type |Description - -|`MATCHES` + - + - Type: `boolean` -| Enables MATCHES comparator. - -|=== - -[[api-reference-neo4jgraphql-input-neo4jgraphqlplugins]] -==== `Neo4jGraphQLPlugins` - -|=== -|Name and Type |Description - -|`auth` + - + - Type: `Neo4jGraphQLAuthPlugin` -|Plugin slot for auth capabilities. -|=== - -[[api-reference-getschema]] -== `getSchema` - -An asynchronous method that generates the GraphQL schema to be used in a server. The result is memoized, so if this is called twice, the schema is only generated once. - -[[api-reference-checkneo4jcompat]] -== `checkNeo4jCompat` - -Asynchronous method to check the compatibility of the specified DBMS, that either resolves to `void` in a successful scenario, or throws an error if the database is not compatible with the Neo4j GraphQL Library. - -Takes an `input` object as a parameter, the supported fields of which are described below. - -=== Example - -Given any valid type definitions saved to the variable `typeDefs` and a valid driver instance saved to the variable `driver`, the following will confirm database compatibility: - -[source, javascript, indent=0] ----- -const neoSchema = new Neo4jGraphQL({ typeDefs, driver }); -await neoSchema.checkNeo4jCompat(); ----- - -[[api-reference-checkneo4jcompat-input]] -=== Input - -Accepts the arguments below: - -|=== -|Name and Type |Description - -|`driver` + - + - Type: https://neo4j.com/docs/javascript-manual/current/[`Driver`] -|An instance of a Neo4j driver. - -|`driverConfig` + - + - Type: xref::reference/api-reference/neo4jgraphql.adoc#api-reference-checkneo4jcompat-input-driverconfig[`DriverConfig`] -|Additional driver configuration options. -|=== - -[[api-reference-checkneo4jcompat-input-driverconfig]] -==== `DriverConfig` - -|=== -|Name and Type |Description - -|`database` + - + - Type: `string` -|The name of the database within the DBMS to connect to. - -|`bookmarks` + - + - Type: `string` or `Array` -|One or more bookmarks to use for the connection. -|=== - -[[api-reference-assertconstraints]] -== `assertIndexesAndConstraints` - -Asynchronous method to assert the existence of database constraints, that either resolves to `void` in a successful scenario, or throws an error if the necessary constraints do not exist following its execution. - -Takes an `input` object as a parameter, the supported fields of which are described below. - -=== Example - -Given the following type definitions saved to the variable `typeDefs` and a valid driver instance saved to the variable `driver`: - -[source, graphql, indent=0] ----- -type Book { - isbn: String! @unique -} ----- - -And the construction of a `Neo4jGraphQL`, using: - -[source, javascript, indent=0] ----- -const neoSchema = new Neo4jGraphQL({ typeDefs, driver }); -const schema = await neoSchema.getSchema(); ----- - -The following will check whether a unique node property constraint exists for label "Book" and property "isbn", and throw an error if it does not: - -[source, javascript, indent=0] ----- -await neoSchema.assertIndexesAndConstraints(); ----- - -The next example will create the constraint if it does not exist: - -[source, javascript, indent=0] ----- -await neoSchema.assertIndexesAndConstraints({ options: { create: true } }); ----- - -[[api-reference-assertconstraints-input]] -=== Input - -Accepts the arguments below: - -|=== -|Name and Type |Description - -|`driver` + - + - Type: https://neo4j.com/docs/javascript-manual/current/[`Driver`] -|An instance of a Neo4j driver. - -|`driverConfig` + - + - Type: xref::reference/api-reference/neo4jgraphql.adoc#api-reference-assertconstraints-input-driverconfig[`DriverConfig`] -|Additional driver configuration options. - -|`options` + - + - Type: xref::reference/api-reference/neo4jgraphql.adoc#api-reference-assertconstraints-input-assertconstraintsoptions[`AssertConstraintsOptions`] -|Options for the execution of `assertIndexesAndConstraints`. -|=== - -[[api-reference-assertconstraints-input-driverconfig]] -==== `DriverConfig` - -|=== -|Name and Type |Description - -|`database` + - + - Type: `string` -|The name of the database within the DBMS to connect to. - -|`bookmarks` + - + - Type: `string` or `Array` -|One or more bookmarks to use for the connection. -|=== - -[[api-reference-assertconstraints-input-assertconstraintsoptions]] -==== `AssertConstraintsOptions` - -|=== -|Name and Type |Description - -|`create` + - + - Type: `boolean` -|Whether or not to create constraints if they do not yet exist. Disabled by default. -|=== \ No newline at end of file diff --git a/modules/ROOT/pages/reference/api-reference/ogm.adoc b/modules/ROOT/pages/reference/api-reference/ogm.adoc deleted file mode 100644 index aa63cec2..00000000 --- a/modules/ROOT/pages/reference/api-reference/ogm.adoc +++ /dev/null @@ -1,5 +0,0 @@ -[[api-reference-ogm]] -= `@neo4j/graphql-ogm` -:page-aliases: api-reference/ogm.adoc - -See xref::ogm/reference.adoc[`OGM`]. \ No newline at end of file diff --git a/modules/ROOT/pages/troubleshooting.adoc b/modules/ROOT/pages/troubleshooting.adoc index 4846fa62..f62b318a 100644 --- a/modules/ROOT/pages/troubleshooting.adoc +++ b/modules/ROOT/pages/troubleshooting.adoc @@ -1,6 +1,7 @@ [[troubleshooting]] = Troubleshooting -:page-aliases: troubleshooting/faqs.adoc, troubleshooting/security.adoc, troubleshooting/optimizing-create-operations.adoc, appendix/preventing-overfetching.adoc, appendix.adoc +:page-aliases: troubleshooting/index.adoc, troubleshooting/faqs.adoc, troubleshooting/security.adoc, \ +troubleshooting/optimizing-create-operations.adoc, appendix/preventing-overfetching.adoc, appendix.adoc This chapter contains common troubleshooting steps. Additionally, there is a section for xref::troubleshooting.adoc#troubleshooting-faqs[FAQs] (Frequently Asked Questions) where you might find answers to your problems. diff --git a/modules/ROOT/pages/type-definitions/directives/cypher.adoc b/modules/ROOT/pages/type-definitions/directives/cypher.adoc index 67cafe7a..3001d36e 100644 --- a/modules/ROOT/pages/type-definitions/directives/cypher.adoc +++ b/modules/ROOT/pages/type-definitions/directives/cypher.adoc @@ -1,6 +1,7 @@ [[type-definitions-cypher]] :description: This page describes how to use the @cypher directive in the Neo4j GraphQL Library. -= `@cypher` += `@cypher` +:page-aliases: type-definitions/cypher.adoc The `@cypher` directive binds a GraphQL field to the results of a Cypher query. This directive can be used both for properties in a type or as top level queries. diff --git a/modules/ROOT/pages/type-definitions/directives/index.adoc b/modules/ROOT/pages/type-definitions/directives/index.adoc index 430ad795..6f935033 100644 --- a/modules/ROOT/pages/type-definitions/directives/index.adoc +++ b/modules/ROOT/pages/type-definitions/directives/index.adoc @@ -1,6 +1,7 @@ [[directives]] :description: This page lists all directives available in the Neo4j GraphQL Library. = Directives +:page-aliases: directives.adoc The Neo4j GraphQL Library provides the following directives to be used whilst defining types: diff --git a/modules/ROOT/pages/type-definitions/types/index.adoc b/modules/ROOT/pages/type-definitions/types/index.adoc index b674d16f..2f56499a 100644 --- a/modules/ROOT/pages/type-definitions/types/index.adoc +++ b/modules/ROOT/pages/type-definitions/types/index.adoc @@ -1,6 +1,7 @@ [[types]] :description: This page lists all types available in the Neo4j GraphQL Library. = Types +:page-aliases: type-definitions/types.adoc The Neo4j GraphQL Library provides the following types: