enlace 0.0.0-alpha.4 → 0.0.1-beta.10

package/dist/hook/index.mjs

@@ -0,0 +1,498 @@
+"use client";
+"use client";
+
+// src/react/createEnlaceHookReact.ts
+import { createEnlace } from "enlace-core";
+
+// src/react/useQueryMode.ts
+import { useRef, useReducer, useEffect } from "react";
+
+// src/react/reducer.ts
+var initialState = {
+  loading: false,
+  fetching: false,
+  data: void 0,
+  error: void 0
+};
+function hookReducer(state, action) {
+  switch (action.type) {
+    case "RESET":
+      return action.state ?? initialState;
+    case "FETCH_START":
+      return {
+        ...state,
+        loading: state.data === void 0,
+        fetching: true
+      };
+    case "FETCH_SUCCESS":
+      return {
+        loading: false,
+        fetching: false,
+        data: action.data,
+        error: void 0
+      };
+    case "FETCH_ERROR":
+      return {
+        loading: false,
+        fetching: false,
+        data: void 0,
+        error: action.error
+      };
+    case "SYNC_CACHE":
+      return action.state;
+    default:
+      return state;
+  }
+}
+
+// src/utils/generateTags.ts
+function generateTags(path) {
+  return path.map((_, i) => path.slice(0, i + 1).join("/"));
+}
+
+// src/utils/sortObjectKeys.ts
+function sortObjectKeys(obj) {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) return obj.map(sortObjectKeys);
+  return Object.keys(obj).sort().reduce(
+    (sorted, key) => {
+      sorted[key] = sortObjectKeys(obj[key]);
+      return sorted;
+    },
+    {}
+  );
+}
+
+// src/react/cache.ts
+var cache = /* @__PURE__ */ new Map();
+function createQueryKey(tracked) {
+  return JSON.stringify(
+    sortObjectKeys({
+      path: tracked.path,
+      method: tracked.method,
+      options: tracked.options
+    })
+  );
+}
+function getCache(key) {
+  return cache.get(key);
+}
+function setCache(key, entry) {
+  const existing = cache.get(key);
+  if (existing) {
+    if ("data" in entry || "error" in entry) {
+      delete existing.promise;
+    }
+    Object.assign(existing, entry);
+    existing.subscribers.forEach((cb) => cb());
+  } else {
+    cache.set(key, {
+      data: void 0,
+      error: void 0,
+      timestamp: 0,
+      tags: [],
+      subscribers: /* @__PURE__ */ new Set(),
+      ...entry
+    });
+  }
+}
+function subscribeCache(key, callback) {
+  let entry = cache.get(key);
+  if (!entry) {
+    cache.set(key, {
+      data: void 0,
+      error: void 0,
+      timestamp: 0,
+      tags: [],
+      subscribers: /* @__PURE__ */ new Set()
+    });
+    entry = cache.get(key);
+  }
+  entry.subscribers.add(callback);
+  return () => {
+    entry.subscribers.delete(callback);
+  };
+}
+function isStale(key, staleTime) {
+  const entry = cache.get(key);
+  if (!entry) return true;
+  return Date.now() - entry.timestamp > staleTime;
+}
+function clearCacheByTags(tags) {
+  cache.forEach((entry) => {
+    const hasMatch = entry.tags.some((tag) => tags.includes(tag));
+    if (hasMatch) {
+      entry.data = void 0;
+      entry.error = void 0;
+      entry.timestamp = 0;
+      delete entry.promise;
+    }
+  });
+}
+
+// src/react/revalidator.ts
+var listeners = /* @__PURE__ */ new Set();
+function invalidateTags(tags) {
+  clearCacheByTags(tags);
+  listeners.forEach((listener) => listener(tags));
+}
+function onRevalidate(callback) {
+  listeners.add(callback);
+  return () => listeners.delete(callback);
+}
+
+// src/react/useQueryMode.ts
+function resolvePath(path, pathParams) {
+  if (!pathParams) return path;
+  return path.map((segment) => {
+    if (segment.startsWith(":")) {
+      const paramName = segment.slice(1);
+      const value = pathParams[paramName];
+      if (value === void 0) {
+        throw new Error(`Missing path parameter: ${paramName}`);
+      }
+      return String(value);
+    }
+    return segment;
+  });
+}
+function useQueryMode(api, trackedCall, options) {
+  const { autoGenerateTags, staleTime, enabled } = options;
+  const queryKey = createQueryKey(trackedCall);
+  const requestOptions = trackedCall.options;
+  const resolvedPath = resolvePath(
+    trackedCall.path,
+    requestOptions?.pathParams
+  );
+  const queryTags = requestOptions?.tags ?? (autoGenerateTags ? generateTags(resolvedPath) : []);
+  const getCacheState = (includeNeedsFetch = false) => {
+    const cached = getCache(queryKey);
+    const hasCachedData = cached?.data !== void 0;
+    const isFetching = !!cached?.promise;
+    const needsFetch = includeNeedsFetch && (!hasCachedData || isStale(queryKey, staleTime));
+    return {
+      loading: !hasCachedData && (isFetching || needsFetch),
+      fetching: isFetching || needsFetch,
+      data: cached?.data,
+      error: cached?.error
+    };
+  };
+  const [state, dispatch] = useReducer(
+    hookReducer,
+    null,
+    () => getCacheState(true)
+  );
+  const mountedRef = useRef(true);
+  const fetchRef = useRef(null);
+  useEffect(() => {
+    mountedRef.current = true;
+    if (!enabled) {
+      dispatch({ type: "RESET" });
+      return () => {
+        mountedRef.current = false;
+      };
+    }
+    dispatch({ type: "RESET", state: getCacheState(true) });
+    const doFetch = () => {
+      const cached2 = getCache(queryKey);
+      if (cached2?.promise) {
+        return;
+      }
+      dispatch({ type: "FETCH_START" });
+      let current = api;
+      for (const segment of resolvedPath) {
+        current = current[segment];
+      }
+      const method = current[trackedCall.method];
+      const fetchPromise = method(trackedCall.options).then((res) => {
+        if (mountedRef.current) {
+          setCache(queryKey, {
+            data: res.error ? void 0 : res.data,
+            error: res.error,
+            timestamp: Date.now(),
+            tags: queryTags
+          });
+        }
+      });
+      setCache(queryKey, {
+        promise: fetchPromise,
+        tags: queryTags
+      });
+    };
+    fetchRef.current = doFetch;
+    const cached = getCache(queryKey);
+    if (cached?.data !== void 0 && !isStale(queryKey, staleTime)) {
+      dispatch({ type: "SYNC_CACHE", state: getCacheState() });
+    } else {
+      doFetch();
+    }
+    const unsubscribe = subscribeCache(queryKey, () => {
+      if (mountedRef.current) {
+        dispatch({ type: "SYNC_CACHE", state: getCacheState() });
+      }
+    });
+    return () => {
+      mountedRef.current = false;
+      fetchRef.current = null;
+      unsubscribe();
+    };
+  }, [queryKey, enabled]);
+  useEffect(() => {
+    if (queryTags.length === 0) return;
+    return onRevalidate((invalidatedTags) => {
+      const hasMatch = invalidatedTags.some((tag) => queryTags.includes(tag));
+      if (hasMatch && mountedRef.current && fetchRef.current) {
+        fetchRef.current();
+      }
+    });
+  }, [JSON.stringify(queryTags)]);
+  return state;
+}
+
+// src/react/types.ts
+var HTTP_METHODS = ["get", "post", "put", "patch", "delete"];
+
+// src/react/trackingProxy.ts
+function createTrackingProxy(onTrack) {
+  const createProxy = (path = []) => {
+    return new Proxy(() => {
+    }, {
+      get(_, prop) {
+        if (HTTP_METHODS.includes(prop)) {
+          const methodFn = (options) => {
+            onTrack({
+              trackedCall: { path, method: prop, options },
+              selectorPath: null,
+              selectorMethod: null
+            });
+            return Promise.resolve({ status: 200, data: void 0, error: void 0 });
+          };
+          onTrack({
+            trackedCall: null,
+            selectorPath: path,
+            selectorMethod: prop
+          });
+          return methodFn;
+        }
+        return createProxy([...path, prop]);
+      }
+    });
+  };
+  return createProxy();
+}
+
+// src/react/useSelectorMode.ts
+import { useRef as useRef2, useReducer as useReducer2 } from "react";
+function resolvePath2(path, pathParams) {
+  if (!pathParams) return path;
+  return path.map((segment) => {
+    if (segment.startsWith(":")) {
+      const paramName = segment.slice(1);
+      const value = pathParams[paramName];
+      if (value === void 0) {
+        throw new Error(`Missing path parameter: ${paramName}`);
+      }
+      return String(value);
+    }
+    return segment;
+  });
+}
+function hasPathParams(path) {
+  return path.some((segment) => segment.startsWith(":"));
+}
+function useSelectorMode(config) {
+  const { method, api, path, methodName, autoRevalidateTags } = config;
+  const [state, dispatch] = useReducer2(hookReducer, initialState);
+  const methodRef = useRef2(method);
+  const apiRef = useRef2(api);
+  const triggerRef = useRef2(null);
+  const pathRef = useRef2(path);
+  const methodNameRef = useRef2(methodName);
+  const autoRevalidateRef = useRef2(autoRevalidateTags);
+  methodRef.current = method;
+  apiRef.current = api;
+  pathRef.current = path;
+  methodNameRef.current = methodName;
+  autoRevalidateRef.current = autoRevalidateTags;
+  if (!triggerRef.current) {
+    triggerRef.current = (async (...args) => {
+      dispatch({ type: "FETCH_START" });
+      const options = args[0];
+      const resolvedPath = resolvePath2(pathRef.current, options?.pathParams);
+      let res;
+      if (hasPathParams(pathRef.current)) {
+        let current = apiRef.current;
+        for (const segment of resolvedPath) {
+          current = current[segment];
+        }
+        const resolvedMethod = current[methodNameRef.current];
+        res = await resolvedMethod(...args);
+      } else {
+        res = await methodRef.current(...args);
+      }
+      if (!res.error) {
+        dispatch({ type: "FETCH_SUCCESS", data: res.data });
+        const tagsToInvalidate = options?.revalidateTags ?? (autoRevalidateRef.current ? generateTags(resolvedPath) : []);
+        if (tagsToInvalidate.length > 0) {
+          invalidateTags(tagsToInvalidate);
+        }
+      } else {
+        dispatch({ type: "FETCH_ERROR", error: res.error });
+      }
+      return res;
+    });
+  }
+  return {
+    trigger: triggerRef.current,
+    ...state
+  };
+}
+
+// src/react/createEnlaceHookReact.ts
+function createEnlaceHookReact(baseUrl, defaultOptions = {}, hookOptions = {}) {
+  const {
+    autoGenerateTags = true,
+    autoRevalidateTags = true,
+    staleTime = 0,
+    onSuccess,
+    onError
+  } = hookOptions;
+  const api = createEnlace(baseUrl, defaultOptions, { onSuccess, onError });
+  function useEnlaceHook(selectorOrQuery, queryOptions) {
+    let trackingResult = {
+      trackedCall: null,
+      selectorPath: null,
+      selectorMethod: null
+    };
+    const trackingProxy = createTrackingProxy((result2) => {
+      trackingResult = result2;
+    });
+    const result = selectorOrQuery(
+      trackingProxy
+    );
+    if (typeof result === "function") {
+      const actualResult = selectorOrQuery(api);
+      return useSelectorMode({
+        method: actualResult,
+        api,
+        path: trackingResult.selectorPath ?? [],
+        methodName: trackingResult.selectorMethod ?? "",
+        autoRevalidateTags
+      });
+    }
+    return useQueryMode(
+      api,
+      trackingResult.trackedCall,
+      { autoGenerateTags, staleTime, enabled: queryOptions?.enabled ?? true }
+    );
+  }
+  return useEnlaceHook;
+}
+
+// src/next/index.ts
+import {
+  createProxyHandler
+} from "enlace-core";
+
+// src/next/fetch.ts
+import {
+  executeFetch
+} from "enlace-core";
+async function executeNextFetch(baseUrl, path, method, combinedOptions, requestOptions) {
+  const {
+    autoGenerateTags = true,
+    autoRevalidateTags = true,
+    revalidator,
+    onSuccess,
+    ...coreOptions
+  } = combinedOptions;
+  const isGet = method === "GET";
+  const autoTags = generateTags(path);
+  const nextOnSuccess = (payload) => {
+    if (!isGet && !requestOptions?.skipRevalidator) {
+      const revalidateTags = requestOptions?.revalidateTags ?? (autoRevalidateTags ? autoTags : []);
+      const revalidatePaths = requestOptions?.revalidatePaths ?? [];
+      if (revalidateTags.length || revalidatePaths.length) {
+        revalidator?.(revalidateTags, revalidatePaths);
+      }
+    }
+    onSuccess?.(payload);
+  };
+  const nextRequestOptions = { ...requestOptions };
+  if (isGet) {
+    const tags = requestOptions?.tags ?? (autoGenerateTags ? autoTags : void 0);
+    const nextFetchOptions = {};
+    if (tags) {
+      nextFetchOptions.tags = tags;
+    }
+    if (requestOptions?.revalidate !== void 0) {
+      nextFetchOptions.revalidate = requestOptions.revalidate;
+    }
+    nextRequestOptions.next = nextFetchOptions;
+  }
+  return executeFetch(
+    baseUrl,
+    path,
+    method,
+    { ...coreOptions, onSuccess: nextOnSuccess },
+    nextRequestOptions
+  );
+}
+
+// src/next/index.ts
+function createEnlaceNext(baseUrl, defaultOptions = {}, nextOptions = {}) {
+  const combinedOptions = { ...defaultOptions, ...nextOptions };
+  return createProxyHandler(
+    baseUrl,
+    combinedOptions,
+    [],
+    executeNextFetch
+  );
+}
+
+// src/next/createEnlaceHookNext.ts
+function createEnlaceHookNext(baseUrl, defaultOptions = {}, hookOptions = {}) {
+  const {
+    autoGenerateTags = true,
+    autoRevalidateTags = true,
+    staleTime = 0,
+    ...nextOptions
+  } = hookOptions;
+  const api = createEnlaceNext(baseUrl, defaultOptions, {
+    autoGenerateTags,
+    autoRevalidateTags,
+    ...nextOptions
+  });
+  function useEnlaceHook(selectorOrQuery, queryOptions) {
+    let trackedCall = null;
+    let selectorPath = null;
+    let selectorMethod = null;
+    const trackingProxy = createTrackingProxy((result2) => {
+      trackedCall = result2.trackedCall;
+      selectorPath = result2.selectorPath;
+      selectorMethod = result2.selectorMethod;
+    });
+    const result = selectorOrQuery(trackingProxy);
+    if (typeof result === "function") {
+      const actualResult = selectorOrQuery(api);
+      return useSelectorMode({
+        method: actualResult,
+        api,
+        path: selectorPath ?? [],
+        methodName: selectorMethod ?? "",
+        autoRevalidateTags
+      });
+    }
+    return useQueryMode(
+      api,
+      trackedCall,
+      { autoGenerateTags, staleTime, enabled: queryOptions?.enabled ?? true }
+    );
+  }
+  return useEnlaceHook;
+}
+export {
+  HTTP_METHODS,
+  createEnlaceHookNext,
+  createEnlaceHookReact
+};

