npmpackage.info

Gathering detailed insights and metrics for @ckitching/postgraphile-plugin-nested-mutations

@ckitching/postgraphile-plugin-nested-mutations - 1.0.2 | npmpackage.info

@ckitching/postgraphile-plugin-nested-mutations

Nested mutations for Postgraphile

1.0.2

MIT

JavaScript

74.97 kB

1.7

Installations

npm install @ckitching/postgraphile-plugin-nested-mutations

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

15.3.0

NPM Version

6.14.10 Pull Requests

Open

0

Total

0

Closed

0

Issues

Open

0

Total

0

Closed

0

Releases

Unable to fetch releases

Languages

JavaScript

Shell

JavaScript (99.7%)

Shell (0.3%)

Developer

ChrisKitching

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

76 Commits

6 Branches

1 Contributors

Updated on Jan 09, 2021

Maintainers

View All 1 Contributors

Package Meta Information

Latest Version

1.0.2

Package Id

@ckitching/postgraphile-plugin-nested-mutations@1.0.2

Unpacked Size

74.97 kB

Size

13.80 kB

File Count

NPM Version

6.14.10

Node Version

15.3.0

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Fork of the abandoned original package.

This fork:

Steals a variety of fixes from other forks scattered across github.
Fixes one more problem (preventing this plugin from trying to treat composite types as tables).

postgraphile-plugin-nested-mutations

This plugin implements nested mutations based on both forward and reverse foreign key relationships in PostGraphile v4. Nested mutations can be of infinite depth.

Getting Started

CLI

1postgraphile --append-plugins postgraphile-plugin-nested-mutations

See here for more information about loading plugins with PostGraphile.

Library

1const express = require('express');
2const { postgraphile } = require('postgraphile');
3const PostGraphileNestedMutations = require('postgraphile-plugin-nested-mutations');
4
5const app = express();
6
7app.use(
8  postgraphile(pgConfig, schema, {
9    appendPlugins: [
10      PostGraphileNestedMutations,
11    ],
12  })
13);
14
15app.listen(5000);

Plugin Options

When using PostGraphile as a library, the following plugin options can be passed via graphileBuildOptions:

nestedMutationsSimpleFieldNames

Use simple field names for nested mutations. Instead of names suffixed with tableBy<Key> and tableUsing<Key>, tables with a single foreign key relationship between them will have their nested relation fields named table. Defaults to false.

1postgraphile(pgConfig, schema, {
2  graphileBuildOptions: {
3    nestedMutationsSimpleFieldNames: true,
4  }
5});

nestedMutationsDeleteOthers

Controls whether the deleteOthers field is available on nested mutations. Defaults to true.

1postgraphile(pgConfig, schema, {
2  graphileBuildOptions: {
3    nestedMutationsDeleteOthers: false,
4  }
5});

nestedMutationsOldUniqueFields

If enabled, plural names for one-to-one relations will be used. For backwards compatibility. Defaults to false.

1postgraphile(pgConfig, schema, {
2  graphileBuildOptions: {
3    nestedMutationsOldUniqueFields: false,
4  }
5});

Usage

This plugin creates an additional field on each GraphQL Input type for every forward and reverse foreign key relationship on a table, with the same name as the foreign table.

Each nested mutation field will have the following fields. They will accept an array if the relationship is a one-to-many relationship, or a single input if they are one-to-one.

Connect to Existing Record

`connectByNodeId`

Connect using a nodeId from the nested table.

`connectBy<K>`

Connect using any readable primary key or unique constraint on the nested table.

Creating New Records

`create`

Create a new record in the nested table.

Delete existing Record

`deleteByNodeId`

Delete using a nodeId from the nested table.

`deleteBy<K>`

Delete using any readable primary key or unique constraint on the nested table.

Updating Records

`updateByNodeId`

Update a record using a nodeId from the nested table.

`updatedBy<K>`

Update a record using any readable primary key or unique constraint on the nested table.

Example

1create table parent (
2  id serial primary key,
3  name text not null
4);
5
6create table child (
7  id serial primary key,
8  parent_id integer,
9  name text not null,
10  constraint child_parent_fkey foreign key (parent_id)
11    references p.parent (id)
12);

