@emkodev/emroute 1.8.2-beta.1 → 1.10.0-beta.1

package/dist/src/service-worker/emroute.sw.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Emroute Service Worker
+ *
+ * Runs Emroute inside a ServiceWorker. Intercepts fetch events and
+ * serves pages from split storage — framework assets in Cache API,
+ * user content (pages, widgets, manifests) in IndexedDB.
+ *
+ * Consumer creates their own sw.ts, calls `createEmrouteSW()` with
+ * options, and the returned handler wires install/activate/fetch.
+ */
+import type { ContextProvider } from '../../core/type/component.type.ts';
+import type { MarkdownRenderer } from '../../core/type/markdown.type.ts';
+import type { SpaMode } from '../../core/type/widget.type.ts';
+import type { BasePath } from '../../core/server/emroute.server.ts';
+/** Options for the emroute ServiceWorker. */
+export interface EmrouteSWOptions {
+    /** Cache name — version this to bust stale caches. */
+    cacheName: string;
+    /** Framework asset paths to precache into Cache API (e.g. emroute.js, app.js). */
+    precache: string[];
+    /** User content paths to precache into IndexedDB (e.g. pages, widgets, manifests). */
+    content?: string[];
+    /** IndexedDB database name for user content. Defaults to 'emroute-content'. */
+    dbName?: string;
+    /** SPA mode (defaults to 'only'). */
+    spa?: SpaMode;
+    /** Base paths. */
+    basePath?: BasePath;
+    /** Title for the HTML shell. */
+    title?: string;
+    /** Markdown renderer (if pages use .md). */
+    markdownRenderer?: MarkdownRenderer;
+    /** Context provider for pages and widgets. */
+    extendContext?: ContextProvider;
+    /**
+     * Origin to fetch precache files from during install.
+     * Defaults to self.location.origin.
+     */
+    origin?: string;
+}
+/**
+ * Wire emroute into the ServiceWorker lifecycle.
+ *
+ * Call this from your sw.ts:
+ * ```ts
+ * import { createEmrouteSW } from '@emkodev/emroute/sw';
+ * createEmrouteSW({
+ *   cacheName: 'my-app-v1',
+ *   precache: ['/emroute.js', '/app.js', '/importmap.json', '/main.css'],
+ *   content: ['/routes.manifest.json', '/routes/index.page.js'],
+ * });
+ * ```
+ */
+export declare function createEmrouteSW(options: EmrouteSWOptions): void;

package/dist/src/service-worker/emroute.sw.js

