@classytic/arc-next 0.8.0 → 0.9.1

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import { ArcClient } from "./client.js";
+import { ArcClient, NextFetchOptions } 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";
@@ -50,8 +50,14 @@ interface RequestOptions {
   token?: string | null;
   organizationId?: string | null;
   cache?: RequestCache;
-  revalidate?: number;
+  /** Flattened Next `revalidate`. `false` = cache indefinitely. */
+  revalidate?: number | false;
   tags?: string[];
+  /**
+   * Idiomatic Next App Router fetch config — passed to `fetch(url, { next })`.
+   * Merged with the flattened `revalidate`/`tags`. Prefer this from Next hosts.
+   */
+  next?: NextFetchOptions;
   headerOptions?: Record<string, string>;
   responseType?: 'json' | 'blob' | 'text';
   signal?: AbortSignal;
@@ -87,6 +93,23 @@ declare class BaseApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, T
   constructor(entity: string, config?: BaseApiConfig);
   /** Merge per-instance headers into request options */
   private withHeaders;
+  /**
+   * Apply the instance's default `cache` to a per-call options object — but
+   * ONLY when the caller expressed no caching intent of their own.
+   *
+   * A per-call `revalidate`/`next` (time-based ISR) or an explicit `cache`
+   * takes precedence. The default is `no-store`; forcing it alongside a
+   * `revalidate` makes Next.js throw ("cache: 'no-store' and revalidate are
+   * contradictory") and otherwise silently pins the route to dynamic
+   * rendering — so a consumer can never opt a single read into ISR. Gating the
+   * default here lets `getBySlug({ slug, options: { revalidate: 60 } })` become
+   * statically cacheable without every other call losing its no-store default.
+   *
+   * Framework-agnostic: `cache` / `revalidate` / `next` are inert pass-throughs
+   * on runtimes (React Native, plain browser fetch) that don't implement the
+   * Next.js fetch extensions, so this never assumes a Next host.
+   */
+  private withCacheDefault;
   createQueryString(params?: Record<string, unknown>): string;
   prepareParams(params?: QueryParams): Record<string, unknown>;
   getAll({
@@ -259,8 +282,16 @@ declare class BaseApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, T
 }
 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 PaginatedResult<infer D> ? D : never;
+/** Any preset-augmented BaseApi — the constraint preset factories accept. */
+type AnyBaseApi = BaseApi<any, any, any>;
+/** Document type of a (possibly augmented) BaseApi. */
+type DocOf<A> = A extends BaseApi<infer D, any, any> ? D : never;
+/** Create-payload type of a (possibly augmented) BaseApi. */
+type CreateOf<A> = A extends BaseApi<any, infer C, any> ? C : never;
+/** Update-payload type of a (possibly augmented) BaseApi. */
+type UpdateOf<A> = A extends BaseApi<any, any, infer U> ? U : 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 { 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 };
+export { type AggResult, type AggRow, AnyBaseApi, BaseApi, BaseApiConfig, type BracketOperator, type BulkCreateResult, CreateOf, type DeleteManyResult, type DeleteResult, DocOf, ExtractDoc, FilterOperator, PopulateOption, QueryParams, RequestOptions, ScopedArgs, SortDirection, SortSpec, type UpdateManyResult, UpdateOf, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination };

package/dist/api.js

@@ -33,6 +33,29 @@ var BaseApi = class {
 			}
 		};
 	}
+	/**
+	* Apply the instance's default `cache` to a per-call options object — but
+	* ONLY when the caller expressed no caching intent of their own.
+	*
+	* A per-call `revalidate`/`next` (time-based ISR) or an explicit `cache`
+	* takes precedence. The default is `no-store`; forcing it alongside a
+	* `revalidate` makes Next.js throw ("cache: 'no-store' and revalidate are
+	* contradictory") and otherwise silently pins the route to dynamic
+	* rendering — so a consumer can never opt a single read into ISR. Gating the
+	* default here lets `getBySlug({ slug, options: { revalidate: 60 } })` become
+	* statically cacheable without every other call losing its no-store default.
+	*
+	* Framework-agnostic: `cache` / `revalidate` / `next` are inert pass-throughs
+	* on runtimes (React Native, plain browser fetch) that don't implement the
+	* Next.js fetch extensions, so this never assumes a Next host.
+	*/
+	withCacheDefault(options = {}) {
+		if (options.cache !== void 0 || options.revalidate !== void 0 || options.next !== void 0) return options;
+		return {
+			cache: this.config.cache,
+			...options
+		};
+	}
 	createQueryString(params = {}) {
 		return createQueryString(params);
 	}
@@ -77,10 +100,7 @@ var BaseApi = class {
 		};
 		const processedParams = this.prepareParams(mergedParams);
 		const queryString = this.createQueryString(processedParams);
-		const requestOptions = {
-			cache: this.config.cache,
-			...options
-		};
+		const requestOptions = { ...this.withCacheDefault(options) };
 		if (token) requestOptions.token = token;
 		if (organizationId) requestOptions.organizationId = organizationId;
 		return this.requestFn("GET", `${this.baseUrl}?${queryString}`, this.withHeaders(requestOptions));
@@ -89,10 +109,7 @@ var BaseApi = class {
 		if (!id) throw new Error("ID is required");
 		const queryString = this.createQueryString(params);
 		const url = queryString ? `${this.baseUrl}/${id}?${queryString}` : `${this.baseUrl}/${id}`;
-		const requestOptions = {
-			cache: this.config.cache,
-			...options
-		};
+		const requestOptions = { ...this.withCacheDefault(options) };
 		if (token) requestOptions.token = token;
 		if (organizationId) requestOptions.organizationId = organizationId;
 		return this.requestFn("GET", url, this.withHeaders(requestOptions));
@@ -142,8 +159,7 @@ var BaseApi = class {
 		}
 		const requestOptions = {
 			body: data,
-			cache: this.config.cache,
-			...options
+			...this.withCacheDefault(options)
 		};
 		if (token) requestOptions.token = token;
 		if (organizationId) requestOptions.organizationId = organizationId;

package/dist/client.d.ts

@@ -602,13 +602,40 @@ interface TextResponse {
   data: string;
   response: Response;
 }
+/**
+ * Next.js App Router `fetch` cache directives — forwarded verbatim as
+ * `fetch(url, { next })`. This is the idiomatic Next shape; a host using the
+ * App Router can pass it 1:1 with what they'd hand to `fetch`. The flattened
+ * `revalidate` / `tags` options remain for back-compat and are merged into
+ * this object before the request (flattened values win / append).
+ *
+ * @see https://nextjs.org/docs/app/api-reference/functions/fetch
+ */
+interface NextFetchOptions {
+  /**
+   * Seconds before the cached response is considered stale and revalidated.
+   * `false` caches indefinitely (Next's `force-cache` semantics); `0` opts
+   * out of caching. Omit to inherit the route's default.
+   */
+  revalidate?: number | false;
+  /** Cache tags for on-demand `revalidateTag(tag)` invalidation. */
+  tags?: string[];
+}
 interface ApiRequestOptions {
   body?: unknown;
   token?: string | null;
   organizationId?: string | null;
-  revalidate?: number;
+  /** Flattened Next `revalidate` (see `next`). `false` = cache indefinitely. */
+  revalidate?: number | false;
   headerOptions?: Record<string, string>;
+  /** Flattened Next cache `tags` (see `next`). */
   tags?: string[];
+  /**
+   * Idiomatic Next App Router fetch cache config — passed straight to
+   * `fetch(url, { next })`. Prefer this over the flattened `revalidate`/`tags`
+   * when a Next host wants full control; both are merged.
+   */
+  next?: NextFetchOptions;
   cache?: RequestCache;
   signal?: AbortSignal;
   /** Explicit idempotency key for this request. Sent as `Idempotency-Key` header. */
@@ -765,10 +792,12 @@ interface ArcFetchOptions extends Omit<RequestInit, 'body' | 'headers'> {
   elevated?: boolean;
   /** Per-call `Idempotency-Key` header. */
   idempotencyKey?: string;
-  /** Next.js fetch `revalidate` pass-through. */
-  revalidate?: number;
-  /** Next.js fetch `tags` pass-through. */
+  /** Flattened Next `revalidate` pass-through. `false` = cache indefinitely. */
+  revalidate?: number | false;
+  /** Flattened Next cache `tags` pass-through. */
   tags?: string[];
+  /** Idiomatic Next App Router fetch config — merged with `revalidate`/`tags`. */
+  next?: NextFetchOptions;
   /** `cache` pass-through (browser fetch + Next.js). */
   cache?: RequestCache;
   /**
@@ -835,4 +864,4 @@ declare const arc: {
   delete: <T = unknown>(path: string, opts?: ArcFetchOptions) => Promise<T>;
 };
 //#endregion
-export { AfterResponseContext, AfterResponseInterceptor, ApiRequestOptions, ArcApiError, ArcApiErrorOptions, ArcClient, ArcClientConfig, ArcErrorCode, ArcFetchOptions, AuthConfig, AuthErrorContext, AuthErrorHandler, BeforeRequestContext, BeforeRequestInterceptor, BlobResponse, ClientConfig, ClientEncryptionConfig, HttpMethod, KNOWN_ARC_ERROR_CODES, RetryConfig, StreamUrlProtocol, TextResponse, ToastHandler, UseRouterHook, _getAuthErrorHandler, _isAuthRecoverable, _resetArcFetchClient, _resetAuthRecovery, _resetAuthWarnings, _resolveRefreshedToken, _runAuthRecovery, arc, arcAuthHeaders, arcFetch, buildStreamUrl, configureAuth, configureClient, createAuthAwareClient, createAuthRefreshHandler, createClient, createQueryString, getAuthContext, getAuthMode, getBaseUrl, getClientAuthContext, handleApiRequest, hasGlobalStaticAuth, isAbortError, isArcApiError, isArcErrorCode, isAutoIdempotency, isDuplicateKeyError, isOrgContextRequiredError, isValidationError };
+export { AfterResponseContext, AfterResponseInterceptor, ApiRequestOptions, ArcApiError, ArcApiErrorOptions, ArcClient, ArcClientConfig, ArcErrorCode, ArcFetchOptions, AuthConfig, AuthErrorContext, AuthErrorHandler, BeforeRequestContext, BeforeRequestInterceptor, BlobResponse, ClientConfig, ClientEncryptionConfig, HttpMethod, KNOWN_ARC_ERROR_CODES, NextFetchOptions, RetryConfig, StreamUrlProtocol, TextResponse, ToastHandler, UseRouterHook, _getAuthErrorHandler, _isAuthRecoverable, _resetArcFetchClient, _resetAuthRecovery, _resetAuthWarnings, _resolveRefreshedToken, _runAuthRecovery, arc, arcAuthHeaders, arcFetch, buildStreamUrl, configureAuth, configureClient, createAuthAwareClient, createAuthRefreshHandler, createClient, createQueryString, getAuthContext, getAuthMode, getBaseUrl, getClientAuthContext, handleApiRequest, hasGlobalStaticAuth, isAbortError, isArcApiError, isArcErrorCode, isAutoIdempotency, isDuplicateKeyError, isOrgContextRequiredError, isValidationError };

package/dist/client.js

@@ -738,7 +738,7 @@ function sleepAbortable(ms, signal) {
 }
 /** A single fetch attempt — used by executeRequest's retry loop. */
 async function executeAttempt(config, method, endpoint, options, attempt) {
-	const { body, token, organizationId, revalidate, headerOptions, tags, cache, signal, idempotencyKey, elevated } = options;
+	const { body, token, organizationId, revalidate, headerOptions, tags, next, cache, signal, idempotencyKey, elevated } = options;
 	const startTime = Date.now();
 	try {
 		let headers = {
@@ -788,14 +788,10 @@ async function executeAttempt(config, method, endpoint, options, attempt) {
 		};
 		if (serializedBody !== void 0) fetchOptions.body = serializedBody;
 		if (cache) fetchOptions.cache = cache;
-		if (revalidate !== void 0) fetchOptions.next = {
-			...fetchOptions.next,
-			revalidate
-		};
-		if (tags) fetchOptions.next = {
-			...fetchOptions.next,
-			tags
-		};
+		const nextCfg = { ...next };
+		if (revalidate !== void 0) nextCfg.revalidate = revalidate;
+		if (tags) nextCfg.tags = nextCfg.tags ? [...nextCfg.tags, ...tags] : tags;
+		if (nextCfg.revalidate !== void 0 || nextCfg.tags) fetchOptions.next = nextCfg;
 		if (!/^https?:\/\//i.test(endpoint) && !config.baseUrl) throw new Error(`[arc-next] handleApiRequest(${method} ${endpoint}): baseUrl is empty. Call configureClient({ baseUrl: '...' }) BEFORE the first request. If you use createAuthAwareClient() at module top-level, make sure the Providers component runs configureClient() first (e.g. in a useState() initializer, before the children render).`);
 		const response = await fetch(`${config.baseUrl}${endpoint}`, fetchOptions);
 		if (!response.ok) {
@@ -1062,7 +1058,7 @@ function sanitizeUserHeaders(headers) {
 * const result = await arc.post<{ ok: true }>('/api/statements', statements);
 */
 function arcFetch(path, options = {}) {
-	const { method = "GET", body, headers, signal, elevated, idempotencyKey, revalidate, tags, cache, client } = options;
+	const { method = "GET", body, headers, signal, elevated, idempotencyKey, revalidate, tags, next, cache, client } = options;
 	const transport = client ?? getDefaultArcFetchClient();
 	const apiOptions = {
 		body,
@@ -1072,6 +1068,7 @@ function arcFetch(path, options = {}) {
 		...idempotencyKey ? { idempotencyKey } : {},
 		...revalidate !== void 0 ? { revalidate } : {},
 		...tags ? { tags } : {},
+		...next ? { next } : {},
 		...cache ? { cache } : {}
 	};
 	return transport.request(method, path, apiOptions);

package/dist/prefetch.d.ts

@@ -11,7 +11,24 @@ interface PrefetchAuthContext {
 }
 interface PrefetchOptions extends PrefetchAuthContext {
   staleTime?: number;
+  /**
+   * Next.js fetch caching forwarded to the underlying API call. A Server
+   * Component that prefetches with `revalidate` lets that data participate in
+   * ISR — without it the SDK's default `no-store` pins the whole route to
+   * dynamic rendering (e.g. a shared layout prefetch silently disables ISR on
+   * every page under it). Inert off-Next (React Native / plain browser fetch).
+   */
+  cache?: RequestCache;
+  revalidate?: number | false;
+  tags?: string[];
 }
+/** Per-call API `options` the prefetcher forwards (caching + custom headers). */
+type ForwardedApiOptions = {
+  headerOptions?: Record<string, string>;
+  cache?: RequestCache;
+  revalidate?: number | false;
+  tags?: string[];
+};
 interface PrefetchDetailOptions extends PrefetchOptions {
   /** Query params (select, populate) — key must match useDetail's params to share cache */
   params?: {
@@ -107,51 +124,39 @@ declare function createCrudPrefetcher(api: {
     params?: Record<string, unknown>;
     token?: string | null;
     organizationId?: string | null;
-    options?: {
-      headerOptions?: Record<string, string>;
-    };
+    options?: ForwardedApiOptions;
   }) => Promise<unknown>;
   getById: (opts: {
     id: string;
     token?: string | null;
     organizationId?: string | null;
-    options?: {
-      headerOptions?: Record<string, string>;
-    };
+    options?: ForwardedApiOptions;
   }) => Promise<unknown>;
   getBySlug?: (opts: {
     slug: string;
     token?: string | null;
     organizationId?: string | null;
     params?: Record<string, unknown>;
-    options?: {
-      headerOptions?: Record<string, string>;
-    };
+    options?: ForwardedApiOptions;
   }) => Promise<unknown>;
   getDeleted?: (opts: {
     params?: Record<string, unknown>;
     token?: string | null;
     organizationId?: string | null;
-    options?: {
-      headerOptions?: Record<string, string>;
-    };
+    options?: ForwardedApiOptions;
   }) => Promise<unknown>;
   aggregate?: (opts: {
     name: string;
     filter?: Record<string, unknown>;
     token?: string | null;
     organizationId?: string | null;
-    options?: {
-      headerOptions?: Record<string, string>;
-    };
+    options?: ForwardedApiOptions;
   }) => Promise<unknown>;
   getTree?: (opts: {
     params?: Record<string, unknown>;
     token?: string | null;
     organizationId?: string | null;
-    options?: {
-      headerOptions?: Record<string, string>;
-    };
+    options?: ForwardedApiOptions;
   }) => Promise<unknown>;
 }, entityKey: string): CrudPrefetcher;
 //#endregion

package/dist/prefetch.js

@@ -29,6 +29,14 @@ import { HydrationBoundary, dehydrate } from "@tanstack/react-query";
 */
 function createCrudPrefetcher(api, entityKey) {
 	const KEYS = createQueryKeys(entityKey);
+	const apiOptions = (o) => {
+		const opt = {};
+		if (o.headers) opt.headerOptions = o.headers;
+		if (o.cache !== void 0) opt.cache = o.cache;
+		if (o.revalidate !== void 0) opt.revalidate = o.revalidate;
+		if (o.tags !== void 0) opt.tags = o.tags;
+		return Object.keys(opt).length ? { options: opt } : {};
+	};
 	return {
 		async prefetchList(queryClient, params = {}, options = {}) {
 			const { organizationId: paramOrgId, ...restParams } = params;
@@ -44,7 +52,7 @@ function createCrudPrefetcher(api, entityKey) {
 					params: restParams,
 					token: options.token ?? null,
 					organizationId: orgId,
-					...options.headers ? { options: { headerOptions: options.headers } } : {}
+					...apiOptions(options)
 				}),
 				staleTime: options.staleTime
 			});
@@ -60,7 +68,7 @@ function createCrudPrefetcher(api, entityKey) {
 					token: token ?? null,
 					organizationId: organizationId ?? null,
 					...params ? { params } : {},
-					...options.headers ? { options: { headerOptions: options.headers } } : {}
+					...apiOptions(options)
 				}),
 				staleTime
 			});
@@ -76,7 +84,7 @@ function createCrudPrefetcher(api, entityKey) {
 					token: token ?? null,
 					organizationId: organizationId ?? null,
 					...params ? { params } : {},
-					...options.headers ? { options: { headerOptions: options.headers } } : {}
+					...apiOptions(options)
 				}),
 				staleTime
 			});
@@ -95,7 +103,7 @@ function createCrudPrefetcher(api, entityKey) {
 					params: restParams,
 					token: options.token ?? null,
 					organizationId: orgId,
-					...options.headers ? { options: { headerOptions: options.headers } } : {}
+					...apiOptions(options)
 				}),
 				staleTime: options.staleTime
 			});
@@ -115,7 +123,7 @@ function createCrudPrefetcher(api, entityKey) {
 					filter,
 					token: options.token ?? null,
 					organizationId: orgId,
-					...options.headers ? { options: { headerOptions: options.headers } } : {}
+					...apiOptions(options)
 				}),
 				staleTime: options.staleTime
 			});