A nested mutation against this schema, using Parent as the base mutation would look like this:

1mutation {
2  createParent(input: {
3    parent: {
4      name: "Parent 1"
5      childrenUsingId: {
6        connectById: [{
7          id: 1
8        }]
9        create: [{
10          name: "Child 1"
11        }, {
12          name: "Child 2"
13        }]
14      }
15    }
16  }) {
17    parent {
18      id
19      name
20      childrenByParentId {
21        nodes {
22          id
23          name
24        }
25      }
26    }
27  }
28}

Or using Child as the base mutation:

1mutation {
2  createChild(input: {
3    child: {
4      name: "Child 1"
5      parentToParentId: {
6        create: {
7          name: "Parent of Child 1"
8        }
9      }
10    },
11  }) {
12    child {
13      id
14      name
15      parentByParentId {
16        id
17        name
18      }
19    }
20  }
21}

Smart Comments

Smart comments are supported for renaming the nested mutation fields.

1comment on constraint child_parent_fkey on child is
2  E'@fieldName parent\n@foreignFieldName children';

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

SAST

Determines if the project uses static code analysis.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

64 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-6chw-6frg-f759
Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx
Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-3gx7-xhv7-5mx3
Warn: Project is vulnerable to: GHSA-8r6j-v8pm-fqw3
Warn: Project is vulnerable to: MAL-2023-462
Warn: Project is vulnerable to: GHSA-w457-6q6x-cgp9
Warn: Project is vulnerable to: GHSA-62gr-4qp9-h98f
Warn: Project is vulnerable to: GHSA-f52g-6jhx-586p
Warn: Project is vulnerable to: GHSA-2cf5-4w76-r9qv
Warn: Project is vulnerable to: GHSA-3cqr-58rm-57f8
Warn: Project is vulnerable to: GHSA-g9r4-xpmj-mj65
Warn: Project is vulnerable to: GHSA-q2c6-c6pm-g3gh
Warn: Project is vulnerable to: GHSA-765h-qjxv-5f44
Warn: Project is vulnerable to: GHSA-f2jv-r9rf-7988
Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj
Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-8cf7-32gw-wr33
Warn: Project is vulnerable to: GHSA-hjrf-2m68-5959
Warn: Project is vulnerable to: GHSA-qwph-4952-7xr6
Warn: Project is vulnerable to: GHSA-6c8f-qphg-qjgp
Warn: Project is vulnerable to: GHSA-4xc9-xhrj-v574
Warn: Project is vulnerable to: GHSA-x5rq-j2xg-h7qm
Warn: Project is vulnerable to: GHSA-jf85-cpcp-j695
Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw
Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9
Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m
Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
Warn: Project is vulnerable to: GHSA-fhjf-83wg-r2j9
Warn: Project is vulnerable to: GHSA-8hfj-j24r-96c4
Warn: Project is vulnerable to: GHSA-wc69-rhjr-hc9g
Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p
Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-4g88-fppr-53pp
Warn: Project is vulnerable to: GHSA-4jqc-8m5r-9rpr
Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9
Warn: Project is vulnerable to: GHSA-r628-mhmh-qjhw
Warn: Project is vulnerable to: GHSA-9r2w-394v-53qc
Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh
Warn: Project is vulnerable to: GHSA-qq89-hq3f-393p
Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36
Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh
Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp

Score

1.7

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

@ckitching/postgraphile-plugin-nested-mutations

Installations

Developer Guide

No

CommonJS

15.3.0

6.14.10

Pull Requests

0

0

0

Issues

0

0

0

Releases

Unable to fetch releases

Languages

Developer

ChrisKitching

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

postgraphile-plugin-nested-mutations

Getting Started

CLI

Library

Plugin Options

Usage

Connect to Existing Record

connectByNodeId

connectBy<K>

Creating New Records

create

Delete existing Record

deleteByNodeId

deleteBy<K>

Updating Records

updateByNodeId

updatedBy<K>

Example

Smart Comments

10

10

0

0

0

0

0

0

0

0

1.7

/10

`connectByNodeId`

`connectBy<K>`

`create`

`deleteByNodeId`

`deleteBy<K>`

`updateByNodeId`

`updatedBy<K>`