@fairfox/polly 0.1.0

package/dist/shared/types/messages.js

@@ -0,0 +1,25 @@
+// src/shared/types/messages.ts
+var ALL_CONTEXTS = [
+  "background",
+  "content",
+  "page",
+  "devtools",
+  "popup",
+  "options",
+  "sidepanel",
+  "offscreen"
+];
+var defaultSettings = {
+  theme: "auto",
+  autoSync: true,
+  debugMode: false,
+  notifications: true,
+  apiEndpoint: "https://api.example.com",
+  refreshInterval: 60000
+};
+export {
+  defaultSettings,
+  ALL_CONTEXTS
+};
+
+//# debugId=CD4C96B7C2FB31BC64756E2164756E21

package/dist/shared/types/messages.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/shared/types/messages.ts"],
+  "sourcesContent": [
+    "// Type definitions for all messages in the extension\n\n/**\n * Base message interface that all messages must satisfy.\n * This allows users to define custom messages alongside framework messages.\n */\nexport interface BaseMessage {\n  type: string;\n}\n\nexport type Context =\n  | \"background\"\n  | \"content\"\n  | \"page\"\n  | \"devtools\"\n  | \"popup\"\n  | \"options\"\n  | \"sidepanel\"\n  | \"offscreen\";\n\n// All contexts (useful for broadcast)\nexport const ALL_CONTEXTS: Context[] = [\n  \"background\",\n  \"content\",\n  \"page\",\n  \"devtools\",\n  \"popup\",\n  \"options\",\n  \"sidepanel\",\n  \"offscreen\",\n] as const;\n\n// Settings schema\nexport type Settings = {\n  theme: \"light\" | \"dark\" | \"auto\";\n  autoSync: boolean;\n  debugMode: boolean;\n  notifications: boolean;\n  apiEndpoint: string;\n  refreshInterval: number;\n};\n\nexport const defaultSettings: Settings = {\n  theme: \"auto\",\n  autoSync: true,\n  debugMode: false,\n  notifications: true,\n  apiEndpoint: \"https://api.example.com\",\n  refreshInterval: 60000,\n};\n\n// Logging types\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport type LogEntry = {\n  id: string;\n  level: LogLevel;\n  message: string;\n  context?: Record<string, unknown>;\n  error?: string;\n  stack?: string;\n  source: Context;\n  timestamp: number;\n};\n\n// All possible messages (discriminated union)\nexport type ExtensionMessage =\n  // DOM Operations (handled by Content Script)\n  | { type: \"DOM_QUERY\"; selector: string }\n  | { type: \"DOM_UPDATE\"; selector: string; content: string }\n  | {\n      type: \"DOM_INSERT\";\n      position: \"beforebegin\" | \"afterbegin\" | \"beforeend\" | \"afterend\";\n      html: string;\n    }\n  | { type: \"DOM_REMOVE\"; selector: string }\n\n  // Page Script Operations (handled by Page Script)\n  | { type: \"PAGE_EVAL\"; code: string }\n  | { type: \"PAGE_GET_VAR\"; varName: string }\n  | { type: \"PAGE_CALL_FN\"; fnName: string; args: unknown[] }\n  | { type: \"PAGE_SET_VAR\"; varName: string; value: unknown }\n\n  // API Operations (handled by Background)\n  | {\n      type: \"API_REQUEST\";\n      endpoint: string;\n      method: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n      body?: unknown;\n      headers?: Record<string, string>;\n    }\n  | {\n      type: \"API_BATCH\";\n      requests: Array<{ endpoint: string; method: string; body?: unknown }>;\n    }\n\n  // Clipboard Operations (handled by Offscreen)\n  | { type: \"CLIPBOARD_WRITE\"; text: string }\n  | { type: \"CLIPBOARD_WRITE_HTML\"; html: string }\n  | { type: \"CLIPBOARD_WRITE_RICH\"; data: { text: string; html: string } }\n  | { type: \"CLIPBOARD_READ\" }\n\n  // Context Menu (handled by Background)\n  | {\n      type: \"CONTEXT_MENU_CLICKED\";\n      menuId: string;\n      info: chrome.contextMenus.OnClickData;\n      tabId: number;\n    }\n  | {\n      type: \"CONTEXT_MENU_CREATE\";\n      id: string;\n      title: string;\n      contexts: chrome.contextMenus.ContextType[];\n    }\n  | { type: \"CONTEXT_MENU_REMOVE\"; id: string }\n\n  // State Sync (broadcast) - Internal only, handled by state primitives\n  | {\n      type: \"STATE_SYNC\";\n      key: string;\n      value: unknown;\n      clock: number;\n    }\n\n  // Tab Operations (handled by Background)\n  | { type: \"TAB_QUERY\"; queryInfo: chrome.tabs.QueryInfo }\n  | { type: \"TAB_GET_CURRENT\" }\n  | { type: \"TAB_RELOAD\"; tabId: number }\n\n  // DevTools Operations\n  | { type: \"DEVTOOLS_INSPECT_ELEMENT\"; selector: string }\n  | {\n      type: \"DEVTOOLS_LOG\";\n      level: \"log\" | \"warn\" | \"error\";\n      message: string;\n      data?: unknown;\n    }\n\n  // Logging (handled by Background LogStore)\n  | {\n      type: \"LOG\";\n      level: LogLevel;\n      message: string;\n      context?: Record<string, unknown>;\n      error?: string;\n      stack?: string;\n      source: Context;\n      timestamp: number;\n    }\n  | {\n      type: \"LOGS_GET\";\n      filters?: {\n        level?: LogLevel;\n        source?: Context;\n        since?: number;\n        limit?: number;\n      };\n    }\n  | { type: \"LOGS_CLEAR\" }\n  | { type: \"LOGS_EXPORT\" }\n\n  // Test Messages (only used in tests)\n  | { type: \"TEST_MESSAGE\"; data?: unknown }\n  | { type: \"TEST\"; iteration?: number }\n  | { type: \"CUSTOM_MESSAGE\"; data?: unknown }\n  | { type: \"SETTINGS_GET\" }\n  | {\n      type: \"SIGNAL_UPDATE\";\n      key?: string;\n      value?: unknown;\n      signalId?: string;\n      source?: Context;\n    }\n  | {\n      type: \"USER_DATA\";\n      password?: string;\n      apiKey?: string;\n      [key: string]: unknown;\n    };\n\n// Helper: Look up the full message type from a union based on the 'type' discriminator\ntype LookupMessage<TUnion, TType extends string> = TUnion extends { type: TType } ? TUnion : never;\n\n// Extract response type from message using phantom type\n// If message has __response field (phantom type), use it; otherwise infer from framework messages\nexport type MessageResponse<T extends BaseMessage> =\n  // First, try to find the matching message in the union by type discriminator\n  T extends { type: infer TType extends string }\n    ? LookupMessage<T, TType> extends { readonly __response?: infer R }\n      ? R // Found phantom type, use it\n      : T extends ExtensionMessage\n        ? // Framework message - infer from type\n          // DOM Operations\n          T extends { type: \"DOM_QUERY\" }\n          ? {\n              elements: Array<{\n                tag: string;\n                text: string;\n                html: string;\n                attrs: Record<string, string>;\n                rect?: DOMRect;\n              }>;\n            }\n          : T extends { type: \"DOM_UPDATE\" }\n            ? { success: boolean }\n            : T extends { type: \"DOM_INSERT\" }\n              ? { success: boolean }\n              : T extends { type: \"DOM_REMOVE\" }\n                ? { success: boolean; count: number }\n                : // Page Script Operations\n                  T extends { type: \"PAGE_EVAL\" }\n                  ? { result: unknown; error?: string }\n                  : T extends { type: \"PAGE_GET_VAR\" }\n                    ? { value: unknown; exists: boolean }\n                    : T extends { type: \"PAGE_CALL_FN\" }\n                      ? { result: unknown; error?: string }\n                      : T extends { type: \"PAGE_SET_VAR\" }\n                        ? { success: boolean }\n                        : // API Operations\n                          T extends { type: \"API_REQUEST\" }\n                          ? {\n                              data: unknown;\n                              status: number;\n                              statusText: string;\n                              headers: Record<string, string>;\n                              error?: string;\n                            }\n                          : T extends { type: \"API_BATCH\" }\n                            ? {\n                                results: Array<{\n                                  data: unknown;\n                                  status: number;\n                                  error?: string;\n                                }>;\n                              }\n                            : // Clipboard Operations\n                              T extends { type: \"CLIPBOARD_WRITE\" }\n                              ? { success: boolean }\n                              : T extends { type: \"CLIPBOARD_WRITE_HTML\" }\n                                ? { success: boolean }\n                                : T extends { type: \"CLIPBOARD_WRITE_RICH\" }\n                                  ? { success: boolean }\n                                  : T extends { type: \"CLIPBOARD_READ\" }\n                                    ? { text: string }\n                                    : // Context Menu\n                                      T extends { type: \"CONTEXT_MENU_CLICKED\" }\n                                      ? undefined\n                                      : T extends { type: \"CONTEXT_MENU_CREATE\" }\n                                        ? { success: boolean }\n                                        : T extends { type: \"CONTEXT_MENU_REMOVE\" }\n                                          ? { success: boolean }\n                                          : // State Sync\n                                            T extends { type: \"STATE_SYNC\" }\n                                            ? undefined\n                                            : // Tab Operations\n                                              T extends { type: \"TAB_QUERY\" }\n                                              ? { tabs: chrome.tabs.Tab[] }\n                                              : T extends {\n                                                    type: \"TAB_GET_CURRENT\";\n                                                  }\n                                                ? { tab: chrome.tabs.Tab }\n                                                : T extends {\n                                                      type: \"TAB_RELOAD\";\n                                                    }\n                                                  ? { success: boolean }\n                                                  : // DevTools Operations\n                                                    T extends {\n                                                        type: \"DEVTOOLS_INSPECT_ELEMENT\";\n                                                      }\n                                                    ? {\n                                                        success: boolean;\n                                                      }\n                                                    : T extends {\n                                                          type: \"DEVTOOLS_LOG\";\n                                                        }\n                                                      ? undefined\n                                                      : // Logging Operations\n                                                        T extends {\n                                                            type: \"LOG\";\n                                                          }\n                                                        ? {\n                                                            success: boolean;\n                                                          }\n                                                        : T extends {\n                                                              type: \"LOGS_GET\";\n                                                            }\n                                                          ? {\n                                                              logs: LogEntry[];\n                                                            }\n                                                          : T extends {\n                                                                type: \"LOGS_CLEAR\";\n                                                              }\n                                                            ? {\n                                                                success: boolean;\n                                                                count: number;\n                                                              }\n                                                            : T extends {\n                                                                  type: \"LOGS_EXPORT\";\n                                                                }\n                                                              ? {\n                                                                  json: string;\n                                                                  count: number;\n                                                                }\n                                                              : T extends {\n                                                                    type: \"SETTINGS_GET\";\n                                                                  }\n                                                                ? {\n                                                                    settings: unknown;\n                                                                  }\n                                                                : undefined\n        : unknown // For custom messages outside ExtensionMessage, require phantom type\n    : unknown; // Fallback for messages without type field\n\n// Message handler mapping (which context handles which message)\n// Can be a single context or an array for multi-target routing\nexport type MessageHandler = {\n  DOM_QUERY: \"content\";\n  DOM_UPDATE: \"content\";\n  DOM_INSERT: \"content\";\n  DOM_REMOVE: \"content\";\n\n  PAGE_EVAL: \"page\";\n  PAGE_GET_VAR: \"page\";\n  PAGE_CALL_FN: \"page\";\n  PAGE_SET_VAR: \"page\";\n\n  API_REQUEST: \"background\";\n  API_BATCH: \"background\";\n\n  CLIPBOARD_WRITE: \"offscreen\";\n  CLIPBOARD_WRITE_HTML: \"offscreen\";\n  CLIPBOARD_WRITE_RICH: \"offscreen\";\n  CLIPBOARD_READ: \"offscreen\";\n\n  CONTEXT_MENU_CLICKED: \"background\";\n  CONTEXT_MENU_CREATE: \"background\";\n  CONTEXT_MENU_REMOVE: \"background\";\n\n  STATE_SYNC: Context[]; // Broadcast to all contexts\n\n  TAB_QUERY: \"background\";\n  TAB_GET_CURRENT: \"background\";\n  TAB_RELOAD: \"background\";\n\n  DEVTOOLS_INSPECT_ELEMENT: \"content\";\n  DEVTOOLS_LOG: \"background\";\n\n  LOG: \"background\";\n  LOGS_GET: \"background\";\n  LOGS_CLEAR: \"background\";\n  LOGS_EXPORT: \"background\";\n};\n\n// Routed message envelope\nexport type RoutedMessage<T extends BaseMessage = ExtensionMessage> = {\n  id: string; // Correlation ID (UUID)\n  source: Context; // Which context sent it\n  targets: Context[]; // Which contexts should receive this (can be multiple)\n  tabId?: number; // Required for per-tab contexts\n  timestamp: number; // When it was sent\n  payload: T; // The actual message\n};\n\n// Routed response envelope\nexport type RoutedResponse<T extends BaseMessage = ExtensionMessage> = {\n  id: string; // Matches request ID\n  success: boolean; // Whether operation succeeded\n  data?: MessageResponse<T>; // Response data\n  error?: string; // Error message if failed\n  timestamp: number; // When response was sent\n};\n"
+  ],
+  "mappings": ";AAqBO,IAAM,eAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAYO,IAAM,kBAA4B;AAAA,EACvC,OAAO;AAAA,EACP,UAAU;AAAA,EACV,WAAW;AAAA,EACX,eAAe;AAAA,EACf,aAAa;AAAA,EACb,iBAAiB;AACnB;",
+  "debugId": "CD4C96B7C2FB31BC64756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "@fairfox/polly",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "Multi-execution-context framework with reactive state and cross-context messaging for Chrome extensions, PWAs, and worker-based applications",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "polly": "./cli/polly.ts"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./state": {
+      "import": "./dist/shared/lib/state.js",
+      "types": "./dist/shared/lib/state.d.ts"
+    },
+    "./message-bus": {
+      "import": "./dist/shared/lib/message-bus.js",
+      "types": "./dist/shared/lib/message-bus.d.ts"
+    },
+    "./background": {
+      "import": "./dist/background/index.js",
+      "types": "./dist/background/index.d.ts"
+    },
+    "./message-router": {
+      "import": "./dist/background/message-router.js",
+      "types": "./dist/background/message-router.d.ts"
+    },
+    "./adapters": {
+      "import": "./dist/shared/adapters/index.js",
+      "types": "./dist/shared/adapters/index.d.ts"
+    },
+    "./errors": {
+      "import": "./dist/shared/lib/errors.js",
+      "types": "./dist/shared/lib/errors.d.ts"
+    },
+    "./types": {
+      "import": "./dist/shared/types/messages.js",
+      "types": "./dist/shared/types/messages.d.ts"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "dev": "bun run build.ts --watch",
+    "build": "bun run build.ts",
+    "build:prod": "bun run build.ts --prod",
+    "build:lib": "bun run build-lib.ts",
+    "build:full-featured": "bun run scripts/build-user-extension.ts examples/full-featured",
+    "build:full-featured:prod": "bun run scripts/build-user-extension.ts examples/full-featured --prod",
+    "typecheck": "bunx tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "prepublishOnly": "bun run typecheck && bun run lint && bun test && bun run build:lib",
+    "publish:public": "npm publish --access public"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.8.3",
+    "@types/bun": "^1.2.19",
+    "@types/chrome": "^0.0.268",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "dependencies": {
+    "@preact/signals": "^2.3.1",
+    "preact": "^10.27.2",
+    "ts-morph": "^21.0.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5",
+    "preact": "^10",
+    "@preact/signals": "^2"
+  },
+  "keywords": [
+    "multi-context",
+    "chrome-extension",
+    "browser-extension",
+    "web-extension",
+    "pwa",
+    "web-workers",
+    "service-workers",
+    "framework",
+    "reactive",
+    "state-management",
+    "messaging",
+    "cross-context",
+    "preact",
+    "signals",
+    "typescript",
+    "distributed",
+    "concurrent"
+  ],
+  "author": "Alex Jeffcott",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AlexJeffcott/polly"
+  },
+  "bugs": {
+    "url": "https://github.com/AlexJeffcott/polly/issues"
+  },
+  "homepage": "https://github.com/AlexJeffcott/polly#readme"
+}