enlace 0.0.1-beta.2 → 0.0.1-beta.20

package/dist/hook/index.mjs

@@ -0,0 +1,590 @@
+"use client";
+"use client";
+
+// src/react/enlaceHookReact.ts
+import { enlace } 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,
+        error: void 0
+      };
+    case "MUTATION_START":
+      return {
+        ...state,
+        loading: true,
+        fetching: true,
+        error: void 0
+      };
+    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, seen = /* @__PURE__ */ new WeakSet()) {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (seen.has(obj)) {
+    return "[Circular]";
+  }
+  seen.add(obj);
+  if (Array.isArray(obj)) {
+    return obj.map((item) => sortObjectKeys(item, seen));
+  }
+  return Object.keys(obj).sort().reduce(
+    (sorted, key) => {
+      sorted[key] = sortObjectKeys(
+        obj[key],
+        seen
+      );
+      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.timestamp = 0;
+      delete entry.promise;
+      entry.subscribers.forEach((cb) => cb());
+    }
+  });
+}
+
+// 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, params) {
+  if (!params) return path;
+  return path.map((segment) => {
+    if (segment.startsWith(":")) {
+      const paramName = segment.slice(1);
+      const value = params[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, pollingInterval } = options;
+  const queryKey = createQueryKey(trackedCall);
+  const requestOptions = trackedCall.options;
+  const resolvedPath = resolvePath(trackedCall.path, requestOptions?.params);
+  const baseTags = requestOptions?.tags ?? (autoGenerateTags ? generateTags(resolvedPath) : []);
+  const queryTags = [...baseTags, ...requestOptions?.additionalTags ?? []];
+  const getCacheState = (includeNeedsFetch = false) => {
+    const cached = getCache(queryKey);
+    const hasCachedData = cached?.data !== void 0;
+    const isFetching = !!cached?.promise;
+    const stale = isStale(queryKey, staleTime);
+    const needsFetch = includeNeedsFetch && (!hasCachedData || stale);
+    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);
+  const pollingTimeoutRef = useRef(null);
+  const pollingIntervalRef = useRef(pollingInterval);
+  pollingIntervalRef.current = pollingInterval;
+  useEffect(() => {
+    mountedRef.current = true;
+    if (!enabled) {
+      dispatch({ type: "RESET" });
+      if (pollingTimeoutRef.current) {
+        clearTimeout(pollingTimeoutRef.current);
+        pollingTimeoutRef.current = null;
+      }
+      return () => {
+        mountedRef.current = false;
+      };
+    }
+    dispatch({ type: "RESET", state: getCacheState(true) });
+    const scheduleNextPoll = () => {
+      const currentPollingInterval = pollingIntervalRef.current;
+      if (!mountedRef.current || !enabled || currentPollingInterval === void 0) {
+        return;
+      }
+      const cached2 = getCache(queryKey);
+      const interval = typeof currentPollingInterval === "function" ? currentPollingInterval(cached2?.data, cached2?.error) : currentPollingInterval;
+      if (interval === false || interval <= 0) {
+        return;
+      }
+      if (pollingTimeoutRef.current) {
+        clearTimeout(pollingTimeoutRef.current);
+      }
+      pollingTimeoutRef.current = setTimeout(() => {
+        if (mountedRef.current && enabled && fetchRef.current) {
+          fetchRef.current();
+        }
+      }, interval);
+    };
+    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) => {
+        setCache(queryKey, {
+          data: res.error ? void 0 : res.data,
+          error: res.error,
+          timestamp: Date.now(),
+          tags: queryTags
+        });
+      }).catch((err) => {
+        setCache(queryKey, {
+          data: void 0,
+          error: err,
+          timestamp: Date.now(),
+          tags: queryTags
+        });
+      }).finally(() => {
+        scheduleNextPoll();
+      });
+      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() });
+      scheduleNextPoll();
+    } else {
+      doFetch();
+    }
+    const unsubscribe = subscribeCache(queryKey, () => {
+      if (mountedRef.current) {
+        dispatch({ type: "SYNC_CACHE", state: getCacheState() });
+      }
+    });
+    return () => {
+      mountedRef.current = false;
+      fetchRef.current = null;
+      if (pollingTimeoutRef.current) {
+        clearTimeout(pollingTimeoutRef.current);
+        pollingTimeoutRef.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, params) {
+  if (!params) return path;
+  return path.map((segment) => {
+    if (segment.startsWith(":")) {
+      const paramName = segment.slice(1);
+      const value = params[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: "MUTATION_START" });
+      const options = args[0];
+      const resolvedPath = resolvePath2(pathRef.current, options?.params);
+      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/enlaceHookReact.ts
+function enlaceHookReact(baseUrl, defaultOptions = {}, hookOptions = {}) {
+  const {
+    autoGenerateTags = true,
+    autoRevalidateTags = true,
+    staleTime = 0,
+    onSuccess,
+    onError
+  } = hookOptions;
+  const api = enlace(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
+      });
+    }
+    if (!trackingResult.trackedCall) {
+      throw new Error(
+        "useAPI query mode requires calling an HTTP method ($get, $post, etc.). Did you mean to use selector mode? Example: useAPI((api) => api.posts.$get())"
+      );
+    }
+    return useQueryMode(
+      api,
+      trackingResult.trackedCall,
+      {
+        autoGenerateTags,
+        staleTime,
+        enabled: queryOptions?.enabled ?? true,
+        pollingInterval: queryOptions?.pollingInterval
+      }
+    );
+  }
+  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,
+    skipServerRevalidation = false,
+    serverRevalidator,
+    onSuccess,
+    ...coreOptions
+  } = combinedOptions;
+  const isGet = method === "GET";
+  const autoTags = generateTags(path);
+  const nextOnSuccess = (payload) => {
+    if (!isGet) {
+      const shouldRevalidateServer = requestOptions?.serverRevalidate ?? !skipServerRevalidation;
+      if (shouldRevalidateServer) {
+        const baseRevalidateTags = requestOptions?.revalidateTags ?? (autoRevalidateTags ? autoTags : []);
+        const revalidateTags = [
+          ...baseRevalidateTags,
+          ...requestOptions?.additionalRevalidateTags ?? []
+        ];
+        const revalidatePaths = requestOptions?.revalidatePaths ?? [];
+        if (revalidateTags.length || revalidatePaths.length) {
+          serverRevalidator?.(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 enlaceNext(baseUrl, defaultOptions = {}, nextOptions = {}) {
+  const combinedOptions = { ...defaultOptions, ...nextOptions };
+  return createProxyHandler(
+    baseUrl,
+    combinedOptions,
+    [],
+    executeNextFetch
+  );
+}
+
+// src/next/enlaceHookNext.ts
+function enlaceHookNext(baseUrl, defaultOptions = {}, hookOptions = {}) {
+  const {
+    autoGenerateTags = true,
+    autoRevalidateTags = true,
+    staleTime = 0,
+    ...nextOptions
+  } = hookOptions;
+  const api = enlaceNext(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
+      });
+    }
+    if (!trackedCall) {
+      throw new Error(
+        "useAPI query mode requires calling an HTTP method ($get, $post, etc.). Did you mean to use selector mode? Example: useAPI((api) => api.posts.$get())"
+      );
+    }
+    return useQueryMode(
+      api,
+      trackedCall,
+      {
+        autoGenerateTags,
+        staleTime,
+        enabled: queryOptions?.enabled ?? true,
+        pollingInterval: queryOptions?.pollingInterval
+      }
+    );
+  }
+  return useEnlaceHook;
+}
+export {
+  HTTP_METHODS,
+  enlaceHookNext,
+  enlaceHookReact
+};