@@ -0,0 +1,181 @@
+/**
+ * Emroute Service Worker
+ *
+ * Runs Emroute inside a ServiceWorker. Intercepts fetch events and
+ * serves pages from split storage — framework assets in Cache API,
+ * user content (pages, widgets, manifests) in IndexedDB.
+ *
+ * Consumer creates their own sw.ts, calls `createEmrouteSW()` with
+ * options, and the returned handler wires install/activate/fetch.
+ */
+/// <reference lib="webworker" />
+import { Emroute } from "../../core/server/emroute.server.js";
+import { CacheRuntime } from "../../runtime/cache.runtime.js";
+import { IdbRuntime } from "../../runtime/idb.runtime.js";
+import { Runtime, } from "../../runtime/abstract.runtime.js";
+/**
+ * Composite Runtime: reads from Cache API first, falls back to IDB.
+ * Writes go to IDB (user content is mutable).
+ */
+class SwRuntime extends Runtime {
+    cache;
+    idb;
+    constructor(cache, idb) {
+        super();
+        this.cache = cache;
+        this.idb = idb;
+    }
+    handle(resource, init) {
+        const method = init?.method ?? 'GET';
+        // Writes go to IDB (user content)
+        if (method === 'PUT' || method === 'DELETE') {
+            return this.idb.handle(resource, init);
+        }
+        // Reads: Cache first, IDB fallback
+        return this.cache.handle(resource, init).then(async (r) => {
+            if (r.status !== 404)
+                return r;
+            return this.idb.handle(resource, init);
+        });
+    }
+    query(resource, options) {
+        if (options?.as === 'text') {
+            return this.handle(resource, options).then(async (r) => {
+                if (r.status === 404) {
+                    const path = typeof resource === 'string' ? resource
+                        : resource instanceof URL ? resource.pathname
+                            : new URL(resource.url).pathname;
+                    throw new Error(`Not found: ${path}`);
+                }
+                return r.text();
+            });
+        }
+        return this.handle(resource, options);
+    }
+    async loadModule(path) {
+        // Try cache first, then IDB
+        try {
+            return await this.cache.loadModule(path);
+        }
+        catch {
+            return await this.idb.loadModule(path);
+        }
+    }
+}
+/**
+ * Wire emroute into the ServiceWorker lifecycle.
+ *
+ * Call this from your sw.ts:
+ * ```ts
+ * import { createEmrouteSW } from '@emkodev/emroute/sw';
+ * createEmrouteSW({
+ *   cacheName: 'my-app-v1',
+ *   precache: ['/emroute.js', '/app.js', '/importmap.json', '/main.css'],
+ *   content: ['/routes.manifest.json', '/routes/index.page.js'],
+ * });
+ * ```
+ */
+export function createEmrouteSW(options) {
+    const { cacheName, precache, content = [], dbName = 'emroute-content', origin = self.location.origin, } = options;
+    const cacheRuntime = new CacheRuntime(cacheName);
+    const idbRuntime = new IdbRuntime(dbName);
+    const swRuntime = new SwRuntime(cacheRuntime, idbRuntime);
+    let emroute = null;
+    async function getEmroute() {
+        if (emroute)
+            return emroute;
+        emroute = await Emroute.create({
+            spa: options.spa ?? 'only',
+            ...(options.basePath ? { basePath: options.basePath } : {}),
+            ...(options.title ? { title: options.title } : {}),
+            ...(options.markdownRenderer ? { markdownRenderer: options.markdownRenderer } : {}),
+            ...(options.extendContext ? { extendContext: options.extendContext } : {}),
+        }, swRuntime);
+        return emroute;
+    }
+    // ── Install: precache from network ──────────────────────────────────
+    self.addEventListener('install', (event) => {
+        event.waitUntil((async () => {
+            // Framework assets → Cache API
+            if (precache.length > 0) {
+                const cache = await caches.open(cacheName);
+                await Promise.all(precache.map(async (path) => {
+                    try {
+                        const response = await fetch(`${origin}${path}`);
+                        if (response.ok) {
+                            await cache.put(new Request(`https://emroute-cache${path}`), response);
+                        }
+                    }
+                    catch {
+                        console.error(`[emroute-sw] Failed to precache asset: ${path}`);
+                    }
+                }));
+            }
+            // User content → IDB
+            if (content.length > 0) {
+                await Promise.all(content.map(async (path) => {
+                    try {
+                        const response = await fetch(`${origin}${path}`);
+                        if (response.ok) {
+                            const data = new Uint8Array(await response.arrayBuffer());
+                            await idbRuntime.handle(path, {
+                                method: 'PUT',
+                                body: data,
+                            });
+                        }
+                    }
+                    catch {
+                        console.error(`[emroute-sw] Failed to precache content: ${path}`);
+                    }
+                }));
+            }
+            await self.skipWaiting();
+        })());
+    });
+    // ── Activate: claim clients, clean old caches ───────────────────────
+    self.addEventListener('activate', (event) => {
+        event.waitUntil((async () => {
+            // Delete old emroute caches
+            const keys = await caches.keys();
+            await Promise.all(keys
+                .filter((key) => key !== cacheName && key.startsWith('emroute'))
+                .map((key) => caches.delete(key)));
+            await self.clients.claim();
+        })());
+    });
+    // ── Fetch: serve from emroute or storage ────────────────────────────
+    self.addEventListener('fetch', (event) => {
+        const url = new URL(event.request.url);
+        // Only handle same-origin requests
+        if (url.origin !== self.location.origin)
+            return;
+        event.respondWith(handleFetch(event.request, url));
+    });
+    async function handleFetch(request, url) {
+        // Navigation requests → emroute server
+        if (request.mode === 'navigate') {
+            try {
+                const server = await getEmroute();
+                const response = await server.handleRequest(request);
+                if (response)
+                    return response;
+            }
+            catch (e) {
+                console.error('[emroute-sw] Navigation error:', e);
+            }
+            // Fall through to storage/network
+        }
+        // Static files → composite runtime (cache first, then IDB)
+        const cached = await swRuntime.handle(url.pathname);
+        if (cached.status !== 404)
+            return cached;
+        // Network fallback
+        try {
+            return await fetch(request);
+        }
+        catch {
+            return new Response('Offline', { status: 503 });
+        }
+    }
+}
+//# sourceMappingURL=emroute.sw.js.map

package/dist/src/service-worker/emroute.sw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emroute.sw.js","sourceRoot":"","sources":["../../../src/service-worker/emroute.sw.ts"],"names":[],"mappings":"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"}

