@swoff/cli 0.3.5 → 0.3.7

package/dist/lib/generators/file-generators/auth-store.js

@@ -1,14 +1,160 @@
 /**
- * Generates auth-store.ts/js — token storage with memory-only for token,
- * IndexedDB for offline user info only (no token persisted).
+ * Generates auth-store.ts/js — token storage, auth headers, auth URL detection,
+ * and token refresh. All auth logic lives here so fetch-wrapper can import it
+ * without circular dependencies.
  *
  * Security: the Bearer token lives in memory only and is cleared on page
  * refresh. Only { user, expiresAt } is persisted to IndexedDB for offline
  * user display. After a page refresh, re-login is required.
  */
 import { writeFile } from "./context.js";
+function generateWithAuthHeaders(authType, ts, R, T) {
+    const a = T("AuthData | null");
+    const h = T("Headers");
+    const hd = T("Headers");
+    switch (authType) {
+        case "cookie":
+            return `/** Inject auth headers. For cookie auth, credentials are handled via AUTH_WITH_CREDENTIALS. */
+export function withAuthHeaders(headers${hd}, _auth${a})${h}{
+  return headers;
+}`;
+        case "bearer":
+            return `/** Inject Bearer token into request headers. */
+export function withAuthHeaders(headers${hd}, auth${a})${h}{
+  if (auth?.token) {
+    headers.set("Authorization", \`Bearer \${auth.token}\`);
+  }
+  return headers;
+}`;
+        case "custom":
+            return `/** Inject custom auth headers. Edit this function to match your backend. */
+export function withAuthHeaders(headers${hd}, auth${a})${h}{
+  // --- EDIT THIS BLOCK FOR YOUR BACKEND ---
+  // if (auth?.token) {
+  //   headers.set("X-Auth-Token", auth.token);
+  // }
+  // --- END OF EDITABLE BLOCK ---
+  return headers;
+}`;
+        default:
+            return `export function withAuthHeaders(headers${hd}, auth${a})${h}{
+  if (auth?.token) {
+    headers.set("Authorization", \`Bearer \${auth.token}\`);
+  }
+  return headers;
+}`;
+    }
+}
+function generateIsAuthUrl(refreshPath, userEndpoint, ts, R, T) {
+    return `/** Check if a URL is an auth endpoint that should bypass the SW cache. */
+export function isAuthUrl(url${T("string")})${R("boolean")}{
+  const authPaths = [
+    "/login",
+    "/logout",
+    "/register",
+    "/api/login",
+    "/api/logout",
+    "/api/register",
+    "${refreshPath}",
+    "${userEndpoint}",
+  ];
+  return authPaths.some((path) => url.includes(path));
+}`;
+}
+function generateEnsureValidAuth(cookieAuth, ts, R, T, PT, refreshPath, ext) {
+    const cr = cookieAuth ? `  credentials: "include" as RequestCredentials,` : "";
+    return `/** Refresh the auth token via the refresh endpoint. Uses plain fetch to bypass SW cache. */
+let refreshPromise${T("Promise<AuthData | null> | null")} = null;
+
+export async function ensureValidAuth()${R("Promise<AuthData | null>")}{
+  const auth = await getAuth();
+  if (!auth) return null;
+  if (!auth.expiresAt || Date.now() < auth.expiresAt) return auth;
+
+  if (!refreshPromise) {
+    refreshPromise = (async () => {
+      const headers = new Headers({ "Content-Type": "application/json" });
+      withAuthHeaders(headers, auth);
+      try {
+        const response = await fetch("${refreshPath}", {
+          method: "POST",
+          headers,
+${cr}      });
+
+        if (!response.ok) {
+          await clearAuth();
+          window.dispatchEvent(new CustomEvent("sw-auth-unauthorized"));
+          return null;
+        }
+
+        const data = await response.json();
+        const updated = { ...auth, token: data.token, expiresAt: data.expiresAt };
+        await setAuth(updated);
+        return updated;
+      } catch {
+        await clearAuth();
+        window.dispatchEvent(new CustomEvent("sw-auth-unauthorized"));
+        return null;
+      }
+    })();
+  }
+
+  try {
+    return await refreshPromise;
+  } finally {
+    refreshPromise = null;
+  }
+}`;
+}
 export function generateAuthStore(ctx) {
     const ext = ctx.ext;
+    const ts = ext === "ts";
+    const T = (type) => (ts ? `: ${type}` : "");
+    const R = (type) => (ts ? `: ${type} ` : " ");
+    const PT = (type) => (ts ? `<${type}>` : "");
+    const AS = (type) => (ts ? ` as ${type}` : "");
+    const authConfig = ctx.config.features.auth;
+    const { refreshPath, userEndpoint, type } = authConfig;
+    const authDataInterface = ts
+        ? `export interface AuthData {
+  token?: string;
+  user?: Record<string, unknown>;
+  expiresAt?: number;
+}
+
+export interface AuthResponse extends Record<string, unknown> {
+  // Uncomment and type the fields your backend's login response returns:
+  // token: string;
+  // user: Record<string, unknown>;
+  // expiresAt?: number;
+}
+
+`
+        : "";
+    const createAuthFromResponseBlock = ts
+        ? `/** Extract AuthData from your backend's login response. Edit this function to match your backend's response shape. */
+export function createAuthFromResponse(response: AuthResponse): AuthData {
+  // --- EDIT THIS TO MATCH YOUR BACKEND ---
+  const data = response as Record<string, unknown>;
+  return {
+    token: data.token as string,
+    user: data.user as Record<string, unknown> | undefined,
+    expiresAt: data.expiresAt as number | undefined,
+  };
+  // --- END OF EDITABLE BLOCK ---
+}
+`
+        : `/** Extract AuthData from your backend's login response. Edit this function to match your backend's response shape. */
+export function createAuthFromResponse(response) {
+  // --- EDIT THIS TO MATCH YOUR BACKEND ---
+  return {
+    token: response.token,
+    user: response.user,
+    expiresAt: response.expiresAt,
+  };
+  // --- END OF EDITABLE BLOCK ---
+}
+`;
     const code = `/**
  * Auth Store — Token in memory only; user info in IndexedDB for offline access.
  *
@@ -18,110 +164,104 @@ export function generateAuthStore(ctx) {
  *   user info offline. After a page refresh, re-login is required.
  *
  * Usage:
- *   import { setAuth, getAuth, clearAuth, isAuthValid } from "./auth-store.${ext}";
+ *   import { setAuth, getAuth, clearAuth, isAuthValid } from "./auth/store.${ext}";
  *
  *   await setAuth({ token, user, expiresAt });
  *   const auth = await getAuth();
  *   await clearAuth();
  */
 
-const DB_NAME = "swoff-auth";
+${authDataInterface}const DB_NAME = "swoff-auth";
 const STORE_NAME = "auth";
 
-let memoryAuth = null;
+let memoryAuth${T("AuthData | null")} = null;
 
-function openAuthDB() {
-  return new Promise((resolve, reject) => {
+${createAuthFromResponseBlock}
+function openAuthDB()${R("Promise<IDBDatabase>")}{
+  return new Promise${PT("IDBDatabase")}((resolve, reject) => {
     const request = indexedDB.open(DB_NAME, 1);
     request.onupgradeneeded = (e) => {
-      const db = e.target.result;
+      const db = (e.target${AS("IDBOpenDBRequest")}).result;
       if (!db.objectStoreNames.contains(STORE_NAME)) {
         db.createObjectStore(STORE_NAME, { keyPath: "key" });
       }
     };
-    request.onsuccess = (e) => resolve(e.target.result);
-    request.onerror = (e) => reject(e.target.error);
+    request.onsuccess = (e) => resolve((e.target${AS("IDBOpenDBRequest")}).result);
+    request.onerror = (e) => reject((e.target${AS("IDBRequest")}).error);
   });
 }
 
-async function persistUserData(authData) {
+async function persistUserData(authData${T("AuthData | null")})${R("Promise<void>")}{
   // Only persist { user, expiresAt } — never the token
   const userData = { user: authData?.user, expiresAt: authData?.expiresAt };
   const db = await openAuthDB();
-  return new Promise((resolve, reject) => {
+  return new Promise${PT("void")}((resolve, reject) => {
     const tx = db.transaction(STORE_NAME, "readwrite");
     const store = tx.objectStore(STORE_NAME);
     const request = store.put({ key: "session", value: userData });
     request.onsuccess = () => resolve();
-    request.onerror = () => reject(request.error);
+    request.onerror = () => reject((request${AS("IDBRequest")}).error);
   });
 }
 
-async function loadUserData() {
+async function loadUserData()${R("Promise<{ user?: Record<string, unknown>; expiresAt?: number } | null>")}{
   const db = await openAuthDB();
   return new Promise((resolve, reject) => {
     const tx = db.transaction(STORE_NAME, "readonly");
     const store = tx.objectStore(STORE_NAME);
     const request = store.get("session");
-    request.onsuccess = () => resolve(request.result?.value || null);
-    request.onerror = () => reject(request.error);
+    request.onsuccess = () => resolve((request${AS("IDBRequest")}).result?.value ?? null);
+    request.onerror = () => reject((request${AS("IDBRequest")}).error);
   });
 }
 
-async function clearPersistedData() {
+async function clearPersistedData()${R("Promise<void>")}{
   const db = await openAuthDB();
-  return new Promise((resolve, reject) => {
+  return new Promise${PT("void")}((resolve, reject) => {
     const tx = db.transaction(STORE_NAME, "readwrite");
     const store = tx.objectStore(STORE_NAME);
     const request = store.delete("session");
     request.onsuccess = () => resolve();
-    request.onerror = () => reject(request.error);
+    request.onerror = () => reject((request${AS("IDBRequest")}).error);
   });
 }
 
-/**
- * Store auth data — token stays in memory only.
- * Only user info and expiry are persisted to IndexedDB.
- * @param {{ token?: string, user?: object, expiresAt?: number }} authData
- */
-export async function setAuth(authData) {
+/** Store auth data in memory and persist user info to IndexedDB for offline access. */
+export async function setAuth(authData${T("AuthData")})${R("Promise<void>")}{
   memoryAuth = authData;
   await persistUserData(authData);
 }
 
-/**
- * Get stored auth — returns memory copy (with token) or
- * falls back to IndexedDB (user info only, no token after refresh).
- */
-export async function getAuth() {
+/** Get auth data from memory (or IndexedDB if memory is empty after page refresh). */
+export async function getAuth()${R("Promise<AuthData | null>")}{
   if (memoryAuth) return memoryAuth;
 
   const userData = await loadUserData();
   if (userData) {
-    // After refresh: user info available, but no token — re-login required
     memoryAuth = userData;
   }
   return memoryAuth;
 }
 
-/**
- * Clear auth — removes from memory and IndexedDB.
- */
-export async function clearAuth() {
+/** Clear auth from memory and IndexedDB. Call on logout or 401. */
+export async function clearAuth()${R("Promise<void>")}{
   memoryAuth = null;
   await clearPersistedData();
 }
 
-/**
- * Check if auth exists and is not expired.
- * @param {object | null} auth — The auth object from getAuth()
- */
-export function isAuthValid(auth) {
+/** Check if auth exists and has not expired. Returns true if no expiresAt is set. */
+export function isAuthValid(auth${T("AuthData | null")})${R("boolean")}{
   if (!auth) return false;
   if (!auth.expiresAt) return true;
   return Date.now() < auth.expiresAt;
 }
+
+${type === "cookie" ? `export const AUTH_WITH_CREDENTIALS = true;` : `export const AUTH_WITH_CREDENTIALS = false;`}
+
+${generateWithAuthHeaders(type, ts, R, T)}
+${generateIsAuthUrl(refreshPath, userEndpoint, ts, R, T)}
+${generateEnsureValidAuth(type === "cookie", ts, R, T, PT, refreshPath, ext)}
 `;
-    writeFile(ctx, `auth-store.${ext}`, code);
+    writeFile(ctx, `auth/store.${ext}`, code);
 }
 //# sourceMappingURL=auth-store.js.map

