@supabase/postgrest-js 3.0.0-next.21 → 3.0.0-next.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +40 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +16 -1
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.mts +16 -1
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +40 -1
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
- package/src/PostgrestBuilder.ts +3 -1
- package/src/PostgrestFilterBuilder.ts +27 -0
- package/src/PostgrestTransformBuilder.ts +10 -0
- package/src/version.ts +1 -1
package/dist/index.mjs
CHANGED
|
@@ -166,6 +166,7 @@ var PostgrestBuilder = class {
|
|
|
166
166
|
* {@link https://docs.postgrest.org/en/stable/references/api/resource_representation.html#stripped-nulls}
|
|
167
167
|
*
|
|
168
168
|
* @category Database
|
|
169
|
+
* @subcategory Using modifiers
|
|
169
170
|
*
|
|
170
171
|
* @example With `select()`
|
|
171
172
|
* ```ts
|
|
@@ -434,6 +435,7 @@ var PostgrestBuilder = class {
|
|
|
434
435
|
* @returns A PostgrestBuilder instance with the new type
|
|
435
436
|
*
|
|
436
437
|
* @category Database
|
|
438
|
+
* @subcategory Using modifiers
|
|
437
439
|
*
|
|
438
440
|
* @example Complete Override type of successful response
|
|
439
441
|
* ```ts
|
|
@@ -489,7 +491,7 @@ var PostgrestBuilder = class {
|
|
|
489
491
|
* let x: typeof data // CountryRowProperties & { status: "A" | "B" } | null
|
|
490
492
|
* ```
|
|
491
493
|
*
|
|
492
|
-
* @example
|
|
494
|
+
* @example Merge vs replace existing types
|
|
493
495
|
* ```typescript
|
|
494
496
|
* // Merge with existing types (default behavior)
|
|
495
497
|
* const query = supabase
|
|
@@ -522,6 +524,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
522
524
|
* @param columns - The columns to retrieve, separated by commas
|
|
523
525
|
*
|
|
524
526
|
* @category Database
|
|
527
|
+
* @subcategory Using modifiers
|
|
525
528
|
*
|
|
526
529
|
* @example With `upsert()`
|
|
527
530
|
* ```ts
|
|
@@ -586,6 +589,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
586
589
|
* instead
|
|
587
590
|
*
|
|
588
591
|
* @category Database
|
|
592
|
+
* @subcategory Using modifiers
|
|
589
593
|
*
|
|
590
594
|
* @example With `select()`
|
|
591
595
|
* ```ts
|
|
@@ -772,6 +776,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
772
776
|
* instead
|
|
773
777
|
*
|
|
774
778
|
* @category Database
|
|
779
|
+
* @subcategory Using modifiers
|
|
775
780
|
*
|
|
776
781
|
* @example With `select()`
|
|
777
782
|
* ```ts
|
|
@@ -881,6 +886,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
881
886
|
* instead
|
|
882
887
|
*
|
|
883
888
|
* @category Database
|
|
889
|
+
* @subcategory Using modifiers
|
|
884
890
|
*
|
|
885
891
|
* @example With `select()`
|
|
886
892
|
* ```ts
|
|
@@ -932,6 +938,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
932
938
|
* @param signal - The AbortSignal to use for the fetch request
|
|
933
939
|
*
|
|
934
940
|
* @category Database
|
|
941
|
+
* @subcategory Using modifiers
|
|
935
942
|
*
|
|
936
943
|
* @remarks
|
|
937
944
|
* You can use this to set a timeout for the request.
|
|
@@ -1002,6 +1009,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1002
1009
|
* returns an error.
|
|
1003
1010
|
*
|
|
1004
1011
|
* @category Database
|
|
1012
|
+
* @subcategory Using modifiers
|
|
1005
1013
|
*
|
|
1006
1014
|
* @example With `select()`
|
|
1007
1015
|
* ```ts
|
|
@@ -1047,6 +1055,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1047
1055
|
* this returns an error.
|
|
1048
1056
|
*
|
|
1049
1057
|
* @category Database
|
|
1058
|
+
* @subcategory Using modifiers
|
|
1050
1059
|
*
|
|
1051
1060
|
* @example With `select()`
|
|
1052
1061
|
* ```ts
|
|
@@ -1086,6 +1095,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1086
1095
|
* Return `data` as a string in CSV format.
|
|
1087
1096
|
*
|
|
1088
1097
|
* @category Database
|
|
1098
|
+
* @subcategory Using modifiers
|
|
1089
1099
|
*
|
|
1090
1100
|
* @exampleDescription Return data as CSV
|
|
1091
1101
|
* By default, the data is returned in JSON format, but can also be returned as Comma Separated Values.
|
|
@@ -1159,6 +1169,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1159
1169
|
* or `"json"`
|
|
1160
1170
|
*
|
|
1161
1171
|
* @category Database
|
|
1172
|
+
* @subcategory Using modifiers
|
|
1162
1173
|
*
|
|
1163
1174
|
* @exampleDescription Get the execution plan
|
|
1164
1175
|
* By default, the data is returned in TEXT format, but can also be returned as JSON by using the `format` parameter.
|
|
@@ -1260,6 +1271,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1260
1271
|
* @deprecated Use overrideTypes<yourType, { merge: false }>() method at the end of your call chain instead
|
|
1261
1272
|
*
|
|
1262
1273
|
* @category Database
|
|
1274
|
+
* @subcategory Using modifiers
|
|
1263
1275
|
*
|
|
1264
1276
|
* @remarks
|
|
1265
1277
|
* - Deprecated: use overrideTypes method instead
|
|
@@ -1322,6 +1334,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1322
1334
|
* @param value - The value to filter with
|
|
1323
1335
|
*
|
|
1324
1336
|
* @category Database
|
|
1337
|
+
* @subcategory Using filters
|
|
1325
1338
|
*
|
|
1326
1339
|
* @example With `select()`
|
|
1327
1340
|
* ```ts
|
|
@@ -1369,6 +1382,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1369
1382
|
* @param value - The value to filter with
|
|
1370
1383
|
*
|
|
1371
1384
|
* @category Database
|
|
1385
|
+
* @subcategory Using filters
|
|
1372
1386
|
*
|
|
1373
1387
|
* @example With `select()`
|
|
1374
1388
|
* ```ts
|
|
@@ -1420,6 +1434,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1420
1434
|
* @param value - The value to filter with
|
|
1421
1435
|
*
|
|
1422
1436
|
* @category Database
|
|
1437
|
+
* @subcategory Using filters
|
|
1423
1438
|
*
|
|
1424
1439
|
* @exampleDescription With `select()`
|
|
1425
1440
|
* When using [reserved words](https://www.postgresql.org/docs/current/sql-keywords-appendix.html) for column names you need
|
|
@@ -1471,6 +1486,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1471
1486
|
* @param value - The value to filter with
|
|
1472
1487
|
*
|
|
1473
1488
|
* @category Database
|
|
1489
|
+
* @subcategory Using filters
|
|
1474
1490
|
*
|
|
1475
1491
|
* @example With `select()`
|
|
1476
1492
|
* ```ts
|
|
@@ -1522,6 +1538,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1522
1538
|
* @param value - The value to filter with
|
|
1523
1539
|
*
|
|
1524
1540
|
* @category Database
|
|
1541
|
+
* @subcategory Using filters
|
|
1525
1542
|
*
|
|
1526
1543
|
* @example With `select()`
|
|
1527
1544
|
* ```ts
|
|
@@ -1569,6 +1586,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1569
1586
|
* @param value - The value to filter with
|
|
1570
1587
|
*
|
|
1571
1588
|
* @category Database
|
|
1589
|
+
* @subcategory Using filters
|
|
1572
1590
|
*
|
|
1573
1591
|
* @example With `select()`
|
|
1574
1592
|
* ```ts
|
|
@@ -1620,6 +1638,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1620
1638
|
* @param pattern - The pattern to match with
|
|
1621
1639
|
*
|
|
1622
1640
|
* @category Database
|
|
1641
|
+
* @subcategory Using filters
|
|
1623
1642
|
*
|
|
1624
1643
|
* @example With `select()`
|
|
1625
1644
|
* ```ts
|
|
@@ -1667,6 +1686,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1667
1686
|
* @param patterns - The patterns to match with
|
|
1668
1687
|
*
|
|
1669
1688
|
* @category Database
|
|
1689
|
+
* @subcategory Using filters
|
|
1670
1690
|
*/
|
|
1671
1691
|
likeAllOf(column, patterns) {
|
|
1672
1692
|
this.url.searchParams.append(column, `like(all).{${patterns.join(",")}}`);
|
|
@@ -1679,6 +1699,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1679
1699
|
* @param patterns - The patterns to match with
|
|
1680
1700
|
*
|
|
1681
1701
|
* @category Database
|
|
1702
|
+
* @subcategory Using filters
|
|
1682
1703
|
*/
|
|
1683
1704
|
likeAnyOf(column, patterns) {
|
|
1684
1705
|
this.url.searchParams.append(column, `like(any).{${patterns.join(",")}}`);
|
|
@@ -1691,6 +1712,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1691
1712
|
* @param pattern - The pattern to match with
|
|
1692
1713
|
*
|
|
1693
1714
|
* @category Database
|
|
1715
|
+
* @subcategory Using filters
|
|
1694
1716
|
*
|
|
1695
1717
|
* @example With `select()`
|
|
1696
1718
|
* ```ts
|
|
@@ -1738,6 +1760,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1738
1760
|
* @param patterns - The patterns to match with
|
|
1739
1761
|
*
|
|
1740
1762
|
* @category Database
|
|
1763
|
+
* @subcategory Using filters
|
|
1741
1764
|
*/
|
|
1742
1765
|
ilikeAllOf(column, patterns) {
|
|
1743
1766
|
this.url.searchParams.append(column, `ilike(all).{${patterns.join(",")}}`);
|
|
@@ -1750,6 +1773,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1750
1773
|
* @param patterns - The patterns to match with
|
|
1751
1774
|
*
|
|
1752
1775
|
* @category Database
|
|
1776
|
+
* @subcategory Using filters
|
|
1753
1777
|
*/
|
|
1754
1778
|
ilikeAnyOf(column, patterns) {
|
|
1755
1779
|
this.url.searchParams.append(column, `ilike(any).{${patterns.join(",")}}`);
|
|
@@ -1790,6 +1814,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1790
1814
|
* @param value - The value to filter with
|
|
1791
1815
|
*
|
|
1792
1816
|
* @category Database
|
|
1817
|
+
* @subcategory Using filters
|
|
1793
1818
|
*
|
|
1794
1819
|
* @exampleDescription Checking for nullness, true or false
|
|
1795
1820
|
* Using the `eq()` filter doesn't work when filtering for `null`.
|
|
@@ -1855,6 +1880,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1855
1880
|
* @param values - The values array to filter with
|
|
1856
1881
|
*
|
|
1857
1882
|
* @category Database
|
|
1883
|
+
* @subcategory Using filters
|
|
1858
1884
|
*
|
|
1859
1885
|
* @example With `select()`
|
|
1860
1886
|
* ```ts
|
|
@@ -1925,6 +1951,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1925
1951
|
* @param value - The jsonb, array, or range value to filter with
|
|
1926
1952
|
*
|
|
1927
1953
|
* @category Database
|
|
1954
|
+
* @subcategory Using filters
|
|
1928
1955
|
*
|
|
1929
1956
|
* @example On array columns
|
|
1930
1957
|
* ```ts
|
|
@@ -2059,6 +2086,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2059
2086
|
* @param value - The jsonb, array, or range value to filter with
|
|
2060
2087
|
*
|
|
2061
2088
|
* @category Database
|
|
2089
|
+
* @subcategory Using filters
|
|
2062
2090
|
*
|
|
2063
2091
|
* @example On array columns
|
|
2064
2092
|
* ```ts
|
|
@@ -2194,6 +2222,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2194
2222
|
* @param range - The range to filter with
|
|
2195
2223
|
*
|
|
2196
2224
|
* @category Database
|
|
2225
|
+
* @subcategory Using filters
|
|
2197
2226
|
*
|
|
2198
2227
|
* @exampleDescription With `select()`
|
|
2199
2228
|
* Postgres supports a number of [range
|
|
@@ -2254,6 +2283,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2254
2283
|
* @param range - The range to filter with
|
|
2255
2284
|
*
|
|
2256
2285
|
* @category Database
|
|
2286
|
+
* @subcategory Using filters
|
|
2257
2287
|
*
|
|
2258
2288
|
* @exampleDescription With `select()`
|
|
2259
2289
|
* Postgres supports a number of [range
|
|
@@ -2313,6 +2343,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2313
2343
|
* @param range - The range to filter with
|
|
2314
2344
|
*
|
|
2315
2345
|
* @category Database
|
|
2346
|
+
* @subcategory Using filters
|
|
2316
2347
|
*
|
|
2317
2348
|
* @exampleDescription With `select()`
|
|
2318
2349
|
* Postgres supports a number of [range
|
|
@@ -2372,6 +2403,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2372
2403
|
* @param range - The range to filter with
|
|
2373
2404
|
*
|
|
2374
2405
|
* @category Database
|
|
2406
|
+
* @subcategory Using filters
|
|
2375
2407
|
*
|
|
2376
2408
|
* @exampleDescription With `select()`
|
|
2377
2409
|
* Postgres supports a number of [range
|
|
@@ -2432,6 +2464,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2432
2464
|
* @param range - The range to filter with
|
|
2433
2465
|
*
|
|
2434
2466
|
* @category Database
|
|
2467
|
+
* @subcategory Using filters
|
|
2435
2468
|
*
|
|
2436
2469
|
* @exampleDescription With `select()`
|
|
2437
2470
|
* Postgres supports a number of [range
|
|
@@ -2490,6 +2523,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2490
2523
|
* @param value - The array or range value to filter with
|
|
2491
2524
|
*
|
|
2492
2525
|
* @category Database
|
|
2526
|
+
* @subcategory Using filters
|
|
2493
2527
|
*
|
|
2494
2528
|
* @example On array columns
|
|
2495
2529
|
* ```ts
|
|
@@ -2589,6 +2623,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2589
2623
|
* @param options.type - Change how the `query` text is interpreted
|
|
2590
2624
|
*
|
|
2591
2625
|
* @category Database
|
|
2626
|
+
* @subcategory Using filters
|
|
2592
2627
|
*
|
|
2593
2628
|
* @remarks
|
|
2594
2629
|
* - For more information, see [Postgres full text search](/docs/guides/database/full-text-search).
|
|
@@ -2698,6 +2733,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2698
2733
|
* to their filter values
|
|
2699
2734
|
*
|
|
2700
2735
|
* @category Database
|
|
2736
|
+
* @subcategory Using filters
|
|
2701
2737
|
*
|
|
2702
2738
|
* @example With `select()`
|
|
2703
2739
|
* ```ts
|
|
@@ -2753,6 +2789,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2753
2789
|
* @param value - The value to filter with, following PostgREST syntax
|
|
2754
2790
|
*
|
|
2755
2791
|
* @category Database
|
|
2792
|
+
* @subcategory Using filters
|
|
2756
2793
|
*
|
|
2757
2794
|
* @remarks
|
|
2758
2795
|
* not() expects you to use the raw PostgREST syntax for the filter values.
|
|
@@ -2817,6 +2854,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2817
2854
|
* @param options.foreignTable - Deprecated, use `referencedTable` instead
|
|
2818
2855
|
*
|
|
2819
2856
|
* @category Database
|
|
2857
|
+
* @subcategory Using filters
|
|
2820
2858
|
*
|
|
2821
2859
|
* @remarks
|
|
2822
2860
|
* or() expects you to use the raw PostgREST syntax for the filter names and values.
|
|
@@ -2970,6 +3008,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2970
3008
|
* @param value - The value to filter with, following PostgREST syntax
|
|
2971
3009
|
*
|
|
2972
3010
|
* @category Database
|
|
3011
|
+
* @subcategory Using filters
|
|
2973
3012
|
*
|
|
2974
3013
|
* @remarks
|
|
2975
3014
|
* filter() expects you to use the raw PostgREST syntax for the filter values.
|