@classytic/arc-next 0.4.1 → 0.6.0

package/dist/api.d.ts

@@ -1,4 +1,7 @@
 import { ArcClient } from "./client.js";
+import { AggregatePaginationResult, KeysetPaginationResult, OffsetPaginationResult, PaginatedResult } from "@classytic/repo-core/pagination";
+import { AggResult, AggRow, BulkCreateResult, DeleteManyResult, DeleteResult, UpdateManyResult } from "@classytic/repo-core/repository";
+import { BracketOperator, BracketOperator as BracketOperator$1 } from "@classytic/repo-core/query-parser";
 
 //#region src/api.d.ts
 interface PopulateOption {
@@ -6,68 +9,24 @@ interface PopulateOption {
   select?: string;
   match?: Record<string, unknown>;
 }
-interface ApiResponse<T = unknown> {
-  success: boolean;
-  data?: T;
-  message?: string;
-}
-interface OffsetPaginationResponse<T = unknown> {
-  success: boolean;
-  method: 'offset';
-  docs: T[];
-  page: number;
-  limit: number;
-  total: number;
-  pages: number;
-  hasNext: boolean;
-  hasPrev: boolean;
-  warning?: string;
-}
-interface KeysetPaginationResponse<T = unknown> {
-  success: boolean;
-  method: 'keyset';
-  docs: T[];
-  limit: number;
-  hasMore: boolean;
-  next: string | null;
-}
-interface AggregatePaginationResponse<T = unknown> {
-  success: boolean;
-  method: 'aggregate';
-  docs: T[];
-  page: number;
-  limit: number;
-  total: number;
-  pages: number;
-  hasNext: boolean;
-  hasPrev: boolean;
-  warning?: string;
-}
-type PaginatedResponse<T = unknown> = OffsetPaginationResponse<T> | KeysetPaginationResponse<T> | AggregatePaginationResponse<T>;
-interface DeleteResponse {
-  success: boolean;
-  data?: {
-    message?: string;
-    id?: string;
-    soft?: boolean;
-  };
-}
-interface BulkCreateResponse<T = unknown> {
-  success: boolean;
-  data?: T[];
-  count?: number;
-}
-interface BulkUpdateResponse {
-  success: boolean;
-  modifiedCount?: number;
-}
-interface BulkDeleteResponse {
-  success: boolean;
-  deletedCount?: number;
-}
 type SortDirection = 1 | -1 | 'asc' | 'desc';
 type SortSpec = Record<string, SortDirection> | string;
-type FilterOperator = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'contains' | 'startsWith' | 'endsWith' | 'regex' | 'like' | 'exists' | 'size' | 'type';
+/**
+ * Filter operators supported by arc-next URL emission.
+ *
+ * Composes:
+ *  - **Canonical** ({@link BracketOperator}) — every operator repo-core's
+ *    `parseUrl` reverses. Cross-kit portable: mongokit, sqlitekit, prismakit,
+ *    and any future kit that consumes the canonical Filter IR all support
+ *    these out of the box.
+ *  - **Driver-specific extensions** — operators that require kit-native
+ *    support. Geo (`near`, `nearSphere`, `geoWithin`, `withinRadius`) is
+ *    mongokit + sqlitekit-spatialite. `size` / `type` are mongokit
+ *    array/BSON helpers. Hosts using kits without these features just
+ *    don't emit them; the union stays open with `(string & {})` so custom
+ *    domain operators still satisfy the type.
+ */
+type FilterOperator = BracketOperator$1 | 'size' | 'type' | 'near' | 'nearSphere' | 'geoWithin' | 'withinRadius' | (string & {});
 interface QueryParams {
   page?: number;
   limit?: number;
@@ -97,6 +56,18 @@ interface RequestOptions {
   responseType?: 'json' | 'blob' | 'text';
   signal?: AbortSignal;
 }
+/**
+ * Common args every BaseApi-style method accepts: `token`, `organizationId`,
+ * and `options` (per-request RequestOptions minus the auth fields).
+ *
+ * Preset method signatures extend this so the auth-injection contract stays
+ * uniform across every call (BaseApi method, preset method, custom user wrapper).
+ */
+interface ScopedArgs {
+  token?: string | null;
+  organizationId?: string | null;
+  options?: Omit<RequestOptions, 'token' | 'organizationId'>;
+}
 interface BaseApiConfig {
   basePath?: string;
   defaultParams?: {
@@ -128,7 +99,7 @@ declare class BaseApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, T
     organizationId?: string | null;
     params?: QueryParams;
     options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<PaginatedResponse<TDoc>>;
+  }): Promise<PaginatedResult<TDoc>>;
   getById({
     token,
     organizationId,
@@ -144,7 +115,7 @@ declare class BaseApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, T
       populate?: string | string[];
     };
     options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<ApiResponse<TDoc>>;
+  }): Promise<TDoc>;
   create({
     token,
     organizationId,
@@ -155,7 +126,7 @@ declare class BaseApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, T
     organizationId?: string | null;
     data: TCreate;
     options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<ApiResponse<TDoc>>;
+  }): Promise<TDoc>;
   update({
     token,
     organizationId,
@@ -168,7 +139,7 @@ declare class BaseApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, T
     id: string;
     data: TUpdate;
     options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<ApiResponse<TDoc>>;
+  }): Promise<TDoc>;
   delete({
     token,
     organizationId,
@@ -179,7 +150,7 @@ declare class BaseApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, T
     organizationId?: string | null;
     id: string;
     options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<DeleteResponse>;
+  }): Promise<DeleteResult>;
   upload({
     token,
     organizationId,
@@ -187,159 +158,109 @@ declare class BaseApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, T
     id,
     path,
     options
-  }: {
-    token?: string | null;
-    organizationId?: string | null;
+  }: ScopedArgs & {
     data: FormData; /** Resource ID — shorthand for path, appended as `baseUrl/{id}/upload` */
     id?: string; /** Custom sub-path appended as `baseUrl/{path}`. Takes precedence over `id`. */
     path?: string;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<ApiResponse<TDoc>>;
-  search({
-    token,
-    organizationId,
-    searchParams,
-    params,
-    options
-  }?: {
-    token?: string | null;
-    organizationId?: string | null;
-    searchParams?: Record<string, unknown>;
-    params?: QueryParams;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<PaginatedResponse<TDoc>>;
-  findBy({
-    token,
-    organizationId,
-    field,
-    value,
-    operator,
-    params,
-    options
-  }: {
-    token?: string | null;
-    organizationId?: string | null;
-    field: string;
-    value: unknown;
-    operator?: FilterOperator;
-    params?: QueryParams;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<PaginatedResponse<TDoc>>;
+  }): Promise<TDoc>;
   request<TResponse = unknown>(method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE', endpoint: string, {
     token,
     organizationId,
     data,
     params,
     options
-  }?: {
-    token?: string | null;
-    organizationId?: string | null;
+  }?: ScopedArgs & {
     data?: unknown;
     params?: QueryParams;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
   }): Promise<TResponse>;
-  getDeleted({
+  /**
+   * Invoke a custom route mounted on this resource (e.g. `/todos/stats`,
+   * `/todos/recent`). Resource-relative wrapper around {@link request} that
+   * prepends `this.baseUrl` so callers don't have to remember the prefix.
+   *
+   * Use this for `defineResource({ routes: [{ method, path, handler }] })` —
+   * Arc's escape hatch for endpoints that don't fit CRUD or actions.
+   *
+   * For aggregates / reports, prefer the response-aware {@link useApiQuery} hook
+   * and pass `invokeRoute` as the queryFn — arc 2.13+ emits raw payloads, so
+   * the response IS the data.
+   *
+   * @example
+   * // GET /todos/stats → { total, byStatus }
+   * const stats = await api.invokeRoute<{ total: number; byStatus: Record<string, number> }>({
+   *   method: 'GET',
+   *   path: '/stats',
+   * });
+   *
+   * // GET /todos/recent?limit=5 → paginated shape spread to root
+   * const recent = await api.invokeRoute<PaginatedResult<Todo>>({
+   *   method: 'GET',
+   *   path: '/recent',
+   *   params: { limit: 5 },
+   * });
+   *
+   * // POST /products/import — body + path
+   * await api.invokeRoute({
+   *   method: 'POST',
+   *   path: '/import',
+   *   data: { source: 'csv', items: [...] },
+   * });
+   */
+  invokeRoute<TResponse = unknown>({
     token,
     organizationId,
+    method,
+    path,
+    data,
     params,
     options
-  }?: {
-    token?: string | null;
-    organizationId?: string | null;
+  }: ScopedArgs & {
+    method?: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE'; /** Path relative to the resource baseUrl. Leading slash optional. */
+    path: string;
+    data?: unknown;
     params?: QueryParams;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<PaginatedResponse<TDoc>>;
-  restore({
-    token,
-    organizationId,
-    id,
-    options
-  }: {
-    token?: string | null;
-    organizationId?: string | null;
-    id: string;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<ApiResponse<TDoc>>;
-  bulkCreate({
-    token,
-    organizationId,
-    data,
-    options
-  }: {
-    token?: string | null;
-    organizationId?: string | null;
-    data: TCreate[];
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<BulkCreateResponse<TDoc>>;
-  bulkUpdate({
-    token,
-    organizationId,
-    filter,
-    data,
-    options
-  }: {
-    token?: string | null;
-    organizationId?: string | null;
-    filter: Record<string, unknown>;
-    data: TUpdate;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<BulkUpdateResponse>;
-  bulkDelete({
+  }): Promise<TResponse>;
+  /**
+   * Fetch a declared aggregation by name.
+   *
+   * @example
+   * const { rows } = await api.aggregate<{ day: string; total: number }>({
+   *   name: 'salesByDay',
+   *   filter: { from: '2025-01-01', to: '2025-12-31' },
+   * });
+   */
+  aggregate<TRow extends AggRow = AggRow>({
     token,
     organizationId,
+    name,
     filter,
     options
-  }: {
-    token?: string | null;
-    organizationId?: string | null;
-    filter: Record<string, unknown>;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<BulkDeleteResponse>;
-  getBySlug({
+  }: ScopedArgs & {
+    /** Aggregation name as declared on the resource. */name: string;
+    /**
+     * URL-encoded filter narrows + dimension args. Reserved keys (`page`,
+     * `limit`, etc.) are stripped server-side; everything else flows into
+     * the AggRequest filter via shallow merge with the host's base filter.
+     */
+    filter?: Record<string, unknown>;
+  }): Promise<AggResult<TRow>>;
+  dispatchAction<TResult = unknown, TBody extends Record<string, unknown> = Record<string, unknown>>({
     token,
     organizationId,
-    slug,
-    params,
-    options
-  }: {
-    token?: string | null;
-    organizationId?: string | null;
-    slug: string;
-    params?: {
-      select?: string;
-      populate?: string | string[];
-    };
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<ApiResponse<TDoc>>;
-  getTree({
-    token,
-    organizationId,
-    params,
-    options
-  }?: {
-    token?: string | null;
-    organizationId?: string | null;
-    params?: QueryParams;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<ApiResponse<TDoc[]>>;
-  getChildren({
-    token,
-    organizationId,
-    parentId,
-    params,
+    id,
+    action,
+    data,
     options
-  }: {
-    token?: string | null;
-    organizationId?: string | null;
-    parentId: string;
-    params?: QueryParams;
-    options?: Omit<RequestOptions, 'token' | 'organizationId'>;
-  }): Promise<PaginatedResponse<TDoc>>;
+  }: ScopedArgs & {
+    id: string;
+    action: string;
+    data?: TBody;
+  }): Promise<TResult>;
 }
 declare function createCrudApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, TUpdate = Partial<TDoc>>(entity: string, config?: BaseApiConfig): BaseApi<TDoc, TCreate, TUpdate>;
-type ExtractDoc<T> = T extends PaginatedResponse<infer D> ? D : never;
-declare function isOffsetPagination<T>(response: PaginatedResponse<T>): response is OffsetPaginationResponse<T>;
-declare function isKeysetPagination<T>(response: PaginatedResponse<T>): response is KeysetPaginationResponse<T>;
-declare function isAggregatePagination<T>(response: PaginatedResponse<T>): response is AggregatePaginationResponse<T>;
+type ExtractDoc<T> = T extends PaginatedResult<infer D> ? D : never;
+declare function isOffsetPagination<T>(response: PaginatedResult<T>): response is OffsetPaginationResult<T>;
+declare function isKeysetPagination<T>(response: PaginatedResult<T>): response is KeysetPaginationResult<T>;
+declare function isAggregatePagination<T>(response: PaginatedResult<T>): response is AggregatePaginationResult<T>;
 //#endregion
-export { AggregatePaginationResponse, ApiResponse, BaseApi, BaseApiConfig, BulkCreateResponse, BulkDeleteResponse, BulkUpdateResponse, DeleteResponse, ExtractDoc, FilterOperator, KeysetPaginationResponse, OffsetPaginationResponse, PaginatedResponse, PopulateOption, QueryParams, RequestOptions, SortDirection, SortSpec, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination };
+export { type AggResult, type AggRow, BaseApi, BaseApiConfig, type BracketOperator, type BulkCreateResult, type DeleteManyResult, type DeleteResult, ExtractDoc, FilterOperator, PopulateOption, QueryParams, RequestOptions, ScopedArgs, SortDirection, SortSpec, type UpdateManyResult, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination };

package/dist/api.js

@@ -63,7 +63,8 @@ var BaseApi = class {
 			}
 			if (value !== void 0 && value !== "") if (["page", "limit"].includes(key)) result[key] = parseInt(String(value)) || (key === "page" ? 1 : 10);
 			else if (Array.isArray(value)) {
-				if (value.length > 1) result[`${key}[in]`] = value.join(",");
+				if (/\[([^\]]+)\]$/.test(key)) result[key] = value.join(",");
+				else if (value.length > 1) result[`${key}[in]`] = value.join(",");
 				else if (value.length === 1) result[key] = value[0];
 			} else result[key] = value;
 		});
@@ -133,40 +134,6 @@ var BaseApi = class {
 		if (organizationId) requestOptions.organizationId = organizationId;
 		return this.requestFn("POST", url, this.withHeaders(requestOptions));
 	}
-	async search({ token = null, organizationId = null, searchParams = {}, params = {}, options = {} } = {}) {
-		const queryParams = {
-			...this.config.defaultParams,
-			...params,
-			...searchParams
-		};
-		const processedParams = this.prepareParams(queryParams);
-		const queryString = this.createQueryString(processedParams);
-		const requestOptions = {
-			cache: this.config.cache,
-			...options
-		};
-		if (token) requestOptions.token = token;
-		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("GET", `${this.baseUrl}?${queryString}`, this.withHeaders(requestOptions));
-	}
-	async findBy({ token = null, organizationId = null, field, value, operator, params = {}, options = {} }) {
-		if (!field || value === void 0) throw new Error("Field and value are required");
-		const queryParams = {
-			...this.config.defaultParams,
-			...params
-		};
-		if (operator) queryParams[`${field}[${operator}]`] = Array.isArray(value) ? value.join(",") : value;
-		else queryParams[field] = value;
-		const processedParams = this.prepareParams(queryParams);
-		const queryString = this.createQueryString(processedParams);
-		const requestOptions = {
-			cache: this.config.cache,
-			...options
-		};
-		if (token) requestOptions.token = token;
-		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("GET", `${this.baseUrl}?${queryString}`, this.withHeaders(requestOptions));
-	}
 	async request(method, endpoint, { token = null, organizationId = null, data, params, options = {} } = {}) {
 		let url = endpoint;
 		if (params) {
@@ -182,109 +149,95 @@ var BaseApi = class {
 		if (organizationId) requestOptions.organizationId = organizationId;
 		return this.requestFn(method, url, this.withHeaders(requestOptions));
 	}
-	async getDeleted({ token = null, organizationId = null, params = {}, options = {} } = {}) {
-		const mergedParams = {
-			...this.config.defaultParams,
-			...params
-		};
-		const processedParams = this.prepareParams(mergedParams);
-		const queryString = this.createQueryString(processedParams);
-		const requestOptions = {
-			cache: this.config.cache,
-			...options
-		};
-		if (token) requestOptions.token = token;
-		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("GET", `${this.baseUrl}/deleted?${queryString}`, this.withHeaders(requestOptions));
+	/**
+	* Invoke a custom route mounted on this resource (e.g. `/todos/stats`,
+	* `/todos/recent`). Resource-relative wrapper around {@link request} that
+	* prepends `this.baseUrl` so callers don't have to remember the prefix.
+	*
+	* Use this for `defineResource({ routes: [{ method, path, handler }] })` —
+	* Arc's escape hatch for endpoints that don't fit CRUD or actions.
+	*
+	* For aggregates / reports, prefer the response-aware {@link useApiQuery} hook
+	* and pass `invokeRoute` as the queryFn — arc 2.13+ emits raw payloads, so
+	* the response IS the data.
+	*
+	* @example
+	* // GET /todos/stats → { total, byStatus }
+	* const stats = await api.invokeRoute<{ total: number; byStatus: Record<string, number> }>({
+	*   method: 'GET',
+	*   path: '/stats',
+	* });
+	*
+	* // GET /todos/recent?limit=5 → paginated shape spread to root
+	* const recent = await api.invokeRoute<PaginatedResult<Todo>>({
+	*   method: 'GET',
+	*   path: '/recent',
+	*   params: { limit: 5 },
+	* });
+	*
+	* // POST /products/import — body + path
+	* await api.invokeRoute({
+	*   method: 'POST',
+	*   path: '/import',
+	*   data: { source: 'csv', items: [...] },
+	* });
+	*/
+	async invokeRoute({ token = null, organizationId = null, method = "GET", path, data, params, options = {} }) {
+		if (!path) throw new Error("path is required");
+		const normalized = path.startsWith("/") ? path : `/${path}`;
+		const endpoint = `${this.baseUrl}${normalized}`;
+		return this.request(method, endpoint, {
+			token,
+			organizationId,
+			data,
+			params,
+			options
+		});
 	}
-	async restore({ token = null, organizationId = null, id, options = {} }) {
-		if (!id) throw new Error("ID is required");
+	/**
+	* Fetch a declared aggregation by name.
+	*
+	* @example
+	* const { rows } = await api.aggregate<{ day: string; total: number }>({
+	*   name: 'salesByDay',
+	*   filter: { from: '2025-01-01', to: '2025-12-31' },
+	* });
+	*/
+	async aggregate({ token = null, organizationId = null, name, filter, options = {} }) {
+		if (!name) throw new Error("Aggregation name is required");
+		const queryString = filter ? this.createQueryString(filter) : "";
+		const endpoint = `${this.baseUrl}/aggregations/${name}${queryString ? `?${queryString}` : ""}`;
 		const requestOptions = { ...options };
 		if (token) requestOptions.token = token;
 		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("POST", `${this.baseUrl}/${id}/restore`, this.withHeaders(requestOptions));
+		return this.requestFn("GET", endpoint, this.withHeaders(requestOptions));
 	}
-	async bulkCreate({ token = null, organizationId = null, data, options = {} }) {
-		const requestOptions = {
-			body: data,
-			...options
-		};
-		if (token) requestOptions.token = token;
-		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("POST", `${this.baseUrl}/bulk`, this.withHeaders(requestOptions));
-	}
-	async bulkUpdate({ token = null, organizationId = null, filter, data, options = {} }) {
+	async dispatchAction({ token = null, organizationId = null, id, action, data, options = {} }) {
+		if (!id) throw new Error("ID is required");
+		if (!action) throw new Error("Action name is required");
 		const requestOptions = {
 			body: {
-				filter,
-				data
+				action,
+				...data ?? {}
 			},
 			...options
 		};
 		if (token) requestOptions.token = token;
 		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("PATCH", `${this.baseUrl}/bulk`, this.withHeaders(requestOptions));
-	}
-	async bulkDelete({ token = null, organizationId = null, filter, options = {} }) {
-		const requestOptions = {
-			body: { filter },
-			...options
-		};
-		if (token) requestOptions.token = token;
-		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("DELETE", `${this.baseUrl}/bulk`, this.withHeaders(requestOptions));
-	}
-	async getBySlug({ token = null, organizationId = null, slug, params = {}, options = {} }) {
-		if (!slug) throw new Error("Slug is required");
-		const queryString = this.createQueryString(params);
-		const url = queryString ? `${this.baseUrl}/slug/${slug}?${queryString}` : `${this.baseUrl}/slug/${slug}`;
-		const requestOptions = {
-			cache: this.config.cache,
-			...options
-		};
-		if (token) requestOptions.token = token;
-		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("GET", url, this.withHeaders(requestOptions));
-	}
-	async getTree({ token = null, organizationId = null, params = {}, options = {} } = {}) {
-		const processedParams = this.prepareParams(params);
-		const queryString = this.createQueryString(processedParams);
-		const requestOptions = {
-			cache: this.config.cache,
-			...options
-		};
-		if (token) requestOptions.token = token;
-		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("GET", `${this.baseUrl}/tree?${queryString}`, this.withHeaders(requestOptions));
-	}
-	async getChildren({ token = null, organizationId = null, parentId, params = {}, options = {} }) {
-		if (!parentId) throw new Error("Parent ID is required");
-		const mergedParams = {
-			...this.config.defaultParams,
-			...params
-		};
-		const processedParams = this.prepareParams(mergedParams);
-		const queryString = this.createQueryString(processedParams);
-		const requestOptions = {
-			cache: this.config.cache,
-			...options
-		};
-		if (token) requestOptions.token = token;
-		if (organizationId) requestOptions.organizationId = organizationId;
-		return this.requestFn("GET", `${this.baseUrl}/${parentId}/children?${queryString}`, this.withHeaders(requestOptions));
+		return this.requestFn("POST", `${this.baseUrl}/${id}/action`, this.withHeaders(requestOptions));
 	}
 };
 function createCrudApi(entity, config = {}) {
 	return new BaseApi(entity, config);
 }
 function isOffsetPagination(response) {
-	return response.method === "offset";
+	return "method" in response && response.method === "offset";
 }
 function isKeysetPagination(response) {
-	return response.method === "keyset";
+	return "method" in response && response.method === "keyset";
 }
 function isAggregatePagination(response) {
-	return response.method === "aggregate";
+	return "method" in response && response.method === "aggregate";
 }
 
 //#endregion