@swoff/cli 0.3.9 → 0.3.10

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

@@ -3,303 +3,11 @@
  * staleTime, prefetching, and cancellation.
  */
 import { writeFile } from "./context.js";
+import { generateFetchWrapperCode } from "../../../runtime/fetch-wrapper.js";
 export function generateFetchWrapper(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 tagInvalidation = ctx.config.features.tagInvalidation.enabled;
-    const authEnabled = ctx.config.features.auth.enabled;
-    const mutationQueue = ctx.config.features.mutationQueue.enabled;
-    const importLines = [
-        tagInvalidation
-            ? `import { generateTags, invalidateUrl${tagInvalidation && mutationQueue ? ", expandCascading" : ""} } from "./invalidation-tags.${ext}";`
-            : "",
-        tagInvalidation ? `import { invalidateByTags } from "./cache.${ext}";` : "",
-        authEnabled
-            ? `import { getAuth, clearAuth, withAuthHeaders, isAuthUrl, AUTH_WITH_CREDENTIALS } from "./auth/store.${ext}";`
-            : "",
-        mutationQueue
-            ? `import { queueMutation } from "./mutation-queue.${ext}";`
-            : "",
-    ]
-        .filter(Boolean)
-        .join("\n");
-    const interfaceBlock = ts
-        ? `
-export interface FetchWithCacheResult${G("T")} {
-  response${T("Response & { json(): Promise<T> }")};
-  fromCache${T("boolean")};
-  queued${T("boolean")};
-}
-`
-        : "";
-    const optionsInterface = ts
-        ? `
-export interface FetchWithCacheOptions extends RequestInit {
-  tags?: string[];
-  auth?: boolean;
-  queueOffline?: boolean;
-  invalidate?: 'auto' | string[] | false;
-  type?: 'read' | 'mutation';
-  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;
-}
-`
-        : "";
-    const authBlock = authEnabled
-        ? `
-  if (options.auth) {
-    const auth = await getAuth();
-    withAuthHeaders(headers, auth);
-  }`
-        : "";
-    const authUrlsBlock = authEnabled
-        ? `
-  // Auth endpoints bypass SW cache
-  if (options.auth && isAuthUrl(url) && !headers.has("X-SW-Cache-Strategy")) {
-    headers.set("X-SW-Cache-Strategy", "mutation");
-  }`
-        : "";
-    const authCredentialsBlock = authEnabled
-        ? `
-  if (AUTH_WITH_CREDENTIALS) {
-    fetchOptions.credentials = "include";
-  }`
-        : "";
-    const auth401Block = authEnabled
-        ? `
-  if (options.auth && response.status === 401) {
-    await clearAuth();
-    window.dispatchEvent(new CustomEvent("sw-auth-unauthorized"));
-  }`
-        : "";
-    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, 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: {},
-        tags: mutationTags,
-        timestamp: Date.now(),
-      });
-      return {
-        response: new Response(JSON.stringify({ queued: true }), { status: 202, headers: { "Content-Type": "application/json" } }),
-        fromCache: false,
-        queued: true,
-      };
-    }`
-        : ``;
-    const autoInvalidateBlock = tagInvalidation
-        ? `
-  // 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 invalidateTarget = options.invalidateUrl || url;
-      if (Array.isArray(invalidateSetting)) {
-        await invalidateByTags(invalidateSetting);
-      } else {
-        await invalidateUrl(invalidateTarget);
-      }
-    }
-  }`
-        : "";
-    const autoTagsBlock = tagInvalidation
-        ? `
-  // Auto-generate tags from URL if not provided
-  if (!options.tags && isRead) {
-    const urlTags = generateTags(url);
-    if (urlTags.length > 0) {
-      headers.set("X-SW-Cache-Tags", urlTags.join(","));
-    }
-  }`
-        : "";
-    const code = `/**
- * Swoff Fetch Wrapper
- * Unified fetch with caching, auth, offline queue, auto-invalidation, staleTime, prefetching, and
- * per-request strategy override.
- *
- * Usage:
- *   import { fetchWithCache, prefetchCache } from './swoff/fetch-wrapper.${ext}';
- *
- *   // GET — cached with auto-generated tags
- *   const { response } = await fetchWithCache("/api/todos");
- *   const data = await response.json();
- *
- *   // POST — mutation with auto-invalidation
- *   await fetchWithCache("/api/todos", {
- *     method: "POST",
- *     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 });
- *
- *   // Prefetch (fire-and-forget warm the cache)
- *   prefetchCache("/api/todos");
- *
- *   // Override caching strategy per-request (highest priority)
- *   await fetchWithCache("/api/checkout", {
- *     method: "POST",
- *     type: "read",
- *     strategy: "network-only",
- *   });
- *
- *   // 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", {
- *     method: "POST",
- *     body: JSON.stringify({ title: "Offline task" }),
- *   });
- *   // When back online, processMutationQueue() replays them
- */
-
-${importLines}
-${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 & FetchWithCacheOptions")} = {})${R("Promise<FetchWithCacheResult<T>>")}{
-  const method = (options.method || "GET").toUpperCase();
-  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);
-
-  // Set cache strategy
-  if (!headers.has("X-SW-Cache-Strategy")) {
-    headers.set("X-SW-Cache-Strategy", isRead ? "read" : "mutation");
-  }
-${autoTagsBlock}
-  // Custom tags override auto-generated
-  if (options.tags && options.tags.length > 0) {
-    headers.set("X-SW-Cache-Tags", options.tags.join(","));
-  }
-
-  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}
-
-  // 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) {
-      const cleanup = () => {
-        inFlightRequests.delete(url);
-        if (options.signal) {
-          options.signal.removeEventListener("abort", abortHandler);
-        }
-      };
-      inFlightRequests.set(url, responsePromise.finally(cleanup));
-    }
-  }
-
-  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";
-  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);
+    const code = generateFetchWrapperCode({ ts, ext }, ctx.config.features.auth.enabled, ctx.config.features.auth.userEndpoint, ctx.config.features.mutationQueue.enabled, ctx.config.features.serviceWorker.requestBatchWindowMs);
+    writeFile(ctx, `fetch/core.${ext}`, code);
 }
 //# sourceMappingURL=fetch-wrapper.js.map

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":"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"}
+{"version":3,"file":"fetch-wrapper.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/fetch-wrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,MAAM,UAAU,oBAAoB,CAAC,GAAqB;IACxD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC;IAExB,MAAM,IAAI,GAAG,wBAAwB,CACnC,EAAE,EAAE,EAAE,GAAG,EAAE,EACX,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAChC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EACrC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EACzC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,oBAAoB,CACvD,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/lib/generators/file-generators/generate-framework-adapters.js

@@ -0,0 +1,56 @@
+import { copyFileSync, existsSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = join(__dirname, "../../../../templates");
+function copyAdapter(frameworkDir, name, ext, outputDir) {
+    const src = join(frameworkDir, `${name}.${ext}x`);
+    if (existsSync(src)) {
+        copyFileSync(src, join(outputDir, `${name}.${ext}x`));
+    }
+    else {
+        const jsSrc = src.replace(`.${ext}x`, ".jsx");
+        if (existsSync(jsSrc)) {
+            copyFileSync(jsSrc, join(outputDir, `${name}.${ext}x`));
+        }
+    }
+}
+const ADAPTERS = [
+    { name: "useNetworkStatus" },
+    { name: "useCachedFetch" },
+    { name: "useMutation" },
+    { name: "usePrefetch" },
+    { name: "useMutationState" },
+    { name: "useCacheInvalidation" },
+    { name: "useSwoffReset" },
+    { name: "useIsFetching" },
+    { name: "useSWUpdate", condition: (c) => c.config.features.pwa.enabled },
+    { name: "useAuth", condition: (c) => c.config.features.auth.enabled },
+    { name: "useMutationQueue", condition: (c) => c.config.features.mutationQueue.enabled },
+    { name: "usePushSubscription", condition: (c) => c.config.features.pushNotifications?.enabled ?? false },
+    { name: "useBackgroundSync", condition: (c) => !!c.config.features.backgroundSync },
+];
+const OUTPUT_SUBDIRS = {
+    react: "adapters",
+    vue: "adapters",
+    svelte: "adapters",
+    solid: "adapters",
+};
+export function generateFrameworkAdapters(ctx) {
+    const subdir = OUTPUT_SUBDIRS[ctx.frameworkName];
+    if (!subdir)
+        return;
+    const frameworkDir = join(templatesDir, ctx.frameworkName);
+    if (!existsSync(frameworkDir))
+        return;
+    const outDir = join(ctx.swoffDir, subdir);
+    if (!existsSync(outDir)) {
+        mkdirSync(outDir, { recursive: true });
+    }
+    for (const a of ADAPTERS) {
+        if (!a.condition || a.condition(ctx)) {
+            copyAdapter(frameworkDir, a.name, ctx.ext, outDir);
+        }
+    }
+}
+//# sourceMappingURL=generate-framework-adapters.js.map

package/dist/lib/generators/file-generators/generate-framework-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-framework-adapters.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/generate-framework-adapters.ts"],"names":[],"mappings":"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"}

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

@@ -36,8 +36,9 @@ export function generateHooks(ctx) {
     if (config.features.backgroundSync) {
         copyHook(hooksDir, "useBackgroundSync", ext);
     }
-    if (config.features.tagInvalidation.enabled) {
-        copyHook(hooksDir, "useCacheInvalidation", ext);
-    }
+    copyHook(hooksDir, "useCacheInvalidation", ext);
+    // Phase 2 — always generated
+    copyHook(hooksDir, "useSwoffReset", ext);
+    copyHook(hooksDir, "useIsFetching", ext);
 }
 //# sourceMappingURL=generate-hooks.js.map

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,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"}
+{"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,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC;IAEhD,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC"}

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

@@ -1,139 +1,10 @@
 import { writeFile } from "./context.js";
+import { generateGqlWrapperCode } from "../../../runtime/gql-wrapper.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);
+    const code = generateGqlWrapperCode({ ts, ext }, endpoint);
+    writeFile(ctx, `graphql/index.${ext}`, code);
 }
 //# sourceMappingURL=gql-wrapper.js.map

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

@@ -1 +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"}
+{"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;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC;IACxB,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;IAEtD,MAAM,IAAI,GAAG,sBAAsB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE3D,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/generators/file-generators/guide-generator.js

@@ -1,5 +1,5 @@
 /**
- * Generates GUIDE.md — points user to online documentation.
+ * Generates GUIDE.md — points user to online documentation and PWA asset info.
  */
 import { writeFile } from "./context.js";
 export function generateGuide(ctx) {
@@ -9,6 +9,34 @@ export function generateGuide(ctx) {
     w("");
     w("Your project was generated with Swoff. All generated files live in `swoff/`.");
     w("");
+    if (ctx.config.features.pwa.enabled && ctx.config.features.pwa.assets.source) {
+        w("## PWA Assets");
+        w("");
+        w("PWA assets (icons, favicon, OG image, splash screens) will be generated from your");
+        w(` source logo during \`swoff generate\`.`);
+        w("");
+        w("To regenerate manually:");
+        w("");
+        w("  swoff assets --source <path>");
+        w("");
+        w("### What gets generated");
+        w("");
+        w("- PWA icons: 64×64, 192×192, 512×512, maskable 512×512");
+        w("- Apple touch icon: 180×180");
+        w("- Apple splash screens: all device resolutions");
+        w("- Favicon: SVG + ICO (16×16, 32×32, 48×48)");
+        w("- OG image: 1200×630 (also used for Twitter card)");
+        w("");
+        w("After generation, reference these assets in your app manually. Run \`swoff assets\` for a copy-paste guide with the exact <link> and <meta> tags.");
+        w("");
+        w("### Source logo requirements");
+        w("");
+        w("- **SVG** recommended — produces the best quality at all sizes");
+        w("- PNG or JPG accepted — will be upscaled if needed");
+        w("- Minimum 512×512 for crisp icons");
+        w("- Transparent backgrounds work well with theme colors");
+        w("");
+    }
     w("For the full documentation, visit:");
     w("");
     w("- **Documentation** — https://swoff.dev/docs");

package/dist/lib/generators/file-generators/guide-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"guide-generator.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/guide-generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,aAAa,CAAC,GAAqB;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEvC,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAC/B,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,CACC,8EAA8E,CAC/E,CAAC;IACF,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,CAAC,oCAAoC,CAAC,CAAC;IACxC,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,CAAC,8CAA8C,CAAC,CAAC;IAClD,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,CAAC,uFAAuF,CAAC,CAAC;IAC3F,CAAC,CAAC,EAAE,CAAC,CAAC;IAEN,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"guide-generator.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/guide-generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,aAAa,CAAC,GAAqB;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEvC,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAC/B,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,CACC,8EAA8E,CAC/E,CAAC;IACF,CAAC,CAAC,EAAE,CAAC,CAAC;IAEN,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7E,CAAC,CAAC,eAAe,CAAC,CAAC;QACnB,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,mFAAmF,CAAC,CAAC;QACvF,CAAC,CAAC,yCAAyC,CAAC,CAAC;QAC7C,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,yBAAyB,CAAC,CAAC;QAC7B,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,gCAAgC,CAAC,CAAC;QACpC,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,yBAAyB,CAAC,CAAC;QAC7B,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,wDAAwD,CAAC,CAAC;QAC5D,CAAC,CAAC,6BAA6B,CAAC,CAAC;QACjC,CAAC,CAAC,gDAAgD,CAAC,CAAC;QACpD,CAAC,CAAC,4CAA4C,CAAC,CAAC;QAChD,CAAC,CAAC,mDAAmD,CAAC,CAAC;QACvD,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,mJAAmJ,CAAC,CAAC;QACvJ,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,8BAA8B,CAAC,CAAC;QAClC,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,gEAAgE,CAAC,CAAC;QACpE,CAAC,CAAC,oDAAoD,CAAC,CAAC;QACxD,CAAC,CAAC,mCAAmC,CAAC,CAAC;QACvC,CAAC,CAAC,uDAAuD,CAAC,CAAC;QAC3D,CAAC,CAAC,EAAE,CAAC,CAAC;IACR,CAAC;IAED,CAAC,CAAC,oCAAoC,CAAC,CAAC;IACxC,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,CAAC,8CAA8C,CAAC,CAAC;IAClD,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,CAAC,uFAAuF,CAAC,CAAC;IAC3F,CAAC,CAAC,EAAE,CAAC,CAAC;IAEN,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC"}