feat: obsolete deprecated features

BREAKING CHANGE: obselete the following previously-deprecated features:
- filter shorthands (e.g. `cs` vs. `contains`)
- `body` in response (vs. `data`)
- `upsert`ing thru `.insert()`

Author: soedirgo

src/PostgrestBuilder.ts

@@ -128,7 +128,6 @@ export default abstract class PostgrestBuilder<T> implements PromiseLike<Postgre
         count,
         status,
         statusText,
-        body: data,
       }
 
       return postgrestResponse
@@ -142,7 +141,6 @@ export default abstract class PostgrestBuilder<T> implements PromiseLike<Postgre
           code: fetchError.code || '',
         },
         data: null,
-        body: null,
         count: null,
         status: 400,
         statusText: 'Bad Request',

src/PostgrestFilterBuilder.ts

@@ -203,9 +203,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /** @deprecated Use `contains()` instead. */
-  cs = this.contains
-
   /**
    * Finds all rows whose json, array, or range value on the stated `column` is
    * contained by the specified `value`.
@@ -227,9 +224,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /** @deprecated Use `containedBy()` instead. */
-  cd = this.containedBy
-
   /**
    * Finds all rows whose range value on the stated `column` is strictly to the
    * left of the specified `range`.
@@ -242,9 +236,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /** @deprecated Use `rangeLt()` instead. */
-  sl = this.rangeLt
-
   /**
    * Finds all rows whose range value on the stated `column` is strictly to
    * the right of the specified `range`.
@@ -257,9 +248,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /** @deprecated Use `rangeGt()` instead. */
-  sr = this.rangeGt
-
   /**
    * Finds all rows whose range value on the stated `column` does not extend
    * to the left of the specified `range`.
@@ -272,9 +260,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /** @deprecated Use `rangeGte()` instead. */
-  nxl = this.rangeGte
-
   /**
    * Finds all rows whose range value on the stated `column` does not extend
    * to the right of the specified `range`.
@@ -287,9 +272,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /** @deprecated Use `rangeLte()` instead. */
-  nxr = this.rangeLte
-
   /**
    * Finds all rows whose range value on the stated `column` is adjacent to
    * the specified `range`.
@@ -302,9 +284,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /** @deprecated Use `rangeAdjacent()` instead. */
-  adj = this.rangeAdjacent
-
   /**
    * Finds all rows whose array or range value on the stated `column` overlaps
    * (has a value in common) with the specified `value`.
@@ -323,9 +302,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /** @deprecated Use `overlaps()` instead. */
-  ov = this.overlaps
-
   /**
    * Finds all rows whose text or tsvector value on the stated `column` matches
    * the tsquery in `query`.
@@ -356,70 +332,6 @@ export default class PostgrestFilterBuilder<T> extends PostgrestTransformBuilder
     return this
   }
 
-  /**
-   * Finds all rows whose tsvector value on the stated `column` matches
-   * to_tsquery(`query`).
-   *
-   * @param column  The column to filter on.
-   * @param query  The Postgres tsquery string to filter with.
-   * @param config  The text search configuration to use.
-   *
-   * @deprecated Use `textSearch()` instead.
-   */
-  fts(column: keyof T, query: string, { config }: { config?: string } = {}): this {
-    const configPart = typeof config === 'undefined' ? '' : `(${config})`
-    this.url.searchParams.append(`${column}`, `fts${configPart}.${query}`)
-    return this
-  }
-
-  /**
-   * Finds all rows whose tsvector value on the stated `column` matches
-   * plainto_tsquery(`query`).
-   *
-   * @param column  The column to filter on.
-   * @param query  The Postgres tsquery string to filter with.
-   * @param config  The text search configuration to use.
-   *
-   * @deprecated Use `textSearch()` with `type: 'plain'` instead.
-   */
-  plfts(column: keyof T, query: string, { config }: { config?: string } = {}): this {
-    const configPart = typeof config === 'undefined' ? '' : `(${config})`
-    this.url.searchParams.append(`${column}`, `plfts${configPart}.${query}`)
-    return this
-  }
-
-  /**
-   * Finds all rows whose tsvector value on the stated `column` matches
-   * phraseto_tsquery(`query`).
-   *
-   * @param column  The column to filter on.
-   * @param query  The Postgres tsquery string to filter with.
-   * @param config  The text search configuration to use.
-   *
-   * @deprecated Use `textSearch()` with `type: 'phrase'` instead.
-   */
-  phfts(column: keyof T, query: string, { config }: { config?: string } = {}): this {
-    const configPart = typeof config === 'undefined' ? '' : `(${config})`
-    this.url.searchParams.append(`${column}`, `phfts${configPart}.${query}`)
-    return this
-  }
-
-  /**
-   * Finds all rows whose tsvector value on the stated `column` matches
-   * websearch_to_tsquery(`query`).
-   *
-   * @param column  The column to filter on.
-   * @param query  The Postgres tsquery string to filter with.
-   * @param config  The text search configuration to use.
-   *
-   * @deprecated Use `textSearch()` with `type: 'websearch'` instead.
-   */
-  wfts(column: keyof T, query: string, { config }: { config?: string } = {}): this {
-    const configPart = typeof config === 'undefined' ? '' : `(${config})`
-    this.url.searchParams.append(`${column}`, `wfts${configPart}.${query}`)
-    return this
-  }
-
   /**
    * Finds all rows whose `column` satisfies the filter.
    *

src/PostgrestQueryBuilder.ts

@@ -77,45 +77,19 @@ export default class PostgrestQueryBuilder<T> extends PostgrestBuilder<T> {
    * @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.
    */
