@ciwergrp/nuxid 1.2.1 → 1.3.0

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@ciwergrp/nuxid",
   "configKey": "nuxid",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -466,7 +466,7 @@ function registerFetcherFeature(options, { from }) {
   if (!options.enabled) {
     return;
   }
-  addImports({ name: "useCursorFetch", as: "useCursorFetch", from });
+  addImports({ name: "useCursorHttp", as: "useCursorHttp", from });
   addImports({ name: "APIResponseCursor", as: "APIResponseCursor", from, type: true });
   addImports({ name: "CursorFetchOptions", as: "CursorFetchOptions", from, type: true });
 }

package/dist/runtime/fetcher/cursor.d.ts

@@ -13,6 +13,7 @@ export interface CursorMetaConfig {
 }
 export interface CursorFetchOptions<TRequest extends NitroFetchRequest = NitroFetchRequest> {
     lazy?: boolean;
+    immediate?: boolean;
     pollInterval?: number;
     fetcher?: typeof $fetch;
     fetchOptions?: NitroFetchOptions<TRequest>;
@@ -20,7 +21,7 @@ export interface CursorFetchOptions<TRequest extends NitroFetchRequest = NitroFe
     itemKey?: string;
     cursorParam?: string;
 }
-export declare function useCursorFetch<T extends Record<string, any> = any, TResponse extends APIResponseCursor<T> = APIResponseCursor<T>, TRequest extends NitroFetchRequest = NitroFetchRequest>(url: TRequest, options?: CursorFetchOptions<TRequest>): {
+export declare function useCursorHttp<T extends Record<string, any> = any, TResponse extends APIResponseCursor<T> = APIResponseCursor<T>, TRequest extends NitroFetchRequest = NitroFetchRequest>(url: TRequest, options?: CursorFetchOptions<TRequest>): Promise<{
     data: import("vue").Ref<TResponse | undefined, TResponse | undefined>;
     loading: Readonly<import("vue").Ref<boolean, boolean>>;
     error: Readonly<import("vue").Ref<Error | null, Error | null>>;
@@ -28,4 +29,5 @@ export declare function useCursorFetch<T extends Record<string, any> = any, TRes
     isLoadMoreTriggered: Readonly<import("vue").Ref<boolean, boolean>>;
     loadMore: () => Promise<void>;
     refresh: () => Promise<void>;
-};
+    init: () => Promise<void>;
+}>;

package/dist/runtime/fetcher/cursor.js

@@ -1,5 +1,5 @@
 import { isRef, onUnmounted, readonly, ref, shallowRef, watch } from "vue";
-export function useCursorFetch(url, options) {
+export async function useCursorHttp(url, options) {
   function findReactiveSources(obj) {
     const sources = [];
     if (!obj || typeof obj !== "object") {
@@ -38,6 +38,7 @@ export function useCursorFetch(url, options) {
   }
   const {
     lazy = false,
+    immediate = true,
     pollInterval,
     fetcher,
     fetchOptions,
@@ -56,6 +57,7 @@ export function useCursorFetch(url, options) {
     unwrapReactiveObject(fetchOptions)
   );
   let pollTimer = null;
+  let fetchPromise = null;
   const fetcherFn = fetcher ?? globalThis.$fetch;
   if (!fetcherFn) {
     throw new Error("Nuxt $fetch is not available in the current context");
@@ -83,25 +85,35 @@ export function useCursorFetch(url, options) {
   };
   const fetchData = async (fetchUrl, params) => {
     if (loading.value) {
-      return;
+      return fetchPromise ?? Promise.resolve();
     }
     if (!hasNextPage.value && data.value) {
-      return;
+      return Promise.resolve();
     }
     loading.value = true;
     error.value = null;
+    const promise = (async () => {
+      try {
+        const response = await fetcherFn(fetchUrl, params);
+        data.value = {
+          ...response,
+          data: [...data.value?.data ?? [], ...response.data]
+        };
+        nextCursor.value = normalizeCursorValue(response.meta?.[cursorKey]);
+        hasNextPage.value = response.meta?.[hasMoreKey] ?? false;
+      } catch (e) {
+        error.value = e;
+      } finally {
+        loading.value = false;
+      }
+    })();
+    fetchPromise = promise;
     try {
-      const response = await fetcherFn(fetchUrl, params);
-      data.value = {
-        ...response,
-        data: [...data.value?.data ?? [], ...response.data]
-      };
-      nextCursor.value = normalizeCursorValue(response.meta?.[cursorKey]);
-      hasNextPage.value = response.meta?.[hasMoreKey] ?? false;
-    } catch (e) {
-      error.value = e;
+      await promise;
     } finally {
-      loading.value = false;
+      if (fetchPromise === promise) {
+        fetchPromise = null;
+      }
     }
   };
   const pollData = async () => {
@@ -144,6 +156,12 @@ export function useCursorFetch(url, options) {
     isLoadMoreTriggered.value = false;
     await fetchData(initialUrl, currentParams.value);
   };
+  const init = async () => {
+    if (data.value) {
+      return;
+    }
+    await fetchData(initialUrl, currentParams.value);
+  };
   const reactiveSources = findReactiveSources(fetchOptions);
   if (reactiveSources.length > 0) {
     watch(
@@ -163,8 +181,8 @@ export function useCursorFetch(url, options) {
       clearInterval(pollTimer);
     }
   });
-  if (!lazy) {
-    void fetchData(initialUrl, currentParams.value);
+  if (!lazy && immediate) {
+    await init();
   }
   return {
     data,
@@ -173,6 +191,7 @@ export function useCursorFetch(url, options) {
     hasNextPage: readonly(hasNextPage),
     isLoadMoreTriggered: readonly(isLoadMoreTriggered),
     loadMore,
-    refresh
+    refresh,
+    init
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciwergrp/nuxid",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "All-in-one essential modules for Nuxt",
   "repository": {
     "type": "git",