@supabase/postgrest-js 3.0.0-next.21 → 3.0.0-next.23
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.cjs
CHANGED
|
@@ -168,6 +168,7 @@ var PostgrestBuilder = class {
|
|
|
168
168
|
* {@link https://docs.postgrest.org/en/stable/references/api/resource_representation.html#stripped-nulls}
|
|
169
169
|
*
|
|
170
170
|
* @category Database
|
|
171
|
+
* @subcategory Using modifiers
|
|
171
172
|
*
|
|
172
173
|
* @example With `select()`
|
|
173
174
|
* ```ts
|
|
@@ -436,6 +437,7 @@ var PostgrestBuilder = class {
|
|
|
436
437
|
* @returns A PostgrestBuilder instance with the new type
|
|
437
438
|
*
|
|
438
439
|
* @category Database
|
|
440
|
+
* @subcategory Using modifiers
|
|
439
441
|
*
|
|
440
442
|
* @example Complete Override type of successful response
|
|
441
443
|
* ```ts
|
|
@@ -491,7 +493,7 @@ var PostgrestBuilder = class {
|
|
|
491
493
|
* let x: typeof data // CountryRowProperties & { status: "A" | "B" } | null
|
|
492
494
|
* ```
|
|
493
495
|
*
|
|
494
|
-
* @example
|
|
496
|
+
* @example Merge vs replace existing types
|
|
495
497
|
* ```typescript
|
|
496
498
|
* // Merge with existing types (default behavior)
|
|
497
499
|
* const query = supabase
|
|
@@ -524,6 +526,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
524
526
|
* @param columns - The columns to retrieve, separated by commas
|
|
525
527
|
*
|
|
526
528
|
* @category Database
|
|
529
|
+
* @subcategory Using modifiers
|
|
527
530
|
*
|
|
528
531
|
* @example With `upsert()`
|
|
529
532
|
* ```ts
|
|
@@ -588,6 +591,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
588
591
|
* instead
|
|
589
592
|
*
|
|
590
593
|
* @category Database
|
|
594
|
+
* @subcategory Using modifiers
|
|
591
595
|
*
|
|
592
596
|
* @example With `select()`
|
|
593
597
|
* ```ts
|
|
@@ -774,6 +778,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
774
778
|
* instead
|
|
775
779
|
*
|
|
776
780
|
* @category Database
|
|
781
|
+
* @subcategory Using modifiers
|
|
777
782
|
*
|
|
778
783
|
* @example With `select()`
|
|
779
784
|
* ```ts
|
|
@@ -883,6 +888,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
883
888
|
* instead
|
|
884
889
|
*
|
|
885
890
|
* @category Database
|
|
891
|
+
* @subcategory Using modifiers
|
|
886
892
|
*
|
|
887
893
|
* @example With `select()`
|
|
888
894
|
* ```ts
|
|
@@ -934,6 +940,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
934
940
|
* @param signal - The AbortSignal to use for the fetch request
|
|
935
941
|
*
|
|
936
942
|
* @category Database
|
|
943
|
+
* @subcategory Using modifiers
|
|
937
944
|
*
|
|
938
945
|
* @remarks
|
|
939
946
|
* You can use this to set a timeout for the request.
|
|
@@ -1004,6 +1011,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1004
1011
|
* returns an error.
|
|
1005
1012
|
*
|
|
1006
1013
|
* @category Database
|
|
1014
|
+
* @subcategory Using modifiers
|
|
1007
1015
|
*
|
|
1008
1016
|
* @example With `select()`
|
|
1009
1017
|
* ```ts
|
|
@@ -1049,6 +1057,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1049
1057
|
* this returns an error.
|
|
1050
1058
|
*
|
|
1051
1059
|
* @category Database
|
|
1060
|
+
* @subcategory Using modifiers
|
|
1052
1061
|
*
|
|
1053
1062
|
* @example With `select()`
|
|
1054
1063
|
* ```ts
|
|
@@ -1088,6 +1097,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1088
1097
|
* Return `data` as a string in CSV format.
|
|
1089
1098
|
*
|
|
1090
1099
|
* @category Database
|
|
1100
|
+
* @subcategory Using modifiers
|
|
1091
1101
|
*
|
|
1092
1102
|
* @exampleDescription Return data as CSV
|
|
1093
1103
|
* By default, the data is returned in JSON format, but can also be returned as Comma Separated Values.
|
|
@@ -1161,6 +1171,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1161
1171
|
* or `"json"`
|
|
1162
1172
|
*
|
|
1163
1173
|
* @category Database
|
|
1174
|
+
* @subcategory Using modifiers
|
|
1164
1175
|
*
|
|
1165
1176
|
* @exampleDescription Get the execution plan
|
|
1166
1177
|
* By default, the data is returned in TEXT format, but can also be returned as JSON by using the `format` parameter.
|
|
@@ -1262,6 +1273,7 @@ var PostgrestTransformBuilder = class extends PostgrestBuilder {
|
|
|
1262
1273
|
* @deprecated Use overrideTypes<yourType, { merge: false }>() method at the end of your call chain instead
|
|
1263
1274
|
*
|
|
1264
1275
|
* @category Database
|
|
1276
|
+
* @subcategory Using modifiers
|
|
1265
1277
|
*
|
|
1266
1278
|
* @remarks
|
|
1267
1279
|
* - Deprecated: use overrideTypes method instead
|
|
@@ -1324,6 +1336,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1324
1336
|
* @param value - The value to filter with
|
|
1325
1337
|
*
|
|
1326
1338
|
* @category Database
|
|
1339
|
+
* @subcategory Using filters
|
|
1327
1340
|
*
|
|
1328
1341
|
* @example With `select()`
|
|
1329
1342
|
* ```ts
|
|
@@ -1371,6 +1384,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1371
1384
|
* @param value - The value to filter with
|
|
1372
1385
|
*
|
|
1373
1386
|
* @category Database
|
|
1387
|
+
* @subcategory Using filters
|
|
1374
1388
|
*
|
|
1375
1389
|
* @example With `select()`
|
|
1376
1390
|
* ```ts
|
|
@@ -1422,6 +1436,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1422
1436
|
* @param value - The value to filter with
|
|
1423
1437
|
*
|
|
1424
1438
|
* @category Database
|
|
1439
|
+
* @subcategory Using filters
|
|
1425
1440
|
*
|
|
1426
1441
|
* @exampleDescription With `select()`
|
|
1427
1442
|
* When using [reserved words](https://www.postgresql.org/docs/current/sql-keywords-appendix.html) for column names you need
|
|
@@ -1473,6 +1488,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1473
1488
|
* @param value - The value to filter with
|
|
1474
1489
|
*
|
|
1475
1490
|
* @category Database
|
|
1491
|
+
* @subcategory Using filters
|
|
1476
1492
|
*
|
|
1477
1493
|
* @example With `select()`
|
|
1478
1494
|
* ```ts
|
|
@@ -1524,6 +1540,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1524
1540
|
* @param value - The value to filter with
|
|
1525
1541
|
*
|
|
1526
1542
|
* @category Database
|
|
1543
|
+
* @subcategory Using filters
|
|
1527
1544
|
*
|
|
1528
1545
|
* @example With `select()`
|
|
1529
1546
|
* ```ts
|
|
@@ -1571,6 +1588,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1571
1588
|
* @param value - The value to filter with
|
|
1572
1589
|
*
|
|
1573
1590
|
* @category Database
|
|
1591
|
+
* @subcategory Using filters
|
|
1574
1592
|
*
|
|
1575
1593
|
* @example With `select()`
|
|
1576
1594
|
* ```ts
|
|
@@ -1622,6 +1640,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1622
1640
|
* @param pattern - The pattern to match with
|
|
1623
1641
|
*
|
|
1624
1642
|
* @category Database
|
|
1643
|
+
* @subcategory Using filters
|
|
1625
1644
|
*
|
|
1626
1645
|
* @example With `select()`
|
|
1627
1646
|
* ```ts
|
|
@@ -1669,6 +1688,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1669
1688
|
* @param patterns - The patterns to match with
|
|
1670
1689
|
*
|
|
1671
1690
|
* @category Database
|
|
1691
|
+
* @subcategory Using filters
|
|
1672
1692
|
*/
|
|
1673
1693
|
likeAllOf(column, patterns) {
|
|
1674
1694
|
this.url.searchParams.append(column, `like(all).{${patterns.join(",")}}`);
|
|
@@ -1681,6 +1701,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1681
1701
|
* @param patterns - The patterns to match with
|
|
1682
1702
|
*
|
|
1683
1703
|
* @category Database
|
|
1704
|
+
* @subcategory Using filters
|
|
1684
1705
|
*/
|
|
1685
1706
|
likeAnyOf(column, patterns) {
|
|
1686
1707
|
this.url.searchParams.append(column, `like(any).{${patterns.join(",")}}`);
|
|
@@ -1693,6 +1714,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1693
1714
|
* @param pattern - The pattern to match with
|
|
1694
1715
|
*
|
|
1695
1716
|
* @category Database
|
|
1717
|
+
* @subcategory Using filters
|
|
1696
1718
|
*
|
|
1697
1719
|
* @example With `select()`
|
|
1698
1720
|
* ```ts
|
|
@@ -1740,6 +1762,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1740
1762
|
* @param patterns - The patterns to match with
|
|
1741
1763
|
*
|
|
1742
1764
|
* @category Database
|
|
1765
|
+
* @subcategory Using filters
|
|
1743
1766
|
*/
|
|
1744
1767
|
ilikeAllOf(column, patterns) {
|
|
1745
1768
|
this.url.searchParams.append(column, `ilike(all).{${patterns.join(",")}}`);
|
|
@@ -1752,6 +1775,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1752
1775
|
* @param patterns - The patterns to match with
|
|
1753
1776
|
*
|
|
1754
1777
|
* @category Database
|
|
1778
|
+
* @subcategory Using filters
|
|
1755
1779
|
*/
|
|
1756
1780
|
ilikeAnyOf(column, patterns) {
|
|
1757
1781
|
this.url.searchParams.append(column, `ilike(any).{${patterns.join(",")}}`);
|
|
@@ -1792,6 +1816,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1792
1816
|
* @param value - The value to filter with
|
|
1793
1817
|
*
|
|
1794
1818
|
* @category Database
|
|
1819
|
+
* @subcategory Using filters
|
|
1795
1820
|
*
|
|
1796
1821
|
* @exampleDescription Checking for nullness, true or false
|
|
1797
1822
|
* Using the `eq()` filter doesn't work when filtering for `null`.
|
|
@@ -1857,6 +1882,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1857
1882
|
* @param values - The values array to filter with
|
|
1858
1883
|
*
|
|
1859
1884
|
* @category Database
|
|
1885
|
+
* @subcategory Using filters
|
|
1860
1886
|
*
|
|
1861
1887
|
* @example With `select()`
|
|
1862
1888
|
* ```ts
|
|
@@ -1927,6 +1953,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
1927
1953
|
* @param value - The jsonb, array, or range value to filter with
|
|
1928
1954
|
*
|
|
1929
1955
|
* @category Database
|
|
1956
|
+
* @subcategory Using filters
|
|
1930
1957
|
*
|
|
1931
1958
|
* @example On array columns
|
|
1932
1959
|
* ```ts
|
|
@@ -2061,6 +2088,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2061
2088
|
* @param value - The jsonb, array, or range value to filter with
|
|
2062
2089
|
*
|
|
2063
2090
|
* @category Database
|
|
2091
|
+
* @subcategory Using filters
|
|
2064
2092
|
*
|
|
2065
2093
|
* @example On array columns
|
|
2066
2094
|
* ```ts
|
|
@@ -2196,6 +2224,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2196
2224
|
* @param range - The range to filter with
|
|
2197
2225
|
*
|
|
2198
2226
|
* @category Database
|
|
2227
|
+
* @subcategory Using filters
|
|
2199
2228
|
*
|
|
2200
2229
|
* @exampleDescription With `select()`
|
|
2201
2230
|
* Postgres supports a number of [range
|
|
@@ -2256,6 +2285,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2256
2285
|
* @param range - The range to filter with
|
|
2257
2286
|
*
|
|
2258
2287
|
* @category Database
|
|
2288
|
+
* @subcategory Using filters
|
|
2259
2289
|
*
|
|
2260
2290
|
* @exampleDescription With `select()`
|
|
2261
2291
|
* Postgres supports a number of [range
|
|
@@ -2315,6 +2345,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2315
2345
|
* @param range - The range to filter with
|
|
2316
2346
|
*
|
|
2317
2347
|
* @category Database
|
|
2348
|
+
* @subcategory Using filters
|
|
2318
2349
|
*
|
|
2319
2350
|
* @exampleDescription With `select()`
|
|
2320
2351
|
* Postgres supports a number of [range
|
|
@@ -2374,6 +2405,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2374
2405
|
* @param range - The range to filter with
|
|
2375
2406
|
*
|
|
2376
2407
|
* @category Database
|
|
2408
|
+
* @subcategory Using filters
|
|
2377
2409
|
*
|
|
2378
2410
|
* @exampleDescription With `select()`
|
|
2379
2411
|
* Postgres supports a number of [range
|
|
@@ -2434,6 +2466,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2434
2466
|
* @param range - The range to filter with
|
|
2435
2467
|
*
|
|
2436
2468
|
* @category Database
|
|
2469
|
+
* @subcategory Using filters
|
|
2437
2470
|
*
|
|
2438
2471
|
* @exampleDescription With `select()`
|
|
2439
2472
|
* Postgres supports a number of [range
|
|
@@ -2492,6 +2525,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2492
2525
|
* @param value - The array or range value to filter with
|
|
2493
2526
|
*
|
|
2494
2527
|
* @category Database
|
|
2528
|
+
* @subcategory Using filters
|
|
2495
2529
|
*
|
|
2496
2530
|
* @example On array columns
|
|
2497
2531
|
* ```ts
|
|
@@ -2591,6 +2625,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2591
2625
|
* @param options.type - Change how the `query` text is interpreted
|
|
2592
2626
|
*
|
|
2593
2627
|
* @category Database
|
|
2628
|
+
* @subcategory Using filters
|
|
2594
2629
|
*
|
|
2595
2630
|
* @remarks
|
|
2596
2631
|
* - For more information, see [Postgres full text search](/docs/guides/database/full-text-search).
|
|
@@ -2700,6 +2735,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2700
2735
|
* to their filter values
|
|
2701
2736
|
*
|
|
2702
2737
|
* @category Database
|
|
2738
|
+
* @subcategory Using filters
|
|
2703
2739
|
*
|
|
2704
2740
|
* @example With `select()`
|
|
2705
2741
|
* ```ts
|
|
@@ -2755,6 +2791,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2755
2791
|
* @param value - The value to filter with, following PostgREST syntax
|
|
2756
2792
|
*
|
|
2757
2793
|
* @category Database
|
|
2794
|
+
* @subcategory Using filters
|
|
2758
2795
|
*
|
|
2759
2796
|
* @remarks
|
|
2760
2797
|
* not() expects you to use the raw PostgREST syntax for the filter values.
|
|
@@ -2819,6 +2856,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2819
2856
|
* @param options.foreignTable - Deprecated, use `referencedTable` instead
|
|
2820
2857
|
*
|
|
2821
2858
|
* @category Database
|
|
2859
|
+
* @subcategory Using filters
|
|
2822
2860
|
*
|
|
2823
2861
|
* @remarks
|
|
2824
2862
|
* or() expects you to use the raw PostgREST syntax for the filter names and values.
|
|
@@ -2972,6 +3010,7 @@ var PostgrestFilterBuilder = class extends PostgrestTransformBuilder {
|
|
|
2972
3010
|
* @param value - The value to filter with, following PostgREST syntax
|
|
2973
3011
|
*
|
|
2974
3012
|
* @category Database
|
|
3013
|
+
* @subcategory Using filters
|
|
2975
3014
|
*
|
|
2976
3015
|
* @remarks
|
|
2977
3016
|
* filter() expects you to use the raw PostgREST syntax for the filter values.
|