Skip to content

Conversation

@darrellwarde
Copy link
Contributor

@darrellwarde darrellwarde commented Aug 8, 2023

Description

cypherParams was missed in the Neo4jGraphQLContext type. This allows users to pass in parameters which will go directly through to the Cypher query.

Previously, these had to be referred to under the $cypherParams parameter, however, I feel that our risk of conflicts is much lower now, so I've made it so that the parameters can be referred to directly instead.

Complexity

Complexity: Low

@changeset-bot
Copy link

changeset-bot bot commented Aug 8, 2023

🦋 Changeset detected

Latest commit: b5b5d73

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages
Name Type
@neo4j/graphql Patch
@neo4j/graphql-toolbox Patch
@neo4j/graphql-ogm Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@darrellwarde darrellwarde requested a review from angrykoala August 8, 2023 15:38
@neo4j-team-graphql
Copy link
Collaborator

neo4j-team-graphql commented Aug 8, 2023

Thanks for the Neo4j GraphQL Toolbox updates.

The Neo4j GraphQL Toolbox has now been torn down - reopening this PR will republish it.

@neo4j-team-graphql
Copy link
Collaborator

neo4j-team-graphql commented Aug 8, 2023

Performance Report

No Performance Changes

Show Full Table
name dbHits old dbHits time (ms) old time (ms) maxRows
aggregations.TopLevelAggregate 3403 3403 39 47 1134
aggregations.NestedAggregation 16553 16553 82 116 2174
aggregations.AggregationWithWhere 11979 11979 50 75 2174
aggregations.AggregationWhereWithinNestedRelationships 22116987 22116987 3394 3512 2008534
aggregations.AggregationWhereWithinNestedConnections 22116987 22116987 3007 3079 2008534
aggregations.NestedCountFromMovieToActors 9734 9734 46 75 2174
aggregations.NestedCountFromActorsToMovie 9937 9937 64 51 2174
aggregations.DeeplyNestedCount 13070331 13070329 5065 5394 2008534
batch-create.BatchCreate 4200 4200 270 210 600
batch-create.BatchCreateSmall 77 77 65 175 11
connect.createAndConnect 14424 14424 261 231 3003
connections.Connection 14082 14082 104 70 2174
connections.NestedConnection 45470 45466 132 166 4516
connections.ConnectionWithSort 3284 3284 76 92 1040
connections.ConnectionWithSortAndCypher 16325 16325 105 133 2174
create.SimpleMutation 7 7 64 109 1
cypher-directive.TopLevelMutationDirective 1135 1135 35 40 1134
delete.SimpleDelete 19401 19401 269 267 1040
delete.NestedDeleteInUpdate 19542 19542 247 219 1183
2925.SingleRelationshipFilter 6468 6468 71 78 1040
2925.NestedSingleRelationshipFilter 22900 22900 90 183 2174
2925.SingleRelationshipRequiredFilter 5201 5201 48 71 1040
2925.NestedSingleRelationshipRequiredFilter 9361 9361 86 88 1040
query.SimpleQuery 3121 3121 33 30 1040
query.SimpleQueryWithRelationship 16162 16162 53 58 2174
query.QueryWhere 9710 9705 41 48 2165
query.SimpleQueryWithNestedWhere 9888 9883 62 79 2165
query.Nested 10096041 10096041 10942 11454 2008534
query.NestedWithFilter 10074401 10074401 10746 11139 2004000
query.OrFilterOnRelationships 42833 41405 208 241 1790
query.OrFilterOnRelationshipsAndNested 36577 35323 288 365 1790
query.QueryWithNestedIn 13495 13539 67 73 1251
query.NestedConnectionWhere 9834 9834 69 97 2174
query.DeeplyNestedConnectionWhere 10039 9879 96 123 2174
query.DeeplyNestedWithRelationshipFilters 19248 19080 197 208 1630
query.NestedWithRelationshipSingleFilters 3881 3881 209 379 1134
query.Fulltext 80 80 38 64 16
query.FulltextWithNestedQuery 587 587 50 55 84
sorting.SortMultipleTypes 3515 3515 75 118 1040
sorting.SortMultipleTypesWithCypherWithCypher 14526 14541 101 174 2174
sorting.SortOnNestedFields 14082 14082 53 64 2174
sorting.SortDeeplyNestedFields 43198 43198 103 129 4516
sorting.SortWithTopLevelCypher 16162 16162 73 66 2174
unions.SimpleUnionQuery 321 321 66 77 35
unions.SimpleUnionQueryWithMissingFields 293 293 65 74 35
unions.NestedUnion 410637 410637 315 359 33033
unions.NestedUnionWithMissingFields 384611 384611 286 452 33033
update.NestedUpdate 16143 16143 98 122 2002

