@hozu/runtime-server 0.11.0 → 0.13.0

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,KAAK,WAAW,EAAgB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC5F,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,YAAY,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,QAAA,MAAM,GAAG,eAAyB,CAAA;AAElC,MAAM,WAAW,UACf,SAAQ,IAAI,CACV,cAAc,EACd,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAC1F;IACD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,UAAU,CAAA;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1B,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACnC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAChD,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,eAAO,MAAM,GAAG,YAAa,UAAU,KAAG,GAAwC,CAAA;AAElF,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,UAAU,GAAG,IACkC,CAAA;AAE7F,eAAO,MAAM,YAAY,MAAO,GAAG,KAAG,OAAkD,CAAA;AAExF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,GAAE,OAAY,GAAG,cAAc,CAO5E"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAe,KAAK,WAAW,EAAgB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AACzG,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,YAAY,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,QAAA,MAAM,GAAG,eAAyB,CAAA;AAElC,MAAM,WAAW,UACf,SAAQ,IAAI,CACV,cAAc,EACd,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAC1F;IACD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,UAAU,CAAA;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1B,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACnC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAChD,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,eAAO,MAAM,GAAG,YAAa,UAAU,KAAG,GAAwC,CAAA;AAElF,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,UAAU,GAAG,IACkC,CAAA;AAE7F,eAAO,MAAM,YAAY,MAAO,GAAG,KAAG,OAAkD,CAAA;AAExF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,GAAE,OAAY,GAAG,cAAc,CAQ5E"}

package/dist/app.js

@@ -1,4 +1,4 @@
-import { buildProject } from '@hozu/core/ir';
+import { appModuleOf, buildProject } from '@hozu/core/ir';
 import { resolverSetOf } from '@hozu/data';
 const APP = Symbol.for('hozu.app');
 export const app = (options) => Object.freeze({ [APP]: options });
@@ -10,6 +10,7 @@ export function appHandlerOptions(a, host = {}) {
         sources: host.dev !== undefined,
         ...(host.manifest ? { manifest: host.manifest } : {}),
     });
-    return { ...options, ...host, build };
+    const dev = host.dev ? { dev: { ...host.dev, app: host.dev.app ?? appModuleOf(projectOfApp(a)) } } : {};
+    return { ...options, ...host, ...dev, build };
 }
 //# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,YAAY,EAAgC,MAAM,eAAe,CAAA;AAC5F,OAAO,EAAoB,aAAa,EAAE,MAAM,YAAY,CAAA;AAM5D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;AA2BlC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,OAAmB,EAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;AAElF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAqB,EAAE,CAChE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,KAAsB,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAE7F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAM,EAAW,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAA;AAExF,MAAM,UAAU,iBAAiB,CAAC,CAAM,EAAE,IAAI,GAAY,EAAE;IAC1D,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;IAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;QAC1C,OAAO,EAAE,IAAI,CAAC,GAAG,KAAK,SAAS;QAC/B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAA;IACF,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAA;AACvC,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAoB,YAAY,EAAgC,MAAM,eAAe,CAAA;AACzG,OAAO,EAAoB,aAAa,EAAE,MAAM,YAAY,CAAA;AAM5D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;AA2BlC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,OAAmB,EAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;AAElF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAqB,EAAE,CAChE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,KAAsB,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAE7F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAM,EAAW,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAA;AAExF,MAAM,UAAU,iBAAiB,CAAC,CAAM,EAAE,IAAI,GAAY,EAAE;IAC1D,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;IAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;QAC1C,OAAO,EAAE,IAAI,CAAC,GAAG,KAAK,SAAS;QAC/B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAA;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACvG,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,CAAA;AAC/C,CAAC"}

