@janhendry/nanostore-ipc-bridge 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jan Hendry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+# @janhendry/nanostore-ipc-bridge
+
+[![npm version](https://img.shields.io/npm/v/@janhendry/nanostore-ipc-bridge.svg)](https://www.npmjs.com/package/@janhendry/nanostore-ipc-bridge)
+[![license](https://img.shields.io/npm/l/@janhendry/nanostore-ipc-bridge.svg)](https://github.com/janhendry/nanostore-ipc-bridge/blob/main/LICENSE)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/@janhendry/nanostore-ipc-bridge)](https://bundlephobia.com/package/@janhendry/nanostore-ipc-bridge)
+[![changelog](https://img.shields.io/badge/changelog-📝-blue)](https://github.com/janhendry/nanostore-ipc-bridge/blob/main/packages/nanostore-ipc-bridge/CHANGELOG.md)
+
+**Zero-config Electron IPC bridge for NanoStores** – Synchronize nanostores between main and renderer processes with full TypeScript support.
+
+## Features
+
+✅ **Zero-config** – Import once, works everywhere  
+✅ **Type-safe** – Full TypeScript support with inference  
+✅ **Multi-window sync** – All renderer windows stay in sync automatically  
+✅ **Race-condition free** – Monotonic revision tracking prevents stale updates  
+✅ **Services/RPC** – Define type-safe services with events  
+✅ **Developer-friendly** – No boilerplate, no manual registration
+
+---
+
+## Installation
+
+```bash
+npm install @janhendry/nanostore-ipc-bridge nanostores
+```
+
+📦 **[View on npm](https://www.npmjs.com/package/@janhendry/nanostore-ipc-bridge)** | 💬 **[Report Issues](https://github.com/janhendry/nanostore-ipc-bridge/issues)** | 📖 **[Full Documentation](https://github.com/janhendry/nanostore-ipc-bridge)** | 📝 **[Changelog](https://github.com/janhendry/nanostore-ipc-bridge/blob/main/packages/nanostore-ipc-bridge/CHANGELOG.md)**
+
+## Quick Start
+
+### 1. Define a synced store (shared file)
+
+```typescript
+// shared/stores.ts
+import { syncedAtom } from "@janhendry/nanostore-ipc-bridge/universal";
+
+export const $counter = syncedAtom("counter", 0);
+export const $settings = syncedAtom("settings", { theme: "dark" });
+```
+
+### 2. Initialize in Main process
+
+```typescript
+// electron/main.ts
+import { initNanoStoreIPC } from "@janhendry/nanostore-ipc-bridge/main";
+import "../shared/stores"; // Import stores to register them
+
+const mainWindow = new BrowserWindow({
+  webPreferences: { preload: path.join(__dirname, "preload.js") },
+});
+
+initNanoStoreIPC({ autoRegisterWindows: true });
+```
+
+### 3. Expose API in Preload script
+
+```typescript
+// electron/preload.ts
+import { exposeNanoStoreIPC } from "@janhendry/nanostore-ipc-bridge/preload";
+
+exposeNanoStoreIPC();
+```
+
+### 4. Use in Renderer
+
+```typescript
+// renderer/App.tsx
+import { useStore } from "@nanostores/react";
+import { $counter, $settings } from "../shared/stores";
+
+export function App() {
+  const counter = useStore($counter);
+  const settings = useStore($settings);
+
+  return (
+    <div>
+      <p>Counter: {counter}</p>
+      <button onClick={() => $counter.set(counter + 1)}>+1</button>
+
+      <p>Theme: {settings.theme}</p>
+      <button onClick={() => $settings.set({ ...settings, theme: "light" })}>
+        Toggle Theme
+      </button>
+    </div>
+  );
+}
+```
+
+**That's it!** All windows will stay in sync automatically.
+
+---
+
+## Services (RPC + Events)
+
+Define type-safe services for complex operations:
+
+```typescript
+// shared/todoService.ts
+import { defineService } from "@janhendry/nanostore-ipc-bridge/services";
+
+export const todoService = defineService("todos", {
+  addTodo: async (text: string) => {
+    const todo = { id: Date.now(), text, completed: false };
+    todos.push(todo);
+    todoService.broadcast("todoAdded", todo);
+    return todo;
+  },
+
+  deleteTodo: async (id: number) => {
+    todos = todos.filter((t) => t.id !== id);
+    todoService.broadcast("todoDeleted", id);
+  },
+});
+```
+
+Use in Renderer:
+
+```typescript
+// Add todo via RPC
+const todo = await todoService.addTodo("Buy milk");
+
+// Listen to events
+todoService.on("todoAdded", (todo) => {
+  console.log("New todo:", todo);
+});
+```
+
+---
+
+## API Reference
+
+### `syncedAtom(id, initialValue)`
+
+Creates a synchronized atom that works in both Main and Renderer.
+
+- **Main process**: Real nanostore with automatic registration
+- **Renderer process**: IPC-backed proxy that syncs with Main
+- **Returns**: Standard nanostore atom with `.get()`, `.set()`, `.subscribe()`
+
+### `initNanoStoreIPC(options?)`
+
+Initialize the IPC bridge in Main process.
+
+**Options:**
+
+- `channelPrefix?: string` – IPC channel prefix (default: `'ns'`)
+- `autoRegisterWindows?: boolean` – Auto-register new windows (default: `true`)
+- `allowRendererSet?: boolean` – Allow renderer to modify stores (default: `true`)
+
+### `exposeNanoStoreIPC(options?)`
+
+Expose IPC API in Preload script.
+
+**Options:**
+
+- `channelPrefix?: string` – Must match Main process (default: `'ns'`)
+- `globalName?: string` – Global variable name (default: `'nanostoreIPC'`)
+
+### `defineService(name, handlers)`
+
+Define a type-safe service with RPC methods and events.
+
+- **Main process**: Handlers execute locally
+- **Renderer process**: Returns RPC proxy
+- **Events**: Use `.broadcast(event, data)` in handlers, `.on(event, cb)` in renderer
+
+---
+
+## How it works
+
+1. **Main process** creates real nanostores and handles IPC requests
+2. **Renderer processes** get IPC-backed proxies that forward operations
+3. **Revision tracking** prevents race conditions (subscribe-before-get is safe)
+4. **Auto-sync** broadcasts changes to all connected windows
+
+---
+
+## Repository
+
+Full source code, demo app, and detailed architecture documentation:
+
+👉 **[github.com/janhendry/nanostore-ipc-bridge](https://github.com/janhendry/nanostore-ipc-bridge)**
+
+---
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+export { DefineServiceOptions, SyncedAtomOptions, defineService, syncedAtom } from './universal/index.mjs';
+import './types-CyJJt8gf.mjs';
+import 'nanostores';

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { DefineServiceOptions, SyncedAtomOptions, defineService, syncedAtom } from './universal/index.js';
+import './types-CyJJt8gf.js';
+import 'nanostores';

package/dist/index.js

@@ -0,0 +1,232 @@
+'use strict';
+
+var nanostores = require('nanostores');
+
+// src/internal/symbols.ts
+var WF_NS_QUEUE = /* @__PURE__ */ Symbol.for("wf.nanostore.ipc.queue");
+var WF_NS_SERVICE_QUEUE = /* @__PURE__ */ Symbol.for("wf.nanostore.ipc.serviceQueue");
+var WF_NS_MAIN_API = /* @__PURE__ */ Symbol.for("wf.nanostore.ipc.mainApi");
+
+// src/universal/defineService.ts
+function isElectronMain() {
+  return typeof process !== "undefined" && !!process.versions?.electron && globalThis.window === void 0;
+}
+function getMainApi() {
+  const globalWithSymbols = globalThis;
+  return globalWithSymbols[WF_NS_MAIN_API] ?? null;
+}
+function getRendererServiceIPC(globalName) {
+  if (globalThis.window === void 0) return null;
+  return globalThis[globalName];
+}
+function getServiceQueue() {
+  const globalWithSymbols = globalThis;
+  const q = globalWithSymbols[WF_NS_SERVICE_QUEUE] ?? /* @__PURE__ */ new Map();
+  globalWithSymbols[WF_NS_SERVICE_QUEUE] = q;
+  return q;
+}
+function defineService(options) {
+  const { id, handlers, hooks, globalName = "nanostoreIPC" } = options;
+  if (isElectronMain()) {
+    const api = getMainApi();
+    const definition = {
+      handlers,
+      beforeAll: hooks?.beforeAll,
+      afterAll: hooks?.afterAll
+    };
+    if (!api) {
+      const queue = getServiceQueue();
+      queue.set(id, { id, definition });
+    } else {
+      api.registerService(id, definition);
+    }
+    const proxy = {};
+    proxy.broadcast = (eventName, data) => {
+      const currentApi = getMainApi();
+      if (currentApi) {
+        currentApi.broadcast(id, eventName, data);
+      }
+    };
+    proxy.on = () => {
+      throw new Error(
+        `[defineService] Cannot use on() in Main process. Use broadcast() to send events to Renderer.`
+      );
+    };
+    for (const [methodName, handler] of Object.entries(handlers)) {
+      proxy[methodName] = handler;
+    }
+    return proxy;
+  } else {
+    const ipc = getRendererServiceIPC(globalName);
+    if (!ipc) {
+      throw new Error(
+        `[defineService] Renderer IPC not available. Ensure exposeNanoStoreIPC() is called in preload script with globalName="${globalName}".`
+      );
+    }
+    const proxy = {};
+    proxy.on = (eventName, callback) => {
+      return ipc.subscribeServiceEvent(id, eventName, callback);
+    };
+    proxy.broadcast = () => {
+      throw new Error(
+        `[defineService] Cannot use broadcast() in Renderer process. Use RPC methods to trigger events from Main.`
+      );
+    };
+    for (const methodName of Object.keys(handlers)) {
+      proxy[methodName] = (...args) => {
+        return ipc.callService(id, methodName, ...args);
+      };
+    }
+    return proxy;
+  }
+}
+
+// src/internal/types.ts
+var NanoStoreIPCError = class extends Error {
+  constructor(message, code, storeId, originalError) {
+    super(message);
+    this.code = code;
+    this.storeId = storeId;
+    this.originalError = originalError;
+    this.name = "NanoStoreIPCError";
+  }
+};
+
+// src/universal/syncedAtom.ts
+function isElectronMain2() {
+  return typeof process !== "undefined" && !!process.versions?.electron && globalThis.window === void 0;
+}
+function getRendererIPC(globalName) {
+  if (globalThis.window === void 0) return null;
+  return globalThis[globalName];
+}
+function getMainApi2() {
+  const globalWithSymbols = globalThis;
+  return globalWithSymbols[WF_NS_MAIN_API] ?? null;
+}
+function getQueue() {
+  const globalWithSymbols = globalThis;
+  const q = globalWithSymbols[WF_NS_QUEUE] ?? /* @__PURE__ */ new Map();
+  globalWithSymbols[WF_NS_QUEUE] = q;
+  return q;
+}
+function syncedAtom(id, initial, options = {}) {
+  const globalName = options.globalName ?? "nanostoreIPC";
+  if (isElectronMain2()) {
+    const $store = nanostores.atom(initial);
+    const api = getMainApi2();
+    if (api) {
+      api.registerStore(id, $store);
+    } else {
+      getQueue().set(id, $store);
+    }
+    return $store;
+  }
+  const ipc = getRendererIPC(globalName);
+  const $local = nanostores.atom(initial);
+  if (!ipc) {
+    if (options.warnIfNoIPC) {
+      console.warn(
+        `[syncedAtom] IPC not available for "${id}". Falling back to local atom().`
+      );
+    }
+    return $local;
+  }
+  let applyingRemote = false;
+  let lastRev = -1;
+  let readyForOutbound = false;
+  const rendererCanSet = options.rendererCanSet ?? true;
+  const unsubscribeRemote = ipc.subscribe(id, (snap) => {
+    if (snap.rev <= lastRev) return;
+    lastRev = snap.rev;
+    applyingRemote = true;
+    $local.set(snap.value);
+    applyingRemote = false;
+    readyForOutbound = true;
+  });
+  ipc.get(id).then((snap) => {
+    if (snap.rev <= lastRev) return;
+    lastRev = snap.rev;
+    applyingRemote = true;
+    $local.set(snap.value);
+    applyingRemote = false;
+    readyForOutbound = true;
+  }).catch((err) => {
+    const ipcError = err instanceof NanoStoreIPCError ? err : new NanoStoreIPCError(
+      `Failed to get initial value for store "${id}"`,
+      "IPC_FAILED",
+      id,
+      err
+    );
+    if (options.onError) {
+      options.onError(ipcError);
+    } else if (options.warnIfNoIPC) {
+      console.warn("[syncedAtom]", ipcError.message, ipcError);
+    }
+    readyForOutbound = true;
+  });
+  const unsubscribeLocal = $local.subscribe((value) => {
+    if (!rendererCanSet) return;
+    if (!readyForOutbound) return;
+    if (applyingRemote) return;
+    if (options.validateValue) {
+      const isValid = options.validateValue(value);
+      if (isValid === false) {
+        const err = new NanoStoreIPCError(
+          `Validation failed for store "${id}"`,
+          "SERIALIZATION_FAILED",
+          id
+        );
+        if (options.onError) options.onError(err);
+        return;
+      }
+    }
+    ipc.set(id, value).catch((err) => {
+      const ipcError = err instanceof NanoStoreIPCError ? err : new NanoStoreIPCError(
+        `Failed to set value for store "${id}"`,
+        "IPC_FAILED",
+        id,
+        err
+      );
+      if (options.onError) {
+        options.onError(ipcError);
+      }
+    });
+  });
+  $local.destroy = () => {
+    try {
+      unsubscribeRemote();
+    } catch (err) {
+      if (options.onError) {
+        options.onError(
+          new NanoStoreIPCError(
+            "Failed to unsubscribe from remote updates",
+            "IPC_FAILED",
+            id,
+            err
+          )
+        );
+      }
+    }
+    try {
+      unsubscribeLocal();
+    } catch (err) {
+      if (options.onError) {
+        options.onError(
+          new NanoStoreIPCError(
+            "Failed to unsubscribe from local updates",
+            "IPC_FAILED",
+            id,
+            err
+          )
+        );
+      }
+    }
+  };
+  return $local;
+}
+
+exports.defineService = defineService;
+exports.syncedAtom = syncedAtom;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/symbols.ts","../src/universal/defineService.ts","../src/internal/types.ts","../src/universal/syncedAtom.ts"],"names":["isElectronMain","getMainApi","atom"],"mappings":"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","file":"index.js","sourcesContent":["export const WF_NS_QUEUE = Symbol.for(\"wf.nanostore.ipc.queue\");\nexport const WF_NS_SERVICE_QUEUE = Symbol.for(\"wf.nanostore.ipc.serviceQueue\");\nexport const WF_NS_MAIN_API = Symbol.for(\"wf.nanostore.ipc.mainApi\");\n","import { WF_NS_MAIN_API, WF_NS_SERVICE_QUEUE } from \"../internal/symbols\";\nimport type {\n\tMainApi,\n\tServiceHandlers,\n\tServiceHooks,\n\tServiceQueueEntry,\n} from \"../internal/types\";\n\nexport interface DefineServiceOptions<THandlers extends ServiceHandlers> {\n\t/**\n\t * Service identifier - must be unique across your app\n\t */\n\tid: string;\n\t/**\n\t * Service method handlers\n\t * Main: executed locally\n\t * Renderer: creates RPC proxy\n\t */\n\thandlers: THandlers;\n\t/**\n\t * Optional middleware hooks for Main process only\n\t */\n\thooks?: ServiceHooks;\n\t/**\n\t * Window global name used by preload exposure.\n\t * Default: \"nanostoreIPC\"\n\t */\n\tglobalName?: string;\n}\n\ntype ServiceProxy<THandlers extends ServiceHandlers> = {\n\t[K in keyof THandlers]: THandlers[K] extends (\n\t\t...args: infer Args\n\t) => Promise<infer Return>\n\t\t? (...args: Args) => Promise<Return>\n\t\t: never;\n} & {\n\t/**\n\t * Subscribe to service events (Renderer only)\n\t */\n\ton: (eventName: string, callback: (data: unknown) => void) => () => void;\n\t/**\n\t * Broadcast an event to all renderer windows (Main only)\n\t */\n\tbroadcast: (eventName: string, data?: unknown) => void;\n};\n\nfunction isElectronMain(): boolean {\n\treturn (\n\t\ttypeof process !== \"undefined\" &&\n\t\t!!(process as { versions?: { electron?: string } }).versions?.electron &&\n\t\tglobalThis.window === undefined\n\t);\n}\n\nfunction getMainApi(): MainApi | null {\n\tconst globalWithSymbols = globalThis as Record<symbol, unknown>;\n\treturn (globalWithSymbols[WF_NS_MAIN_API] as MainApi | undefined) ?? null;\n}\n\ntype RendererServiceIPC = {\n\tcallService: <T = unknown>(\n\t\tserviceId: string,\n\t\tmethod: string,\n\t\t...args: unknown[]\n\t) => Promise<T>;\n\tsubscribeServiceEvent: (\n\t\tserviceId: string,\n\t\teventName: string,\n\t\tcb: (data: unknown) => void,\n\t) => () => void;\n};\n\nfunction getRendererServiceIPC(globalName: string): RendererServiceIPC | null {\n\tif (globalThis.window === undefined) return null;\n\treturn (globalThis as unknown as Record<string, unknown>)[\n\t\tglobalName\n\t] as RendererServiceIPC | null;\n}\n\nfunction getServiceQueue(): Map<string, ServiceQueueEntry> {\n\tconst globalWithSymbols = globalThis as Record<symbol, unknown>;\n\tconst q: Map<string, ServiceQueueEntry> =\n\t\t(globalWithSymbols[WF_NS_SERVICE_QUEUE] as\n\t\t\t| Map<string, ServiceQueueEntry>\n\t\t\t| undefined) ?? new Map();\n\tglobalWithSymbols[WF_NS_SERVICE_QUEUE] = q;\n\treturn q;\n}\n\n/**\n * Define a service that works in both Main and Renderer processes.\n *\n * **Main Process:**\n * - Registers handlers to be called via IPC\n * - Returns proxy with broadcast() method for sending events\n * - Handlers execute locally\n *\n * **Renderer Process:**\n * - Returns RPC proxy that calls Main process via IPC\n * - Returns proxy with on() method for listening to events\n * - All methods are async and execute remotely\n *\n * @example\n * ```ts\n * // shared/services/todoService.ts\n * export const todoService = defineService({\n *   id: 'todos',\n *   handlers: {\n *     async addTodo(text: string) {\n *       const todo = { id: Date.now(), text };\n *       todos.push(todo);\n *       todoService.broadcast('todoAdded', todo); // Main only\n *       return todo;\n *     },\n *     async getTodos() {\n *       return todos;\n *     }\n *   }\n * });\n *\n * // Main process (electron/main.ts)\n * import './shared/services/todoService'; // Auto-registers\n *\n * // Renderer (React component)\n * const todo = await todoService.addTodo('Buy milk'); // RPC call\n * todoService.on('todoAdded', (todo) => {\n *   console.log('New todo:', todo);\n * });\n * ```\n */\nexport function defineService<THandlers extends ServiceHandlers>(\n\toptions: DefineServiceOptions<THandlers>,\n): ServiceProxy<THandlers> {\n\tconst { id, handlers, hooks, globalName = \"nanostoreIPC\" } = options;\n\n\tif (isElectronMain()) {\n\t\t// Main Process: Register service handlers or queue\n\t\tconst api = getMainApi();\n\t\tconst definition = {\n\t\t\thandlers,\n\t\t\tbeforeAll: hooks?.beforeAll,\n\t\t\tafterAll: hooks?.afterAll,\n\t\t};\n\n\t\tif (!api) {\n\t\t\t// Main API not ready yet - add to queue\n\t\t\tconst queue = getServiceQueue();\n\t\t\tqueue.set(id, { id, definition });\n\t\t} else {\n\t\t\t// Main API ready - register immediately\n\t\t\tapi.registerService(id, definition);\n\t\t}\n\n\t\t// Create proxy with broadcast() method\n\t\tconst proxy = {} as ServiceProxy<THandlers>;\n\n\t\t// Add broadcast method (works with or without API)\n\t\tproxy.broadcast = (eventName: string, data?: unknown) => {\n\t\t\tconst currentApi = getMainApi();\n\t\t\tif (currentApi) {\n\t\t\t\tcurrentApi.broadcast(id, eventName, data);\n\t\t\t}\n\t\t\t// If API not ready, broadcast is silently skipped (service not fully initialized yet)\n\t\t};\n\n\t\t// Add dummy on() that throws (Main shouldn't listen to events)\n\t\tproxy.on = () => {\n\t\t\tthrow new Error(\n\t\t\t\t`[defineService] Cannot use on() in Main process. Use broadcast() to send events to Renderer.`,\n\t\t\t);\n\t\t};\n\n\t\t// Bind handler methods directly (no RPC needed in Main)\n\t\tfor (const [methodName, handler] of Object.entries(handlers)) {\n\t\t\t(proxy as Record<string, unknown>)[methodName] = handler;\n\t\t}\n\n\t\treturn proxy;\n\t} else {\n\t\t// Renderer Process: Create RPC proxy\n\t\tconst ipc = getRendererServiceIPC(globalName);\n\t\tif (!ipc) {\n\t\t\tthrow new Error(\n\t\t\t\t`[defineService] Renderer IPC not available. Ensure exposeNanoStoreIPC() is called in preload script with globalName=\"${globalName}\".`,\n\t\t\t);\n\t\t}\n\n\t\tconst proxy = {} as ServiceProxy<THandlers>;\n\n\t\t// Add on() method for event subscription\n\t\tproxy.on = (eventName: string, callback: (data: unknown) => void) => {\n\t\t\treturn ipc.subscribeServiceEvent(id, eventName, callback);\n\t\t};\n\n\t\t// Add dummy broadcast() that throws (Renderer shouldn't broadcast)\n\t\tproxy.broadcast = () => {\n\t\t\tthrow new Error(\n\t\t\t\t`[defineService] Cannot use broadcast() in Renderer process. Use RPC methods to trigger events from Main.`,\n\t\t\t);\n\t\t};\n\n\t\t// Create RPC proxy for each handler\n\t\tfor (const methodName of Object.keys(handlers)) {\n\t\t\t(proxy as Record<string, unknown>)[methodName] = (...args: unknown[]) => {\n\t\t\t\treturn ipc.callService(id, methodName, ...args);\n\t\t\t};\n\t\t}\n\n\t\treturn proxy;\n\t}\n}\n","import type { Store } from \"nanostores\";\n\nexport type Snapshot<T> = { id: string; rev: number; value: T };\n\nexport type MainRegisterFn = <T = unknown>(id: string, store: Store<T>) => void;\n\nexport type MainApi = {\n\tregisterStore: MainRegisterFn;\n\tisInitialized: () => boolean;\n\tregisterService: ServiceRegisterFn;\n\tbroadcast: (serviceId: string, eventName: string, data?: unknown) => void;\n};\n\nexport type ErrorHandler = (error: NanoStoreIPCError) => void;\n\nexport class NanoStoreIPCError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic code:\n\t\t\t| \"STORE_NOT_FOUND\"\n\t\t\t| \"RENDERER_WRITE_DISABLED\"\n\t\t\t| \"SERIALIZATION_FAILED\"\n\t\t\t| \"IPC_FAILED\"\n\t\t\t| \"SERVICE_NOT_FOUND\"\n\t\t\t| \"SERVICE_METHOD_NOT_FOUND\"\n\t\t\t| \"ALREADY_INITIALIZED\",\n\t\tpublic storeId?: string,\n\t\tpublic originalError?: unknown,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"NanoStoreIPCError\";\n\t}\n}\n\n// Service types\nexport type ServiceHandler = (...args: unknown[]) => Promise<unknown>;\n\nexport type ServiceHandlers = Record<string, ServiceHandler>;\n\nexport type ServiceHooks = {\n\tbeforeAll?: (methodName: string, args: unknown[]) => void | Promise<void>;\n\tafterAll?: (\n\t\tmethodName: string,\n\t\tresult: unknown,\n\t\tduration: number,\n\t) => void | Promise<void>;\n};\n\nexport type ServiceDefinition<T extends ServiceHandlers = ServiceHandlers> = {\n\thandlers: T;\n\tbeforeAll?: (methodName: string, args: unknown[]) => void | Promise<void>;\n\tafterAll?: (\n\t\tmethodName: string,\n\t\tresult: unknown,\n\t\tduration: number,\n\t) => void | Promise<void>;\n};\n\nexport type ServiceQueueEntry<T extends ServiceHandlers = ServiceHandlers> = {\n\tid: string;\n\tdefinition: ServiceDefinition<T>;\n};\n\nexport type ServiceEventCallback = (data: unknown) => void;\n\nexport type ServiceBroadcastFn = (eventName: string, data: unknown) => void;\n\nexport type ServiceRegisterFn = <T extends ServiceHandlers>(\n\tid: string,\n\thandlers: ServiceDefinition<T>,\n) => void;\n\nexport type ServiceCallResult<T = unknown> = {\n\tsuccess: boolean;\n\tresult?: T;\n\terror?: {\n\t\tmessage: string;\n\t\tcode: string;\n\t\tstack?: string;\n\t};\n};\n","import type { Store, WritableAtom } from \"nanostores\";\nimport { atom } from \"nanostores\";\nimport { WF_NS_MAIN_API, WF_NS_QUEUE } from \"../internal/symbols\";\nimport type { ErrorHandler, MainApi, Snapshot } from \"../internal/types\";\nimport { NanoStoreIPCError } from \"../internal/types\";\n\nexport interface SyncedAtomOptions<T> {\n\t/**\n\t * If true, renderer writes are blocked even if main allows writes.\n\t * Useful to force \"actions only\" mutability later without breaking API.\n\t */\n\trendererCanSet?: boolean;\n\t/**\n\t * Optional: warn when IPC is not available (e.g. during SSR/tests).\n\t */\n\twarnIfNoIPC?: boolean;\n\t/**\n\t * Optional: channel prefix to match init/expose\n\t * If you set it here, you must also pass it to expose/init.\n\t * If omitted, uses unprefixed channels.\n\t */\n\tchannelPrefix?: string;\n\t/**\n\t * Window global name used by preload exposure.\n\t * Default: \"nanostoreIPC\"\n\t */\n\tglobalName?: string;\n\t/**\n\t * Error handler called when errors occur in IPC operations.\n\t */\n\tonError?: ErrorHandler;\n\t/**\n\t * Optional value validator. Return false to reject the value.\n\t * Can be used for runtime validation (e.g., with Zod).\n\t */\n\tvalidateValue?: (value: T) => boolean | Promise<boolean>;\n}\n\nfunction isElectronMain(): boolean {\n\t// In Electron main, `process.versions.electron` exists and there is no window/document.\n\treturn (\n\t\ttypeof process !== \"undefined\" &&\n\t\t!!(process as { versions?: { electron?: string } }).versions?.electron &&\n\t\tglobalThis.window === undefined\n\t);\n}\n\ntype RendererIPC = {\n\tget: <T = unknown>(id: string) => Promise<Snapshot<T>>;\n\tset: <T = unknown>(id: string, value: T) => Promise<void>;\n\tsubscribe: <T = unknown>(\n\t\tid: string,\n\t\tcb: (snap: Snapshot<T>) => void,\n\t) => () => void;\n\tsubscribeAll: (cb: (snap: Snapshot<unknown>) => void) => () => void;\n};\n\nfunction getRendererIPC(globalName: string): RendererIPC | null {\n\tif (globalThis.window === undefined) return null;\n\treturn (globalThis as unknown as Record<string, unknown>)[\n\t\tglobalName\n\t] as RendererIPC | null;\n}\n\nfunction getMainApi(): MainApi | null {\n\tconst globalWithSymbols = globalThis as Record<symbol, unknown>;\n\treturn (globalWithSymbols[WF_NS_MAIN_API] as MainApi | undefined) ?? null;\n}\n\nfunction getQueue(): Map<string, Store<unknown>> {\n\tconst globalWithSymbols = globalThis as Record<symbol, unknown>;\n\tconst q: Map<string, Store<unknown>> = (globalWithSymbols[WF_NS_QUEUE] as\n\t\t| Map<string, Store<unknown>>\n\t\t| undefined) ?? new Map();\n\tglobalWithSymbols[WF_NS_QUEUE] = q;\n\treturn q;\n}\n\n/**\n * syncedAtom(id, initial):\n * - In Electron Main: creates a real atom and registers it for IPC broadcast.\n * - In Electron Renderer: creates a proxy atom and syncs it via preload-exposed IPC API.\n * - Outside Electron: behaves as a normal atom(initial).\n *\n * No central \"bridge definition\" required; ID is the single piece of shared contract.\n */\nexport function syncedAtom<T>(\n\tid: string,\n\tinitial: T,\n\toptions: SyncedAtomOptions<T> = {},\n) {\n\tconst globalName = options.globalName ?? \"nanostoreIPC\";\n\n\t// MAIN: real store + registration\n\tif (isElectronMain()) {\n\t\tconst $store = atom<T>(initial);\n\n\t\tconst api = getMainApi();\n\t\tif (api) {\n\t\t\tapi.registerStore(id, $store);\n\t\t} else {\n\t\t\t// initNanoStoreIPC not called yet -> queue for later\n\t\t\tgetQueue().set(id, $store);\n\t\t}\n\n\t\treturn $store;\n\t}\n\n\t// RENDERER: IPC-backed proxy store (if IPC is available)\n\tconst ipc = getRendererIPC(globalName);\n\n\ttype AtomWithDestroy<T> = WritableAtom<T> & { destroy: () => void };\n\tconst $local = atom<T>(initial) as AtomWithDestroy<T>;\n\n\tif (!ipc) {\n\t\tif (options.warnIfNoIPC) {\n\t\t\t// eslint-disable-next-line no-console\n\t\t\tconsole.warn(\n\t\t\t\t`[syncedAtom] IPC not available for \"${id}\". Falling back to local atom().`,\n\t\t\t);\n\t\t}\n\t\treturn $local;\n\t}\n\n\tlet applyingRemote = false;\n\tlet lastRev = -1;\n\tlet readyForOutbound = false;\n\tconst rendererCanSet = options.rendererCanSet ?? true;\n\n\t// remote -> local (subscribe first)\n\tconst unsubscribeRemote = ipc.subscribe(id, (snap: Snapshot<T>) => {\n\t\tif (snap.rev <= lastRev) return;\n\t\tlastRev = snap.rev;\n\t\tapplyingRemote = true;\n\t\t$local.set(snap.value);\n\t\tapplyingRemote = false;\n\t\treadyForOutbound = true;\n\t});\n\n\t// then get snapshot (rev-gated)\n\tipc\n\t\t.get<T>(id)\n\t\t.then((snap: Snapshot<T>) => {\n\t\t\tif (snap.rev <= lastRev) return;\n\t\t\tlastRev = snap.rev;\n\n\t\t\tapplyingRemote = true;\n\t\t\t$local.set(snap.value);\n\t\t\tapplyingRemote = false;\n\t\t\treadyForOutbound = true;\n\t\t})\n\t\t.catch((err: unknown) => {\n\t\t\tconst ipcError =\n\t\t\t\terr instanceof NanoStoreIPCError\n\t\t\t\t\t? err\n\t\t\t\t\t: new NanoStoreIPCError(\n\t\t\t\t\t\t\t`Failed to get initial value for store \"${id}\"`,\n\t\t\t\t\t\t\t\"IPC_FAILED\",\n\t\t\t\t\t\t\tid,\n\t\t\t\t\t\t\terr,\n\t\t\t\t\t\t);\n\n\t\t\tif (options.onError) {\n\t\t\t\toptions.onError(ipcError);\n\t\t\t} else if (options.warnIfNoIPC) {\n\t\t\t\tconsole.warn(\"[syncedAtom]\", ipcError.message, ipcError);\n\t\t\t}\n\n\t\t\treadyForOutbound = true; // allow local usage even if remote missing\n\t\t});\n\n\t// local -> remote (after first remote snapshot or after get failed)\n\tconst unsubscribeLocal = $local.subscribe((value: T) => {\n\t\tif (!rendererCanSet) return;\n\t\tif (!readyForOutbound) return;\n\t\tif (applyingRemote) return;\n\n\t\t// Optional validation\n\t\tif (options.validateValue) {\n\t\t\tconst isValid = options.validateValue(value);\n\t\t\tif (isValid === false) {\n\t\t\t\tconst err = new NanoStoreIPCError(\n\t\t\t\t\t`Validation failed for store \"${id}\"`,\n\t\t\t\t\t\"SERIALIZATION_FAILED\",\n\t\t\t\t\tid,\n\t\t\t\t);\n\t\t\t\tif (options.onError) options.onError(err);\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\tipc.set(id, value).catch((err: unknown) => {\n\t\t\tconst ipcError =\n\t\t\t\terr instanceof NanoStoreIPCError\n\t\t\t\t\t? err\n\t\t\t\t\t: new NanoStoreIPCError(\n\t\t\t\t\t\t\t`Failed to set value for store \"${id}\"`,\n\t\t\t\t\t\t\t\"IPC_FAILED\",\n\t\t\t\t\t\t\tid,\n\t\t\t\t\t\t\terr,\n\t\t\t\t\t\t);\n\t\t\tif (options.onError) {\n\t\t\t\toptions.onError(ipcError);\n\t\t\t}\n\t\t});\n\t});\n\n\t// Optional cleanup hook\n\t$local.destroy = () => {\n\t\ttry {\n\t\t\tunsubscribeRemote();\n\t\t} catch (err) {\n\t\t\tif (options.onError) {\n\t\t\t\toptions.onError(\n\t\t\t\t\tnew NanoStoreIPCError(\n\t\t\t\t\t\t\"Failed to unsubscribe from remote updates\",\n\t\t\t\t\t\t\"IPC_FAILED\",\n\t\t\t\t\t\tid,\n\t\t\t\t\t\terr,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\tunsubscribeLocal();\n\t\t} catch (err) {\n\t\t\tif (options.onError) {\n\t\t\t\toptions.onError(\n\t\t\t\t\tnew NanoStoreIPCError(\n\t\t\t\t\t\t\"Failed to unsubscribe from local updates\",\n\t\t\t\t\t\t\"IPC_FAILED\",\n\t\t\t\t\t\tid,\n\t\t\t\t\t\terr,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t};\n\n\treturn $local;\n}\n"]}