package/dist/index.d.mts

@@ -1,121 +1,83 @@
-type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-type SchemaMethod = "$get" | "$post" | "$put" | "$patch" | "$delete";
-type EnlaceResponse<TData, TError> = {
-    ok: true;
-    status: number;
-    data: TData;
-    error?: never;
-} | {
-    ok: false;
-    status: number;
-    data?: never;
-    error: TError;
-};
-type EnlaceOptions = Omit<RequestInit, "method" | "body">;
-type FetchExecutor<TOptions = EnlaceOptions, TRequestOptions = RequestOptions<unknown>> = <TData, TError>(baseUrl: string, path: string[], method: HttpMethod, defaultOptions: TOptions, requestOptions?: TRequestOptions) => Promise<EnlaceResponse<TData, TError>>;
-type RequestOptions<TBody = never> = {
-    body?: TBody;
-    query?: Record<string, string | number | boolean | undefined>;
-    headers?: HeadersInit;
-    cache?: RequestCache;
+import { EnlaceCallbackPayload, EnlaceErrorCallbackPayload, EnlaceCallbacks, EnlaceOptions, WildcardClient, EnlaceClient } from 'enlace-core';
+export * from 'enlace-core';
+
+/** Per-request options for React hooks */
+type ReactRequestOptionsBase = {
+    /**
+     * Cache tags for caching (GET requests only)
+     * This will auto generate tags from the URL path if not provided and autoGenerateTags is enabled.
+     * But can be manually specified to override auto-generation.
+     * */
+    tags?: string[];
+    /** Tags to invalidate after mutation (triggers refetch in matching queries) */
+    revalidateTags?: string[];
+    /**
+     * Path parameters for dynamic URL segments.
+     * Used to replace :paramName placeholders in the URL path.
+     * @example
+     * // With path api.products[':id'].delete
+     * trigger({ pathParams: { id: '123' } }) // → DELETE /products/123
+     */
+    pathParams?: Record<string, string | number>;
 };
-type MethodDefinition = {
-    data: unknown;
-    error: unknown;
-    body?: unknown;
+/** Options for createEnlaceHookReact factory */
+type EnlaceHookOptions = {
+    /**
+     * Auto-generate cache tags from URL path for GET requests.
+     * e.g., `/posts/1` generates tags `['posts', 'posts/1']`
+     * @default true
+     */
+    autoGenerateTags?: boolean;
+    /** Auto-revalidate generated tags after successful mutations. @default true */
+    autoRevalidateTags?: boolean;
+    /** Time in ms before cached data is considered stale. @default 0 (always stale) */
+    staleTime?: number;
+    /** Callback called on successful API responses */
+    onSuccess?: (payload: EnlaceCallbackPayload<unknown>) => void;
+    /** Callback called on error responses (HTTP errors or network failures) */
+    onError?: (payload: EnlaceErrorCallbackPayload<unknown>) => void;
 };
+
 /**
- * Helper to define an endpoint with proper typing.
- * Provides cleaner syntax than writing { data, error, body } manually.
- *
- * @example
- * type MyApi = {
- *   posts: {
- *     $get: Endpoint<Post[], ApiError>;
- *     $post: Endpoint<Post, ApiError, CreatePost>;  // with body
- *     _: {
- *       $get: Endpoint<Post, NotFoundError>;
- *     };
- *   };
- * };
+ * Handler function called after successful mutations to trigger server-side revalidation.
+ * @param tags - Cache tags to revalidate
+ * @param paths - URL paths to revalidate
  */
-type Endpoint<TData, TError, TBody = never> = [TBody] extends [never] ? {
-    data: TData;
-    error: TError;
-} : {
-    data: TData;
-    error: TError;
-    body: TBody;
-};
-type ExtractMethodDef<TSchema, TMethod extends SchemaMethod> = TSchema extends {
-    [K in TMethod]: infer M;
-} ? M extends MethodDefinition ? M : never : never;
-type ExtractData<TSchema, TMethod extends SchemaMethod> = ExtractMethodDef<TSchema, TMethod> extends {
-    data: infer D;
-} ? D : never;
-type ExtractError<TSchema, TMethod extends SchemaMethod> = ExtractMethodDef<TSchema, TMethod> extends {
-    error: infer E;
-} ? E : never;
-type ExtractBody<TSchema, TMethod extends SchemaMethod> = ExtractMethodDef<TSchema, TMethod> extends {
-    body: infer B;
-} ? B : never;
-type HasMethod<TSchema, TMethod extends SchemaMethod> = TSchema extends {
-    [K in TMethod]: MethodDefinition;
-} ? true : false;
-type MethodFn<TSchema, TMethod extends SchemaMethod, TRequestOptionsBase = object> = HasMethod<TSchema, TMethod> extends true ? ExtractBody<TSchema, TMethod> extends never ? (options?: RequestOptions<never> & TRequestOptionsBase) => Promise<EnlaceResponse<ExtractData<TSchema, TMethod>, ExtractError<TSchema, TMethod>>> : (options: RequestOptions<ExtractBody<TSchema, TMethod>> & TRequestOptionsBase) => Promise<EnlaceResponse<ExtractData<TSchema, TMethod>, ExtractError<TSchema, TMethod>>> : never;
-type IsSpecialKey<K> = K extends SchemaMethod | "_" ? true : false;
-type StaticPathKeys<TSchema> = {
-    [K in keyof TSchema as IsSpecialKey<K> extends true ? never : K extends string ? K : never]: TSchema[K];
+type RevalidateHandler = (tags: string[], paths: string[]) => void | Promise<void>;
+/** Next.js-specific options (third argument for createEnlaceNext) */
+type NextOptions = Pick<EnlaceHookOptions, "autoGenerateTags" | "autoRevalidateTags"> & EnlaceCallbacks & {
+    /**
+     * Handler called after successful mutations to trigger server-side revalidation.
+     * Receives auto-generated or manually specified tags and paths.
+     * @example
+     * ```ts
+     * createEnlaceNext("http://localhost:3000/api/", {}, {
+     *   revalidator: (tags, paths) => revalidateServerAction(tags, paths)
+     * });
+     * ```
+     */
+    revalidator?: RevalidateHandler;
 };
-type ExtractDynamicSchema<TSchema> = TSchema extends {
-    _: infer D;
-} ? D : never;
-type MethodOrPath<TSchema, TMethodName extends string, TSchemaMethod extends SchemaMethod, TRequestOptionsBase = object> = TMethodName extends keyof TSchema ? EnlaceClient<TSchema[TMethodName], TRequestOptionsBase> : MethodFn<TSchema, TSchemaMethod, TRequestOptionsBase>;
-type HttpMethods<TSchema, TRequestOptionsBase = object> = {
-    get: MethodOrPath<TSchema, "get", "$get", TRequestOptionsBase>;
-    post: MethodOrPath<TSchema, "post", "$post", TRequestOptionsBase>;
-    put: MethodOrPath<TSchema, "put", "$put", TRequestOptionsBase>;
-    patch: MethodOrPath<TSchema, "patch", "$patch", TRequestOptionsBase>;
-    delete: MethodOrPath<TSchema, "delete", "$delete", TRequestOptionsBase>;
+/** Per-request options for Next.js fetch - extends React's base options */
+type NextRequestOptionsBase = ReactRequestOptionsBase & {
+    /** Time in seconds to revalidate, or false to disable */
+    revalidate?: number | false;
+    /**
+     * URL paths to revalidate after mutation
+     * This doesn't do anything on the client by itself - it's passed to the revalidator handler.
+     * You must implement the revalidation logic in the revalidator.
+     */
+    revalidatePaths?: string[];
+    /**
+     * Skip server-side revalidation for this request.
+     * Useful when autoRevalidateTags is enabled but you want to opt-out for specific mutations.
+     * You can still pass empty [] to revalidateTags to skip triggering revalidation.
+     * But this flag can be used if you want to revalidate client-side and skip server-side entirely.
+     * Eg. you don't fetch any data on server component and you might want to skip the overhead of revalidation.
+     */
+    skipRevalidator?: boolean;
 };
-type DynamicAccess<TSchema, TRequestOptionsBase = object> = ExtractDynamicSchema<TSchema> extends never ? object : {
-    [key: string]: EnlaceClient<ExtractDynamicSchema<TSchema>, TRequestOptionsBase>;
-    [key: number]: EnlaceClient<ExtractDynamicSchema<TSchema>, TRequestOptionsBase>;
-};
-type MethodNameKeys = "get" | "post" | "put" | "patch" | "delete";
-type EnlaceClient<TSchema, TRequestOptionsBase = object> = HttpMethods<TSchema, TRequestOptionsBase> & DynamicAccess<TSchema, TRequestOptionsBase> & {
-    [K in keyof StaticPathKeys<TSchema> as K extends MethodNameKeys ? never : K]: EnlaceClient<TSchema[K], TRequestOptionsBase>;
-};
-type WildcardMethodFn<TRequestOptionsBase = object> = (options?: RequestOptions<unknown> & TRequestOptionsBase) => Promise<EnlaceResponse<unknown, unknown>>;
-/**
- * Wildcard client type - allows any path access when no schema is provided.
- * All methods are available at every level and return unknown types.
- */
-type WildcardClient<TRequestOptionsBase = object> = {
-    get: WildcardMethodFn<TRequestOptionsBase>;
-    post: WildcardMethodFn<TRequestOptionsBase>;
-    put: WildcardMethodFn<TRequestOptionsBase>;
-    patch: WildcardMethodFn<TRequestOptionsBase>;
-    delete: WildcardMethodFn<TRequestOptionsBase>;
-} & {
-    [key: string]: WildcardClient<TRequestOptionsBase>;
-    [key: number]: WildcardClient<TRequestOptionsBase>;
-};
-
-declare function createProxyHandler<TSchema extends object, TOptions = EnlaceOptions>(baseUrl: string, defaultOptions: TOptions, path?: string[], fetchExecutor?: FetchExecutor<TOptions, RequestOptions<unknown>>): TSchema;
 
-declare function executeFetch<TData, TError>(baseUrl: string, path: string[], method: HttpMethod, defaultOptions: EnlaceOptions, requestOptions?: RequestOptions<unknown>): Promise<EnlaceResponse<TData, TError>>;
-
-/**
- * Creates an API client.
- *
- * @example
- * // Typed mode - with schema
- * const api = createEnlace<MyApi>('https://api.example.com');
- *
- * // Untyped mode - no schema
- * const api = createEnlace('https://api.example.com');
- */
-declare function createEnlace<TSchema = unknown>(baseUrl: string, defaultOptions?: EnlaceOptions): unknown extends TSchema ? WildcardClient : EnlaceClient<TSchema>;
+declare function createEnlaceNext<TSchema = unknown, TDefaultError = unknown>(baseUrl: string, defaultOptions?: EnlaceOptions | null, nextOptions?: NextOptions): unknown extends TSchema ? WildcardClient<NextRequestOptionsBase> : EnlaceClient<TSchema, TDefaultError, NextRequestOptionsBase>;
 
-export { type Endpoint, type EnlaceClient, type EnlaceOptions, type EnlaceResponse, type FetchExecutor, type HttpMethod, type MethodDefinition, type RequestOptions, type SchemaMethod, type WildcardClient, createEnlace, createProxyHandler, executeFetch };
+export { type NextOptions, type NextRequestOptionsBase, createEnlaceNext };