package/dist/bus.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Carries invalidated tags between the instances of one app (ADR 0050 B). Tags, never data: an instance that
+ * receives tags drops its own pages and entries and pushes to its own live clients. Delivery is at least once and
+ * unordered; dropping a tag twice is harmless.
+ */
+export interface InvalidationBus {
+    publish(tags: string[]): void | Promise<void>;
+    subscribe(onTags: (tags: string[]) => void): () => void;
+    /** For a transport that receives over the app's own HTTP: answers `POST /_hozu/invalidate`. */
+    accept?(request: Request): Promise<Response>;
+}
+/** One process: nothing to tell. */
+export declare function localBus(): InvalidationBus;
+export interface HttpBusOptions {
+    /** The base URL of every instance, including this one and the app's base path: `http://10.0.0.2:3000`. */
+    peers: string[];
+    /** Shared by every instance; at least 32 characters. */
+    secret: string;
+    /** Reports a peer that stayed unreachable after the retries. */
+    onError?: (error: unknown, peer: string) => void;
+    /** Delays between attempts, in milliseconds. */
+    retries?: number[];
+    fetch?: typeof fetch;
+    now?: () => number;
+}
+/**
+ * Signed `POST /_hozu/invalidate` to every peer (HMAC-SHA256 over the body, which carries a timestamp; messages
+ * older than 30 s or from the future are refused). Zero dependencies: Web Crypto and `fetch`.
+ */
+export declare function httpBus({ peers, secret, onError, retries, fetch: send, now, }: HttpBusOptions): InvalidationBus;
+//# sourceMappingURL=bus.d.ts.map

package/dist/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACvD,+FAA+F;IAC/F,MAAM,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC7C;AAED,oCAAoC;AACpC,wBAAgB,QAAQ,IAAI,eAAe,CAE1C;AAED,MAAM,WAAW,cAAc;IAC7B,0GAA0G;IAC1G,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAQD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,MAAM,EACN,OAAiF,EACjF,OAAsB,EACtB,KAAK,EAAE,IAAY,EACnB,GAAc,GACf,EAAE,cAAc,GAAG,eAAe,CA2DlC"}

package/dist/bus.js

@@ -0,0 +1,73 @@
+/** One process: nothing to tell. */
+export function localBus() {
+    return { publish: () => { }, subscribe: () => () => { } };
+}
+const WINDOW_MS = 30_000;
+const encoder = new TextEncoder();
+const hex = (bytes) => [...new Uint8Array(bytes)].map((b) => b.toString(16).padStart(2, '0')).join('');
+/**
+ * Signed `POST /_hozu/invalidate` to every peer (HMAC-SHA256 over the body, which carries a timestamp; messages
+ * older than 30 s or from the future are refused). Zero dependencies: Web Crypto and `fetch`.
+ */
+export function httpBus({ peers, secret, onError = (error, peer) => console.error('[hozu] invalidation bus:', peer, error), retries = [100, 1_000], fetch: send = fetch, now = Date.now, }) {
+    if (secret.length < 32)
+        throw new Error('httpBus needs a secret of at least 32 characters');
+    const id = crypto.randomUUID();
+    const key = crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign', 'verify']);
+    const sign = async (body) => hex(await crypto.subtle.sign('HMAC', await key, encoder.encode(body)));
+    const listeners = new Set();
+    const wait = (ms) => new Promise((r) => setTimeout(r, ms));
+    async function deliver(peer, body, signature) {
+        const url = `${peer.replace(/\/$/, '')}/_hozu/invalidate`;
+        for (let attempt = 0;; attempt++) {
+            try {
+                const response = await send(url, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json', 'x-hozu-signature': signature },
+                    body,
+                });
+                if (response.ok)
+                    return;
+                throw new Error(`${url} answered ${response.status}`);
+            }
+            catch (error) {
+                const delay = retries[attempt];
+                if (delay === undefined)
+                    return onError(error, peer);
+                await wait(delay);
+            }
+        }
+    }
+    return {
+        async publish(tags) {
+            if (!tags.length)
+                return;
+            const body = JSON.stringify({ tags, at: now(), from: id });
+            const signature = await sign(body);
+            await Promise.all(peers.map((peer) => deliver(peer, body, signature)));
+        },
+        subscribe(onTags) {
+            listeners.add(onTags);
+            return () => listeners.delete(onTags);
+        },
+        async accept(request) {
+            if (request.method !== 'POST')
+                return new Response(null, { status: 405, headers: { allow: 'POST' } });
+            const body = await request.text();
+            const signature = request.headers.get('x-hozu-signature') ?? '';
+            const given = new Uint8Array(signature.match(/../g)?.map((b) => Number.parseInt(b, 16)) ?? []);
+            const valid = /^[0-9a-f]{64}$/.test(signature) &&
+                (await crypto.subtle.verify('HMAC', await key, given, encoder.encode(body)));
+            if (!valid)
+                return new Response('Invalid signature', { status: 403 });
+            const message = JSON.parse(body);
+            if (Math.abs(now() - message.at) > WINDOW_MS)
+                return new Response('Expired message', { status: 403 });
+            if (message.from !== id)
+                for (const listener of listeners)
+                    listener(message.tags);
+            return new Response(null, { status: 204 });
+        },
+    };
+}
+//# sourceMappingURL=bus.js.map