package/dist/lib/generators/file-generators/auth-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth-store.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/auth-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,GAAqB;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAEpB,MAAM,IAAI,GAAG;;;;;;;;;8EAS+D,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuGhF,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"auth-store.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/auth-store.ts"],"names":[],"mappings":"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"}

package/dist/lib/generators/file-generators/auth-user.js

@@ -4,43 +4,45 @@
 import { writeFile } from "./context.js";
 export function generateAuthUser(ctx) {
     const ext = ctx.ext;
+    const ts = ext === "ts";
+    const T = (type) => (ts ? `: ${type}` : "");
+    const R = (type) => (ts ? `: ${type} ` : " ");
+    const PT = (type) => (ts ? `<${type}>` : "");
+    const AS = (type) => (ts ? ` as ${type}` : "");
     const userEndpoint = ctx.config.features.auth.userEndpoint;
     const code = `/**
  * Current User — fetch, cache, and invalidate the current user for offline access.
  *
  * Usage:
- *   import { fetchCurrentUser, cacheUser, getCachedUser, clearCachedUser } from "./auth-user.${ext}";
+ *   import { fetchCurrentUser, cacheUser, getCachedUser, clearCachedUser } from "./auth/user.${ext}";
  *
  *   await fetchCurrentUser();           // Fetch from server & cache
  *   const user = await getCachedUser(); // Get cached (offline-capable)
  *   await clearCachedUser();            // Clear on logout
  */
 
-import { authenticatedFetch } from "./auth-fetch.${ext}";
+import { fetchWithCache } from "../fetch-wrapper.${ext}";
 
 const DB_NAME = "swoff-auth-user";
 const STORE_NAME = "current-user";
 
-function openAuthDB() {
-  return new Promise((resolve, reject) => {
+function openAuthDB()${R("Promise<IDBDatabase>")}{
+  return new Promise${PT("IDBDatabase")}((resolve, reject) => {
     const request = indexedDB.open(DB_NAME, 1);
     request.onupgradeneeded = (e) => {
-      const db = e.target.result;
+      const db = (e.target${AS("IDBOpenDBRequest")}).result;
       if (!db.objectStoreNames.contains(STORE_NAME)) {
         db.createObjectStore(STORE_NAME, { keyPath: "key" });
       }
     };
-    request.onsuccess = (e) => resolve(e.target.result);
-    request.onerror = (e) => reject(e.target.error);
+    request.onsuccess = (e) => resolve((e.target${AS("IDBOpenDBRequest")}).result);
+    request.onerror = (e) => reject((e.target${AS("IDBRequest")}).error);
   });
 }
 
-/**
- * Fetch current user from your backend and cache locally.
- * Uses userEndpoint from swoff.config.json.
- */
-export async function fetchCurrentUser() {
-  const response = await authenticatedFetch("${userEndpoint}");
+/** Fetch current user from the user endpoint and cache the result in IndexedDB. */
+export async function fetchCurrentUser()${R("Promise<Record<string, unknown>>")}{
+  const { response } = await fetchWithCache("${userEndpoint}", { auth: true });
   if (!response.ok) throw new Error("Failed to fetch user");
 
   const user = await response.json();
@@ -48,12 +50,10 @@ export async function fetchCurrentUser() {
   return user;
 }
 
-/**
- * Store user in IndexedDB for offline access.
- */
-export async function cacheUser(user) {
+/** Persist user data to IndexedDB for offline access. */
+export async function cacheUser(user${T("Record<string, unknown>")})${R("Promise<void>")}{
   const db = await openAuthDB();
-  return new Promise((resolve, reject) => {
+  return new Promise<void>((resolve, reject) => {
     const tx = db.transaction(STORE_NAME, "readwrite");
     const store = tx.objectStore(STORE_NAME);
     store.put({ key: "user", value: user });
@@ -62,34 +62,30 @@ export async function cacheUser(user) {
   });
 }
 
-/**
- * Get cached user — works offline.
- */
-export async function getCachedUser() {
+/** Load user data from IndexedDB cache (no token — only user object survives refresh). */
+export async function getCachedUser()${R("Promise<Record<string, unknown> | null>")}{
   const db = await openAuthDB();
-  return new Promise((resolve, reject) => {
+  return new Promise${PT("Record<string, unknown> | null")}((resolve, reject) => {
     const tx = db.transaction(STORE_NAME, "readonly");
     const store = tx.objectStore(STORE_NAME);
     const request = store.get("user");
-    request.onsuccess = () => resolve(request.result?.value || null);
-    request.onerror = () => reject(request.error);
+    request.onsuccess = () => resolve((request${AS("IDBRequest")}).result?.value ?? null);
+    request.onerror = () => reject((request${AS("IDBRequest")}).error);
   });
 }
 
-/**
- * Clear cached user on logout.
- */
-export async function clearCachedUser() {
+/** Remove user data from IndexedDB cache. Call on logout. */
+export async function clearCachedUser()${R("Promise<void>")}{
   const db = await openAuthDB();
-  return new Promise((resolve, reject) => {
+  return new Promise${PT("void")}((resolve, reject) => {
     const tx = db.transaction(STORE_NAME, "readwrite");
     const store = tx.objectStore(STORE_NAME);
     store.delete("user");
     tx.oncomplete = () => resolve();
-    tx.onerror = () => reject(tx.error);
+    tx.onerror = () => reject((tx${AS("IDBTransaction")}).error);
   });
 }
 `;
-    writeFile(ctx, `auth-user.${ext}`, code);
+    writeFile(ctx, `auth/user.${ext}`, code);
 }
 //# sourceMappingURL=auth-user.js.map

