feat: add ignoreDuplicates option to upsert

Author: rosswaycaster

packages/core/postgrest-js/src/lib/PostgrestQueryBuilder.ts

@@ -125,22 +125,28 @@ export default class PostgrestQueryBuilder<T> extends PostgrestBuilder<T> {
    * @param onConflict  By specifying the `on_conflict` query parameter, you can make UPSERT work on a column(s) that has a UNIQUE constraint.
    * @param returning  By default the new record is returned. Set this to 'minimal' if you don't need this value.
    * @param count  Count algorithm to use to count rows in a table.
+   * @param ignoreDuplicates  Specifies if duplicate rows should be ignored and not inserted.
    */
   upsert(
     values: Partial<T> | Partial<T>[],
     {
       onConflict,
       returning = 'representation',
       count = null,
+      ignoreDuplicates = false,
     }: {
       onConflict?: string
       returning?: 'minimal' | 'representation'
       count?: null | 'exact' | 'planned' | 'estimated'
+      ignoreDuplicates?: boolean
     } = {}
   ): PostgrestFilterBuilder<T> {
     this.method = 'POST'
 
-    const prefersHeaders = ['resolution=merge-duplicates', `return=${returning}`]
+    const prefersHeaders = [
+      `resolution=${ignoreDuplicates ? 'ignore' : 'merge'}-duplicates`,
+      `return=${returning}`,
+    ]
 
     if (onConflict !== undefined) this.url.searchParams.set('on_conflict', onConflict)
     this.body = values

packages/core/postgrest-js/test/__snapshots__/index.test.ts.snap

@@ -1122,6 +1122,17 @@ Object {
 }
 `;
 
+exports[`ignoreDuplicates upsert 1`] = `
+Object {
+  "body": Array [],
+  "count": null,
+  "data": Array [],
+  "error": null,
+  "status": 201,
+  "statusText": "Created",
+}
+`;
+
 exports[`insert, update, delete with count: 'exact' basic delete count: 'exact' 1`] = `
 Object {
   "body": Array [

packages/core/postgrest-js/test/basic.ts

@@ -41,6 +41,13 @@ test('on_conflict insert', async () => {
   expect(res).toMatchSnapshot()
 })
 
+test('ignoreDuplicates upsert', async () => {
+  const res = await postgrest
+    .from('users')
+    .upsert({ username: 'dragarcia' }, { onConflict: 'username', ignoreDuplicates: true })
+  expect(res).toMatchSnapshot()
+})
+
 describe('basic insert, update, delete', () => {
   test('basic insert', async () => {
     let res = await postgrest