package/dist/bus.js.map

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

package/dist/cache.d.ts

@@ -10,6 +10,12 @@ export interface PageCache {
     get(key: string): Promise<CachedPage | undefined>;
     set(key: string, page: CachedPage): Promise<void>;
     deleteTags(tags: string[]): Promise<number>;
+    /** Pages now cached and pages dropped to stay within a bound, for `server.stats()`; optional. */
+    readonly size?: number;
+    readonly evictions?: number;
 }
-export declare function memoryCache(): PageCache;
+/** The default page cache: at most `maxPages` pages, least recently used first out (ADR 0050 D1). */
+export declare function memoryCache({ maxPages }?: {
+    maxPages?: number;
+}): PageCache;
 //# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC5C;AAED,wBAAgB,WAAW,IAAI,SAAS,CAiBvC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,iGAAiG;IACjG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,EAAE,QAAgB,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CAavF"}

package/dist/cache.js

@@ -1,18 +1,16 @@
-export function memoryCache() {
-    const pages = new Map();
+import { Lru } from '@hozu/data';
+/** The default page cache: at most `maxPages` pages, least recently used first out (ADR 0050 D1). */
+export function memoryCache({ maxPages = 5_000 } = {}) {
+    const pages = new Lru(maxPages);
     return {
         get: async (key) => pages.get(key),
-        set: async (key, page) => {
-            pages.set(key, page);
+        set: async (key, page) => pages.set(key, page, page.tags),
+        deleteTags: async (tags) => pages.deleteTags(tags),
+        get size() {
+            return pages.size;
         },
-        deleteTags: async (tags) => {
-            let count = 0;
-            for (const [key, page] of pages)
-                if (tags.some((t) => page.tags.includes(t))) {
-                    pages.delete(key);
-                    count++;
-                }
-            return count;
+        get evictions() {
+            return pages.evictions;
         },
     };
 }

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;IAC3C,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAClC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACvB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACtB,CAAC;QACD,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACzB,IAAI,KAAK,GAAG,CAAC,CAAA;YACb,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK;gBAC7B,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5C,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBACjB,KAAK,EAAE,CAAA;gBACT,CAAC;YACH,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAoBhC,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,GAA0B,EAAE;IAC1E,MAAM,KAAK,GAAG,IAAI,GAAG,CAAa,QAAQ,CAAC,CAAA;IAC3C,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAClC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QACzD,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAClD,IAAI,IAAI;YACN,OAAO,KAAK,CAAC,IAAI,CAAA;QACnB,CAAC;QACD,IAAI,SAAS;YACX,OAAO,KAAK,CAAC,SAAS,CAAA;QACxB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/dev-effects.d.ts

@@ -0,0 +1,14 @@
+import type { DevEffect, DevOptions, ProjectIR } from '@hozu/core/ir';
+/** Fills in where each effect is implemented: its `implement(...)` in the app module, or its `fetch.ts` export. */
+export declare function implementedAt(effects: DevEffect[] | null, dev: DevOptions, fetches: Record<string, string>, readFile: ((file: string) => Promise<Uint8Array>) | undefined): Promise<DevEffect[] | null>;
+/** An endpoint for the DevTools API drawer: its declared method, path and input. */
+export interface DevEndpoint {
+    ref: string;
+    method: 'GET' | 'POST';
+    path: string;
+    input: unknown;
+    raw: boolean;
+    mode: string;
+}
+export declare function projectEndpoints(ir: ProjectIR): DevEndpoint[];
+//# sourceMappingURL=dev-effects.d.ts.map

package/dist/dev-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-effects.d.ts","sourceRoot":"","sources":["../src/dev-effects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAIrE,mHAAmH;AACnH,wBAAsB,aAAa,CACjC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAC3B,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,SAAS,GAC5D,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CA6B7B;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,WAAW,EAAE,CAW7D"}

package/dist/dev-effects.js

@@ -0,0 +1,41 @@
+const literal = (s) => s.replace(/[$]/g, '\\$&');
+/** Fills in where each effect is implemented: its `implement(...)` in the app module, or its `fetch.ts` export. */
+export async function implementedAt(effects, dev, fetches, readFile) {
+    if (!effects || !readFile)
+        return effects;
+    const texts = new Map();
+    const lines = (file) => {
+        let text = texts.get(file);
+        if (!text) {
+            text = readFile(file)
+                .then((bytes) => new TextDecoder().decode(bytes).split('\n'))
+                .catch(() => null);
+            texts.set(file, text);
+        }
+        return text;
+    };
+    const relative = (file) => file.startsWith(`${dev.root}/`) ? file.slice(dev.root.length + 1) : file;
+    return Promise.all(effects.map(async (e) => {
+        const dot = e.ref.indexOf('.');
+        const sym = literal(e.ref.slice(dot + 1));
+        const file = e.runs === 'server' ? dev.app : fetches[e.ref.slice(0, dot)];
+        if (!file)
+            return e;
+        const pattern = e.runs === 'server'
+            ? new RegExp(`implement\\(\\s*(?:[\\w$]+\\.)?${sym}\\b`)
+            : new RegExp(`export const ${sym}\\b`);
+        const at = (await lines(file))?.findIndex((l) => pattern.test(l)) ?? -1;
+        return at < 0 ? e : { ...e, implemented: { file: relative(file), line: at + 1, column: 1 } };
+    }));
+}
+export function projectEndpoints(ir) {
+    return Object.values(ir.features).flatMap((f) => Object.entries(f.endpoints).map(([sym, e]) => ({
+        ref: `${f.id}.${sym}`,
+        method: e.method,
+        path: ir.http.basePath + e.path,
+        input: e.raw ? null : (f.schemas[e.input] ?? null),
+        raw: e.raw === true,
+        mode: e.mode,
+    })));
+}
+//# sourceMappingURL=dev-effects.js.map

package/dist/dev-effects.js.map

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

package/dist/dev-trace.d.ts

@@ -0,0 +1,21 @@
+/** An outgoing request made while developing (ADR 0050 G): what an effect really sent and got back. */
+export interface TraceEntry {
+    id: number;
+    method: string;
+    url: string;
+    requestHeaders: [string, string][];
+    requestBody: string | null;
+    status: number | null;
+    responseHeaders: [string, string][];
+    responseBody: string | null;
+    ms: number;
+    error: string | null;
+}
+/** Wraps `fetch` once, in development only, keeping the last 200 outgoing requests. */
+export declare function traceFetch(): void;
+/** The requests after `after` (an id), and the last id so far. */
+export declare const traced: (after: number) => {
+    last: number;
+    entries: TraceEntry[];
+};
+//# sourceMappingURL=dev-trace.d.ts.map

package/dist/dev-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-trace.d.ts","sourceRoot":"","sources":["../src/dev-trace.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAaD,uFAAuF;AACvF,wBAAgB,UAAU,SA+CzB;AA0BD,kEAAkE;AAClE,eAAO,MAAM,MAAM,UAAW,MAAM;IAAQ,IAAI;IAAY,OAAO;CAAwC,CAAA"}

package/dist/dev-trace.js

@@ -0,0 +1,86 @@
+const LIMIT = 200;
+const BODY = 8_000;
+const entries = [];
+let next = 1;
+let installed = false;
+const cut = (text) => text === null ? null : text.length > BODY ? `${text.slice(0, BODY)}… (${text.length} characters)` : text;
+const textual = (type) => !type || /json|text|xml|urlencoded|javascript/.test(type);
+/** Wraps `fetch` once, in development only, keeping the last 200 outgoing requests. */
+export function traceFetch() {
+    if (installed)
+        return;
+    installed = true;
+    const original = globalThis.fetch;
+    globalThis.fetch = async (input, init) => {
+        const request = new Request(input, init);
+        const entry = {
+            id: next++,
+            method: request.method,
+            url: request.url,
+            requestHeaders: [...request.headers],
+            requestBody: request.body
+                ? cut(await request
+                    .clone()
+                    .text()
+                    .catch(() => null))
+                : null,
+            status: null,
+            responseHeaders: [],
+            responseBody: null,
+            ms: 0,
+            error: null,
+        };
+        const started = performance.now();
+        const done = () => {
+            entry.ms = Math.round(performance.now() - started);
+            entries.push(entry);
+            if (entries.length > LIMIT)
+                entries.shift();
+        };
+        let response;
+        try {
+            response = await original(request);
+        }
+        catch (error) {
+            entry.error = error instanceof Error ? error.message : String(error);
+            done();
+            throw error;
+        }
+        entry.status = response.status;
+        entry.responseHeaders = [...response.headers];
+        done();
+        void capture(response.clone()).then((body) => {
+            entry.responseBody = body;
+        });
+        return response;
+    };
+}
+/** At most BODY characters of a textual body, read beside the caller; a stream is never waited for. */
+async function capture(response) {
+    const type = response.headers.get('content-type');
+    if (!textual(type) || /event-stream/.test(type ?? '')) {
+        void response.body?.cancel().catch(() => { });
+        return `(${type ?? 'body'})`;
+    }
+    const reader = response.body?.getReader();
+    if (!reader)
+        return null;
+    const decoder = new TextDecoder();
+    let text = '';
+    try {
+        while (text.length <= BODY) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            text += decoder.decode(value, { stream: true });
+        }
+    }
+    catch {
+        return cut(text) || null;
+    }
+    void reader.cancel().catch(() => { });
+    return cut(text);
+}
+/** The requests after `after` (an id), and the last id so far. */
+export const traced = (after) => ({ last: next - 1, entries: entries.filter((e) => e.id > after) });
+//# sourceMappingURL=dev-trace.js.map

package/dist/dev-trace.js.map

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

package/dist/fn-modules.d.ts

@@ -0,0 +1,22 @@
+import { type BuildResult, type ProjectIR } from '@hozu/core/ir';
+/** One browser module of `fn` implementations (ADR 0050 C). */
+export interface FnModule {
+    path: string;
+    source: string;
+}
+/**
+ * Framework builtins (`%…` operators, `#…` formats and messages, which server lowering may add to an island) share
+ * one module that every island page loads; a feature's `fn`s go in its own.
+ */
+export declare const moduleOfFn: (ref: string) => string;
+/** Every `fn` reference in an IR value: `{ fn, arg }` values and `{ op: 'fn', fn, arg }` guards. */
+export declare function fnRefs(value: unknown, out?: Set<string>): Set<string>;
+/** The `fn`s the browser can call: those in machines and in views bound to a machine. */
+export declare function clientFns(ir: ProjectIR): Set<string>;
+/** The routes and endpoints an island can reach: `ui.link(route | endpoint, …)` values in nodes and machines (ADR 0050 E). */
+export declare function linkTargets(value: unknown, out?: Set<string>): Set<string>;
+/** The fn modules a page's islands can call: its machine-bound views and their machines, plus builtins. */
+export declare function modulesOfPage(ir: ProjectIR, views: string[], available: Record<string, string>): string[];
+/** The browser `fn` modules of a build, by module name, at content-hashed paths under `/_hozu/f/`. */
+export declare function fnModules(build: BuildResult): Record<string, FnModule>;
+//# sourceMappingURL=fn-modules.d.ts.map

package/dist/fn-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn-modules.d.ts","sourceRoot":"","sources":["../src/fn-modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAY,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAE1E,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAS,MAAM,WAAkE,CAAA;AAExG,oGAAoG;AACpG,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,cAAoB,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ3E;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CASpD;AAED,8HAA8H;AAC9H,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,cAAoB,GAAG,GAAG,CAAC,MAAM,CAAC,CAShF;AAID,2GAA2G;AAC3G,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAqBzG;AA2BD,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CActE"}

package/dist/fn-modules.js

@@ -0,0 +1,127 @@
+import { hashJson } from '@hozu/core/ir';
+/**
+ * Framework builtins (`%…` operators, `#…` formats and messages, which server lowering may add to an island) share
+ * one module that every island page loads; a feature's `fn`s go in its own.
+ */
+export const moduleOfFn = (ref) => (/^[%#]/.test(ref) ? 'hozu' : ref.slice(0, ref.indexOf('.')));
+/** Every `fn` reference in an IR value: `{ fn, arg }` values and `{ op: 'fn', fn, arg }` guards. */
+export function fnRefs(value, out = new Set()) {
+    if (Array.isArray(value))
+        for (const v of value)
+            fnRefs(v, out);
+    else if (value && typeof value === 'object') {
+        const o = value;
+        if (typeof o.fn === 'string' && 'arg' in o)
+            out.add(o.fn);
+        for (const v of Object.values(o))
+            fnRefs(v, out);
+    }
+    return out;
+}
+/** The `fn`s the browser can call: those in machines and in views bound to a machine. */
+export function clientFns(ir) {
+    const out = new Set();
+    for (const f of Object.values(ir.features)) {
+        if (f.machine)
+            fnRefs(f.machine, out);
+        for (const view of Object.values(f.views))
+            if (view.machine)
+                fnRefs(view.root, out);
+        for (const q of Object.values(f.queries))
+            if (q.runs !== 'server')
+                fnRefs(q.tags, out);
+        for (const m of Object.values(f.mutations))
+            if (m.runs !== 'server')
+                fnRefs(m.invalidates, out);
+    }
+    return out;
+}
+/** The routes and endpoints an island can reach: `ui.link(route | endpoint, …)` values in nodes and machines (ADR 0050 E). */
+export function linkTargets(value, out = new Set()) {
+    if (Array.isArray(value))
+        for (const v of value)
+            linkTargets(v, out);
+    else if (value && typeof value === 'object') {
+        const o = value;
+        if (typeof o.link === 'string' && 'params' in o)
+            out.add(o.link);
+        if (typeof o.endpoint === 'string' && 'input' in o)
+            out.add(o.endpoint);
+        for (const v of Object.values(o))
+            linkTargets(v, out);
+    }
+    return out;
+}
+const routeModules = new WeakMap();
+/** The fn modules a page's islands can call: its machine-bound views and their machines, plus builtins. */
+export function modulesOfPage(ir, views, available) {
+    const memo = routeModules.get(ir) ?? new Map();
+    routeModules.set(ir, memo);
+    const key = views.join(' ');
+    let names = memo.get(key);
+    if (!names) {
+        const refs = new Set();
+        for (const ref of views) {
+            const dot = ref.indexOf('.');
+            const feature = ir.features[ref.slice(0, dot)];
+            const view = feature?.views[ref.slice(dot + 1)];
+            if (!feature || !view?.machine)
+                continue;
+            fnRefs(view.root, refs);
+            fnRefs(ir.features[view.machine]?.machine ?? null, refs);
+            for (const q of Object.values(feature.queries))
+                if (q.runs !== 'server')
+                    fnRefs(q.tags, refs);
+            for (const m of Object.values(feature.mutations))
+                if (m.runs !== 'server')
+                    fnRefs(m.invalidates, refs);
+        }
+        names = [...new Set(['hozu', ...[...refs].map(moduleOfFn)])].sort();
+        memo.set(key, names);
+    }
+    return names.flatMap((n) => (available[n] ? [available[n]] : []));
+}
+const expressionOf = (impl) => {
+    const source = String(impl);
+    return /^(async\s+)?(function\b|\(|[A-Za-z_$][\w$]*\s*=>)/.test(source) ? source : `function ${source}`;
+};
+function moduleSource(build, refs) {
+    const helpers = new Map();
+    const clashing = new Set();
+    for (const ref of refs)
+        for (const [name, src] of Object.entries(build.bindings.fnHelpers[ref] ?? {})) {
+            const seen = helpers.get(name);
+            if (seen === undefined)
+                helpers.set(name, src);
+            else if (seen !== src)
+                clashing.add(name);
+        }
+    const shared = [...helpers].filter(([name]) => !clashing.has(name));
+    const entries = refs.map((ref) => {
+        const own = Object.entries(build.bindings.fnHelpers[ref] ?? {}).filter(([name]) => clashing.has(name));
+        const expression = expressionOf(build.bindings.fns[ref]);
+        if (!own.length)
+            return `  ${JSON.stringify(ref)}: ${expression},`;
+        const locals = own.map(([name, src]) => `const ${name} = ${src};`).join(' ');
+        return `  ${JSON.stringify(ref)}: (() => { ${locals} return ${expression} })(),`;
+    });
+    return `${shared.map(([name, src]) => `const ${name} = ${src};\n`).join('')}export const fns = {\n${entries.join('\n')}\n}\n`;
+}
+/** The browser `fn` modules of a build, by module name, at content-hashed paths under `/_hozu/f/`. */
+export function fnModules(build) {
+    const groups = new Map();
+    const builtins = Object.keys(build.bindings.fns).filter((ref) => moduleOfFn(ref) === 'hozu');
+    for (const ref of [...new Set([...clientFns(build.ir), ...builtins])].sort()) {
+        if (!(ref in build.bindings.fns))
+            continue;
+        const name = moduleOfFn(ref);
+        groups.set(name, [...(groups.get(name) ?? []), ref]);
+    }
+    const out = {};
+    for (const [name, refs] of groups) {
+        const source = moduleSource(build, refs);
+        out[name] = { path: `/_hozu/f/${name}-${hashJson(source).slice(0, 10)}.js`, source };
+    }
+    return out;
+}
+//# sourceMappingURL=fn-modules.js.map

package/dist/fn-modules.js.map

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

package/dist/handler.d.ts

@@ -1,7 +1,8 @@
 import type { TagUse } from '@hozu/core';
 import { type BuildResult, type DevOptions, type ImageSet, type Manifest } from '@hozu/core/ir';
-import { type FetchLoader, type OnError, type ResolverSet } from '@hozu/data';
+import { type DataCache, type FetchLoader, type OnError, type ResolverSet } from '@hozu/data';
 import { type App, type AppHost } from './app.ts';
+import { type InvalidationBus } from './bus.ts';
 import { type PageCache } from './cache.ts';
 import { type ComponentBundle, type Stylesheet } from './render.ts';
 import { type RenderModule } from './rendered.ts';
@@ -17,6 +18,12 @@ export interface HandlerOptions {
     onError?: OnError;
     csp?: CspSources | false;
     cache?: PageCache;
+    /** Public query results (ADR 0050 A); by default `memoryDataCache()`. */
+    dataCache?: DataCache;
+    /** Tells the other instances which tags were invalidated (ADR 0050 B); by default `localBus()`. */
+    bus?: InvalidationBus;
+    /** Seconds after which `'static'` public data and pages are read again, as a safety net when bus messages can be lost; off by default. */
+    staticTtl?: number;
     readFile?: (file: string) => Promise<Uint8Array>;
     manifest?: Manifest;
     images?: ImageSet | null;
@@ -40,6 +47,16 @@ export interface OgCard {
 export interface Handler {
     fetch(request: Request): Promise<Response>;
     revalidate(tags: TagUse[]): Promise<Revalidated>;
+    /** Cache sizes and evictions, for monitoring (ADR 0050 A). */
+    stats(): ServerStats;
+}
+export interface ServerStats {
+    dataEntries: number;
+    pages: number | null;
+    evictions: {
+        data: number;
+        pages: number | null;
+    };
 }
 export interface Revalidated {
     entries: number;

package/dist/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EACL,KAAK,WAAW,EAGhB,KAAK,UAAU,EAOf,KAAK,QAAQ,EAGb,KAAK,QAAQ,EAOd,MAAM,eAAe,CAAA;AACtB,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,OAAO,EAEZ,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,OAAO,EAAmC,MAAM,UAAU,CAAA;AAElF,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAMzE,OAAO,EACL,KAAK,eAAe,EAMpB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAG9D,OAAO,EAAE,KAAK,UAAU,EAAgE,MAAM,eAAe,CAAA;AAC7G,OAAO,EAAkB,KAAK,YAAY,EAAgB,MAAM,cAAc,CAAA;AAG9E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAA;IAClB,SAAS,EAAE,WAAW,CAAA;IACtB,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,YAAY,CAAA;IACxD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1B,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,UAAU,GAAG,KAAK,CAAA;IACxB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAChD,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IAC9C,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAA;IACnD,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,oHAAoH;IACpH,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAwBD,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,MACiE,CAAA;AAgC5G,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAA;AAC/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"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"}