package/dist/lib/generators/file-generators/auth-user.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth-user.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/auth-user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,gBAAgB,CAAC,GAAqB;IACpD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;IAE3D,MAAM,IAAI,GAAG;;;;gGAIiF,GAAG;;;;;;;mDAOhD,GAAG;;;;;;;;;;;;;;;;;;;;;;;;+CAwBP,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiD1D,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"auth-user.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/auth-user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,gBAAgB,CAAC,GAAqB;IACpD,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,EAAE,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;IAE3D,MAAM,IAAI,GAAG;;;;gGAIiF,GAAG;;;;;;;mDAOhD,GAAG;;;;;uBAK/B,CAAC,CAAC,sBAAsB,CAAC;sBAC1B,EAAE,CAAC,aAAa,CAAC;;;4BAGX,EAAE,CAAC,kBAAkB,CAAC;;;;;kDAKA,EAAE,CAAC,kBAAkB,CAAC;+CACzB,EAAE,CAAC,YAAY,CAAC;;;;;0CAKrB,CAAC,CAAC,kCAAkC,CAAC;+CAChC,YAAY;;;;;;;;;sCASrB,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;;uCAYjD,CAAC,CAAC,yCAAyC,CAAC;;sBAE7D,EAAE,CAAC,gCAAgC,CAAC;;;;gDAIV,EAAE,CAAC,YAAY,CAAC;6CACnB,EAAE,CAAC,YAAY,CAAC;;;;;yCAKpB,CAAC,CAAC,eAAe,CAAC;;sBAErC,EAAE,CAAC,MAAM,CAAC;;;;;mCAKG,EAAE,CAAC,gBAAgB,CAAC;;;CAGtD,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/lib/generators/file-generators/background-sync.js

