@supabase/postgrest-js 2.103.0-canary.1 → 2.103.0-canary.2

package/dist/index.cjs

@@ -126,7 +126,7 @@ var PostgrestBuilder = class {
 	* ```
 	*/
 	constructor(builder) {
-		var _builder$shouldThrowO, _builder$isMaybeSingl, _builder$urlLengthLim, _builder$retry;
+		var _builder$shouldThrowO, _builder$isMaybeSingl, _builder$shouldStripN, _builder$urlLengthLim, _builder$retry;
 		this.shouldThrowOnError = false;
 		this.retryEnabled = true;
 		this.method = builder.method;
@@ -137,6 +137,7 @@ var PostgrestBuilder = class {
 		this.shouldThrowOnError = (_builder$shouldThrowO = builder.shouldThrowOnError) !== null && _builder$shouldThrowO !== void 0 ? _builder$shouldThrowO : false;
 		this.signal = builder.signal;
 		this.isMaybeSingle = (_builder$isMaybeSingl = builder.isMaybeSingle) !== null && _builder$isMaybeSingl !== void 0 ? _builder$isMaybeSingl : false;
+		this.shouldStripNulls = (_builder$shouldStripN = builder.shouldStripNulls) !== null && _builder$shouldStripN !== void 0 ? _builder$shouldStripN : false;
 		this.urlLengthLimit = (_builder$urlLengthLim = builder.urlLengthLimit) !== null && _builder$urlLengthLim !== void 0 ? _builder$urlLengthLim : 8e3;
 		this.retryEnabled = (_builder$retry = builder.retry) !== null && _builder$retry !== void 0 ? _builder$retry : true;
 		if (builder.fetch) this.fetch = builder.fetch;
@@ -155,6 +156,60 @@ var PostgrestBuilder = class {
 		return this;
 	}
 	/**
+	* Strip null values from the response data. Properties with `null` values
+	* will be omitted from the returned JSON objects.
+	*
+	* Requires PostgREST 11.2.0+.
+	*
+	* {@link https://docs.postgrest.org/en/stable/references/api/resource_representation.html#stripped-nulls}
+	*
+	* @category Database
+	*
+	* @example With `select()`
+	* ```ts
+	* const { data, error } = await supabase
+	*   .from('characters')
+	*   .select()
+	*   .stripNulls()
+	* ```
+	*
+	* @exampleSql With `select()`
+	* ```sql
+	* create table
+	*   characters (id int8 primary key, name text, bio text);
+	*
+	* insert into
+	*   characters (id, name, bio)
+	* values
+	*   (1, 'Luke', null),
+	*   (2, 'Leia', 'Princess of Alderaan');
+	* ```
+	*
+	* @exampleResponse With `select()`
+	* ```json
+	* {
+	*   "data": [
+	*     {
+	*       "id": 1,
+	*       "name": "Luke"
+	*     },
+	*     {
+	*       "id": 2,
+	*       "name": "Leia",
+	*       "bio": "Princess of Alderaan"
+	*     }
+	*   ],
+	*   "status": 200,
+	*   "statusText": "OK"
+	* }
+	* ```
+	*/
+	stripNulls() {
+		if (this.headers.get("Accept") === "text/csv") throw new Error("stripNulls() cannot be used with csv()");
+		this.shouldStripNulls = true;
+		return this;
+	}
+	/**
 	* Set an HTTP header for the request.
 	*
 	* @category Database
@@ -193,6 +248,11 @@ var PostgrestBuilder = class {
 		if (this.schema === void 0) {} else if (["GET", "HEAD"].includes(this.method)) this.headers.set("Accept-Profile", this.schema);
 		else this.headers.set("Content-Profile", this.schema);
 		if (this.method !== "GET" && this.method !== "HEAD") this.headers.set("Content-Type", "application/json");
+		if (this.shouldStripNulls) {
+			const currentAccept = this.headers.get("Accept");
+			if (currentAccept === "application/vnd.pgrst.object+json") this.headers.set("Accept", "application/vnd.pgrst.object+json;nulls=stripped");
+			else if (!currentAccept || currentAccept === "application/json") this.headers.set("Accept", "application/vnd.pgrst.array+json;nulls=stripped");
+		}
 		const _fetch = this.fetch;
 		const executeWithRetry = async () => {
 			let attemptCount = 0;