Old Schema Generation: 49.344s
Schema Generation: 48.128s
Old Subgraph Schema Generation: 1:01.985 (m:ss.mmm)
Subgraph Schema Generation: 59.405s

Copy link
Member

@angrykoala angrykoala left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, a couple of proposals that may improve slightly the code readability

@darrellwarde darrellwarde merged commit e9bf1e6 into neo4j:4.0.0 Aug 9, 2023
darrellwarde added a commit that referenced this pull request Sep 1, 2023
* Merging content for restructuring of docs (#3087)

* test

* update

* more rearranging and merging of content

* resolving conflict

* conflict solving

* new attempt to solve conflicts

* Update dependency webpack to v5.76.1

* Update dependency react-router-dom to v6.9.0

* Update dependency lint-staged to v13.2.0

* Update dependency ws to v8.13.0

* resolving conflicts

* new attempt to solve conflicts

* new attempt to solve conflicts

* fixing content nav with pages that were missing

* further adjustments after review

* merging mathematical operators into update

* Fix yarn.lock

* undoing the accidental deletion of the neo4jgraphql.adoc page

* reviewing indexing of links after restructuring of the manual

* fix yarn

* Fix lockfile

* Fix yarn.lock

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Darrell Warde <darrell.warde@gmail.com>

* Move subscriptions to features instead of plugins

* Tests on default subscriptions

* Update subscription docs with default example

* Add migration guide on subscriptions

* Update v4-migration.adoc

* Update class names for subscription plugins

* Update TestSubscriptionPlugin in tests

* Fix apollo e2e tests

* Apply suggestions from code review

Co-authored-by: Lidia Zuin <102308961+lidiazuin@users.noreply.github.com>

* Rename several references from plugins to mechanisms

* Update docs/modules/ROOT/pages/subscriptions/mechanisms.adoc

Co-authored-by: Lidia Zuin <102308961+lidiazuin@users.noreply.github.com>

* Fix escaping for relationships

* Fix cypher builder tests

* fix: use gql from graphql-tag in place of old apollo-server gql export

* Update import of gql

* rm unused import

* Remove tests against 4.3 database (#3346)

* Remove tests against 4.3 database

* Fix yarn.lock

* Fix broken Subscriptions test

* Fix property escaping in MERGE operation

* Update fluffy-suns-invite.md

* make temporary set-up to test validation rules

* field category aid

* add tests for existing graphql rule: KnownDirectiveArgument

* add support for fulltext directive in DirectiveArgumentOfCorrectType

* Remove the `@auth` directive (#3579)

* Remove `@auth` code and related tests

* Remove deprecated tests

* Remove `@auth` from final tests

* Tweaks to get tests passing

* Fix missing predicates in nested projection

* Update TCK tests following changes to authorization

* Remove commented block

* Remove redundant Subscriptions tests

* Fix unit tests

* Fix tests

* Add fulltext tests back in which were unrelated to auth

* Better Cypher Builder usage

* Fix broken tests on `4.0.0` (#3593)

* add tests and improve validation run temporary set-up

* pass extra definitions to validation

* extend DirectiveArgumentOfCorrectType to static directives - problematic

* adds rule to validate directive argument values. To be refactored

* Fix sort tck test

* Remove `Neo4jDatabaseInfo` from the public context (#3630)

* Remove Neo4j version check for point translation

* Remove Neo4j database info from public API

* Remove unneeded export, add changeset

* Fix import

* Remove req and request from our context type (#3629)

* Simpler configuration of Cypher query options (#3628)

* Perform major dependency upgrades breaking Node version (#3602)

* Perform major dependency upgrades breaking Node version

* Update OGM snapshots with new inputs and outputs

* Update cypher builder dependency to 1.0.0

* Address additional linting errors on `4.0.0` (#3654)

* Address additional linting errors on `4.0.0`

* Fix issue

* Authorization support for Apollo Federation (#3661)

* Add initial Federation authorization

* Add E2E tests

* Update Federation E2E tests to work without port

* Test type level authorization

* Add changeset

* Update TCK tests

* Skip Federation tests for GraphQL 15

* Remove auth plugin and all references (#3662)

* Remove auth plugin and all references

* Add missing dependency

* Remove auth from content nav

* Use modern driver API and bump version requirements (#3645)

* Bump driver

* In progress changes to driver usage

* Remove DriverWithSessionConfig

* Remove `getContextValuesWithBookmarks`

* Fix typo

* Fix tests

* Remove unused req from performance tests

* Remove unused variables

* Remove deprecated options

* Fix tests

* Mark bookmark fields as deprecated

* Add changeset

* Update OGM snapshots

* Un-deprecate `fulltext` argument, add descriptions for different functionality (#3669)

* Un-deprecate `fulltext` argument, add descriptions for different functionality

* Update snapshot

* Assessment and grouping of all library exports (#3670)

* Assessment and grouping of all library exports

* Add changeset

* Fix test import

* Fix doc blocks

* Simplify the programmatic toggle for debug logging (#3673)

* Simplify the programmatic toggle for debug logging

* Move Toolbox database selection

* Remove unused exports now defined in OGM (#3679)

* Remove `nodes` and `relationships` from the library's public API (#3671)

* Remove `nodes` and `relationships` from the library's public API

* Fix bad merge

* Cypher query options only settable in the context (#3674)

* Cypher query options only settable in the context

* Remove unused export

* Remove reference from troubleshooting guide

* `apoc.util.validate` to `apoc.util.validatePredicate` (#3672)

* Update math operators to use `apoc.util.validatePredicate`

* Relationship validation string using `apoc.util.validatePredicate`

* `createUpdateAndParams` array functions using `apoc.util.validatePredicate`

* `translateUpdate` to use `apoc.util.validatePredicate`, and combine the conditions for less calls

* Remove prodedure checks

* Testing to see if session is causing failures

* Add null checks to validations, only add division rule if needed

* Update packages/graphql/tests/integration/math.int.test.ts

Co-authored-by: MacondoExpress <simone.gammicchia@gmail.com>

---------

Co-authored-by: MacondoExpress <simone.gammicchia@gmail.com>

* Strongly type `context` field in OGM (#3690)

* Strongly type `context` field in OGM

* Fix schema tests

* Validation configuration changes (#3687)

* Miscellaneous test fix

* Missing custom resolvers to warn instead of throw

* Unified validate option, removal of library config object

* Docs updates

* Add changeset

* Update docs

* Add a bit about `startupValidation`

* Remove `neo4jValidateGraphQLDocument` (#3691)

* Subscriptions Engine (#3688)

* Changes subscription mechanism to engine

* Miscellaneous fixes

* Add migration step

* Docs remnants

* Fix linting and tests

* Update examples

* EngineAMQP to AMQPEngine

* Much better naming for subscriptions engine

* Update nine-poems-retire.md

* Re-lock

* Fix version of AMQP engine

* Version Packages (beta) (#2774)

* adds directive combination rules

* adds jwt directives validation rule

* Remove docs (#3696)

* Remove docs

* Remove references

* adds more validation rules and tests, id in progress

* finish all validations except customResolver, add tests, refactoring todo

* refactor into generic rules w/ specialized validation functions

* remove comments

* tidy up code

* improve relationship validation, start updating tests

* merge 4.0.0

* update tests

* attempt fix ts error

* fix global id inherited alias

* remove comments

* refactor relationship validation

* refactor invalid directive combinations

* remove unused imports

* update validation on getSubgraphSchema

* make valid-object-type rule work

* fix reviewdog on tests

* Version Packages (beta) (#3734)

* Schema model refactoring (#3689)

* Add directive annotations (#3615)

* feat: add alias directive annotation

* feat: add queryOptions directive annotation

* feat: parse Kind.INT and Kind.Float into JS numbers

* feat: add default directive annotation

* feat: add coalesce directive annotation

* feat: add customResolver annotation

* feat: add ID directive annotation

* refactor: use makeDirectiveNode in key-annotation tests

* feat: add mutation directive annotation

* feat: add plural directive annotation

* feat: add filterable directive annotation

* feat: add fulltext directive annotation

* feat: add node directive annotation

* feat: add populatedBy directive annotation

* feat: add query directive annotation

* feat: add private directive annotation

* feat: add relationshipProperties annotation

* feat: add selectable directive annotation

* feat: add settable directive annotation

* feat: add timestamp directive annotation

* feat: add unique directive annotation

* feat: add subscription directive annotation

* feat: add jwt-claim directive annotation

* feat: add jwt-payload directive annotation

* feat: add directives to Annotation

---------

Co-authored-by: MacondoExpress <simone.gammicchia@neotechnology.com>

* Schema model re-design (#3596)

* initial refactor of the schema model

* add unit tests for schema model Attributes

* include initial design for the GraphQL models

* add Attribute tests, improve Attribute models

* merge schema model changes with authorization changes

* fix relationship-field parsing on schema model

* organise parser folder

* Add missing GraphQL models to the Schema Models

* change Schema Model test to showcase how to dynamically get EntityModels from relationships

* improve coverage on the Attribute Models

* add more tests to the ConcreteEntityModel

* Apply suggestions from code review

Co-authored-by: angrykoala <angrykoala@outlook.es>

* lint fixes

* rename graphql-models to model-adapters

* remove @relationshipProperties annotation as it is implicit within the Relationship class

* remove code duplicity around leadingUnderscores utility and test it

* parseArguments of directive using default values, add Schema Model tests for annotations and relationships

* remove not necessary node directive

* polishing

* add license header

* Update packages/graphql/src/schema-model/parser/parse-arguments.ts

* add graphqlDefaultValue to Attribute

* remove the graphqlDefault logic

* add comment on the PluralAnnotation

---------

Co-authored-by: Michael Webb <28074382+mjfwebb@users.noreply.github.com>
Co-authored-by: angrykoala <angrykoala@outlook.es>

* address review

* make additional definitions mandatory on validations

* improve error check

* improve validation tests

* Update logical filters in aggregation queries

* Introspector to produce `@mutation` instead of `@exclude` (#3743)

* fix: remove unnecessary readonly (#3735)

* chore(deps): update dependency eslint-config-prettier to v8.10.0

* chore(deps): update dependency jest-extended to v4.0.1

* Introspector to produce `@mutation` instead of `@exclude`

---------

Co-authored-by: Thomas Wiss <thomas.wiss@neotechnology.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* Update logical operators on field aggregations outside of node/edge

* Update aggregation implicit and filter

* cypherParams added to new context type, and fields can be directly referred to (#3758)

* cypherParams added to new context type, and fields can be directly referred to

* Resolve all possible label references

* Address PR comments

* code review changes

* fix tests after code review changes

* Fix default logical operators in aggregation filters

* refactor: add types to assertArgumentType

* Add integration test

* fix toolbox error

* Stronger typings for context (#3779)

* Pass info into Executor rather than putting in context

* Typings for fulltext in current context

* Remove unused context entries

* Remove some unneeded context references

* Add context types

* Switch to new context typings

* Remove legacy Context type

* improve valid-directive-combination to check inherited directives as well

* remove resolutions

* fix fulltext missing type

* change id autogenerate default value, remove errors from make-augmented-schema and update tests

* add scaffold directive definition for type dependant directives

* conditionally run directiveArgumentOfCorrectType rule on auth directives

* adjust tests and invalid directive combination matrix

* fix RENAMED_DIRECTIVE_OR_TYPE regex

* remove faulty export

* Reduction in types accepted for type definitions (#3592)

* Refined normalization of user type definitions

* Remove unused type

* Wrap current behaviour with new lifecycle naming

* Fix linting error

* Delete unused tests

* Fix test typings

* Update Neo4jGraphQL.ts

* Correct default access mode for `@cypher` (#3792)

* chore(deps): update dependency eslint to v8.47.0

* Toolbox: Ensure no additional commas are added to the editor value (#3784)

* `@cypher` default access mode to match operation

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Michael Webb <28074382+mjfwebb@users.noreply.github.com>

* Schema model improvements (#3794)

* change isListOf to includeLists flag

* clean up AttributeAdapter

* remove type guards for type

* polish

* use assertionOptions rather than flag

* fix assertions

* add isList argument to the relationship to differentiate between 1..1 or 1..n

* polish

* Move the `limit` argument of `@queryOptions` to `@limit` (#3809)

* Move the `limit` argument of `@queryOptions` to `@limit`

* Update translate-read.ts

* changes from review

* use a lambda instead of Fn.bind

* Improved typings for Subscriptions context and authorization (#3810)

* Improved typings for Subscriptions context and authorization

* Single type for common context fields

* Fix typings so it works without connectionParams

* Fix possible undefined

* Address PR comments

* Rename context interface

* add rule for directives on root type fields

* change queryOptions with limit

* chore: fix linting issues

* Remove references to global authentication (#3815)

* Version Packages (beta) (#3757)

* fix cypher with authorization on root type fields tests

* do not allow directives on interface fields except for relationshipProperties

* remove  rule as directives on intreface fields are no longer possible

* add comments

* disallow unique directive on relationshipProperties explicitly, since interface rule is gone

* improve error messages on root types fields

* remove interface inheritance from validate relationship directive rule

* remove interface inheritance from validate directive combination rule

* Breaking changes to the `@id` directive (#3823)

* Break `@id` `global` argument out into `@relayId`

* Remove arguments from `@id`

* Add changeset

* Address first PR comments

* Switch back to default name for constraints

* Fix directive description

* Remove automatic constraint for `@id`

* Fix typo

* Fix tests

* fix interface field directives tests

* fix id directive rule

* remove interface inheritance from @id validation

* move some tests to validateDocument

* fix some tests with interface inheritance

* Revert "fix some tests with interface inheritance"

This reverts commit 09069f8.

* Revert "remove interface inheritance from @id validation"

This reverts commit 29f5f85.

* Revert "fix interface field directives tests"

This reverts commit 2f0aafc.

* Revert "remove interface inheritance from validate directive combination rule"

This reverts commit 6b3175d.

* Revert "remove interface inheritance from validate relationship directive rule"

This reverts commit ae12676.

* Revert "disallow unique directive on relationshipProperties explicitly, since interface rule is gone"

This reverts commit 4c8b9e8.

* Revert "remove  rule as directives on intreface fields are no longer possible"

This reverts commit 0897e82.

* rename globalId to relayId

* refactor relationship validation to use inheritance utils

* improve directive combination to not run when < 2 directives

* allow directives on interface fields

* update tests

* Remove definitions for `@exclude`, `@readonly` and `@writeonly` (#3857)

* Change `@subscription` `operations` argument to be `events` (#3858)

* `@subscription` `operations` to `events`

* Add changeset

* Missed some usages

* Fix tests

* Rolls back TypeScript to 5.1.6 (#3867)

* update rules with object and interface extensions

* update jwt directives rule to consider extensions

* update relationshipProperties rule to consider extensions

* update relayId rule to consider extensions

* add tests on all rules for extensions

* fix skip test

* fix missing directives

* improve jwt directives rule to check for adding jwt on extension as last thing

* Fix: `cypherParams` in context now work as expected when using OGM (#3830)

* Fix: `cypherParams` in context now work as expected when using OGM

* Remove jwt and token from OGM context types

* Change test to use cypherParams

* Update typing

* improve jwt directives rule to use context document

* refactor jwt directives rule

* Fix README

* Remove unused import

---------

Co-authored-by: MacondoExpress <simone.gammicchia@gmail.com>
Co-authored-by: Darrell Warde <8117355+darrellwarde@users.noreply.github.com>
Co-authored-by: Lidia Zuin <102308961+lidiazuin@users.noreply.github.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Darrell Warde <darrell.warde@gmail.com>
Co-authored-by: Michael Webb <michael.webb@neo4j.com>
Co-authored-by: a-alle <alexandra.albu@neo4j.com>
Co-authored-by: Alle <111279668+a-alle@users.noreply.github.com>
Co-authored-by: MacondoExpress <simone.gammicchia@neotechnology.com>
Co-authored-by: Neo4j Team GraphQL <88824828+neo4j-team-graphql@users.noreply.github.com>
Co-authored-by: Michael Webb <28074382+mjfwebb@users.noreply.github.com>
Co-authored-by: Thomas Wiss <thomas.wiss@neotechnology.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants