@classytic/arc-next 0.7.0 → 0.7.1

package/dist/client.js

@@ -585,16 +585,48 @@ function createClient(config) {
 * });
 */
 function createAuthAwareClient(overrides = {}) {
-	return createClient({
-		baseUrl: overrides.baseUrl ?? getBaseUrl(),
-		authMode: overrides.authMode ?? getAuthMode(),
-		autoIdempotency: overrides.autoIdempotency ?? isAutoIdempotency(),
-		elevated: overrides.elevated ?? clientConfig?.elevated,
-		...overrides,
-		getToken: overrides.getToken ?? (() => readToken(authConfig?.getToken)),
-		getOrgId: overrides.getOrgId ?? (() => authConfig?.getOrgId?.() ?? null),
-		headerName: overrides.headerName ?? authConfig?.headerName
+	const { toast, navigation, getToken, getOrgId, headerName, ...overrideCfg } = overrides;
+	const authGetToken = getToken ?? (() => readToken(authConfig?.getToken));
+	const authGetOrgId = getOrgId ?? (() => authConfig?.getOrgId?.() ?? null);
+	const authHeaderName = headerName ?? authConfig?.headerName;
+	const clientAuth = {
+		getToken: authGetToken,
+		getOrgId: authGetOrgId,
+		headerName: authHeaderName
+	};
+	const resolveClientCfg = () => ({
+		baseUrl: overrideCfg.baseUrl ?? getBaseUrl(),
+		authMode: overrideCfg.authMode ?? getAuthMode(),
+		autoIdempotency: overrideCfg.autoIdempotency ?? isAutoIdempotency(),
+		elevated: overrideCfg.elevated ?? clientConfig?.elevated,
+		internalApiKey: overrideCfg.internalApiKey ?? clientConfig?.internalApiKey,
+		defaultHeaders: overrideCfg.defaultHeaders ?? clientConfig?.defaultHeaders,
+		credentials: overrideCfg.credentials ?? clientConfig?.credentials,
+		apiVersion: overrideCfg.apiVersion ?? clientConfig?.apiVersion,
+		retry: overrideCfg.retry ?? clientConfig?.retry,
+		beforeRequest: overrideCfg.beforeRequest ?? clientConfig?.beforeRequest,
+		afterResponse: overrideCfg.afterResponse ?? clientConfig?.afterResponse
 	});
+	return {
+		request: (method, endpoint, options) => {
+			const cfg = resolveClientCfg();
+			const resolved = { ...options };
+			if (resolved.token === void 0) resolved.token = readToken(authGetToken);
+			if (resolved.organizationId === void 0) resolved.organizationId = authGetOrgId();
+			if (cfg.authMode === "header" && resolved.token) {
+				resolved.headerOptions = {
+					[authHeaderName ?? "x-api-key"]: resolved.token,
+					...resolved.headerOptions ?? {}
+				};
+				resolved.token = void 0;
+			}
+			return executeRequest(cfg, method, endpoint, resolved);
+		},
+		config: resolveClientCfg(),
+		toast,
+		navigation,
+		auth: clientAuth
+	};
 }
 /**
 * Get auth context for a specific client instance, falling back to global.
@@ -759,6 +791,7 @@ async function executeAttempt(config, method, endpoint, options, attempt) {
 			...fetchOptions.next,
 			tags
 		};
+		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) {
 			let json = null;

package/dist/query.d.ts

@@ -57,8 +57,28 @@ interface DetailQueryOptions<TData = unknown> {
   /** Pass-through options for the underlying fetch request (cache, revalidate, tags, headers) */
   request?: RequestPassthrough;
 }
+/**
+ * Result of `useList` (and `useListQuery`). Matches the same typed-end-to-end
+ * shape `repo-core` uses for its server-side result interfaces (`AggResult`,
+ * `OffsetPaginationResult`, etc.) — no raw-cache escape hatch on the public
+ * surface, just the typed extracted view.
+ *
+ * Need the raw cache entry? Use `useQueryClient().getQueryData(KEYS.list(...))`
+ * — it's typed against whatever `setQueryData` last wrote, and it makes the
+ * "I'm reaching past the SDK" intent explicit.
+ */
 interface ListQueryResult<T> {
+  /**
+   * Extracted items array — `T[]`. Always typed, always flat (infinite-list
+   * pages are pre-flattened), always consistent across response-shape
+   * variants (`data` / `items` / `results` / any-array fallback).
+   */
   items: T[];
+  /**
+   * Normalized pagination snapshot — offset / keyset / aggregate all map
+   * onto the same `{ method, total, pages, page, limit, hasNext, hasPrev, next? }`
+   * shape. `null` when the response carries no pagination signal.
+   */
   pagination: PaginationData | null;
   isLoading: boolean;
   isFetching: boolean;
@@ -67,9 +87,22 @@ interface ListQueryResult<T> {
   isStale: boolean;
   error: Error | null;
   refetch: () => Promise<unknown>;
-  data: unknown;
 }
+/**
+ * Result of `useDetail` (and `useDetailQuery`). Matches the typed-end-to-end
+ * shape repo-core uses for its result interfaces — no raw-cache escape
+ * hatch on the public surface, just the typed extracted view.
+ *
+ * Need the raw cache entry? `useQueryClient().getQueryData(KEYS.detail(id))`
+ * — typed against whatever `setQueryData` last wrote, and the explicit
+ * `getQueryData` call signals "I'm reaching past the SDK" at the call site.
+ */
 interface DetailQueryResult<T> {
+  /**
+   * The extracted entity — `T | null`. Always typed, always the raw doc
+   * (not a wrapper), always consistent with what `prefetchDetail` /
+   * `cache.getDetail` / `useNavigation` write back.
+   */
   item: T | null;
   isLoading: boolean;
   isFetching: boolean;
@@ -85,7 +118,6 @@ interface DetailQueryResult<T> {
   isPlaceholderData: boolean;
   error: Error | null;
   refetch: () => Promise<unknown>;
-  data: unknown;
 }
 interface CreateListQueryConfig {
   queryKey: QueryKey;

package/dist/query.js

@@ -39,8 +39,7 @@ function useListQuery({ queryKey, queryFn, enabled = true, options = {}, select
 		isSuccess: query.isSuccess,
 		isStale: query.isStale,
 		error: query.error,
-		refetch: query.refetch,
-		data: query.data
+		refetch: query.refetch
 	};
 }
 /**
@@ -97,8 +96,7 @@ function useDetailQuery({ queryKey, queryFn, enabled = true, options = {}, selec
 		isStale: query.isStale,
 		isPlaceholderData: query.isPlaceholderData,
 		error: query.error,
-		refetch: query.refetch,
-		data: query.data
+		refetch: query.refetch
 	};
 }
 function useInfiniteListQuery({ queryKey, queryFn, enabled = true, options = {}, initialPageParam = 1, getNextPageParam, getPreviousPageParam, maxPages }) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/arc-next",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "React + TanStack Query SDK for Arc resources",
   "type": "module",
   "sideEffects": false,