@supabase/postgrest-js 2.93.3 → 2.93.4-canary.1

package/dist/index.cjs

@@ -46,7 +46,7 @@ var PostgrestBuilder = class {
 	* ```
 	*/
 	constructor(builder) {
-		var _builder$shouldThrowO, _builder$isMaybeSingl;
+		var _builder$shouldThrowO, _builder$isMaybeSingl, _builder$urlLengthLim;
 		this.shouldThrowOnError = false;
 		this.method = builder.method;
 		this.url = builder.url;
@@ -56,6 +56,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.urlLengthLimit = (_builder$urlLengthLim = builder.urlLengthLimit) !== null && _builder$urlLengthLim !== void 0 ? _builder$urlLengthLim : 8e3;
 		if (builder.fetch) this.fetch = builder.fetch;
 		else this.fetch = fetch;
 	}
@@ -154,6 +155,8 @@ var PostgrestBuilder = class {
 		if (!this.shouldThrowOnError) res = res.catch((fetchError) => {
 			var _fetchError$name2;
 			let errorDetails = "";
+			let hint = "";
+			let code = "";
 			const cause = fetchError === null || fetchError === void 0 ? void 0 : fetchError.cause;
 			if (cause) {
 				var _cause$message, _cause$code, _fetchError$name, _cause$name;
@@ -167,12 +170,22 @@ var PostgrestBuilder = class {
 				var _fetchError$stack;
 				errorDetails = (_fetchError$stack = fetchError === null || fetchError === void 0 ? void 0 : fetchError.stack) !== null && _fetchError$stack !== void 0 ? _fetchError$stack : "";
 			}
+			const urlLength = this.url.toString().length;
+			if ((fetchError === null || fetchError === void 0 ? void 0 : fetchError.name) === "AbortError" || (fetchError === null || fetchError === void 0 ? void 0 : fetchError.code) === "ABORT_ERR") {
+				code = "";
+				hint = "Request was aborted (timeout or manual cancellation)";
+				if (urlLength > this.urlLengthLimit) hint += `. Note: Your request URL is ${urlLength} characters, which may exceed server limits. If selecting many fields, consider using views. If filtering with large arrays (e.g., .in('id', [many IDs])), consider using an RPC function to pass values server-side.`;
+			} else if ((cause === null || cause === void 0 ? void 0 : cause.name) === "HeadersOverflowError" || (cause === null || cause === void 0 ? void 0 : cause.code) === "UND_ERR_HEADERS_OVERFLOW") {
+				code = "";
+				hint = "HTTP headers exceeded server limits (typically 16KB)";
+				if (urlLength > this.urlLengthLimit) hint += `. Your request URL is ${urlLength} characters. If selecting many fields, consider using views. If filtering with large arrays (e.g., .in('id', [200+ IDs])), consider using an RPC function instead.`;
+			}
 			return {
 				error: {
 					message: `${(_fetchError$name2 = fetchError === null || fetchError === void 0 ? void 0 : fetchError.name) !== null && _fetchError$name2 !== void 0 ? _fetchError$name2 : "FetchError"}: ${fetchError === null || fetchError === void 0 ? void 0 : fetchError.message}`,
 					details: errorDetails,
-					hint: "",
-					code: ""
+					hint,
+					code
 				},
 				data: null,
 				count: null,
@@ -824,11 +837,12 @@ var PostgrestQueryBuilder = class {
 	* )
 	* ```
 	*/
-	constructor(url, { headers = {}, schema, fetch: fetch$1 }) {
+	constructor(url, { headers = {}, schema, fetch: fetch$1, urlLengthLimit = 8e3 }) {
 		this.url = url;
 		this.headers = new Headers(headers);
 		this.schema = schema;
 		this.fetch = fetch$1;
+		this.urlLengthLimit = urlLengthLimit;
 	}
 	/**
 	* Clone URL and headers to prevent shared state between operations.
@@ -881,7 +895,8 @@ var PostgrestQueryBuilder = class {
 			url,
 			headers,
 			schema: this.schema,
-			fetch: this.fetch
+			fetch: this.fetch,
+			urlLengthLimit: this.urlLengthLimit
 		});
 	}
 	/**
@@ -929,7 +944,8 @@ var PostgrestQueryBuilder = class {
 			headers,
 			schema: this.schema,
 			body: values,
-			fetch: (_this$fetch = this.fetch) !== null && _this$fetch !== void 0 ? _this$fetch : fetch
+			fetch: (_this$fetch = this.fetch) !== null && _this$fetch !== void 0 ? _this$fetch : fetch,
+			urlLengthLimit: this.urlLengthLimit
 		});
 	}
 	/**
@@ -1038,7 +1054,8 @@ var PostgrestQueryBuilder = class {
 			headers,
 			schema: this.schema,
 			body: values,
-			fetch: (_this$fetch2 = this.fetch) !== null && _this$fetch2 !== void 0 ? _this$fetch2 : fetch
+			fetch: (_this$fetch2 = this.fetch) !== null && _this$fetch2 !== void 0 ? _this$fetch2 : fetch,
+			urlLengthLimit: this.urlLengthLimit
 		});
 	}
 	/**
@@ -1073,7 +1090,8 @@ var PostgrestQueryBuilder = class {
 			headers,
 			schema: this.schema,
 			body: values,
-			fetch: (_this$fetch3 = this.fetch) !== null && _this$fetch3 !== void 0 ? _this$fetch3 : fetch
+			fetch: (_this$fetch3 = this.fetch) !== null && _this$fetch3 !== void 0 ? _this$fetch3 : fetch,
+			urlLengthLimit: this.urlLengthLimit
 		});
 	}
 	/**
@@ -1105,11 +1123,78 @@ var PostgrestQueryBuilder = class {
 			url,
 			headers,
 			schema: this.schema,
-			fetch: (_this$fetch4 = this.fetch) !== null && _this$fetch4 !== void 0 ? _this$fetch4 : fetch
+			fetch: (_this$fetch4 = this.fetch) !== null && _this$fetch4 !== void 0 ? _this$fetch4 : fetch,
+			urlLengthLimit: this.urlLengthLimit
 		});
 	}
 };
 
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
+		return typeof o$1;
+	} : function(o$1) {
+		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r$1) {
+			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
+			_defineProperty(e, r$1, t[r$1]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
+			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
+		});
+	}
+	return e;
+}
+
 //#endregion
 //#region src/PostgrestClient.ts
 /**
@@ -1131,6 +1216,8 @@ var PostgrestClient = class PostgrestClient {
 	* @param options.headers - Custom headers
 	* @param options.schema - Postgres schema to switch to
 	* @param options.fetch - Custom fetch
+	* @param options.timeout - Optional timeout in milliseconds for all requests. When set, requests will automatically abort after this duration to prevent indefinite hangs.
+	* @param options.urlLengthLimit - Maximum URL length in characters before warnings/errors are triggered. Defaults to 8000.
 	* @example
 	* ```ts
 	* import PostgrestClient from '@supabase/postgrest-js'
@@ -1138,14 +1225,38 @@ var PostgrestClient = class PostgrestClient {
 	* const postgrest = new PostgrestClient('https://xyzcompany.supabase.co/rest/v1', {
 	*   headers: { apikey: 'public-anon-key' },
 	*   schema: 'public',
+	*   timeout: 30000, // 30 second timeout
 	* })
 	* ```
 	*/
-	constructor(url, { headers = {}, schema, fetch: fetch$1 } = {}) {
+	constructor(url, { headers = {}, schema, fetch: fetch$1, timeout, urlLengthLimit = 8e3 } = {}) {
 		this.url = url;
 		this.headers = new Headers(headers);
 		this.schemaName = schema;
-		this.fetch = fetch$1;
+		this.urlLengthLimit = urlLengthLimit;
+		const originalFetch = fetch$1 !== null && fetch$1 !== void 0 ? fetch$1 : globalThis.fetch;
+		if (timeout !== void 0 && timeout > 0) this.fetch = (input, init) => {
+			const controller = new AbortController();
+			const timeoutId = setTimeout(() => controller.abort(), timeout);
+			const existingSignal = init === null || init === void 0 ? void 0 : init.signal;
+			if (existingSignal) {
+				if (existingSignal.aborted) {
+					clearTimeout(timeoutId);
+					return originalFetch(input, init);
+				}
+				const abortHandler = () => {
+					clearTimeout(timeoutId);
+					controller.abort();
+				};
+				existingSignal.addEventListener("abort", abortHandler, { once: true });
+				return originalFetch(input, _objectSpread2(_objectSpread2({}, init), {}, { signal: controller.signal })).finally(() => {
+					clearTimeout(timeoutId);
+					existingSignal.removeEventListener("abort", abortHandler);
+				});
+			}
+			return originalFetch(input, _objectSpread2(_objectSpread2({}, init), {}, { signal: controller.signal })).finally(() => clearTimeout(timeoutId));
+		};
+		else this.fetch = originalFetch;
 	}
 	/**
 	* Perform a query on a table or a view.
@@ -1157,7 +1268,8 @@ var PostgrestClient = class PostgrestClient {
 		return new PostgrestQueryBuilder(new URL(`${this.url}/${relation}`), {
 			headers: new Headers(this.headers),
 			schema: this.schemaName,
-			fetch: this.fetch
+			fetch: this.fetch,
+			urlLengthLimit: this.urlLengthLimit
 		});
 	}
 	/**
@@ -1171,7 +1283,8 @@ var PostgrestClient = class PostgrestClient {
 		return new PostgrestClient(this.url, {
 			headers: this.headers,
 			schema,
-			fetch: this.fetch
+			fetch: this.fetch,
+			urlLengthLimit: this.urlLengthLimit
 		});
 	}
 	/**
@@ -1234,7 +1347,8 @@ var PostgrestClient = class PostgrestClient {
 			headers,
 			schema: this.schemaName,
 			body,
-			fetch: (_this$fetch = this.fetch) !== null && _this$fetch !== void 0 ? _this$fetch : fetch
+			fetch: (_this$fetch = this.fetch) !== null && _this$fetch !== void 0 ? _this$fetch : fetch,
+			urlLengthLimit: this.urlLengthLimit
 		});
 	}
 };