-  insert(
-    values: Partial<T> | Partial<T>[],
-    options?: {
-      returning?: 'minimal' | 'representation'
-      count?: null | 'exact' | 'planned' | 'estimated'
-    }
-  ): PostgrestFilterBuilder<T>
-  /**
-   * @deprecated Use `upsert()` instead.
-   */
-  insert(
-    values: Partial<T> | Partial<T>[],
-    options?: {
-      upsert?: boolean
-      onConflict?: string
-      returning?: 'minimal' | 'representation'
-      count?: null | 'exact' | 'planned' | 'estimated'
-    }
-  ): PostgrestFilterBuilder<T>
   insert(
     values: Partial<T> | Partial<T>[],
     {
-      upsert = false,
-      onConflict,
       returning = 'representation',
       count = null,
     }: {
-      upsert?: boolean
-      onConflict?: string
       returning?: 'minimal' | 'representation'
       count?: null | 'exact' | 'planned' | 'estimated'
     } = {}
   ): PostgrestFilterBuilder<T> {
     this.method = 'POST'
 
     const prefersHeaders = [`return=${returning}`]
-    if (upsert) prefersHeaders.push('resolution=merge-duplicates')
-
-    if (upsert && onConflict !== undefined) this.url.searchParams.set('on_conflict', onConflict)
     this.body = values
     if (count) {
       prefersHeaders.push(`count=${count}`)

src/types.ts

@@ -25,23 +25,18 @@ interface PostgrestResponseBase {
 interface PostgrestResponseSuccess<T> extends PostgrestResponseBase {
   error: null
   data: T[]
-  body: T[]
   count: number | null
 }
 interface PostgrestResponseFailure extends PostgrestResponseBase {
   error: PostgrestError
   data: null
-  // For backward compatibility: body === data
-  body: null
   count: null
 }
 export type PostgrestResponse<T> = PostgrestResponseSuccess<T> | PostgrestResponseFailure
 
 interface PostgrestSingleResponseSuccess<T> extends PostgrestResponseBase {
   error: null
   data: T
-  // For backward compatibility: body === data
-  body: T
 }
 export type PostgrestSingleResponse<T> =
   | PostgrestSingleResponseSuccess<T>