@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/package.json
CHANGED
package/src/PostgrestBuilder.ts
CHANGED
|
@@ -168,6 +168,7 @@ export default abstract class PostgrestBuilder<
|
|
|
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
|
|
@@ -589,6 +590,7 @@ export default abstract class PostgrestBuilder<
|
|
|
589
590
|
* @returns A PostgrestBuilder instance with the new type
|
|
590
591
|
*
|
|
591
592
|
* @category Database
|
|
593
|
+
* @subcategory Using modifiers
|
|
592
594
|
*
|
|
593
595
|
* @example Complete Override type of successful response
|
|
594
596
|
* ```ts
|
|
@@ -644,7 +646,7 @@ export default abstract class PostgrestBuilder<
|
|
|
644
646
|
* let x: typeof data // CountryRowProperties & { status: "A" | "B" } | null
|
|
645
647
|
* ```
|
|
646
648
|
*
|
|
647
|
-
* @example
|
|
649
|
+
* @example Merge vs replace existing types
|
|
648
650
|
* ```typescript
|
|
649
651
|
* // Merge with existing types (default behavior)
|
|
650
652
|
* const query = supabase
|
|
@@ -118,6 +118,7 @@ export default class PostgrestFilterBuilder<
|
|
|
118
118
|
* @param value - The value to filter with
|
|
119
119
|
*
|
|
120
120
|
* @category Database
|
|
121
|
+
* @subcategory Using filters
|
|
121
122
|
*
|
|
122
123
|
* @example With `select()`
|
|
123
124
|
* ```ts
|
|
@@ -179,6 +180,7 @@ export default class PostgrestFilterBuilder<
|
|
|
179
180
|
* @param value - The value to filter with
|
|
180
181
|
*
|
|
181
182
|
* @category Database
|
|
183
|
+
* @subcategory Using filters
|
|
182
184
|
*
|
|
183
185
|
* @example With `select()`
|
|
184
186
|
* ```ts
|
|
@@ -246,6 +248,7 @@ export default class PostgrestFilterBuilder<
|
|
|
246
248
|
* @param value - The value to filter with
|
|
247
249
|
*
|
|
248
250
|
* @category Database
|
|
251
|
+
* @subcategory Using filters
|
|
249
252
|
*
|
|
250
253
|
* @exampleDescription With `select()`
|
|
251
254
|
* When using [reserved words](https://www.postgresql.org/docs/current/sql-keywords-appendix.html) for column names you need
|
|
@@ -300,6 +303,7 @@ export default class PostgrestFilterBuilder<
|
|
|
300
303
|
* @param value - The value to filter with
|
|
301
304
|
*
|
|
302
305
|
* @category Database
|
|
306
|
+
* @subcategory Using filters
|
|
303
307
|
*
|
|
304
308
|
* @example With `select()`
|
|
305
309
|
* ```ts
|
|
@@ -354,6 +358,7 @@ export default class PostgrestFilterBuilder<
|
|
|
354
358
|
* @param value - The value to filter with
|
|
355
359
|
*
|
|
356
360
|
* @category Database
|
|
361
|
+
* @subcategory Using filters
|
|
357
362
|
*
|
|
358
363
|
* @example With `select()`
|
|
359
364
|
* ```ts
|
|
@@ -404,6 +409,7 @@ export default class PostgrestFilterBuilder<
|
|
|
404
409
|
* @param value - The value to filter with
|
|
405
410
|
*
|
|
406
411
|
* @category Database
|
|
412
|
+
* @subcategory Using filters
|
|
407
413
|
*
|
|
408
414
|
* @example With `select()`
|
|
409
415
|
* ```ts
|
|
@@ -458,6 +464,7 @@ export default class PostgrestFilterBuilder<
|
|
|
458
464
|
* @param pattern - The pattern to match with
|
|
459
465
|
*
|
|
460
466
|
* @category Database
|
|
467
|
+
* @subcategory Using filters
|
|
461
468
|
*
|
|
462
469
|
* @example With `select()`
|
|
463
470
|
* ```ts
|
|
@@ -511,6 +518,7 @@ export default class PostgrestFilterBuilder<
|
|
|
511
518
|
* @param patterns - The patterns to match with
|
|
512
519
|
*
|
|
513
520
|
* @category Database
|
|
521
|
+
* @subcategory Using filters
|
|
514
522
|
*/
|
|
515
523
|
likeAllOf(column: string, patterns: readonly string[]): this {
|
|
516
524
|
this.url.searchParams.append(column, `like(all).{${patterns.join(',')}}`)
|
|
@@ -529,6 +537,7 @@ export default class PostgrestFilterBuilder<
|
|
|
529
537
|
* @param patterns - The patterns to match with
|
|
530
538
|
*
|
|
531
539
|
* @category Database
|
|
540
|
+
* @subcategory Using filters
|
|
532
541
|
*/
|
|
533
542
|
likeAnyOf(column: string, patterns: readonly string[]): this {
|
|
534
543
|
this.url.searchParams.append(column, `like(any).{${patterns.join(',')}}`)
|
|
@@ -544,6 +553,7 @@ export default class PostgrestFilterBuilder<
|
|
|
544
553
|
* @param pattern - The pattern to match with
|
|
545
554
|
*
|
|
546
555
|
* @category Database
|
|
556
|
+
* @subcategory Using filters
|
|
547
557
|
*
|
|
548
558
|
* @example With `select()`
|
|
549
559
|
* ```ts
|
|
@@ -597,6 +607,7 @@ export default class PostgrestFilterBuilder<
|
|
|
597
607
|
* @param patterns - The patterns to match with
|
|
598
608
|
*
|
|
599
609
|
* @category Database
|
|
610
|
+
* @subcategory Using filters
|
|
600
611
|
*/
|
|
601
612
|
ilikeAllOf(column: string, patterns: readonly string[]): this {
|
|
602
613
|
this.url.searchParams.append(column, `ilike(all).{${patterns.join(',')}}`)
|
|
@@ -615,6 +626,7 @@ export default class PostgrestFilterBuilder<
|
|
|
615
626
|
* @param patterns - The patterns to match with
|
|
616
627
|
*
|
|
617
628
|
* @category Database
|
|
629
|
+
* @subcategory Using filters
|
|
618
630
|
*/
|
|
619
631
|
ilikeAnyOf(column: string, patterns: readonly string[]): this {
|
|
620
632
|
this.url.searchParams.append(column, `ilike(any).{${patterns.join(',')}}`)
|
|
@@ -667,6 +679,7 @@ export default class PostgrestFilterBuilder<
|
|
|
667
679
|
* @param value - The value to filter with
|
|
668
680
|
*
|
|
669
681
|
* @category Database
|
|
682
|
+
* @subcategory Using filters
|
|
670
683
|
*
|
|
671
684
|
* @exampleDescription Checking for nullness, true or false
|
|
672
685
|
* Using the `eq()` filter doesn't work when filtering for `null`.
|
|
@@ -741,6 +754,7 @@ export default class PostgrestFilterBuilder<
|
|
|
741
754
|
* @param values - The values array to filter with
|
|
742
755
|
*
|
|
743
756
|
* @category Database
|
|
757
|
+
* @subcategory Using filters
|
|
744
758
|
*
|
|
745
759
|
* @example With `select()`
|
|
746
760
|
* ```ts
|
|
@@ -847,6 +861,7 @@ export default class PostgrestFilterBuilder<
|
|
|
847
861
|
* @param value - The jsonb, array, or range value to filter with
|
|
848
862
|
*
|
|
849
863
|
* @category Database
|
|
864
|
+
* @subcategory Using filters
|
|
850
865
|
*
|
|
851
866
|
* @example On array columns
|
|
852
867
|
* ```ts
|
|
@@ -995,6 +1010,7 @@ export default class PostgrestFilterBuilder<
|
|
|
995
1010
|
* @param value - The jsonb, array, or range value to filter with
|
|
996
1011
|
*
|
|
997
1012
|
* @category Database
|
|
1013
|
+
* @subcategory Using filters
|
|
998
1014
|
*
|
|
999
1015
|
* @example On array columns
|
|
1000
1016
|
* ```ts
|
|
@@ -1140,6 +1156,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1140
1156
|
* @param range - The range to filter with
|
|
1141
1157
|
*
|
|
1142
1158
|
* @category Database
|
|
1159
|
+
* @subcategory Using filters
|
|
1143
1160
|
*
|
|
1144
1161
|
* @exampleDescription With `select()`
|
|
1145
1162
|
* Postgres supports a number of [range
|
|
@@ -1203,6 +1220,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1203
1220
|
* @param range - The range to filter with
|
|
1204
1221
|
*
|
|
1205
1222
|
* @category Database
|
|
1223
|
+
* @subcategory Using filters
|
|
1206
1224
|
*
|
|
1207
1225
|
* @exampleDescription With `select()`
|
|
1208
1226
|
* Postgres supports a number of [range
|
|
@@ -1265,6 +1283,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1265
1283
|
* @param range - The range to filter with
|
|
1266
1284
|
*
|
|
1267
1285
|
* @category Database
|
|
1286
|
+
* @subcategory Using filters
|
|
1268
1287
|
*
|
|
1269
1288
|
* @exampleDescription With `select()`
|
|
1270
1289
|
* Postgres supports a number of [range
|
|
@@ -1327,6 +1346,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1327
1346
|
* @param range - The range to filter with
|
|
1328
1347
|
*
|
|
1329
1348
|
* @category Database
|
|
1349
|
+
* @subcategory Using filters
|
|
1330
1350
|
*
|
|
1331
1351
|
* @exampleDescription With `select()`
|
|
1332
1352
|
* Postgres supports a number of [range
|
|
@@ -1390,6 +1410,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1390
1410
|
* @param range - The range to filter with
|
|
1391
1411
|
*
|
|
1392
1412
|
* @category Database
|
|
1413
|
+
* @subcategory Using filters
|
|
1393
1414
|
*
|
|
1394
1415
|
* @exampleDescription With `select()`
|
|
1395
1416
|
* Postgres supports a number of [range
|
|
@@ -1454,6 +1475,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1454
1475
|
* @param value - The array or range value to filter with
|
|
1455
1476
|
*
|
|
1456
1477
|
* @category Database
|
|
1478
|
+
* @subcategory Using filters
|
|
1457
1479
|
*
|
|
1458
1480
|
* @example On array columns
|
|
1459
1481
|
* ```ts
|
|
@@ -1569,6 +1591,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1569
1591
|
* @param options.type - Change how the `query` text is interpreted
|
|
1570
1592
|
*
|
|
1571
1593
|
* @category Database
|
|
1594
|
+
* @subcategory Using filters
|
|
1572
1595
|
*
|
|
1573
1596
|
* @remarks
|
|
1574
1597
|
* - For more information, see [Postgres full text search](/docs/guides/database/full-text-search).
|
|
@@ -1689,6 +1712,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1689
1712
|
* to their filter values
|
|
1690
1713
|
*
|
|
1691
1714
|
* @category Database
|
|
1715
|
+
* @subcategory Using filters
|
|
1692
1716
|
*
|
|
1693
1717
|
* @example With `select()`
|
|
1694
1718
|
* ```ts
|
|
@@ -1769,6 +1793,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1769
1793
|
* @param value - The value to filter with, following PostgREST syntax
|
|
1770
1794
|
*
|
|
1771
1795
|
* @category Database
|
|
1796
|
+
* @subcategory Using filters
|
|
1772
1797
|
*
|
|
1773
1798
|
* @remarks
|
|
1774
1799
|
* not() expects you to use the raw PostgREST syntax for the filter values.
|
|
@@ -1839,6 +1864,7 @@ export default class PostgrestFilterBuilder<
|
|
|
1839
1864
|
* @param options.foreignTable - Deprecated, use `referencedTable` instead
|
|
1840
1865
|
*
|
|
1841
1866
|
* @category Database
|
|
1867
|
+
* @subcategory Using filters
|
|
1842
1868
|
*
|
|
1843
1869
|
* @remarks
|
|
1844
1870
|
* or() expects you to use the raw PostgREST syntax for the filter names and values.
|
|
@@ -2005,6 +2031,7 @@ export default class PostgrestFilterBuilder<
|
|
|
2005
2031
|
* @param value - The value to filter with, following PostgREST syntax
|
|
2006
2032
|
*
|
|
2007
2033
|
* @category Database
|
|
2034
|
+
* @subcategory Using filters
|
|
2008
2035
|
*
|
|
2009
2036
|
* @remarks
|
|
2010
2037
|
* filter() expects you to use the raw PostgREST syntax for the filter values.
|
|
@@ -24,6 +24,7 @@ export default class PostgrestTransformBuilder<
|
|
|
24
24
|
* @param columns - The columns to retrieve, separated by commas
|
|
25
25
|
*
|
|
26
26
|
* @category Database
|
|
27
|
+
* @subcategory Using modifiers
|
|
27
28
|
*
|
|
28
29
|
* @example With `upsert()`
|
|
29
30
|
* ```ts
|
|
@@ -148,6 +149,7 @@ export default class PostgrestTransformBuilder<
|
|
|
148
149
|
* instead
|
|
149
150
|
*
|
|
150
151
|
* @category Database
|
|
152
|
+
* @subcategory Using modifiers
|
|
151
153
|
*
|
|
152
154
|
* @example With `select()`
|
|
153
155
|
* ```ts
|
|
@@ -354,6 +356,7 @@ export default class PostgrestTransformBuilder<
|
|
|
354
356
|
* instead
|
|
355
357
|
*
|
|
356
358
|
* @category Database
|
|
359
|
+
* @subcategory Using modifiers
|
|
357
360
|
*
|
|
358
361
|
* @example With `select()`
|
|
359
362
|
* ```ts
|
|
@@ -470,6 +473,7 @@ export default class PostgrestTransformBuilder<
|
|
|
470
473
|
* instead
|
|
471
474
|
*
|
|
472
475
|
* @category Database
|
|
476
|
+
* @subcategory Using modifiers
|
|
473
477
|
*
|
|
474
478
|
* @example With `select()`
|
|
475
479
|
* ```ts
|
|
@@ -531,6 +535,7 @@ export default class PostgrestTransformBuilder<
|
|
|
531
535
|
* @param signal - The AbortSignal to use for the fetch request
|
|
532
536
|
*
|
|
533
537
|
* @category Database
|
|
538
|
+
* @subcategory Using modifiers
|
|
534
539
|
*
|
|
535
540
|
* @remarks
|
|
536
541
|
* You can use this to set a timeout for the request.
|
|
@@ -602,6 +607,7 @@ export default class PostgrestTransformBuilder<
|
|
|
602
607
|
* returns an error.
|
|
603
608
|
*
|
|
604
609
|
* @category Database
|
|
610
|
+
* @subcategory Using modifiers
|
|
605
611
|
*
|
|
606
612
|
* @example With `select()`
|
|
607
613
|
* ```ts
|
|
@@ -651,6 +657,7 @@ export default class PostgrestTransformBuilder<
|
|
|
651
657
|
* this returns an error.
|
|
652
658
|
*
|
|
653
659
|
* @category Database
|
|
660
|
+
* @subcategory Using modifiers
|
|
654
661
|
*
|
|
655
662
|
* @example With `select()`
|
|
656
663
|
* ```ts
|
|
@@ -695,6 +702,7 @@ export default class PostgrestTransformBuilder<
|
|
|
695
702
|
* Return `data` as a string in CSV format.
|
|
696
703
|
*
|
|
697
704
|
* @category Database
|
|
705
|
+
* @subcategory Using modifiers
|
|
698
706
|
*
|
|
699
707
|
* @exampleDescription Return data as CSV
|
|
700
708
|
* By default, the data is returned in JSON format, but can also be returned as Comma Separated Values.
|
|
@@ -770,6 +778,7 @@ export default class PostgrestTransformBuilder<
|
|
|
770
778
|
* or `"json"`
|
|
771
779
|
*
|
|
772
780
|
* @category Database
|
|
781
|
+
* @subcategory Using modifiers
|
|
773
782
|
*
|
|
774
783
|
* @exampleDescription Get the execution plan
|
|
775
784
|
* By default, the data is returned in TEXT format, but can also be returned as JSON by using the `format` parameter.
|
|
@@ -895,6 +904,7 @@ export default class PostgrestTransformBuilder<
|
|
|
895
904
|
* @deprecated Use overrideTypes<yourType, { merge: false }>() method at the end of your call chain instead
|
|
896
905
|
*
|
|
897
906
|
* @category Database
|
|
907
|
+
* @subcategory Using modifiers
|
|
898
908
|
*
|
|
899
909
|
* @remarks
|
|
900
910
|
* - Deprecated: use overrideTypes method instead
|
package/src/version.ts
CHANGED
|
@@ -4,4 +4,4 @@
|
|
|
4
4
|
// - Debugging and support (identifying which version is running)
|
|
5
5
|
// - Telemetry and logging (version reporting in errors/analytics)
|
|
6
6
|
// - Ensuring build artifacts match the published package version
|
|
7
|
-
export const version = '3.0.0-next.
|
|
7
|
+
export const version = '3.0.0-next.22'
|