@swoff/cli 0.3.5 → 0.3.7

package/dist/lib/generators/file-generators/quick-readme.js.map

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

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

@@ -4,6 +4,10 @@
 import { writeFile } from "./context.js";
 export function generateReconcile(ctx) {
     const ext = ctx.ext;
+    const ts = ext === "ts";
+    const T = (type) => (ts ? `: ${type}` : "");
+    const R = (type) => (ts ? `: ${type} ` : " ");
+    const AS = (type) => (ts ? ` as ${type}` : "");
     const code = `/**
  * Swoff ID Reconciliation
  * Update local records with server data after mutation sync.
@@ -16,7 +20,7 @@ export function generateReconcile(ctx) {
 
 import { getRecord, putRecord, deleteRecord } from './store.${ext}';
 
-export async function reconcileRecord(storeName, tempId, serverData) {
+export async function reconcileRecord(storeName${T("string")}, tempId${T("string")}, serverData${T("Record<string, unknown>")})${R("Promise<void>")}{
   const existing = await getRecord(storeName, tempId);
   if (!existing) return;
 
@@ -34,20 +38,11 @@ export async function reconcileRecord(storeName, tempId, serverData) {
     await deleteRecord(storeName, tempId);
   }
 
-  await reconcileReferences(storeName, tempId, serverData.id);
+  await reconcileReferences(storeName, tempId, serverData.id${AS("string | number")});
 }
 
-export async function reconcileReferences(storeName, oldId, newId) {
+export async function reconcileReferences(storeName${T("string")}, oldId${T("string")}, newId${T("string | number")})${R("Promise<void>")}{
   // Override this for your app's schema.
-  // Example: update foreign-key references in related stores.
-  //
-  // const txns = await getAllRecords('transactions');
-  // for (const txn of txns) {
-  //   if (txn.todoId === oldId) {
-  //     txn.todoId = newId;
-  //     await putRecord('transactions', txn);
-  //   }
-  // }
 }
 `;
     writeFile(ctx, `reconcile.${ext}`, code);

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

@@ -1 +1 @@
-{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/reconcile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,GAAqB;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,IAAI,GAAG;;;;;0DAK2C,GAAG;;;;;8DAKC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmChE,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/reconcile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,GAAqB;IACrD,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,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEvD,MAAM,IAAI,GAAG;;;;;0DAK2C,GAAG;;;;;8DAKC,GAAG;;iDAEhB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;;8DAkBrF,EAAE,CAAC,iBAAiB,CAAC;;;qDAG9B,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;;CAGxI,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}

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

@@ -4,6 +4,11 @@
 import { writeFile } from "./context.js";
 export function generateStore(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 dbName = "app-db";
     const code = `/**
  * Swoff IndexedDB Store
@@ -19,55 +24,60 @@ export function generateStore(ctx) {
 
 const DB_NAME = "${dbName}";
 
-export function openAppDB() {
-  return new Promise((resolve, reject) => {
+/** Open the app's IndexedDB database. Creates it if it doesn't exist. */
+export function openAppDB()${R("Promise<IDBDatabase>")}{
+  return new Promise${PT("IDBDatabase")}((resolve, reject) => {
     const request = indexedDB.open(DB_NAME);
-    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);
   });
 }
 
-export async function getRecord(storeName, id) {
+/** Get a record by ID from an IndexedDB store. Returns undefined if not found. */
+export async function getRecord(storeName${T("string")}, id${T("IDBValidKey")})${R("Promise<Record<string, unknown> | undefined>")}{
   const db = await openAppDB();
-  return new Promise((resolve, reject) => {
+  return new Promise${PT("Record<string, unknown> | undefined")}((resolve, reject) => {
     const tx = db.transaction(storeName, "readonly");
     const store = tx.objectStore(storeName);
     const request = store.get(id);
-    request.onsuccess = () => resolve(request.result);
-    request.onerror = () => reject(request.error);
+    request.onsuccess = () => resolve((request${AS("IDBRequest<Record<string, unknown> | undefined>")}).result);
+    request.onerror = () => reject((request${AS("IDBRequest")}).error);
   });
 }
 
-export async function putRecord(storeName, record) {
+/** Store a record in an IndexedDB store (insert or update). Returns the record's key. */
+export async function putRecord(storeName${T("string")}, record${T("Record<string, unknown>")})${R("Promise<IDBValidKey>")}{
   const db = await openAppDB();
-  return new Promise((resolve, reject) => {
+  return new Promise${PT("IDBValidKey")}((resolve, reject) => {
     const tx = db.transaction(storeName, "readwrite");
     const store = tx.objectStore(storeName);
     const request = store.put(record);
-    tx.oncomplete = () => resolve(request.result);
-    tx.onerror = () => reject(tx.error);
+    tx.oncomplete = () => resolve((request${AS("IDBRequest<IDBValidKey>")}).result);
+    tx.onerror = () => reject((tx${AS("IDBTransaction")}).error);
   });
 }
 
-export async function deleteRecord(storeName, id) {
+/** Delete a record by ID from an IndexedDB store. */
+export async function deleteRecord(storeName${T("string")}, id${T("IDBValidKey")})${R("Promise<void>")}{
   const db = await openAppDB();
-  return new Promise((resolve, reject) => {
+  return new Promise${PT("void")}((resolve, reject) => {
     const tx = db.transaction(storeName, "readwrite");
     const store = tx.objectStore(storeName);
-    const request = store.delete(id);
+    store.delete(id);
     tx.oncomplete = () => resolve();
-    tx.onerror = () => reject(tx.error);
+    tx.onerror = () => reject((tx${AS("IDBTransaction")}).error);
   });
 }
 
-export async function getAllRecords(storeName) {
+/** Get all records from an IndexedDB store. */
+export async function getAllRecords(storeName${T("string")})${R("Promise<Record<string, unknown>[]>")}{
   const db = await openAppDB();
-  return new Promise((resolve, reject) => {
+  return new Promise${PT("Record<string, unknown>[]")}((resolve, reject) => {
     const tx = db.transaction(storeName, "readonly");
     const store = tx.objectStore(storeName);
     const request = store.getAll();
-    request.onsuccess = () => resolve(request.result);
-    request.onerror = () => reject(request.error);
+    request.onsuccess = () => resolve((request${AS("IDBRequest<Record<string, unknown>[]>")}).result);
+    request.onerror = () => reject((request${AS("IDBRequest")}).error);
   });
 }
 `;

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

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/store.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,MAAM,GAAG,QAAQ,CAAC;IAExB,MAAM,IAAI,GAAG;;;;;oFAKqE,GAAG;;;;;;;mBAOpE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDxB,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/store.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;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,MAAM,GAAG,QAAQ,CAAC;IAExB,MAAM,IAAI,GAAG;;;;;oFAKqE,GAAG;;;;;;;mBAOpE,MAAM;;;6BAGI,CAAC,CAAC,sBAAsB,CAAC;sBAChC,EAAE,CAAC,aAAa,CAAC;;kDAEW,EAAE,CAAC,kBAAkB,CAAC;+CACzB,EAAE,CAAC,YAAY,CAAC;;;;;2CAKpB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,8CAA8C,CAAC;;sBAE5G,EAAE,CAAC,qCAAqC,CAAC;;;;gDAIf,EAAE,CAAC,iDAAiD,CAAC;6CACxD,EAAE,CAAC,YAAY,CAAC;;;;;2CAKlB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,sBAAsB,CAAC;;sBAEpG,EAAE,CAAC,aAAa,CAAC;;;;4CAIK,EAAE,CAAC,yBAAyB,CAAC;mCACtC,EAAE,CAAC,gBAAgB,CAAC;;;;;8CAKT,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;sBAEhF,EAAE,CAAC,MAAM,CAAC;;;;;mCAKG,EAAE,CAAC,gBAAgB,CAAC;;;;;+CAKR,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,oCAAoC,CAAC;;sBAE/E,EAAE,CAAC,2BAA2B,CAAC;;;;gDAIL,EAAE,CAAC,uCAAuC,CAAC;6CAC9C,EAAE,CAAC,YAAY,CAAC;;;CAG5D,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/lib/generators/file-generators/sw-generator-build.js

@@ -6,21 +6,22 @@ export function generateSwGeneratorBuild(ctx) {
     const code = `#!/usr/bin/env node
 /**
  * Swoff SW Generator Build Script
- * Reads swoff/sw-template.js and generates versioned SW output.
+ * Reads swoff/sw/template.js and generates versioned SW output.
  *
  * Add to package.json:
- *   "build": "your-build && node swoff/sw-generator.js"
+ *   "build": "your-build && node swoff/sw/generator.js"
  */
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
 import { join, dirname, relative } from 'path';
+import { createHash } from 'crypto';
 import { fileURLToPath } from 'url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const projectRoot = join(__dirname, '..');
+const projectRoot = process.cwd();
 
 const pkgPath = join(projectRoot, 'package.json');
-const templatePath = join(__dirname, 'sw-template.js');
+const templatePath = join(__dirname, 'template.js');
 const configPath = join(projectRoot, 'swoff.config.json');
 
 if (!existsSync(configPath)) {
@@ -30,7 +31,7 @@ if (!existsSync(configPath)) {
 }
 
 if (!existsSync(templatePath)) {
-  console.error('Error: swoff/sw-template.js not found');
+  console.error('Error: swoff/sw/template.js not found');
   process.exit(1);
 }
 
@@ -38,7 +39,12 @@ const pkg = existsSync(pkgPath) ? JSON.parse(readFileSync(pkgPath, 'utf8')) : {
 const config = JSON.parse(readFileSync(configPath, 'utf8'));
 const template = readFileSync(templatePath, 'utf8');
 
-const version = config.version === 'from-package' ? pkg.version || '1.0.0' : config.version;
+const swConfig = config.features?.serviceWorker || {};
+const versionConfig = swConfig.version || {};
+const versionEnabled = versionConfig.enabled !== false;
+const version = versionConfig.source === 'manual' && versionConfig.value
+  ? versionConfig.value
+  : pkg.version || '1.0.0';
 const outputDir = config.build?.outputDir || 'dist';
 const swFilename = config.build?.swFilename || 'sw';
 
@@ -61,8 +67,12 @@ function collectAssets(dir) {
   return assets;
 }
 
+function generateCacheNameHash(swContent) {
+  return 'sw-cache-' + createHash('sha256').update(swContent).digest('hex').slice(0, 12);
+}
+
 const allAssets = collectAssets(outDir);
-const swFile = \`\${swFilename}-v\${version}.js\`;
+const swFile = versionEnabled ? \`\${swFilename}-v\${version}.js\` : \`\${swFilename}.js\`;
 const filtered = allAssets.filter(a => !a.endsWith(swFile) && a !== '/version.json');
 const fallback = ['/index.html'];
 if (config.features?.pwa?.enabled) fallback.push('/manifest.json');
@@ -70,19 +80,30 @@ const combined = [...new Set([...fallback, ...filtered])];
 const assetsToCache = combined.map(url => ({ url, options: {} }));
 
 let sw = template;
-sw = sw.replace('// [[CACHE_NAME]]', \`CACHE_NAME = 'sw-v\${version}'\`);
+if (versionEnabled) {
+  sw = sw.replace('// [[CACHE_NAME]]', \`CACHE_NAME = 'sw-v\${version}'\`);
+} else {
+  const sentinel = 'SW_CACHE_SENTINEL';
+  sw = sw.replace('// [[CACHE_NAME]]', \`CACHE_NAME = '\${sentinel}'\`);
+}
 sw = sw.replace('// [[ASSETS_LIST]]', \`ASSETS_TO_CACHE = \${JSON.stringify(assetsToCache, null, 2)}\`);
 sw = sw.replace('// [[AUTO_SKIP_WAITING]]', \`const AUTO_SKIP_WAITING = \${config.features?.serviceWorker?.autoActivate || false};\`);
 
-writeFileSync(join(outDir, swFile), sw);
-writeFileSync(join(outDir, 'version.json'), JSON.stringify({
-  version,
-  minSupportedVersion: config.minSupportedVersion || '0.0.0',
-  generatedAt: new Date().toISOString(),
-}, null, 2));
-
-console.log(\`Service worker built: \${outputDir}/\${swFile}\`);
+if (!versionEnabled) {
+  const cacheName = generateCacheNameHash(sw);
+  sw = sw.replace(sentinel, cacheName);
+  writeFileSync(join(outDir, swFile), sw);
+  console.log(\`Service worker built: \${outputDir}/\${swFile}\`);
+} else {
+  writeFileSync(join(outDir, swFile), sw);
+  writeFileSync(join(outDir, 'version.json'), JSON.stringify({
+    version,
+    minSupportedVersion: versionConfig.minSupportedVersion || '0.0.0',
+    generatedAt: new Date().toISOString(),
+  }, null, 2));
+  console.log(\`Service worker built: \${outputDir}/\${swFile}\`);
+}
 `;
-    writeFile(ctx, "sw-generator.js", code);
+    writeFile(ctx, "sw/generator.js", code);
 }
 //# sourceMappingURL=sw-generator-build.js.map

package/dist/lib/generators/file-generators/sw-generator-build.js.map

@@ -1 +1 @@
-{"version":3,"file":"sw-generator-build.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/sw-generator-build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,wBAAwB,CAAC,GAAqB;IAC5D,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Ed,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"sw-generator-build.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/sw-generator-build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,wBAAwB,CAAC,GAAqB;IAC5D,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoGd,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -1,24 +1,21 @@
 /**
- * Generates sw-injector.{js|ts} - client-side SW registration + PWA + cross-tab sync.
+ * Generates sw/injector.{js|ts} - core SW registration logic only.
  */
 import { writeFile } from "./context.js";
 export function generateSwInjector(ctx) {
-    const autoRegister = ctx.config.features.serviceWorker.autoRegister;
+    const autoUpdate = ctx.config.features.serviceWorker.autoUpdate;
     const autoActivate = ctx.config.features.serviceWorker.autoActivate;
-    const pwaEnabled = ctx.config.features.pwa.enabled;
-    const preventDefaultInstall = ctx.config.features.pwa.preventDefaultInstall;
-    const crossTabSync = ctx.config.features.crossTabSync;
+    const versionEnabled = ctx.config.features.serviceWorker.version.enabled;
     const ext = ctx.ext;
-    const mutationQueueEnabled = ctx.config.features.mutationQueue;
-    const authEnabled = ctx.config.features.auth.enabled;
-    const code = `/**
+    const ts = ext === "ts";
+    const T = (type) => (ts ? `: ${type}` : "");
+    const R = (type) => (ts ? `: ${type} ` : " ");
+    const versionedCode = `/**
  * Swoff SW Injector
- * Framework-agnostic SW registration, PWA install support, and cross-tab sync.
+ * Framework-agnostic SW registration with versioned URLs and update flow.
  *
  * Usage:
- *   import { initServiceWorker } from './swoff/sw-injector.${ext}';
- *
- *   // Call in your app entry point (e.g., main.tsx, app.js):
+ *   import { initServiceWorker } from './swoff/sw/injector.${ext}';
  *   initServiceWorker();
  *
  * Window events:
@@ -27,52 +24,48 @@ export function generateSwInjector(ctx) {
  *   sw-progress          - Download progress (detail: { percent, downloaded, total })
  *   sw-ready             - SW active and controlling page
  *   sw-error             - SW registration failed
- *   pwa-installable      - PWA can be installed (detail: { isInstallable: true })
- *   pwa-installed        - User accepted install (detail: { outcome: 'accepted' })
- *   cache-invalidated    - Cache entries with given tags cleared (detail: { tags })
- *   mutation-sync-complete - Queued mutations synced (detail: { succeeded, failed })
- *   mutation-queue-changed - Queue modified
- *   mutation-rollback     - Mutation exhausted retries (detail: { method, url, tempId, previousData })
- *   sw-auth-unauthorized  - 401 response received (token expired or invalid)${authEnabled ? `
- *   sw-auth-state-change  - Login or logout (detail: { authenticated: boolean })` : ""}
  *
  * Window properties:
  *   window.latestSWVersion       - Latest version from version.json
  *   window.currentSWVersion      - Active SW version
  *   window.swAvailableVersion    - Pending update version
  *   window.swUpdateRequired      - Forced update needed (version < minSupportedVersion)
- *   window.swMinSupportedVersion - Minimum supported version from version.json
+ *   window.swMinSupportedVersion - Minimum supported version
  *   window.swReady               - SW is active
  *   window.swError               - Registration failed
- *   window.deferredInstallPrompt - Captured BeforeInstallPromptEvent
- *   window.pwaInstallable        - Whether PWA can be installed
  */
-${mutationQueueEnabled ? `import { processMutationQueue } from "./mutation-queue.${ext}";
-` : ""}
-const AUTO_REGISTER = ${autoRegister};
+const AUTO_UPDATE = ${autoUpdate};
 const AUTO_ACTIVATE = ${autoActivate};
 
-// --- SW Registration ---
+function semverCompare(a${T("string")}, b${T("string")})${R("number")}{
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if (pa[i] > pb[i]) return 1;
+    if (pa[i] < pb[i]) return -1;
+  }
+  return 0;
+}
 
 async function checkForUpdate() {
-  const response = await fetch("/version.json");
+  const response = await fetch("/version.json?t=" + Date.now());
   if (!response.ok) {
     throw new Error("Failed to fetch version.json");
   }
   return response.json();
 }
 
-async function waitForController() {
-  return new Promise((resolve) => {
+async function waitForController()${R("Promise<void>")}{
+  return new Promise<void>((resolve) => {
     if (navigator.serviceWorker.controller) {
       resolve();
     } else {
-      navigator.serviceWorker.addEventListener("controllerchange", resolve, { once: true });
+      navigator.serviceWorker.addEventListener("controllerchange", () => resolve(), { once: true });
     }
   });
 }
 
-async function doRegisterServiceWorker(version) {
+async function doRegisterServiceWorker(version${T("string")})${R("Promise<ServiceWorkerRegistration>")}{
   const swUrl = \`/sw-v\${version}.js\`;
   const registration = await navigator.serviceWorker.register(swUrl);
   localStorage.setItem("swRegisteredVersion", version);
@@ -84,18 +77,13 @@ async function doRegisterServiceWorker(version) {
   return registration;
 }
 
-function shouldRegister() {
-  return true;
-}
-
-export async function initServiceWorker() {
+/** Register the SW with version checking and update flow. Checks version.json, handles updates, and dispatches sw-ready/sw-error events. */
+export async function initServiceWorker()${R("Promise<void>")}{
   if (!("serviceWorker" in navigator)) {
     console.warn("Service Workers not supported");
     return;
   }
 
-  if (!shouldRegister()) return;
-
   try {
     const manifest = await checkForUpdate();
     const currentVersion = localStorage.getItem("swRegisteredVersion");
@@ -105,7 +93,7 @@ export async function initServiceWorker() {
     if (currentVersion === manifest.version) {
       const registration = await navigator.serviceWorker.getRegistration();
       if (registration && registration.active) {
-        window.currentSWVersion = currentVersion;
+        window.currentSWVersion = currentVersion ?? undefined;
         window.dispatchEvent(new CustomEvent("sw-version-detected"));
         await waitForController();
         if (!window.swReady) {
@@ -115,9 +103,9 @@ export async function initServiceWorker() {
     } else if (currentVersion && currentVersion !== manifest.version) {
       window.swAvailableVersion = manifest.version;
       window.swUpdateRequired =
-        currentVersion < (manifest.minSupportedVersion || "0.0.0");
+        semverCompare(currentVersion, manifest.minSupportedVersion || "0.0.0") < 0;
 
-      if (AUTO_REGISTER) {
+      if (AUTO_UPDATE) {
         const registration = await navigator.serviceWorker.getRegistration();
         if (registration && registration.waiting) {
           if (AUTO_ACTIVATE) {
@@ -163,7 +151,9 @@ export async function initServiceWorker() {
         }
         return;
       }
-    } catch {}
+    } catch {
+      // Handle the case where no existing active registration is found
+    }
 
     console.error("Service Worker initialization failed:", error);
     window.swError = true;
@@ -171,7 +161,8 @@ export async function initServiceWorker() {
   }
 }
 
-export async function handleUpdateApproved(newVersion) {
+/** Accept a pending SW update. Reloads the page once the new SW takes control. */
+export async function handleUpdateApproved(newVersion${T("string")})${R("Promise<void>")}{
   const registration = await navigator.serviceWorker.getRegistration();
   if (registration && registration.waiting) {
     registration.waiting.postMessage({ type: "SKIP_WAITING" });
@@ -186,81 +177,61 @@ export async function handleUpdateApproved(newVersion) {
   }
 }
 
-export async function skipWaiting() {
+/** Activate a waiting SW without reloading. Useful when you handle the transition yourself. */
+export async function skipWaiting()${R("Promise<void>")}{
   const registration = await navigator.serviceWorker.ready;
   if (registration.waiting) {
     registration.waiting.postMessage({ type: "SKIP_WAITING" });
   }
 }
+`;
+    const simpleCode = `/**
+ * Swoff SW Injector (Simple Mode)
+ * Fixed SW URL with hash-based cache name — no versioned URLs or update events.
+ *
+ * Usage:
+ *   import { initServiceWorker } from './swoff/sw/injector.${ext}';
+ *   initServiceWorker();
+ *
+ * Window events:
+ *   sw-ready  - SW active and controlling page
+ *   sw-error  - SW registration failed
+ *
+ * Window properties:
+ *   window.currentSWVersion  - "simple"
+ *   window.swReady           - SW is active
+ *   window.swError           - Registration failed
+ */
+async function waitForController()${R("Promise<void>")}{
+  return new Promise<void>((resolve) => {
+    if (navigator.serviceWorker.controller) {
+      resolve();
+    } else {
+      navigator.serviceWorker.addEventListener("controllerchange", () => resolve(), { once: true });
+    }
+  });
+}
 
-// --- PWA Install Support ---
-${pwaEnabled ? `
-window.addEventListener("beforeinstallprompt", (e) => {
-  window.deferredInstallPrompt = e;
-  window.pwaInstallable = true;
-
-  if (${preventDefaultInstall}) {
-    e.preventDefault();
+/** Register the SW with a fixed URL (non-versioned mode). Dispatches sw-ready/sw-error. */
+export async function initServiceWorker()${R("Promise<void>")}{
+  if (!("serviceWorker" in navigator)) {
+    console.warn("Service Workers not supported");
+    return;
+  }
+  try {
+    const registration = await navigator.serviceWorker.register("/sw.js");
+    window.currentSWVersion = "simple";
+    window.dispatchEvent(new CustomEvent("sw-version-detected"));
+    await waitForController();
+    window.dispatchEvent(new CustomEvent("sw-ready"));
+  } catch (error) {
+    console.error("Service Worker registration failed:", error);
+    window.swError = true;
+    window.dispatchEvent(new CustomEvent("sw-error"));
   }
-
-  window.dispatchEvent(
-    new CustomEvent("pwa-installable", {
-      detail: { isInstallable: true },
-    })
-  );
-});
-
-window.addEventListener("appinstalled", () => {
-  window.deferredInstallPrompt = null;
-  window.pwaInstallable = false;
-
-  window.dispatchEvent(
-    new CustomEvent("pwa-installed", {
-      detail: { outcome: "accepted" },
-    })
-  );
-});
-` : ""}
-${mutationQueueEnabled ? `
-// --- Mutation Queue Listener ---
-window.addEventListener("online", processMutationQueue);
-` : ""}
-// --- 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"));
-    }
-${crossTabSync ? `
-    if (event.data.type === "TAG_INVALIDATED" && event.data.tag) {
-      window.dispatchEvent(
-        new CustomEvent("cache-invalidated", {
-          detail: { tags: [event.data.tag] },
-        })
-      );
-    }
-` : ""}  });
 }
 `;
-    writeFile(ctx, `sw-injector.${ext}`, code);
+    const code = versionEnabled ? versionedCode : simpleCode;
+    writeFile(ctx, `sw/injector.${ext}`, code);
 }
 //# sourceMappingURL=sw-injector.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sw-injector.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/sw-injector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC;IACpE,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC;IACpE,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;IACnD,MAAM,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAC5E,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAEpB,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;IAE/D,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;IAErD,MAAM,IAAI,GAAG;;;;;8DAK+C,GAAG;;;;;;;;;;;;;;;;;+EAiBc,WAAW,CAAC,CAAC,CAAC;kFACX,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;EAarF,oBAAoB,CAAC,CAAC,CAAC,0DAA0D,GAAG;CACrF,CAAC,CAAC,CAAC,EAAE;wBACkB,YAAY;wBACZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgJlC,UAAU,CAAC,CAAC,CAAC;;;;;QAKP,qBAAqB;;;;;;;;;;;;;;;;;;;;;CAqB5B,CAAC,CAAC,CAAC,EAAE;EACJ,oBAAoB,CAAC,CAAC,CAAC;;;CAGxB,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BJ,YAAY,CAAC,CAAC,CAAC;;;;;;;;CAQhB,CAAC,CAAC,CAAC,EAAE;;CAEL,CAAC;IAEA,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"sw-injector.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/sw-injector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC;IAChE,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC;IACpE,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC;IACzE,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC;IAExB,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,aAAa,GAAG;;;;;8DAKsC,GAAG;;;;;;;;;;;;;;;;;;;sBAmB3C,UAAU;wBACR,YAAY;;0BAEV,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;oCAkBjC,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;gDAUN,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,oCAAoC,CAAC;;;;;;;;;;;;;2CAa3D,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDAoFN,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;qCAgBnD,CAAC,CAAC,eAAe,CAAC;;;;;;CAMtD,CAAC;IAEA,MAAM,UAAU,GAAG;;;;;8DAKyC,GAAG;;;;;;;;;;;;oCAY7B,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;2CAWX,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;CAiB5D,CAAC;IAEA,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;IAEzD,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/lib/generators/file-generators/sw-push.js

@@ -0,0 +1,67 @@
+/**
+ * Generates SW push notification event handlers.
+ * Appended to the SW template via the // [[PUSH_HANDLERS]] placeholder.
+ */
+export function generateSwPushHandlers() {
+    return `
+// --- Push Notification Handlers ---
+
+self.addEventListener("push", (event) => {
+  let data;
+
+  try {
+    data = event.data ? event.data.json() : {};
+  } catch {
+    data = { title: "New Update", body: event.data?.text() || "" };
+  }
+
+  const options = {
+    body: data.body || "",
+    icon: data.icon || "/icon-192.png",
+    badge: data.badge || "",
+    image: data.image || undefined,
+    vibrate: data.vibrate || [200, 100, 200],
+    data: {
+      url: data.url || "/",
+      ...(data.data || {}),
+    },
+    actions: data.actions || [],
+    tag: data.tag || undefined,
+    requireInteraction: data.requireInteraction || false,
+  };
+
+  event.waitUntil(self.registration.showNotification(data.title || "Update", options));
+});
+
+self.addEventListener("notificationclick", (event) => {
+  event.notification.close();
+
+  const url = event.notification.data?.url || "/";
+  const action = event.action;
+
+  event.waitUntil(
+    (async () => {
+      if (action) {
+        // Handle action clicks (e.g., "reply", "dismiss")
+      }
+
+      const clients = await self.clients.matchAll({ type: "window" });
+
+      for (const client of clients) {
+        const clientUrl = new URL(client.url);
+        const targetUrl = new URL(url, self.location.origin);
+
+        if (clientUrl.pathname === targetUrl.pathname && "focus" in client) {
+          return client.focus();
+        }
+      }
+
+      if (clients.openWindow) {
+        return clients.openWindow(url);
+      }
+    })(),
+  );
+});
+`;
+}
+//# sourceMappingURL=sw-push.js.map

package/dist/lib/generators/file-generators/sw-push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sw-push.js","sourceRoot":"","sources":["../../../../src/lib/generators/file-generators/sw-push.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,sBAAsB;IACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DR,CAAC;AACF,CAAC"}