@bagelink/sdk 1.9.164 → 1.9.168

package/dist/index.cjs

@@ -1457,12 +1457,14 @@ class ApiResponse extends Array {
   /** Raw axios response */
   $raw;
   /** Total number of items (from x-total-count header) */
-  totalCount;
-  /** Current page number (from x-page header) */
+  total;
+  /** Number of items per page (from x-limit header) */
+  limit;
+  /** Number of items skipped (from x-offset header) */
+  offset;
+  /** Current page number (calculated: Math.floor(offset / limit) + 1) */
   page;
-  /** Items per page (from x-per-page header) */
-  perPage;
-  /** Total number of pages (calculated) */
+  /** Total number of pages (calculated: Math.ceil(total / limit)) */
   totalPages;
   /** Rate limit remaining (from x-ratelimit-remaining header) */
   rateLimit;
@@ -1477,9 +1479,10 @@ class ApiResponse extends Array {
       if (response) {
         this.$raw = response;
         this.$metadata = ApiResponse.parseMetadataStatic(response);
-        this.totalCount = this.$metadata.totalCount;
+        this.total = this.$metadata.total;
+        this.limit = this.$metadata.limit;
+        this.offset = this.$metadata.offset;
         this.page = this.$metadata.page;
-        this.perPage = this.$metadata.perPage;
         this.totalPages = this.$metadata.totalPages;
         this.rateLimit = this.$metadata.rateLimit;
         this.rateLimitReset = this.$metadata.rateLimitReset;
@@ -1495,16 +1498,17 @@ class ApiResponse extends Array {
       const obj = Object.assign(/* @__PURE__ */ Object.create(null), data);
       obj.$raw = response;
       obj.$metadata = ApiResponse.parseMetadataStatic(response);
-      obj.totalCount = obj.$metadata.totalCount;
+      obj.total = obj.$metadata.total;
+      obj.limit = obj.$metadata.limit;
+      obj.offset = obj.$metadata.offset;
       obj.page = obj.$metadata.page;
-      obj.perPage = obj.$metadata.perPage;
       obj.totalPages = obj.$metadata.totalPages;
       obj.rateLimit = obj.$metadata.rateLimit;
       obj.rateLimitReset = obj.$metadata.rateLimitReset;
       obj.getHeader = (name) => response?.headers[name.toLowerCase()];
-      obj.hasPagination = obj.totalCount !== void 0 || obj.page !== void 0;
-      obj.hasNextPage = obj.page && obj.totalPages ? obj.page < obj.totalPages : false;
-      obj.hasPrevPage = obj.page ? obj.page > 1 : false;
+      obj.hasPagination = obj.total !== void 0 || obj.offset !== void 0;
+      obj.hasNextPage = obj.total !== void 0 && obj.limit !== void 0 && obj.offset !== void 0 ? obj.offset + obj.limit < obj.total : false;
+      obj.hasPrevPage = obj.offset !== void 0 ? obj.offset > 0 : false;
       return obj;
     }
     const instance = new ApiResponse(data, response);
@@ -1514,16 +1518,19 @@ class ApiResponse extends Array {
     const { headers } = response;
     const metadata = {};
     if (headers["x-total-count"]) {
-      metadata.totalCount = Number(headers["x-total-count"]);
+      metadata.total = Number(headers["x-total-count"]);
     }
-    if (headers["x-page"]) {
-      metadata.page = Number(headers["x-page"]);
+    if (headers["x-limit"]) {
+      metadata.limit = Number(headers["x-limit"]);
     }
-    if (headers["x-per-page"]) {
-      metadata.perPage = Number(headers["x-per-page"]);
+    if (headers["x-offset"]) {
+      metadata.offset = Number(headers["x-offset"]);
     }
-    if (metadata.totalCount && metadata.perPage) {
-      metadata.totalPages = Math.ceil(metadata.totalCount / metadata.perPage);
+    if (metadata.total !== void 0 && metadata.limit) {
+      metadata.totalPages = Math.ceil(metadata.total / metadata.limit);
+    }
+    if (metadata.offset !== void 0 && metadata.limit) {
+      metadata.page = Math.floor(metadata.offset / metadata.limit) + 1;
     }
     if (headers["x-ratelimit-remaining"] || headers["x-rate-limit-remaining"]) {
       metadata.rateLimit = Number(
@@ -1546,15 +1553,15 @@ class ApiResponse extends Array {
     return this.$raw.headers[name.toLowerCase()];
   }
   get hasPagination() {
-    return this.totalCount !== void 0 || this.page !== void 0;
+    return this.total !== void 0 || this.offset !== void 0;
   }
   get hasNextPage() {
-    if (!this.page || !this.totalPages) return false;
-    return this.page < this.totalPages;
+    if (this.total === void 0 || this.limit === void 0 || this.offset === void 0) return false;
+    return this.offset + this.limit < this.total;
   }
   get hasPrevPage() {
-    if (!this.page) return false;
-    return this.page > 1;
+    if (this.offset === void 0) return false;
+    return this.offset > 0;
   }
 }
 function parseApiError(error) {

package/dist/index.d.cts

@@ -529,12 +529,14 @@ declare function formatAPIErrorMessage(err: unknown): string;
  */
 interface ResponseMetadata {
     /** Total number of items (from x-total-count header) */
-    totalCount?: number;
-    /** Current page number (from x-page header) */
+    total?: number;
+    /** Number of items per page (from x-limit header) */
+    limit?: number;
+    /** Number of items skipped (from x-offset header) */
+    offset?: number;
+    /** Current page number (calculated: Math.floor(offset / limit) + 1) */
     page?: number;
-    /** Items per page (from x-per-page header) */
-    perPage?: number;
-    /** Total number of pages */
+    /** Total number of pages (calculated: Math.ceil(total / limit)) */
     totalPages?: number;
     /** Rate limit remaining (from x-rate-limit-remaining header) */
     rateLimit?: number;
@@ -558,12 +560,14 @@ declare class ApiResponse<TData = any> extends Array<TData extends Array<infer U
     /** Raw axios response */
     $raw: AxiosResponse<TData>;
     /** Total number of items (from x-total-count header) */
-    totalCount?: number;
-    /** Current page number (from x-page header) */
+    total?: number;
+    /** Number of items per page (from x-limit header) */
+    limit?: number;
+    /** Number of items skipped (from x-offset header) */
+    offset?: number;
+    /** Current page number (calculated: Math.floor(offset / limit) + 1) */
     page?: number;
-    /** Items per page (from x-per-page header) */
-    perPage?: number;
-    /** Total number of pages (calculated) */
+    /** Total number of pages (calculated: Math.ceil(total / limit)) */
     totalPages?: number;
     /** Rate limit remaining (from x-ratelimit-remaining header) */
     rateLimit?: number;

package/dist/index.d.mts

@@ -529,12 +529,14 @@ declare function formatAPIErrorMessage(err: unknown): string;
  */
 interface ResponseMetadata {
     /** Total number of items (from x-total-count header) */
-    totalCount?: number;
-    /** Current page number (from x-page header) */
+    total?: number;
+    /** Number of items per page (from x-limit header) */
+    limit?: number;
+    /** Number of items skipped (from x-offset header) */
+    offset?: number;
+    /** Current page number (calculated: Math.floor(offset / limit) + 1) */
     page?: number;
-    /** Items per page (from x-per-page header) */
-    perPage?: number;
-    /** Total number of pages */
+    /** Total number of pages (calculated: Math.ceil(total / limit)) */
     totalPages?: number;
     /** Rate limit remaining (from x-rate-limit-remaining header) */
     rateLimit?: number;
@@ -558,12 +560,14 @@ declare class ApiResponse<TData = any> extends Array<TData extends Array<infer U
     /** Raw axios response */
     $raw: AxiosResponse<TData>;
     /** Total number of items (from x-total-count header) */
-    totalCount?: number;
-    /** Current page number (from x-page header) */
+    total?: number;
+    /** Number of items per page (from x-limit header) */
+    limit?: number;
+    /** Number of items skipped (from x-offset header) */
+    offset?: number;
+    /** Current page number (calculated: Math.floor(offset / limit) + 1) */
     page?: number;
-    /** Items per page (from x-per-page header) */
-    perPage?: number;
-    /** Total number of pages (calculated) */
+    /** Total number of pages (calculated: Math.ceil(total / limit)) */
     totalPages?: number;
     /** Rate limit remaining (from x-ratelimit-remaining header) */
     rateLimit?: number;

package/dist/index.d.ts

@@ -529,12 +529,14 @@ declare function formatAPIErrorMessage(err: unknown): string;
  */
 interface ResponseMetadata {
     /** Total number of items (from x-total-count header) */
-    totalCount?: number;
-    /** Current page number (from x-page header) */
+    total?: number;
+    /** Number of items per page (from x-limit header) */
+    limit?: number;
+    /** Number of items skipped (from x-offset header) */
+    offset?: number;
+    /** Current page number (calculated: Math.floor(offset / limit) + 1) */
     page?: number;
-    /** Items per page (from x-per-page header) */
-    perPage?: number;
-    /** Total number of pages */
+    /** Total number of pages (calculated: Math.ceil(total / limit)) */
     totalPages?: number;
     /** Rate limit remaining (from x-rate-limit-remaining header) */
     rateLimit?: number;
@@ -558,12 +560,14 @@ declare class ApiResponse<TData = any> extends Array<TData extends Array<infer U
     /** Raw axios response */
     $raw: AxiosResponse<TData>;
     /** Total number of items (from x-total-count header) */
-    totalCount?: number;
-    /** Current page number (from x-page header) */
+    total?: number;
+    /** Number of items per page (from x-limit header) */
+    limit?: number;
+    /** Number of items skipped (from x-offset header) */
+    offset?: number;
+    /** Current page number (calculated: Math.floor(offset / limit) + 1) */
     page?: number;
-    /** Items per page (from x-per-page header) */
-    perPage?: number;
-    /** Total number of pages (calculated) */
+    /** Total number of pages (calculated: Math.ceil(total / limit)) */
     totalPages?: number;
     /** Rate limit remaining (from x-ratelimit-remaining header) */
     rateLimit?: number;

package/dist/index.mjs

@@ -1451,12 +1451,14 @@ class ApiResponse extends Array {
   /** Raw axios response */
   $raw;
   /** Total number of items (from x-total-count header) */
-  totalCount;
-  /** Current page number (from x-page header) */
+  total;
+  /** Number of items per page (from x-limit header) */
+  limit;
+  /** Number of items skipped (from x-offset header) */
+  offset;
+  /** Current page number (calculated: Math.floor(offset / limit) + 1) */
   page;
-  /** Items per page (from x-per-page header) */
-  perPage;
-  /** Total number of pages (calculated) */
+  /** Total number of pages (calculated: Math.ceil(total / limit)) */
   totalPages;
   /** Rate limit remaining (from x-ratelimit-remaining header) */
   rateLimit;
@@ -1471,9 +1473,10 @@ class ApiResponse extends Array {
       if (response) {
         this.$raw = response;
         this.$metadata = ApiResponse.parseMetadataStatic(response);
-        this.totalCount = this.$metadata.totalCount;
+        this.total = this.$metadata.total;
+        this.limit = this.$metadata.limit;
+        this.offset = this.$metadata.offset;
         this.page = this.$metadata.page;
-        this.perPage = this.$metadata.perPage;
         this.totalPages = this.$metadata.totalPages;
         this.rateLimit = this.$metadata.rateLimit;
         this.rateLimitReset = this.$metadata.rateLimitReset;
@@ -1489,16 +1492,17 @@ class ApiResponse extends Array {
       const obj = Object.assign(/* @__PURE__ */ Object.create(null), data);
       obj.$raw = response;
       obj.$metadata = ApiResponse.parseMetadataStatic(response);
-      obj.totalCount = obj.$metadata.totalCount;
+      obj.total = obj.$metadata.total;
+      obj.limit = obj.$metadata.limit;
+      obj.offset = obj.$metadata.offset;
       obj.page = obj.$metadata.page;
-      obj.perPage = obj.$metadata.perPage;
       obj.totalPages = obj.$metadata.totalPages;
       obj.rateLimit = obj.$metadata.rateLimit;
       obj.rateLimitReset = obj.$metadata.rateLimitReset;
       obj.getHeader = (name) => response?.headers[name.toLowerCase()];
-      obj.hasPagination = obj.totalCount !== void 0 || obj.page !== void 0;
-      obj.hasNextPage = obj.page && obj.totalPages ? obj.page < obj.totalPages : false;
-      obj.hasPrevPage = obj.page ? obj.page > 1 : false;
+      obj.hasPagination = obj.total !== void 0 || obj.offset !== void 0;
+      obj.hasNextPage = obj.total !== void 0 && obj.limit !== void 0 && obj.offset !== void 0 ? obj.offset + obj.limit < obj.total : false;
+      obj.hasPrevPage = obj.offset !== void 0 ? obj.offset > 0 : false;
       return obj;
     }
     const instance = new ApiResponse(data, response);
@@ -1508,16 +1512,19 @@ class ApiResponse extends Array {
     const { headers } = response;
     const metadata = {};
     if (headers["x-total-count"]) {
-      metadata.totalCount = Number(headers["x-total-count"]);
+      metadata.total = Number(headers["x-total-count"]);
     }
-    if (headers["x-page"]) {
-      metadata.page = Number(headers["x-page"]);
+    if (headers["x-limit"]) {
+      metadata.limit = Number(headers["x-limit"]);
     }
-    if (headers["x-per-page"]) {
-      metadata.perPage = Number(headers["x-per-page"]);
+    if (headers["x-offset"]) {
+      metadata.offset = Number(headers["x-offset"]);
     }
-    if (metadata.totalCount && metadata.perPage) {
-      metadata.totalPages = Math.ceil(metadata.totalCount / metadata.perPage);
+    if (metadata.total !== void 0 && metadata.limit) {
+      metadata.totalPages = Math.ceil(metadata.total / metadata.limit);
+    }
+    if (metadata.offset !== void 0 && metadata.limit) {
+      metadata.page = Math.floor(metadata.offset / metadata.limit) + 1;
     }
     if (headers["x-ratelimit-remaining"] || headers["x-rate-limit-remaining"]) {
       metadata.rateLimit = Number(
@@ -1540,15 +1547,15 @@ class ApiResponse extends Array {
     return this.$raw.headers[name.toLowerCase()];
   }
   get hasPagination() {
-    return this.totalCount !== void 0 || this.page !== void 0;
+    return this.total !== void 0 || this.offset !== void 0;
   }
   get hasNextPage() {
-    if (!this.page || !this.totalPages) return false;
-    return this.page < this.totalPages;
+    if (this.total === void 0 || this.limit === void 0 || this.offset === void 0) return false;
+    return this.offset + this.limit < this.total;
   }
   get hasPrevPage() {
-    if (!this.page) return false;
-    return this.page > 1;
+    if (this.offset === void 0) return false;
+    return this.offset > 0;
   }
 }
 function parseApiError(error) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bagelink/sdk",
   "type": "module",
-  "version": "1.9.164",
+  "version": "1.9.168",
   "description": "Bagel core sdk packages",
   "author": {
     "name": "Bagel Studio",

package/src/index.ts

@@ -23,12 +23,14 @@ export { unwrap, type Unwrapped } from './unwrap'
  */
 export interface ResponseMetadata {
 	/** Total number of items (from x-total-count header) */
-	totalCount?: number
-	/** Current page number (from x-page header) */
+	total?: number
+	/** Number of items per page (from x-limit header) */
+	limit?: number
+	/** Number of items skipped (from x-offset header) */
+	offset?: number
+	/** Current page number (calculated: Math.floor(offset / limit) + 1) */
 	page?: number
-	/** Items per page (from x-per-page header) */
-	perPage?: number
-	/** Total number of pages */
+	/** Total number of pages (calculated: Math.ceil(total / limit)) */
 	totalPages?: number
 	/** Rate limit remaining (from x-rate-limit-remaining header) */
 	rateLimit?: number
@@ -55,15 +57,18 @@ export class ApiResponse<TData = any> extends Array<TData extends Array<infer U>
 	public $raw!: AxiosResponse<TData>
 
 	/** Total number of items (from x-total-count header) */
-	public totalCount?: number
+	public total?: number
 
-	/** Current page number (from x-page header) */
-	public page?: number
+	/** Number of items per page (from x-limit header) */
+	public limit?: number
+
+	/** Number of items skipped (from x-offset header) */
+	public offset?: number
 
-	/** Items per page (from x-per-page header) */
-	public perPage?: number
+	/** Current page number (calculated: Math.floor(offset / limit) + 1) */
+	public page?: number
 
-	/** Total number of pages (calculated) */
+	/** Total number of pages (calculated: Math.ceil(total / limit)) */
 	public totalPages?: number
 
 	/** Rate limit remaining (from x-ratelimit-remaining header) */
@@ -86,9 +91,10 @@ export class ApiResponse<TData = any> extends Array<TData extends Array<infer U>
 			if (response) {
 				this.$raw = response as AxiosResponse<TData>
 				this.$metadata = ApiResponse.parseMetadataStatic(response)
-				this.totalCount = this.$metadata.totalCount
+				this.total = this.$metadata.total
+				this.limit = this.$metadata.limit
+				this.offset = this.$metadata.offset
 				this.page = this.$metadata.page
-				this.perPage = this.$metadata.perPage
 				this.totalPages = this.$metadata.totalPages
 				this.rateLimit = this.$metadata.rateLimit
 				this.rateLimitReset = this.$metadata.rateLimitReset
@@ -106,16 +112,19 @@ export class ApiResponse<TData = any> extends Array<TData extends Array<infer U>
 			const obj = Object.assign(Object.create(null), data) as any
 			obj.$raw = response
 			obj.$metadata = ApiResponse.parseMetadataStatic(response)
-			obj.totalCount = obj.$metadata.totalCount
+			obj.total = obj.$metadata.total
+			obj.limit = obj.$metadata.limit
+			obj.offset = obj.$metadata.offset
 			obj.page = obj.$metadata.page
-			obj.perPage = obj.$metadata.perPage
 			obj.totalPages = obj.$metadata.totalPages
 			obj.rateLimit = obj.$metadata.rateLimit
 			obj.rateLimitReset = obj.$metadata.rateLimitReset
 			obj.getHeader = (name: string) => response?.headers[name.toLowerCase()]
-			obj.hasPagination = obj.totalCount !== undefined || obj.page !== undefined
-			obj.hasNextPage = obj.page && obj.totalPages ? obj.page < obj.totalPages : false
-			obj.hasPrevPage = obj.page ? obj.page > 1 : false
+			obj.hasPagination = obj.total !== undefined || obj.offset !== undefined
+			obj.hasNextPage = obj.total !== undefined && obj.limit !== undefined && obj.offset !== undefined
+				? obj.offset + obj.limit < obj.total
+				: false
+			obj.hasPrevPage = obj.offset !== undefined ? obj.offset > 0 : false
 			return obj
 		}
 
@@ -129,17 +138,20 @@ export class ApiResponse<TData = any> extends Array<TData extends Array<infer U>
 		const metadata: ResponseMetadata = {}
 
 		if (headers['x-total-count']) {
-			metadata.totalCount = Number(headers['x-total-count'])
+			metadata.total = Number(headers['x-total-count'])
 		}
-		if (headers['x-page']) {
-			metadata.page = Number(headers['x-page'])
+		if (headers['x-limit']) {
+			metadata.limit = Number(headers['x-limit'])
 		}
-		if (headers['x-per-page']) {
-			metadata.perPage = Number(headers['x-per-page'])
+		if (headers['x-offset']) {
+			metadata.offset = Number(headers['x-offset'])
 		}
 
-		if (metadata.totalCount && metadata.perPage) {
-			metadata.totalPages = Math.ceil(metadata.totalCount / metadata.perPage)
+		if (metadata.total !== undefined && metadata.limit) {
+			metadata.totalPages = Math.ceil(metadata.total / metadata.limit)
+		}
+		if (metadata.offset !== undefined && metadata.limit) {
+			metadata.page = Math.floor(metadata.offset / metadata.limit) + 1
 		}
 
 		if (headers['x-ratelimit-remaining'] || headers['x-rate-limit-remaining']) {
@@ -167,17 +179,17 @@ export class ApiResponse<TData = any> extends Array<TData extends Array<infer U>
 	}
 
 	public get hasPagination(): boolean {
-		return this.totalCount !== undefined || this.page !== undefined
+		return this.total !== undefined || this.offset !== undefined
 	}
 
 	public get hasNextPage(): boolean {
-		if (!this.page || !this.totalPages) return false
-		return this.page < this.totalPages
+		if (this.total === undefined || this.limit === undefined || this.offset === undefined) return false
+		return this.offset + this.limit < this.total
 	}
 
 	public get hasPrevPage(): boolean {
-		if (!this.page) return false
-		return this.page > 1
+		if (this.offset === undefined) return false
+		return this.offset > 0
 	}
 }