package/dist/src/service-worker/mod.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Service Worker Module
+ *
+ * Entry point for `@emkodev/emroute/sw`.
+ */
+export { createEmrouteSW, type EmrouteSWOptions } from './emroute.sw.ts';
+export { CacheRuntime } from '../../runtime/cache.runtime.ts';
+export { IdbRuntime } from '../../runtime/idb.runtime.ts';

package/dist/src/service-worker/mod.js

@@ -0,0 +1,9 @@
+/**
+ * Service Worker Module
+ *
+ * Entry point for `@emkodev/emroute/sw`.
+ */
+export { createEmrouteSW } from "./emroute.sw.js";
+export { CacheRuntime } from "../../runtime/cache.runtime.js";
+export { IdbRuntime } from "../../runtime/idb.runtime.js";
+//# sourceMappingURL=mod.js.map

package/dist/src/service-worker/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/service-worker/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAyB,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emkodev/emroute",
-  "version": "1.8.2-beta.1",
+  "version": "1.10.0-beta.1",
   "description": "File-based (but storage-agnostic) router with triple rendering (SPA, SSR HTML, SSR Markdown). Zero dependencies.",
   "license": "BSD-3-Clause",
   "author": "emko.dev",
@@ -96,6 +96,21 @@
       "bun": "./runtime/fetch.runtime.ts",
       "types": "./dist/runtime/fetch.runtime.d.ts",
       "default": "./dist/runtime/fetch.runtime.js"
