@swoff/cli 0.3.7 → 0.3.9

package/dist/lib/generators/file-generators/fetch-wrapper.js

@@ -1,5 +1,6 @@
 /**
- * Generates fetch-wrapper.ts/js — unified fetch with caching, auth, offline queue, and auto-invalidation.
+ * Generates fetch-wrapper.ts/js — unified fetch with caching, auth, offline queue, auto-invalidation,
+ * staleTime, prefetching, and cancellation.
  */
 import { writeFile } from "./context.js";
 export function generateFetchWrapper(ctx) {
@@ -8,12 +9,12 @@ export function generateFetchWrapper(ctx) {
     const T = (type) => (ts ? `: ${type}` : "");
     const R = (type) => (ts ? `: ${type} ` : " ");
     const G = (type) => (ts ? `<${type}>` : "");
-    const tagInvalidation = ctx.config.features.tagInvalidation;
+    const tagInvalidation = ctx.config.features.tagInvalidation.enabled;
     const authEnabled = ctx.config.features.auth.enabled;
-    const mutationQueue = ctx.config.features.mutationQueue;
+    const mutationQueue = ctx.config.features.mutationQueue.enabled;
     const importLines = [
         tagInvalidation
-            ? `import { generateTags } from "./invalidation-tags.${ext}";`
+            ? `import { generateTags, invalidateUrl${tagInvalidation && mutationQueue ? ", expandCascading" : ""} } from "./invalidation-tags.${ext}";`
             : "",
         tagInvalidation ? `import { invalidateByTags } from "./cache.${ext}";` : "",
         authEnabled
@@ -30,20 +31,24 @@ export function generateFetchWrapper(ctx) {
 export interface FetchWithCacheResult${G("T")} {
   response${T("Response & { json(): Promise<T> }")};
   fromCache${T("boolean")};
+  queued${T("boolean")};
 }
 `
         : "";
-    const optionsType = ts ? `FetchWithCacheOptions` : `options`;
     const optionsInterface = ts
         ? `
 export interface FetchWithCacheOptions extends RequestInit {
   tags?: string[];
-  staleWhileRevalidate?: boolean;
   auth?: boolean;
   queueOffline?: boolean;
   invalidate?: 'auto' | string[] | false;
   type?: 'read' | 'mutation';
-  strategy?: 'cache-first' | 'network-first' | 'stale-while-revalidate' | 'cache-only' | 'network-only';
+  strategy?: 'cache-first' | 'network-first' | 'stale-while-revalidate' | 'cache-only' | 'network-only' | 'reactive';
+  staleTime?: number;
+  /** Custom response validation for mutation success. Default: res.ok. Use this when your API returns 200 with { success: false } for logical failures. */
+  validateSuccess?: (response: Response) => boolean | Promise<boolean>;
+  /** Override the URL used for auto-invalidation. Defaults to the request URL. Useful when the mutation URL differs from the cache tag URL. */
+  invalidateUrl?: string;
 }
 `
         : "";
@@ -74,44 +79,56 @@ export interface FetchWithCacheOptions extends RequestInit {
     window.dispatchEvent(new CustomEvent("sw-auth-unauthorized"));
   }`
         : "";
-    const offlineReadBlock = `    if (isRead) {
+    const mutationTagsBlock = tagInvalidation && mutationQueue
+        ? `  // Pre-compute invalidation tags for SW-side IDB storage
+  let mutationTags: string[] = [];
+  if (!isRead) {
+    const invalidateSetting = options.invalidate !== false ? (options.invalidate || 'auto') : false;
+    if (invalidateSetting !== false) {
+      if (Array.isArray(invalidateSetting)) {
+        mutationTags = invalidateSetting;
+      } else {
+        mutationTags = generateTags(url);
+        mutationTags = expandCascading(mutationTags);
+      }
+      headers.set("X-SW-Invalidate-Tags", mutationTags.join(","));
+    }
+  }`
+        : `  let mutationTags: string[] = options.tags || [];`;
+    const offlineReadCatchBlock = `    if (options.signal?.aborted) throw new DOMException("The operation was aborted", "AbortError");
       const cached = await caches.match(input);
-      if (cached) return { response: cached, fromCache: true };
-      throw new Error("Offline: no cached data available");
-    }`;
-    const offlineWriteBlock = mutationQueue
-        ? `    // Write offline — auto-queue
-    if (options.queueOffline !== false) {
-      const headerObj: Record<string, string> = {};
-      headers.forEach((value, key) => {
-        headerObj[key] = value;
-      });
+      if (cached) return { response: cached, fromCache: true, queued: false };
+      throw new Error("Offline: no cached data available");`;
+    const offlineWriteFallbackBlock = mutationQueue
+        ? `    if (options.queueOffline !== false) {
       await queueMutation({
         method,
         url,
         body: options.body,
-        headers: headerObj,
-        tags: options.tags || [],
+        headers: {},
+        tags: mutationTags,
         timestamp: Date.now(),
       });
       return {
-        response: new Response(null, { status: 202, statusText: "Queued" }),
+        response: new Response(JSON.stringify({ queued: true }), { status: 202, headers: { "Content-Type": "application/json" } }),
         fromCache: false,
+        queued: true,
       };
-    }
-    throw new Error("Offline: write operation failed");`
-        : `    throw new Error("Offline: write operation failed");`;
+    }`
+        : ``;
     const autoInvalidateBlock = tagInvalidation
         ? `
-  // Auto-invalidate after mutation success
-  if (!isRead && response.ok) {
+  // Auto-invalidate after mutation success (skip if SW queued it)
+  const mutationSuccess = options.validateSuccess ? await options.validateSuccess(response) : response.ok;
+  const mutationQueued = response.headers.get("X-SW-Mutation-Queued") === "true";
+  if (!isRead && mutationSuccess && !mutationQueued) {
     const invalidateSetting = options.invalidate !== false ? (options.invalidate || 'auto') : false;
     if (invalidateSetting !== false) {
-      const tagsToInvalidate${T("string[]")} = Array.isArray(invalidateSetting)
-        ? invalidateSetting
-        : (options.tags || generateTags(url));
-      if (tagsToInvalidate.length > 0) {
-        await invalidateByTags(tagsToInvalidate);
+      const invalidateTarget = options.invalidateUrl || url;
+      if (Array.isArray(invalidateSetting)) {
+        await invalidateByTags(invalidateSetting);
+      } else {
+        await invalidateUrl(invalidateTarget);
       }
     }
   }`
@@ -128,11 +145,11 @@ export interface FetchWithCacheOptions extends RequestInit {
         : "";
     const code = `/**
  * Swoff Fetch Wrapper
- * Unified fetch with caching, auth, offline queue, auto-invalidation, and
+ * Unified fetch with caching, auth, offline queue, auto-invalidation, staleTime, prefetching, and
  * per-request strategy override.
  *
  * Usage:
- *   import { fetchWithCache } from './swoff/fetch-wrapper.${ext}';
+ *   import { fetchWithCache, prefetchCache } from './swoff/fetch-wrapper.${ext}';
  *
  *   // GET — cached with auto-generated tags
  *   const { response } = await fetchWithCache("/api/todos");
@@ -144,14 +161,31 @@ export interface FetchWithCacheOptions extends RequestInit {
  *     body: JSON.stringify({ title: "New task" }),
  *   });
  *
+ *   // Skip auto-invalidation, invalidate manually later
+ *   await fetchWithCache("/api/todos", {
+ *     method: "POST",
+ *     body: JSON.stringify({ title: "New" }),
+ *     invalidate: false,
+ *   });
+ *
+ *   // Validate mutation success with custom logic
+ *   await fetchWithCache("/api/todos", {
+ *     method: "POST",
+ *     body: JSON.stringify({ title: "New" }),
+ *     validateSuccess: (res) => res.status === 200,
+ *   });
+ *
+ *   // Custom tags for caching (read) + explicit invalidate tags (mutation)
+ *   await fetchWithCache("/api/todos", {
+ *     tags: ["custom-tag"],
+ *     invalidate: ["custom-tag"],
+ *   });
+ *
  *   // Authenticated request (works with bearer, cookie, custom)
  *   const { response: userRes } = await fetchWithCache("/api/me", { auth: true });
  *
- *   // Custom tags + stale-while-revalidate
- *   const { response: staleRes, fromCache } = await fetchWithCache("/api/data", {
- *     tags: ["data"],
- *     staleWhileRevalidate: true,
- *   });
+ *   // Prefetch (fire-and-forget warm the cache)
+ *   prefetchCache("/api/todos");
  *
  *   // Override caching strategy per-request (highest priority)
  *   await fetchWithCache("/api/checkout", {
@@ -160,13 +194,10 @@ export interface FetchWithCacheOptions extends RequestInit {
  *     strategy: "network-only",
  *   });
  *
- *   // Override method-based caching with explicit type
- *   // Use type: "mutation" for POST-based reads (search, GraphQL)
- *   await fetchWithCache("/api/search", {
- *     method: "POST",
- *     type: "read",
- *     body: JSON.stringify({ query: "hello" }),
- *   });
+ *   // Support AbortController for cancellation
+ *   const controller = new AbortController();
+ *   setTimeout(() => controller.abort(), 5000);
+ *   const { response } = await fetchWithCache("/api/todos", { signal: controller.signal });
  *
  *   // Offline: auto-queues writes (disable with queueOffline: false)
  *   await fetchWithCache("/api/todos", {
@@ -181,9 +212,9 @@ ${interfaceBlock}${optionsInterface}
 const inFlightRequests = new Map${G("string, Promise<Response>")}();
 
 /** Fetch with caching, auth, offline queue, auto-invalidation, and per-request strategy override. Returns { response, fromCache }. Use { auth: true } for authenticated requests — works with bearer, cookie, and custom auth types. */
-export async function fetchWithCache${G("T")}(input${T("RequestInfo")}, options${T("RequestInit & { tags?: string[]; staleWhileRevalidate?: boolean; auth?: boolean; queueOffline?: boolean; invalidate?: 'auto' | string[] | false; type?: 'read' | 'mutation'; strategy?: 'cache-first' | 'network-first' | 'stale-while-revalidate' | 'cache-only' | 'network-only' }")} = {})${R("Promise<FetchWithCacheResult<T>>")}{
+export async function fetchWithCache${G("T")}(input${T("RequestInfo")}, options${T("RequestInit & FetchWithCacheOptions")} = {})${R("Promise<FetchWithCacheResult<T>>")}{
   const method = (options.method || "GET").toUpperCase();
-  const isRead = options.type === "read" || (options.type !== "mutation" && (method === "GET" || method === "HEAD"));
+  const isRead = options.type === "read" || (options.type !== "mutation" && (method === "GET" || method === "HEAD" || method === "OPTIONS"));
   const url = typeof input === "string" ? input : input.url;
 
   const headers = new Headers(options.headers);
@@ -198,37 +229,75 @@ ${autoTagsBlock}
     headers.set("X-SW-Cache-Tags", options.tags.join(","));
   }
 
-  if (options.staleWhileRevalidate && !options.strategy) {
-    headers.set("X-SW-Strategy", "stale-while-revalidate");
-  }
   if (options.strategy) {
     headers.set("X-SW-Strategy", options.strategy);
   }
+  if (options.staleTime !== undefined) {
+    headers.set("X-SW-Stale-Time", String(options.staleTime));
+  }
 ${authBlock}${authUrlsBlock}
+  // Forward no-queue option to SW
+  if (options.queueOffline === false) {
+    headers.set("X-SW-No-Queue", "true");
+  }
+
   const fetchOptions${T("RequestInit")} = { ...options, headers };
 ${authCredentialsBlock}
 
-  // Offline handling
-  if (!navigator.onLine) {
-${offlineReadBlock}
-${offlineWriteBlock}
+  // Check for abort before proceeding
+  if (options.signal?.aborted) {
+    throw new DOMException("The operation was aborted", "AbortError");
   }
-
+${mutationTagsBlock}
   // Deduplicate in-flight GET requests
   let responsePromise${T("Promise<Response>")};
   if (isRead && inFlightRequests.has(url)) {
     responsePromise = inFlightRequests.get(url)!.then((r) => r.clone());
   } else {
+    const abortHandler = () => {
+      inFlightRequests.delete(url);
+    };
+    if (options.signal) {
+      options.signal.addEventListener("abort", abortHandler, { once: true });
+    }
     responsePromise = fetch(input, fetchOptions);
     if (isRead) {
-      inFlightRequests.set(url, responsePromise.finally(() => inFlightRequests.delete(url)));
+      const cleanup = () => {
+        inFlightRequests.delete(url);
+        if (options.signal) {
+          options.signal.removeEventListener("abort", abortHandler);
+        }
+      };
+      inFlightRequests.set(url, responsePromise.finally(cleanup));
     }
   }
 
-  const response = await responsePromise;
+  let response${T("Response")};
+  try {
+    response = await responsePromise;
+  } catch (err) {
+    if (err instanceof TypeError) {
+      if (isRead) {
+${offlineReadCatchBlock}
+      }
+      // SW not controlling — fallback to client-side queue
+      if (!navigator.serviceWorker?.controller) {
+${offlineWriteFallbackBlock}
+      }
+    }
+    throw err;
+  }
 ${autoInvalidateBlock}${auth401Block}
   const fromCache = response.headers.get("X-SW-From-Cache") === "true";
-  return { response, fromCache };
+  const queued = response.headers.get("X-SW-Mutation-Queued") === "true";
+  return { response, fromCache, queued };
+}
+
+/** Fire-and-forget prefetch: warms the cache for a URL without blocking. Useful for route prefetching or link hover prefetching. */
+export function prefetchCache(input${T("RequestInfo")}, options${T("RequestInit & FetchWithCacheOptions")} = {})${R("void")}{
+  fetchWithCache(input, { ...options }).catch(() => {
+    // Prefetch failures are intentionally silent
+  });
 }
 `;
     writeFile(ctx, `fetch-wrapper.${ext}`, code);

package/dist/lib/generators/file-generators/fetch-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-wrapper.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/fetch-wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,oBAAoB,CAAC,GAAqB;IACxD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC5D,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;IACrD,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;IAExD,MAAM,WAAW,GAAG;QAClB,eAAe;YACb,CAAC,CAAC,qDAAqD,GAAG,IAAI;YAC9D,CAAC,CAAC,EAAE;QACN,eAAe,CAAC,CAAC,CAAC,6CAA6C,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE;QAC3E,WAAW;YACT,CAAC,CAAC,uGAAuG,GAAG,IAAI;YAChH,CAAC,CAAC,EAAE;QACN,aAAa;YACX,CAAC,CAAC,mDAAmD,GAAG,IAAI;YAC5D,CAAC,CAAC,EAAE;KACP;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,cAAc,GAAG,EAAE;QACvB,CAAC,CAAC;uCACiC,CAAC,CAAC,GAAG,CAAC;YACjC,CAAC,CAAC,mCAAmC,CAAC;aACrC,CAAC,CAAC,SAAS,CAAC;;CAExB;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,WAAW,GAAG,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7D,MAAM,gBAAgB,GAAG,EAAE;QACzB,CAAC,CAAC;;;;;;;;;;CAUL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,SAAS,GAAG,WAAW;QAC3B,CAAC,CAAC;;;;IAIF;QACA,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,aAAa,GAAG,WAAW;QAC/B,CAAC,CAAC;;;;IAIF;QACA,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,oBAAoB,GAAG,WAAW;QACtC,CAAC,CAAC;;;IAGF;QACA,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,YAAY,GAAG,WAAW;QAC9B,CAAC,CAAC;;;;IAIF;QACA,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,gBAAgB,GAAG;;;;MAIrB,CAAC;IAEL,MAAM,iBAAiB,GAAG,aAAa;QACrC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;wDAmBkD;QACpD,CAAC,CAAC,yDAAyD,CAAC;IAE9D,MAAM,mBAAmB,GAAG,eAAe;QACzC,CAAC,CAAC;;;;;8BAKwB,CAAC,CAAC,UAAU,CAAC;;;;;;;IAOvC;QACA,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,aAAa,GAAG,eAAe;QACnC,CAAC,CAAC;;;;;;;IAOF;QACA,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,IAAI,GAAG;;;;;;6DAM8C,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4C9D,WAAW;EACX,cAAc,GAAG,gBAAgB;kCACD,CAAC,CAAC,2BAA2B,CAAC;;;sCAG1B,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,sRAAsR,CAAC,SAAS,CAAC,CAAC,kCAAkC,CAAC;;;;;;;;;;;EAWtZ,aAAa;;;;;;;;;;;;EAYb,SAAS,GAAG,aAAa;sBACL,CAAC,CAAC,aAAa,CAAC;EACpC,oBAAoB;;;;EAIpB,gBAAgB;EAChB,iBAAiB;;;;uBAII,CAAC,CAAC,mBAAmB,CAAC;;;;;;;;;;;EAW3C,mBAAmB,GAAG,YAAY;;;;CAInC,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"fetch-wrapper.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/fetch-wrapper.ts"],"names":[],"mappings":"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"}

package/dist/lib/generators/file-generators/generate-hooks.js

@@ -15,15 +15,19 @@ export function generateHooks(ctx) {
     if (!existsSync(hooksDir)) {
         mkdirSync(hooksDir, { recursive: true });
     }
+    // Always generated hooks
     copyHook(hooksDir, "useNetworkStatus", ext);
     copyHook(hooksDir, "useCachedFetch", ext);
+    copyHook(hooksDir, "useMutation", ext);
+    copyHook(hooksDir, "usePrefetch", ext);
+    copyHook(hooksDir, "useMutationState", ext);
     if (config.features.pwa.enabled) {
         copyHook(hooksDir, "useSWUpdate", ext);
     }
     if (config.features.auth.enabled) {
         copyHook(hooksDir, "useAuth", ext);
     }
-    if (config.features.mutationQueue) {
+    if (config.features.mutationQueue.enabled) {
         copyHook(hooksDir, "useMutationQueue", ext);
     }
     if (config.features.pushNotifications?.enabled) {
@@ -32,7 +36,7 @@ export function generateHooks(ctx) {
     if (config.features.backgroundSync) {
         copyHook(hooksDir, "useBackgroundSync", ext);
     }
-    if (config.features.tagInvalidation) {
+    if (config.features.tagInvalidation.enabled) {
         copyHook(hooksDir, "useCacheInvalidation", ext);
     }
 }

package/dist/lib/generators/file-generators/generate-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-hooks.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/generate-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;AAEpE,SAAS,QAAQ,CAAC,QAAgB,EAAE,IAAY,EAAE,GAAW;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC;IAClD,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAqB;IACjD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC;IACrD,IAAI,aAAa,KAAK,OAAO;QAAE,OAAO;IAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAE1C,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAClC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,EAAE,CAAC;QAC/C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QACnC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QACpC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}
+{"version":3,"file":"generate-hooks.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/generate-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;AAEpE,SAAS,QAAQ,CAAC,QAAgB,EAAE,IAAY,EAAE,GAAW;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC;IAClD,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAqB;IACjD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC;IACrD,IAAI,aAAa,KAAK,OAAO;QAAE,OAAO;IAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAE5C,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1C,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,EAAE,CAAC;QAC/C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QACnC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC5C,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/lib/generators/file-generators/gql-wrapper.js

@@ -0,0 +1,139 @@
+import { writeFile } from "./context.js";
+export function generateGqlWrapper(ctx) {
+    const ext = ctx.ext;
+    const ts = ext === "ts";
+    const T = (type) => (ts ? `: ${type}` : "");
+    const R = (type) => (ts ? `: ${type} ` : " ");
+    const G = (type) => (ts ? `<${type}>` : "");
+    const AS = (type) => (ts ? ` as ${type}` : "");
+    const endpoint = ctx.config.features.graphql.endpoint;
+    const optionsInterface = ts
+        ? `
+export interface GqlOptions {
+  variables?: Record<string, unknown>;
+  tags?: string[];
+  auth?: boolean;
+  queueOffline?: boolean;
+  invalidate?: 'auto' | string[] | false;
+}
+`
+        : "";
+    const code = `/**
+ * Swoff GraphQL Wrapper
+ * Brings Swoff's caching, offline queue, and tag-based invalidation to GraphQL APIs.
+ * Hashes query + variables for deterministic cache keys and auto-generates tags
+ * from operation names. Built on top of fetchWithCache.
+ *
+ * Usage:
+ *   import { fetchWithGql, queryGql, mutateGql } from './swoff/gql-wrapper.${ext}';
+ *
+ *   // Query — cached with body-hash key
+ *   const { data } = await queryGql("{ todos { id title } }");
+ *
+ *   // Query with variables
+ *   const { data: todo } = await queryGql(
+ *     "query GetTodo($id: ID!) { todo(id: $id) { id title } }",
+ *     { id: "42" }
+ *   );
+ *
+ *   // Mutation — auto-invalidates related cache tags
+ *   const { data: created } = await mutateGql(
+ *     "mutation CreateTodo($title: String!) { createTodo(title: $title) { id } }",
+ *     { title: "New task" }
+ *   );
+ *
+ *   // Authenticated
+ *   const { data } = await queryGql("query Me { me { name } }", {}, { auth: true });
+ *
+ *   // Offline: mutations are auto-queued
+ *   const { data } = await mutateGql(
+ *     "mutation CreateTodo($title: String!) { createTodo(title: $title) { id } }",
+ *     { title: "Offline task" },
+ *     { queueOffline: true }
+ *   );
+ */
+
+import { fetchWithCache } from "./fetch-wrapper.${ext}";
+import type { GqlResult } from "./swoff";
+${optionsInterface}
+/** Extract operation name from a GraphQL document. Returns null for anonymous queries (e.g. "{ todos { id } }"). */
+function getOperationName(query${T("string")})${T("string | null")}{
+  const match = query.match(/(query|mutation|subscription)\\s+(\\w+)/);
+  return match ? match[2] : null;
+}
+
+/** Determine if a GraphQL document is a query (read) vs mutation/subscription (write). */
+function isReadOperation(query${T("string")})${T("boolean")}{
+  const trimmed = query.trim();
+  if (trimmed.startsWith("mutation") || trimmed.startsWith("subscription")) return false;
+  return true;
+}
+
+/** Hash an object into a hex string for deterministic cache keying. Uses SHA-256 via SubtleCrypto. */
+async function bodyHash(obj${T("unknown")})${T("Promise<string>")}{
+  const json = JSON.stringify(obj);
+  const bytes = new TextEncoder().encode(json);
+  const hash = await crypto.subtle.digest("SHA-256", bytes);
+  return Array.from(new Uint8Array(hash)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 16);
+}
+
+/** Generate cache-relevant tags from a GQL operation name. e.g. "getTodos" → ["todos"], "createTodo" → ["todos", "todo"]. */
+function tagsFromOpName(name${T("string | null")})${T("string[]")}{
+  if (!name) return [];
+  const stripped = name.replace(/^(get|fetch|list|all|query)/i, "").replace(/^(create|set|add|new|update|delete|remove)/i, "");
+  if (!stripped) return [name.toLowerCase()];
+  const tag = stripped.charAt(0).toLowerCase() + stripped.slice(1);
+  const plural = tag.replace(/s$/, "") + "s";
+  return [plural, tag];
+}
+
+/** Fetch a GraphQL endpoint with Swoff's caching, auth, offline queue, and auto-invalidation. Hashes query + variables for deterministic cache keys. */
+export async function fetchWithGql${G("T")}(
+  query${T("string")},
+  options${T("GqlOptions")} = {}
+)${R("Promise<GqlResult<T>>")}{
+  const isRead = isReadOperation(query);
+  const opName = getOperationName(query);
+  const variables = options.variables;
+  const hash = await bodyHash({ query, variables });
+  const tags = options.tags || tagsFromOpName(opName);
+
+  const { response, fromCache } = await fetchWithCache("${endpoint}", {
+    method: "POST",
+    body: JSON.stringify({ query, variables }),
+    headers: {
+      "Content-Type": "application/json",
+      "X-SW-Cache-Key": "gql:" + hash,
+    },
+    tags,
+    type: isRead ? "read" : "mutation",
+    auth: options.auth,
+    queueOffline: options.queueOffline,
+    invalidate: options.invalidate,
+  });
+
+  const result = await response.json();
+  return { data: result.data${AS("T")}, fromCache };
+}
+
+/** Shorthand for GraphQL queries (type: "read"). Cached by default with body-hash key. */
+export async function queryGql${G("T")}(
+  query${T("string")},
+  variables${T("Record<string, unknown> | undefined")} = undefined,
+  options${T("GqlOptions")} = {}
+)${R("Promise<GqlResult<T>>")}{
+  return fetchWithGql${G("T")}(query, { ...options, variables });
+}
+
+/** Shorthand for GraphQL mutations (type: "mutation"). Auto-invalidates related cache tags. */
+export async function mutateGql${G("T")}(
+  mutation${T("string")},
+  variables${T("Record<string, unknown> | undefined")} = undefined,
+  options${T("GqlOptions")} = {}
+)${R("Promise<GqlResult<T>>")}{
+  return fetchWithGql${G("T")}(mutation, { ...options, variables });
+}
+`;
+    writeFile(ctx, `gql-wrapper.${ext}`, code);
+}
+//# sourceMappingURL=gql-wrapper.js.map

package/dist/lib/generators/file-generators/gql-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gql-wrapper.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/gql-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;IAEtD,MAAM,gBAAgB,GAAG,EAAE;QACzB,CAAC,CAAC;;;;;;;;CAQL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,IAAI,GAAG;;;;;;;8EAO+D,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;kDA4B/B,GAAG;;EAEnD,gBAAgB;;iCAEe,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;;;;;gCAMlC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;;;;;;;6BAO9B,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC;;;;;;;;8BAQnC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;;;;;;;;;;oCAU7B,CAAC,CAAC,GAAG,CAAC;SACjC,CAAC,CAAC,QAAQ,CAAC;WACT,CAAC,CAAC,YAAY,CAAC;GACvB,CAAC,CAAC,uBAAuB,CAAC;;;;;;;0DAO6B,QAAQ;;;;;;;;;;;;;;;8BAepC,EAAE,CAAC,GAAG,CAAC;;;;gCAIL,CAAC,CAAC,GAAG,CAAC;SAC7B,CAAC,CAAC,QAAQ,CAAC;aACP,CAAC,CAAC,qCAAqC,CAAC;WAC1C,CAAC,CAAC,YAAY,CAAC;GACvB,CAAC,CAAC,uBAAuB,CAAC;uBACN,CAAC,CAAC,GAAG,CAAC;;;;iCAII,CAAC,CAAC,GAAG,CAAC;YAC3B,CAAC,CAAC,QAAQ,CAAC;aACV,CAAC,CAAC,qCAAqC,CAAC;WAC1C,CAAC,CAAC,YAAY,CAAC;GACvB,CAAC,CAAC,uBAAuB,CAAC;uBACN,CAAC,CAAC,GAAG,CAAC;;CAE5B,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}