@@ -134,7 +142,7 @@ function createCrudPrefetcher(api, entityKey) {
 					params: restParams,
 					token: options.token ?? null,
 					organizationId: orgId,
-					...options.headers ? { options: { headerOptions: options.headers } } : {}
+					...apiOptions(options)
 				}),
 				staleTime: options.staleTime
 			});
@@ -156,7 +164,7 @@ function createCrudPrefetcher(api, entityKey) {
 					},
 					token: options.token ?? null,
 					organizationId: orgId,
-					...options.headers ? { options: { headerOptions: options.headers } } : {}
+					...apiOptions(options)
 				}),
 				initialPageParam: 1,
 				getNextPageParam: () => void 0,

package/dist/presets/bulk.d.ts

@@ -1,4 +1,4 @@
-import { BaseApi, ScopedArgs } from "../api.js";
+import { AnyBaseApi, CreateOf, DocOf, ScopedArgs, UpdateOf } from "../api.js";
 import { BulkCreateResult, DeleteManyResult, UpdateManyResult } from "@classytic/repo-core/repository";
 
 //#region src/presets/bulk.d.ts
@@ -38,6 +38,6 @@ interface BulkMethods<TDoc, TCreate = Partial<TDoc>, TUpdate = Partial<TDoc>> {
  * await todos.bulkUpdate({ filter: { status: 'pending' }, data: { status: 'archived' } });
  * await todos.bulkDelete({ filter: { archivedBefore: '2024-01-01' } });
  */
-declare function withBulk<TDoc, TCreate, TUpdate>(api: BaseApi<TDoc, TCreate, TUpdate>): BaseApi<TDoc, TCreate, TUpdate> & BulkMethods<TDoc, TCreate, TUpdate>;
+declare function withBulk<TApi extends AnyBaseApi>(api: TApi): TApi & BulkMethods<DocOf<TApi>, CreateOf<TApi>, UpdateOf<TApi>>;
 //#endregion
 export { BulkMethods, withBulk };

package/dist/presets/search.d.ts

@@ -1,4 +1,4 @@
-import { BaseApi, ScopedArgs } from "../api.js";
+import { AnyBaseApi, DocOf, ScopedArgs } from "../api.js";
 import { PaginatedResult } from "@classytic/repo-core/pagination";
 
 //#region src/presets/search.d.ts
@@ -51,6 +51,6 @@ interface SearchPresetMethods<TDoc> {
  * await places.searchSimilar({ vector: [0.1, 0.2, ...], body: { topK: 5 } });
  * await places.embed({ input: 'hello world' });
  */
-declare function withSearchPreset<TDoc, TCreate, TUpdate>(api: BaseApi<TDoc, TCreate, TUpdate>): BaseApi<TDoc, TCreate, TUpdate> & SearchPresetMethods<TDoc>;
+declare function withSearchPreset<TApi extends AnyBaseApi>(api: TApi): TApi & SearchPresetMethods<DocOf<TApi>>;
 //#endregion
 export { SearchPresetMethods, withSearchPreset };

package/dist/presets/slug.d.ts

@@ -1,4 +1,4 @@
-import { BaseApi, ScopedArgs } from "../api.js";
+import { AnyBaseApi, DocOf, ScopedArgs } from "../api.js";
 
 //#region src/presets/slug.d.ts
 interface SlugLookupMethods<TDoc> {
@@ -23,6 +23,6 @@ interface SlugLookupMethods<TDoc> {
  *
  * const cat = await categories.getBySlug({ slug: 'engineering' });
  */
-declare function withSlugLookup<TDoc, TCreate, TUpdate>(api: BaseApi<TDoc, TCreate, TUpdate>): BaseApi<TDoc, TCreate, TUpdate> & SlugLookupMethods<TDoc>;
+declare function withSlugLookup<TApi extends AnyBaseApi>(api: TApi): TApi & SlugLookupMethods<DocOf<TApi>>;
 //#endregion
 export { SlugLookupMethods, withSlugLookup };

package/dist/presets/soft-delete.d.ts

@@ -1,4 +1,4 @@
-import { BaseApi, QueryParams, ScopedArgs } from "../api.js";
+import { AnyBaseApi, DocOf, QueryParams, ScopedArgs } from "../api.js";
 import { PaginatedResult } from "@classytic/repo-core/pagination";
 
 //#region src/presets/soft-delete.d.ts
@@ -29,6 +29,6 @@ interface SoftDeleteMethods<TDoc> {
  * await todos.restore({ id });            // undo
  * const trash = await todos.getDeleted();
  */
-declare function withSoftDelete<TDoc, TCreate, TUpdate>(api: BaseApi<TDoc, TCreate, TUpdate>): BaseApi<TDoc, TCreate, TUpdate> & SoftDeleteMethods<TDoc>;
+declare function withSoftDelete<TApi extends AnyBaseApi>(api: TApi): TApi & SoftDeleteMethods<DocOf<TApi>>;
 //#endregion
 export { SoftDeleteMethods, withSoftDelete };

package/dist/presets/tree.d.ts

@@ -1,4 +1,4 @@
-import { BaseApi, QueryParams, ScopedArgs } from "../api.js";
+import { AnyBaseApi, DocOf, QueryParams, ScopedArgs } from "../api.js";
 import { PaginatedResult } from "@classytic/repo-core/pagination";
 
 //#region src/presets/tree.d.ts
@@ -27,6 +27,6 @@ interface TreeMethods<TDoc> {
  * const root = await categories.getTree();
  * const kids = await categories.getChildren({ parentId: 'engineering' });
  */
-declare function withTree<TDoc, TCreate, TUpdate>(api: BaseApi<TDoc, TCreate, TUpdate>): BaseApi<TDoc, TCreate, TUpdate> & TreeMethods<TDoc>;
+declare function withTree<TApi extends AnyBaseApi>(api: TApi): TApi & TreeMethods<DocOf<TApi>>;
 //#endregion
 export { TreeMethods, withTree };

package/dist/presets/tree.js

@@ -16,14 +16,10 @@
 function withTree(api) {
 	return Object.assign(api, {
 		async getTree({ token = null, organizationId = null, params = {}, options = {} } = {}) {
-			const merged = {
-				...api.config.defaultParams,
-				...params
-			};
 			return api.request("GET", `${api.baseUrl}/tree`, {
 				token,
 				organizationId,
-				params: merged,
+				params,
 				options
 			});
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/arc-next",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "React + TanStack Query SDK for Arc resources",
   "type": "module",
   "sideEffects": false,
@@ -123,7 +123,8 @@
     "push": "classytic-push",
     "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
     "release": "npm run push -- main && npm run release:tag && npm publish",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.test.json"
   },
   "peerDependencies": {
     "@classytic/repo-core": ">=0.4.0",
@@ -132,10 +133,18 @@
     "react": ">=19.0.0"
   },
   "peerDependenciesMeta": {
-    "react": { "optional": false },
-    "@tanstack/react-query": { "optional": false },
-    "@classytic/repo-core": { "optional": false },
-    "jose": { "optional": true }
+    "react": {
+      "optional": false
+    },
+    "@tanstack/react-query": {
+      "optional": false
+    },
+    "@classytic/repo-core": {
+      "optional": false
+    },
+    "jose": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@classytic/dev-tools": "^0.2.0",