+    },
+    "./runtime/cache": {
+      "bun": "./runtime/cache.runtime.ts",
+      "types": "./dist/runtime/cache.runtime.d.ts",
+      "default": "./dist/runtime/cache.runtime.js"
+    },
+    "./runtime/idb": {
+      "bun": "./runtime/idb.runtime.ts",
+      "types": "./dist/runtime/idb.runtime.d.ts",
+      "default": "./dist/runtime/idb.runtime.js"
+    },
+    "./sw": {
+      "bun": "./src/service-worker/mod.ts",
+      "types": "./dist/src/service-worker/mod.d.ts",
+      "default": "./dist/src/service-worker/mod.js"
     }
   },
   "devDependencies": {

package/runtime/cache.runtime.ts

@@ -0,0 +1,127 @@
+/**
+ * Cache Runtime
+ *
+ * Browser-compatible Runtime backed by the Cache API.
+ * Used inside ServiceWorkers to serve files offline.
+ *
+ * No bundling, no transpiling, no filesystem access.
+ * No directory scanning — manifests are pre-cached during SW install.
+ */
+
+import {
+  CONTENT_TYPES,
+  type FetchParams,
+  type FetchReturn,
+  Runtime,
+  type RuntimeConfig,
+} from './abstract.runtime.ts';
+
+export class CacheRuntime extends Runtime {
+  private cache: Cache | null = null;
+  private readonly cacheName: string;
+
+  constructor(cacheName: string, config: RuntimeConfig = {}) {
+    super(config);
+    this.cacheName = cacheName;
+  }
+
+  private async getCache(): Promise<Cache> {
+    this.cache ??= await caches.open(this.cacheName);
+    return this.cache;
+  }
+
+  handle(
+    resource: FetchParams[0],
+    init?: FetchParams[1],
+  ): FetchReturn {
+    const path = this.parsePath(resource);
+    const method = init?.method ?? 'GET';
+
+    switch (method) {
+      case 'PUT':
+        return this.write(path, init?.body ?? null);
+      case 'DELETE':
+        return this.delete(path);
+      default:
+        return this.read(path);
+    }
+  }
+
+  query(
+    resource: FetchParams[0],
+    options: FetchParams[1] & { as: 'text' },
+  ): Promise<string>;
+  query(
+    resource: FetchParams[0],
+    options?: FetchParams[1],
+  ): FetchReturn;
+  query(
+    resource: FetchParams[0],
+    options?: FetchParams[1] & { as?: 'text' },
+  ): Promise<Response | string> {
+    if (options?.as === 'text') {
+      return this.read(this.parsePath(resource)).then(async (r) => {
+        if (r.status === 404) throw new Error(`Not found: ${this.parsePath(resource)}`);
+        return r.text();
+      });
+    }
+    return this.handle(resource, options);
+  }
+
+  override async loadModule(path: string): Promise<unknown> {
+    const response = await this.read(path);
+    if (response.status === 404) {
+      throw new Error(`Module not found in cache: ${path}`);
+    }
+    const js = await response.text();
+    const blob = new Blob([js], { type: 'application/javascript' });
+    const objectUrl = URL.createObjectURL(blob);
+    try {
+      return await import(objectUrl);
+    } finally {
+      URL.revokeObjectURL(objectUrl);
+    }
+  }
+
+  // ── Private ─────────────────────────────────────────────────────────
+
+  private async read(path: string): Promise<Response> {
+    const cache = await this.getCache();
+    const key = new Request(this.toFakeUrl(path));
+    const cached = await cache.match(key);
+    if (!cached) return new Response('Not Found', { status: 404 });
+    return cached;
+  }
+
+  private async write(path: string, body: BodyInit | null): Promise<Response> {
+    const cache = await this.getCache();
+    const ext = path.slice(path.lastIndexOf('.')).toLowerCase();
+    const contentType = CONTENT_TYPES.get(ext) ?? 'application/octet-stream';
+    const response = new Response(body, {
+      status: 200,
+      headers: { 'Content-Type': contentType },
+    });
+    await cache.put(new Request(this.toFakeUrl(path)), response);
+    return new Response(null, { status: 204 });
+  }
+
+  private async delete(path: string): Promise<Response> {
+    const cache = await this.getCache();
+    await cache.delete(new Request(this.toFakeUrl(path)));
+    return new Response(null, { status: 204 });
+  }
+
+  private parsePath(resource: FetchParams[0]): string {
+    if (typeof resource === 'string') return resource;
+    if (resource instanceof URL) return resource.pathname;
+    return new URL(resource.url).pathname;
+  }
+
+  /**
+   * Cache API requires full URLs as keys.
+   * Use a synthetic origin so paths are consistent regardless of SW scope.
+   */
+  private toFakeUrl(path: string): string {
+    return `https://emroute-cache${path}`;
+  }
+}

package/runtime/idb.runtime.ts

@@ -0,0 +1,203 @@
+/**
+ * IndexedDB Runtime
+ *
+ * Browser-compatible Runtime backed by IndexedDB.
+ * Stores user content (pages, widgets, manifests) with full CRUD,
+ * directory listing, and persistent storage.
+ *
+ * Schema: single object store, key = path (string), value = Uint8Array.
+ * Content type inferred from file extension via CONTENT_TYPES map.
+ */
+
+import {
+  CONTENT_TYPES,
+  type FetchParams,
+  type FetchReturn,
+  Runtime,
+  type RuntimeConfig,
+} from './abstract.runtime.ts';
+
+const STORE_NAME = 'files';
+
+export class IdbRuntime extends Runtime {
+  private db: IDBDatabase | null = null;
+  private readonly dbName: string;
+
+  constructor(dbName: string, config: RuntimeConfig = {}) {
+    super(config);
+    this.dbName = dbName;
+  }
+
+  private open(): Promise<IDBDatabase> {
+    if (this.db) return Promise.resolve(this.db);
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.open(this.dbName, 1);
+      request.onupgradeneeded = () => {
+        request.result.createObjectStore(STORE_NAME);
+      };
+      request.onsuccess = () => {
+        this.db = request.result;
+        resolve(this.db);
+      };
+      request.onerror = () => reject(request.error);
+    });
+  }
+
+  handle(
+    resource: FetchParams[0],
+    init?: FetchParams[1],
+  ): FetchReturn {
+    const [pathname, method, body] = this.parse(resource, init);
+
+    switch (method) {
+      case 'PUT':
+        return this.write(pathname, body);
+      case 'DELETE':
+        return this.delete(pathname);
+      default:
+        return this.read(pathname);
+    }
+  }
+
+  query(
+    resource: FetchParams[0],
+    options: FetchParams[1] & { as: 'text' },
+  ): Promise<string>;
+  query(
+    resource: FetchParams[0],
+    options?: FetchParams[1],
+  ): FetchReturn;
+  query(
+    resource: FetchParams[0],
+    options?: FetchParams[1] & { as?: 'text' },
+  ): Promise<Response | string> {
+    if (options?.as === 'text') {
+      const pathname = this.parsePath(resource);
+      return this.get(pathname).then((data) => {
+        if (!data) throw new Error(`Not found: ${pathname}`);
+        return new TextDecoder().decode(data);
+      });
+    }
+    return this.handle(resource, options);
+  }
+
+  override async loadModule(path: string): Promise<unknown> {
+    const data = await this.get(path);
+    if (!data) throw new Error(`Module not found in IDB: ${path}`);
+    const buf = data.buffer as ArrayBuffer;
+    const blob = new Blob([buf], { type: 'application/javascript' });
+    const objectUrl = URL.createObjectURL(blob);
+    try {
+      return await import(objectUrl);
+    } finally {
+      URL.revokeObjectURL(objectUrl);
+    }
+  }
+
+  // ── Private ─────────────────────────────────────────────────────────
+
+  private async read(path: string): Promise<Response> {
+    if (path.endsWith('/')) {
+      const children = await this.listChildren(path);
+      if (children.length === 0) return new Response('Not Found', { status: 404 });
+      return Response.json(children);
+    }
+
+    const data = await this.get(path);
+    if (!data) {
+      // Directory-style fallback: check if path has children
+      const children = await this.listChildren(path + '/');
+      if (children.length > 0) return Response.json(children);
+      return new Response('Not Found', { status: 404 });
+    }
+
+    const ext = path.slice(path.lastIndexOf('.')).toLowerCase();
+    return new Response(data.buffer as ArrayBuffer, {
+      status: 200,
+      headers: { 'Content-Type': CONTENT_TYPES.get(ext) ?? 'application/octet-stream' },
+    });
+  }
+
+  private async write(path: string, body: BodyInit | null): Promise<Response> {
+    const data = body
+      ? new Uint8Array(await new Response(body).arrayBuffer())
+      : new Uint8Array();
+    await this.put(path, data);
+    return new Response(null, { status: 204 });
+  }
+
+  private async delete(path: string): Promise<Response> {
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(STORE_NAME, 'readwrite');
+      tx.objectStore(STORE_NAME).delete(path);
+      tx.oncomplete = () => resolve(new Response(null, { status: 204 }));
+      tx.onerror = () => reject(tx.error);
+    });
+  }
+
+  private async get(path: string): Promise<Uint8Array | undefined> {
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(STORE_NAME, 'readonly');
+      const req = tx.objectStore(STORE_NAME).get(path);
+      req.onsuccess = () => resolve(req.result as Uint8Array | undefined);
+      req.onerror = () => reject(req.error);
+    });
+  }
+
+  private async put(path: string, data: Uint8Array): Promise<void> {
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(STORE_NAME, 'readwrite');
+      tx.objectStore(STORE_NAME).put(data, path);
+      tx.oncomplete = () => resolve();
+      tx.onerror = () => reject(tx.error);
+    });
+  }
+
+  private async listChildren(prefix: string): Promise<string[]> {
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(STORE_NAME, 'readonly');
+      const store = tx.objectStore(STORE_NAME);
+      const range = IDBKeyRange.bound(prefix, prefix + '\uffff', false, false);
+      const req = store.getAllKeys(range);
+      req.onsuccess = () => {
+        const entries = new Set<string>();
+        for (const key of req.result as string[]) {
+          const rest = (key as string).slice(prefix.length);
+          const slashIdx = rest.indexOf('/');
+          if (slashIdx === -1) {
+            entries.add(rest);
+          } else {
+            entries.add(rest.slice(0, slashIdx + 1));
+          }
+        }
+        resolve([...entries]);
+      };
+      req.onerror = () => reject(req.error);
+    });
+  }
+
+  private parsePath(resource: FetchParams[0]): string {
+    if (typeof resource === 'string') return resource;
+    if (resource instanceof URL) return resource.pathname;
+    return new URL(resource.url).pathname;
+  }
+
+  private parse(
+    resource: FetchParams[0],
+    init?: RequestInit,
+  ): [string, string, BodyInit | null] {
+    const pathname = this.parsePath(resource);
+    if (typeof resource === 'string' || resource instanceof URL) {
+      return [pathname, init?.method ?? 'GET', init?.body ?? null];
+    }
+    return [
+      pathname,
+      init?.method ?? resource.method,
+      init?.body ?? resource.body,
+    ];
+  }
+}

package/src/element/component.element.ts

@@ -39,7 +39,10 @@ export class ComponentElement<TParams, TData> extends HTMLElementBase {
   /** App-level context provider set once during router initialization. */
   private static extendContext: ContextProvider | undefined;
 
-  /** Register (or clear) the context provider that enriches every widget's ComponentContext. */
+  /**
+   * Register (or clear) the context provider that enriches every widget's ComponentContext.
+   * @deprecated Use `bootEmrouteApp({ extendContext })` instead — it wires both pages and widgets.
+   */
   static setContextProvider(provider: ContextProvider | undefined): void {
     ComponentElement.extendContext = provider;
   }

package/src/index.ts

@@ -59,7 +59,6 @@ export type {
 
 export { PageComponent } from '../core/component/page.component.ts';
 export { WidgetComponent } from '../core/component/widget.component.ts';
-export { WidgetRegistry } from '../core/widget/widget.registry.ts';
 
 // Route config
 export { type BasePath, DEFAULT_BASE_PATH } from '../core/server/emroute.server.ts';