@@ -4,6 +4,9 @@
 import { writeFile } from "./context.js";
 export function generateBackgroundSync(ctx) {
     const ext = ctx.ext;
+    const ts = ext === "ts";
+    const T = (type) => (ts ? `: ${type}` : "");
+    const R = (type) => (ts ? `: ${type} ` : " ");
     const code = `/**
  * Swoff Background Sync
  * Register sync events for processing mutation queue after tab close.
@@ -17,8 +20,7 @@ export function generateBackgroundSync(ctx) {
  *     url: "/api/todos",
  *     body: { title: "Grocery" },
  *     tags: ["todos"],
- *     storeName: "todos",
- *     tempId: "temp_abc123",
+ *     tags: ["todos"],
  *   });
  */
 
@@ -26,7 +28,7 @@ import { queueMutation, processMutationQueue, getPendingCount } from "./mutation
 
 const SYNC_TAG = "sync-mutations";
 
-async function registerSync() {
+async function registerSync()${R("Promise<void>")}{
   if (!("serviceWorker" in navigator) || !("SyncManager" in window)) {
     window.addEventListener("online", processMutationQueue, { once: true });
     return;
@@ -40,12 +42,14 @@ async function registerSync() {
   }
 }
 
-export async function syncWhenPossible(mutation) {
+/** Queue a mutation and register a background sync event so it runs even after tab close. */
+export async function syncWhenPossible(mutation${T("object")})${R("Promise<void>")}{
   await queueMutation(mutation);
   await registerSync();
 }
 
-export async function retrySync() {
+/** Re-register a background sync if mutations are still pending. Called automatically after each sync cycle. */
+export async function retrySync()${R("Promise<void>")}{
   if (!("serviceWorker" in navigator) || !("SyncManager" in window)) return;
   const count = await getPendingCount();
   if (count > 0) {

package/dist/lib/generators/file-generators/background-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-sync.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/background-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,sBAAsB,CAAC,GAAqB;IAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,IAAI,GAAG;;;;;;iEAMkD,GAAG;;;;;;;;;;;;yFAYqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC3F,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,mBAAmB,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"background-sync.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/background-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,sBAAsB,CAAC,GAAqB;IAC1D,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;IAEtD,MAAM,IAAI,GAAG;;;;;;iEAMkD,GAAG;;;;;;;;;;;yFAWqB,GAAG;;;;+BAI7D,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;iDAeA,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;;;;;mCAM/C,CAAC,CAAC,eAAe,CAAC;;;;;;;;;CASpD,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,mBAAmB,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/generators/file-generators/cache.js

@@ -4,6 +4,9 @@
 import { writeFile } from "./context.js";
 export function generateCache(ctx) {
     const ext = ctx.ext;
+    const ts = ext === "ts";
+    const T = (type) => (ts ? `: ${type}` : "");
+    const R = (type) => (ts ? `: ${type} ` : " ");
     const code = `/**
  * Swoff Cache Invalidation
  * Framework-agnostic cache tag invalidation.
@@ -15,7 +18,8 @@ export function generateCache(ctx) {
  *   await invalidateByTag("todos");
  */
 
-export async function invalidateByTag(tag) {
+/** Invalidate all cached responses tagged with the given tag. Dispatches cache-invalidated event. */
+export async function invalidateByTag(tag${T("string")})${R("Promise<void>")}{
   if (!navigator.serviceWorker?.controller) return;
 
   navigator.serviceWorker.controller.postMessage({
@@ -28,10 +32,9 @@ export async function invalidateByTag(tag) {
   );
 }
 
-export async function invalidateByTags(tags) {
-  for (const tag of tags) {
-    await invalidateByTag(tag);
-  }
+/** Invalidate all cached responses matching any of the given tags. */
+export async function invalidateByTags(tags${T("string[]")})${R("Promise<void>")}{
+  await Promise.all(tags.map((tag) => invalidateByTag(tag)));
 }
 `;
     writeFile(ctx, `cache.${ext}`, code);

package/dist/lib/generators/file-generators/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,aAAa,CAAC,GAAqB;IACjD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAEpB,MAAM,IAAI,GAAG;;;;;sDAKuC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBxD,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,aAAa,CAAC,GAAqB;IACjD,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;IAEtD,MAAM,IAAI,GAAG;;;;;sDAKuC,GAAG;;;;;;;2CAOd,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;;;;6CAc/B,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;;CAG/E,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/lib/generators/file-generators/client-injector.js

@@ -0,0 +1,101 @@
+/**
+ * Generates client-injector.{js|ts} - orchestrator that wires feature modules together.
+ */
+import { writeFile } from "./context.js";
+export function generateClientInjector(ctx) {
+    const ext = ctx.ext;
+    const ts = ext === "ts";
+    const pwaEnabled = ctx.config.features.pwa.enabled;
+    const mutationQueueEnabled = ctx.config.features.mutationQueue;
+    const crossTabSync = ctx.config.features.crossTabSync;
+    const pwaImport = pwaEnabled
+        ? `import { setupPwaInstall } from "./pwa/install.${ext}";
+`
+        : "";
+    const pwaCall = pwaEnabled ? `setupPwaInstall();\n` : "";
+    const mutationImport = mutationQueueEnabled
+        ? `import { processMutationQueue } from "./mutation-queue.${ext}";
+`
+        : "";
+    const mutationOnlineListener = mutationQueueEnabled
+        ? `
+// --- Mutation Queue Online Listener ---
+window.addEventListener("online", processMutationQueue);
+`
+        : "";
+    const crossTabHandler = crossTabSync
+        ? `
+    if (event.data.type === "TAG_INVALIDATED" && event.data.tag) {
+      window.dispatchEvent(
+        new CustomEvent("cache-invalidated", {
+          detail: { tags: [event.data.tag] },
+        })
+      );
+    }
+`
+        : "";
+    const swImport = `import { initServiceWorker as swInit } from "./sw/injector.${ext}";
+`;
+    const code = `/**
+ * Swoff Client Injector
+ * Orchestrates SW registration, PWA install, and cross-tab sync.
+ * Single entry point for all Swoff client-side features.
+ *
+ * Usage:
+ *   import { initServiceWorker } from './swoff/client-injector.${ext}';
+ *   initServiceWorker();
+ *
+ * Window events (dispatched by this module):
+ *   sw-progress           - Download progress (detail: { percent, downloaded, total })
+ *   sw-ready              - SW active and controlling page
+ *   sw-error              - SW registration failed
+ *   cache-invalidated     - Cache entries cleared (detail: { tags })
+ *   mutation-sync-complete - Queued mutations synced (detail: { succeeded, failed })
+ *   mutation-queue-changed - Queue modified
+ *
+ * Window events (dispatched by feature modules):
+ *   pwa-installable       - PWA can be installed (detail: { isInstallable: true })
+ *   pwa-installed         - User accepted install (detail: { outcome: 'accepted' })
+ *   sw-auth-unauthorized  - 401 response received
+ *   sw-auth-state-change  - Login or logout (detail: { authenticated: boolean })
+ *   mutation-rollback     - Mutation exhausted retries
+ *   sw-update-available   - New version ready (detail: { version })
+ *   sw-version-detected   - Version info available
+ */
+${pwaImport}${mutationImport}${swImport}
+${pwaCall}${mutationOnlineListener}
+// --- SW Message Listener ---
+if (typeof window !== "undefined" && "serviceWorker" in navigator) {
+  navigator.serviceWorker.addEventListener("message", (event) => {
+    if (event.data.type === "SW_PROGRESS") {
+      const { percent, downloaded, total } = event.data;
+      window.dispatchEvent(
+        new CustomEvent("sw-progress", {
+          detail: { percent, downloaded, total },
+        })
+      );
+    }
+    if (event.data.type === "BACKGROUND_SYNC_COMPLETE") {
+      const { succeeded, failed, tags } = event.data.detail;
+      window.dispatchEvent(
+        new CustomEvent("mutation-sync-complete", {
+          detail: { succeeded, failed },
+        })
+      );
+      if (tags && tags.length > 0) {
+        window.dispatchEvent(
+          new CustomEvent("cache-invalidated", { detail: { tags } })
+        );
+      }
+      window.dispatchEvent(new CustomEvent("mutation-queue-changed"));
+    }${crossTabHandler}  });
+}
+
+/** Initialize SW registration and all client-side features (PWA install, mutation queue, cross-tab sync). Call once at app startup. */
+export async function initServiceWorker()${ts ? ": Promise<void>" : " "}{
+  await swInit();
+}
+`;
+    writeFile(ctx, `client-injector.${ext}`, code);
+}
+//# sourceMappingURL=client-injector.js.map

package/dist/lib/generators/file-generators/client-injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-injector.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/client-injector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,sBAAsB,CAAC,GAAqB;IAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC;IACxB,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;IACnD,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/D,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;IAEtD,MAAM,SAAS,GAAG,UAAU;QAC1B,CAAC,CAAC,kDAAkD,GAAG;CAC1D;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzD,MAAM,cAAc,GAAG,oBAAoB;QACzC,CAAC,CAAC,0DAA0D,GAAG;CAClE;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,sBAAsB,GAAG,oBAAoB;QACjD,CAAC,CAAC;;;CAGL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,eAAe,GAAG,YAAY;QAClC,CAAC,CAAC;;;;;;;;CAQL;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,QAAQ,GAAG,8DAA8D,GAAG;CACnF,CAAC;IAEA,MAAM,IAAI,GAAG;;;;;;kEAMmD,GAAG;;;;;;;;;;;;;;;;;;;;EAoBnE,SAAS,GAAG,cAAc,GAAG,QAAQ;EACrC,OAAO,GAAG,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;OAyB3B,eAAe;;;;2CAIqB,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG;;;CAGtE,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,mBAAmB,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}