@fairfox/polly 0.40.0 → 0.49.0

package/README.md

@@ -99,7 +99,7 @@ The four primitives above keep state consistent inside a single deployment. But
 **`$peerState`** — every device holds a full [Automerge](https://automerge.org/) CRDT replica. The server holds one too, so cron and HTTP handlers can read and mutate documents. If the server loses its storage, any reconnecting client repopulates it through the normal sync protocol.
 
 ```typescript
-import { createPeerStateClient, configurePeerState, $peerState } from "@fairfox/polly";
+import { createPeerStateClient, configurePeerState, $peerState } from "@fairfox/polly/peer";
 
 const client = createPeerStateClient({ url: "wss://yourapp.com/polly/peer" });
 configurePeerState(client.repo);
@@ -112,7 +112,7 @@ settings.value = { theme: "light" }; // syncs to every peer
 **`$meshState`** — peers exchange operations directly over WebRTC data channels, signed with Ed25519 and encrypted with XSalsa20-Poly1305. No server sees the data. A small stateless signalling server helps peers find each other; removing it does not affect running connections.
 
 ```typescript
-import { configureMeshState, $meshState, MeshNetworkAdapter, MeshWebRTCAdapter } from "@fairfox/polly";
+import { configureMeshState, $meshState, MeshNetworkAdapter, MeshWebRTCAdapter } from "@fairfox/polly/mesh";
 
 const repo = new Repo({ network: [new MeshNetworkAdapter({ base: webrtcAdapter, keyring })] });
 configureMeshState(repo);
@@ -275,22 +275,24 @@ bun install && bun run dev
 | [full-featured](examples/full-featured) | Production Chrome extension with all framework features |
 | [elysia-todo-app](examples/elysia-todo-app) | Full-stack web app with Elysia + Bun, offline-first |
 | [webrtc-p2p-chat](examples/webrtc-p2p-chat) | Peer-to-peer chat over WebRTC data channels |
-| [team-task-manager](examples/team-task-manager) | Collaborative task management with end-to-end encryption |
+| [team-task-manager](examples/team-task-manager) | Role-based collaborative tasks with `$constraints()` and verified urgent-task counts |
 
 ## CLI
 
 ```
-polly init [name]       Scaffold a new project
-polly build [--prod]    Build for development or production
-polly dev               Build with watch mode
-polly check             Run all checks (typecheck, lint, test, build)
-polly typecheck         Type-check your code
-polly lint [--fix]      Lint (and optionally auto-fix)
-polly format            Format your code
-polly test              Run tests
-polly verify            Run formal verification
-polly visualize         Generate architecture diagrams (Structurizr DSL)
-polly quality           Run conformance checks (no-as-casting)
+polly init [name] [--type=TYPE]   Scaffold a new project (extension | pwa | websocket | generic)
+polly build [--prod]              Build for development or production
+polly dev                         Build with watch mode
+polly check                       Run all checks (typecheck, lint, test, build)
+polly typecheck                   Type-check your code
+polly lint [--fix]                Lint (and optionally auto-fix)
+polly format                      Format your code
+polly test [args]                 Run unit tests (bun test)
+polly test:browser [dir]          Run *.browser.{ts,tsx} in Puppeteer
+polly verify                      Run formal verification (TLA+/TLC)
+polly visualize                   Generate architecture diagrams (Structurizr DSL)
+polly quality [args]              Run conformance checks (no-as-casting, boundaries, secrets,
+                                  server-imports, forbidden-deps, banners, marketing, ...)
 ```
 
 ## Quality tooling

package/dist/src/background/index.d.ts

@@ -36,4 +36,5 @@ import type { BaseMessage, ExtensionMessage } from "../shared/types/messages";
  */
 export declare function createBackground<TMessage extends BaseMessage = ExtensionMessage>(adapters?: ExtensionAdapters): MessageBus<TMessage>;
 export { getMessageBus } from "../shared/lib/message-bus";
+export { LogStore, type LogStoreOptions } from "./log-store";
 export { MessageRouter } from "./message-router";

package/dist/src/background/index.js

@@ -1826,6 +1826,68 @@ class MessageRouter {
     MessageRouter.instanceExists = false;
   }
 }
+// src/background/log-store.ts
+class LogStore {
+  bus;
+  logs = [];
+  maxLogs;
+  constructor(bus, options) {
+    this.bus = bus || getMessageBus("background");
+    this.maxLogs = options?.maxLogs || 1000;
+    this.setupHandlers();
+  }
+  setupHandlers() {
+    this.bus.on("LOG", async (payload) => {
+      const entry = {
+        id: crypto.randomUUID(),
+        level: payload.level,
+        message: payload.message,
+        ...payload.context && { context: payload.context },
+        ...payload.error && { error: payload.error },
+        ...payload.stack && { stack: payload.stack },
+        source: payload.source,
+        timestamp: payload.timestamp
+      };
+      this.logs.push(entry);
+      if (this.logs.length > this.maxLogs) {
+        this.logs.shift();
+      }
+      return { success: true };
+    });
+    this.bus.on("LOGS_GET", async (payload) => {
+      let filtered = this.logs;
+      if (payload.filters?.level) {
+        filtered = filtered.filter((log) => log.level === payload.filters?.level);
+      }
+      if (payload.filters?.source) {
+        filtered = filtered.filter((log) => log.source === payload.filters?.source);
+      }
+      if (payload.filters?.since !== undefined) {
+        const since = payload.filters.since;
+        filtered = filtered.filter((log) => log.timestamp >= since);
+      }
+      if (payload.filters?.limit) {
+        filtered = filtered.slice(-payload.filters.limit);
+      }
+      return { logs: filtered };
+    });
+    this.bus.on("LOGS_CLEAR", async () => {
+      const count = this.logs.length;
+      this.logs = [];
+      return { success: true, count };
+    });
+    this.bus.on("LOGS_EXPORT", async () => {
+      const json = JSON.stringify(this.logs, null, 2);
+      return { json, count: this.logs.length };
+    });
+  }
+  getCount() {
+    return this.logs.length;
+  }
+  getAllLogs() {
+    return [...this.logs];
+  }
+}
 
 // src/background/index.ts
 function createBackground(adapters) {
@@ -1836,7 +1898,8 @@ function createBackground(adapters) {
 export {
   getMessageBus,
   createBackground,
-  MessageRouter
+  MessageRouter,
+  LogStore
 };
 
-//# debugId=B8B01C48D6E4EE6364756E2164756E21
+//# debugId=4914221959EE755064756E2164756E21