@janhendry/nanostore-ipc-bridge 0.0.1

package/dist/preload/index.js

@@ -0,0 +1,122 @@
+'use strict';
+
+var electron = require('electron');
+
+// src/preload/exposeNanoStoreIPC.ts
+function ch(prefix, c) {
+  return prefix ? `${prefix}:${c}` : c;
+}
+function validateIPCValue(value) {
+  if (value === null || value === void 0) return;
+  const type = typeof value;
+  if (type === "string" || type === "number" || type === "boolean") return;
+  if (type === "function" || type === "symbol") {
+    throw new TypeError(`Cannot serialize ${type} values via IPC`);
+  }
+  if (type === "object") {
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== Array.prototype && proto !== null) {
+      if (!(value instanceof Date || value instanceof RegExp || value instanceof Error)) {
+        throw new TypeError("Cannot serialize class instances via IPC");
+      }
+    }
+    if ("__proto__" in value || "constructor" in value || "prototype" in value) {
+      const obj = value;
+      const proto2 = Object.getPrototypeOf(obj);
+      if (proto2 !== Object.prototype && proto2 !== Array.prototype && proto2 !== null) {
+        throw new TypeError("Potentially unsafe object structure");
+      }
+    }
+  }
+}
+function validateId(id) {
+  if (typeof id !== "string" || id.length === 0) {
+    throw new TypeError("ID must be a non-empty string");
+  }
+  if (id.length > 256) {
+    throw new TypeError("ID too long (max 256 characters)");
+  }
+}
+function exposeNanoStoreIPC(opts = {}) {
+  const channelPrefix = opts.channelPrefix ?? "";
+  const globalName = opts.globalName ?? "nanostoreIPC";
+  const api = {
+    get: (id) => {
+      validateId(id);
+      return electron.ipcRenderer.invoke(ch(channelPrefix, "ns:get"), id);
+    },
+    set: (id, value) => {
+      validateId(id);
+      validateIPCValue(value);
+      return electron.ipcRenderer.invoke(ch(channelPrefix, "ns:set"), id, value);
+    },
+    subscribe: (id, cb) => {
+      validateId(id);
+      if (typeof cb !== "function") {
+        throw new TypeError("Callback must be a function");
+      }
+      const channel = ch(channelPrefix, "ns:update");
+      const handler = (_, snap) => {
+        if (snap.id !== id) return;
+        cb(snap);
+      };
+      electron.ipcRenderer.on(channel, handler);
+      return () => electron.ipcRenderer.removeListener(channel, handler);
+    },
+    subscribeAll: (cb) => {
+      if (typeof cb !== "function") {
+        throw new TypeError("Callback must be a function");
+      }
+      const channel = ch(channelPrefix, "ns:update");
+      const handler = (_, snap) => cb(snap);
+      electron.ipcRenderer.on(channel, handler);
+      return () => electron.ipcRenderer.removeListener(channel, handler);
+    },
+    // Service RPC call
+    callService: async (serviceId, method, ...args) => {
+      validateId(serviceId);
+      validateId(method);
+      for (const arg of args) {
+        validateIPCValue(arg);
+      }
+      const channel = ch(channelPrefix, "svc:call");
+      const result = await electron.ipcRenderer.invoke(
+        channel,
+        serviceId,
+        method,
+        args
+      );
+      if (!result.success) {
+        const error = new Error(result.error?.message || "Service call failed");
+        error.name = result.error?.code || "ServiceError";
+        if (result.error?.stack) {
+          error.stack = result.error.stack;
+        }
+        throw error;
+      }
+      return result.result;
+    },
+    // Subscribe to service events
+    subscribeServiceEvent: (serviceId, eventName, cb) => {
+      validateId(serviceId);
+      validateId(eventName);
+      if (typeof cb !== "function") {
+        throw new TypeError("Callback must be a function");
+      }
+      const channel = ch(channelPrefix, "svc:event");
+      const handler = (_, payload) => {
+        if (payload.serviceId !== serviceId || payload.eventName !== eventName)
+          return;
+        cb(payload.data);
+      };
+      electron.ipcRenderer.on(channel, handler);
+      return () => electron.ipcRenderer.removeListener(channel, handler);
+    }
+  };
+  electron.contextBridge.exposeInMainWorld(globalName, api);
+  return api;
+}
+
+exports.exposeNanoStoreIPC = exposeNanoStoreIPC;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/preload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/preload/exposeNanoStoreIPC.ts"],"names":["proto","ipcRenderer","contextBridge"],"mappings":"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","file":"index.js","sourcesContent":["import { contextBridge, ipcRenderer } from \"electron\";\nimport type { ServiceCallResult, Snapshot } from \"../internal/types\";\n\nexport interface ExposeNanoStoreIPCOptions {\n\tchannelPrefix?: string;\n\t/**\n\t * Name under which the API is exposed to window.\n\t * Default: \"nanostoreIPC\"\n\t */\n\tglobalName?: string;\n}\n\nexport type NanoStoreIPC = {\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\t// Services\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 ch(prefix: string, c: string) {\n\treturn prefix ? `${prefix}:${c}` : c;\n}\n\n/**\n * Validates that a value is safe to send via IPC.\n * Checks for basic serializability and prevents prototype pollution.\n */\nfunction validateIPCValue(value: unknown): void {\n\tif (value === null || value === undefined) return;\n\n\tconst type = typeof value;\n\n\t// Primitives are always safe\n\tif (type === \"string\" || type === \"number\" || type === \"boolean\") return;\n\n\t// Functions, symbols, and undefined are not serializable\n\tif (type === \"function\" || type === \"symbol\") {\n\t\tthrow new TypeError(`Cannot serialize ${type} values via IPC`);\n\t}\n\n\t// Check objects and arrays recursively (with depth limit)\n\tif (type === \"object\") {\n\t\t// Reject dangerous constructors\n\t\tconst proto = Object.getPrototypeOf(value);\n\t\tif (\n\t\t\tproto !== Object.prototype &&\n\t\t\tproto !== Array.prototype &&\n\t\t\tproto !== null\n\t\t) {\n\t\t\t// Allow Date, RegExp, Error which are structured-cloneable\n\t\t\tif (\n\t\t\t\t!(\n\t\t\t\t\tvalue instanceof Date ||\n\t\t\t\t\tvalue instanceof RegExp ||\n\t\t\t\t\tvalue instanceof Error\n\t\t\t\t)\n\t\t\t) {\n\t\t\t\tthrow new TypeError(\"Cannot serialize class instances via IPC\");\n\t\t\t}\n\t\t}\n\n\t\t// Check for prototype pollution attempts\n\t\tif (\n\t\t\t\"__proto__\" in (value as object) ||\n\t\t\t\"constructor\" in (value as object) ||\n\t\t\t\"prototype\" in (value as object)\n\t\t) {\n\t\t\tconst obj = value as Record<string, unknown>;\n\t\t\t// Use Object.getPrototypeOf instead of deprecated __proto__\n\t\t\tconst proto = Object.getPrototypeOf(obj);\n\t\t\tif (\n\t\t\t\tproto !== Object.prototype &&\n\t\t\t\tproto !== Array.prototype &&\n\t\t\t\tproto !== null\n\t\t\t) {\n\t\t\t\tthrow new TypeError(\"Potentially unsafe object structure\");\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Validates string IDs to prevent injection attacks\n */\nfunction validateId(id: string): void {\n\tif (typeof id !== \"string\" || id.length === 0) {\n\t\tthrow new TypeError(\"ID must be a non-empty string\");\n\t}\n\tif (id.length > 256) {\n\t\tthrow new TypeError(\"ID too long (max 256 characters)\");\n\t}\n}\n\nexport function exposeNanoStoreIPC(opts: ExposeNanoStoreIPCOptions = {}) {\n\tconst channelPrefix = opts.channelPrefix ?? \"\";\n\tconst globalName = opts.globalName ?? \"nanostoreIPC\";\n\n\tconst api: NanoStoreIPC = {\n\t\tget: (id) => {\n\t\t\tvalidateId(id);\n\t\t\treturn ipcRenderer.invoke(ch(channelPrefix, \"ns:get\"), id);\n\t\t},\n\t\tset: (id, value) => {\n\t\t\tvalidateId(id);\n\t\t\tvalidateIPCValue(value);\n\t\t\treturn ipcRenderer.invoke(ch(channelPrefix, \"ns:set\"), id, value);\n\t\t},\n\t\tsubscribe: <T>(id: string, cb: (snap: Snapshot<T>) => void) => {\n\t\t\tvalidateId(id);\n\t\t\tif (typeof cb !== \"function\") {\n\t\t\t\tthrow new TypeError(\"Callback must be a function\");\n\t\t\t}\n\t\t\tconst channel = ch(channelPrefix, \"ns:update\");\n\t\t\tconst handler = (_: unknown, snap: Snapshot<unknown>) => {\n\t\t\t\tif (snap.id !== id) return;\n\t\t\t\tcb(snap as Snapshot<T>);\n\t\t\t};\n\t\t\tipcRenderer.on(channel, handler);\n\t\t\treturn () => ipcRenderer.removeListener(channel, handler);\n\t\t},\n\t\tsubscribeAll: (cb) => {\n\t\t\tif (typeof cb !== \"function\") {\n\t\t\t\tthrow new TypeError(\"Callback must be a function\");\n\t\t\t}\n\t\t\tconst channel = ch(channelPrefix, \"ns:update\");\n\t\t\tconst handler = (_: unknown, snap: Snapshot<unknown>) => cb(snap);\n\t\t\tipcRenderer.on(channel, handler);\n\t\t\treturn () => ipcRenderer.removeListener(channel, handler);\n\t\t},\n\n\t\t// Service RPC call\n\t\tcallService: async <T = unknown>(\n\t\t\tserviceId: string,\n\t\t\tmethod: string,\n\t\t\t...args: unknown[]\n\t\t): Promise<T> => {\n\t\t\tvalidateId(serviceId);\n\t\t\tvalidateId(method);\n\n\t\t\t// Validate all arguments\n\t\t\tfor (const arg of args) {\n\t\t\t\tvalidateIPCValue(arg);\n\t\t\t}\n\n\t\t\tconst channel = ch(channelPrefix, \"svc:call\");\n\t\t\tconst result: ServiceCallResult = await ipcRenderer.invoke(\n\t\t\t\tchannel,\n\t\t\t\tserviceId,\n\t\t\t\tmethod,\n\t\t\t\targs,\n\t\t\t);\n\n\t\t\tif (!result.success) {\n\t\t\t\t// Reconstruct error from Main\n\t\t\t\tconst error = new Error(result.error?.message || \"Service call failed\");\n\t\t\t\terror.name = result.error?.code || \"ServiceError\";\n\t\t\t\tif (result.error?.stack) {\n\t\t\t\t\terror.stack = result.error.stack;\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\n\t\t\treturn result.result as T;\n\t\t},\n\n\t\t// Subscribe to service events\n\t\tsubscribeServiceEvent: (\n\t\t\tserviceId: string,\n\t\t\teventName: string,\n\t\t\tcb: (data: unknown) => void,\n\t\t) => {\n\t\t\tvalidateId(serviceId);\n\t\t\tvalidateId(eventName);\n\t\t\tif (typeof cb !== \"function\") {\n\t\t\t\tthrow new TypeError(\"Callback must be a function\");\n\t\t\t}\n\t\t\tconst channel = ch(channelPrefix, \"svc:event\");\n\t\t\tconst handler = (\n\t\t\t\t_: unknown,\n\t\t\t\tpayload: { serviceId: string; eventName: string; data: unknown },\n\t\t\t) => {\n\t\t\t\tif (payload.serviceId !== serviceId || payload.eventName !== eventName)\n\t\t\t\t\treturn;\n\t\t\t\tcb(payload.data);\n\t\t\t};\n\t\t\tipcRenderer.on(channel, handler);\n\t\t\treturn () => ipcRenderer.removeListener(channel, handler);\n\t\t},\n\t};\n\n\tcontextBridge.exposeInMainWorld(globalName, api);\n\treturn api;\n}\n"]}

package/dist/preload/index.mjs

@@ -0,0 +1,120 @@
+import { contextBridge, ipcRenderer } from 'electron';
+
+// src/preload/exposeNanoStoreIPC.ts
+function ch(prefix, c) {
+  return prefix ? `${prefix}:${c}` : c;
+}
+function validateIPCValue(value) {
+  if (value === null || value === void 0) return;
+  const type = typeof value;
+  if (type === "string" || type === "number" || type === "boolean") return;
+  if (type === "function" || type === "symbol") {
+    throw new TypeError(`Cannot serialize ${type} values via IPC`);
+  }
+  if (type === "object") {
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== Array.prototype && proto !== null) {
+      if (!(value instanceof Date || value instanceof RegExp || value instanceof Error)) {
+        throw new TypeError("Cannot serialize class instances via IPC");
+      }
+    }
+    if ("__proto__" in value || "constructor" in value || "prototype" in value) {
+      const obj = value;
+      const proto2 = Object.getPrototypeOf(obj);
+      if (proto2 !== Object.prototype && proto2 !== Array.prototype && proto2 !== null) {
+        throw new TypeError("Potentially unsafe object structure");
+      }
+    }
+  }
+}
+function validateId(id) {
+  if (typeof id !== "string" || id.length === 0) {
+    throw new TypeError("ID must be a non-empty string");
+  }
+  if (id.length > 256) {
+    throw new TypeError("ID too long (max 256 characters)");
+  }
+}
+function exposeNanoStoreIPC(opts = {}) {
+  const channelPrefix = opts.channelPrefix ?? "";
+  const globalName = opts.globalName ?? "nanostoreIPC";
+  const api = {
+    get: (id) => {
+      validateId(id);
+      return ipcRenderer.invoke(ch(channelPrefix, "ns:get"), id);
+    },
+    set: (id, value) => {
+      validateId(id);
+      validateIPCValue(value);
+      return ipcRenderer.invoke(ch(channelPrefix, "ns:set"), id, value);
+    },
+    subscribe: (id, cb) => {
+      validateId(id);
+      if (typeof cb !== "function") {
+        throw new TypeError("Callback must be a function");
+      }
+      const channel = ch(channelPrefix, "ns:update");
+      const handler = (_, snap) => {
+        if (snap.id !== id) return;
+        cb(snap);
+      };
+      ipcRenderer.on(channel, handler);
+      return () => ipcRenderer.removeListener(channel, handler);
+    },
+    subscribeAll: (cb) => {
+      if (typeof cb !== "function") {
+        throw new TypeError("Callback must be a function");
+      }
+      const channel = ch(channelPrefix, "ns:update");
+      const handler = (_, snap) => cb(snap);
+      ipcRenderer.on(channel, handler);
+      return () => ipcRenderer.removeListener(channel, handler);
+    },
+    // Service RPC call
+    callService: async (serviceId, method, ...args) => {
+      validateId(serviceId);
+      validateId(method);
+      for (const arg of args) {
+        validateIPCValue(arg);
+      }
+      const channel = ch(channelPrefix, "svc:call");
+      const result = await ipcRenderer.invoke(
+        channel,
+        serviceId,
+        method,
+        args
+      );
+      if (!result.success) {
+        const error = new Error(result.error?.message || "Service call failed");
+        error.name = result.error?.code || "ServiceError";
+        if (result.error?.stack) {
+          error.stack = result.error.stack;
+        }
+        throw error;
+      }
+      return result.result;
+    },
+    // Subscribe to service events
+    subscribeServiceEvent: (serviceId, eventName, cb) => {
+      validateId(serviceId);
+      validateId(eventName);
+      if (typeof cb !== "function") {
+        throw new TypeError("Callback must be a function");
+      }
+      const channel = ch(channelPrefix, "svc:event");
+      const handler = (_, payload) => {
+        if (payload.serviceId !== serviceId || payload.eventName !== eventName)
+          return;
+        cb(payload.data);
+      };
+      ipcRenderer.on(channel, handler);
+      return () => ipcRenderer.removeListener(channel, handler);
+    }
+  };
+  contextBridge.exposeInMainWorld(globalName, api);
+  return api;
+}
+
+export { exposeNanoStoreIPC };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/preload/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/preload/exposeNanoStoreIPC.ts"],"names":["proto"],"mappings":"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","file":"index.mjs","sourcesContent":["import { contextBridge, ipcRenderer } from \"electron\";\nimport type { ServiceCallResult, Snapshot } from \"../internal/types\";\n\nexport interface ExposeNanoStoreIPCOptions {\n\tchannelPrefix?: string;\n\t/**\n\t * Name under which the API is exposed to window.\n\t * Default: \"nanostoreIPC\"\n\t */\n\tglobalName?: string;\n}\n\nexport type NanoStoreIPC = {\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\t// Services\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 ch(prefix: string, c: string) {\n\treturn prefix ? `${prefix}:${c}` : c;\n}\n\n/**\n * Validates that a value is safe to send via IPC.\n * Checks for basic serializability and prevents prototype pollution.\n */\nfunction validateIPCValue(value: unknown): void {\n\tif (value === null || value === undefined) return;\n\n\tconst type = typeof value;\n\n\t// Primitives are always safe\n\tif (type === \"string\" || type === \"number\" || type === \"boolean\") return;\n\n\t// Functions, symbols, and undefined are not serializable\n\tif (type === \"function\" || type === \"symbol\") {\n\t\tthrow new TypeError(`Cannot serialize ${type} values via IPC`);\n\t}\n\n\t// Check objects and arrays recursively (with depth limit)\n\tif (type === \"object\") {\n\t\t// Reject dangerous constructors\n\t\tconst proto = Object.getPrototypeOf(value);\n\t\tif (\n\t\t\tproto !== Object.prototype &&\n\t\t\tproto !== Array.prototype &&\n\t\t\tproto !== null\n\t\t) {\n\t\t\t// Allow Date, RegExp, Error which are structured-cloneable\n\t\t\tif (\n\t\t\t\t!(\n\t\t\t\t\tvalue instanceof Date ||\n\t\t\t\t\tvalue instanceof RegExp ||\n\t\t\t\t\tvalue instanceof Error\n\t\t\t\t)\n\t\t\t) {\n\t\t\t\tthrow new TypeError(\"Cannot serialize class instances via IPC\");\n\t\t\t}\n\t\t}\n\n\t\t// Check for prototype pollution attempts\n\t\tif (\n\t\t\t\"__proto__\" in (value as object) ||\n\t\t\t\"constructor\" in (value as object) ||\n\t\t\t\"prototype\" in (value as object)\n\t\t) {\n\t\t\tconst obj = value as Record<string, unknown>;\n\t\t\t// Use Object.getPrototypeOf instead of deprecated __proto__\n\t\t\tconst proto = Object.getPrototypeOf(obj);\n\t\t\tif (\n\t\t\t\tproto !== Object.prototype &&\n\t\t\t\tproto !== Array.prototype &&\n\t\t\t\tproto !== null\n\t\t\t) {\n\t\t\t\tthrow new TypeError(\"Potentially unsafe object structure\");\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Validates string IDs to prevent injection attacks\n */\nfunction validateId(id: string): void {\n\tif (typeof id !== \"string\" || id.length === 0) {\n\t\tthrow new TypeError(\"ID must be a non-empty string\");\n\t}\n\tif (id.length > 256) {\n\t\tthrow new TypeError(\"ID too long (max 256 characters)\");\n\t}\n}\n\nexport function exposeNanoStoreIPC(opts: ExposeNanoStoreIPCOptions = {}) {\n\tconst channelPrefix = opts.channelPrefix ?? \"\";\n\tconst globalName = opts.globalName ?? \"nanostoreIPC\";\n\n\tconst api: NanoStoreIPC = {\n\t\tget: (id) => {\n\t\t\tvalidateId(id);\n\t\t\treturn ipcRenderer.invoke(ch(channelPrefix, \"ns:get\"), id);\n\t\t},\n\t\tset: (id, value) => {\n\t\t\tvalidateId(id);\n\t\t\tvalidateIPCValue(value);\n\t\t\treturn ipcRenderer.invoke(ch(channelPrefix, \"ns:set\"), id, value);\n\t\t},\n\t\tsubscribe: <T>(id: string, cb: (snap: Snapshot<T>) => void) => {\n\t\t\tvalidateId(id);\n\t\t\tif (typeof cb !== \"function\") {\n\t\t\t\tthrow new TypeError(\"Callback must be a function\");\n\t\t\t}\n\t\t\tconst channel = ch(channelPrefix, \"ns:update\");\n\t\t\tconst handler = (_: unknown, snap: Snapshot<unknown>) => {\n\t\t\t\tif (snap.id !== id) return;\n\t\t\t\tcb(snap as Snapshot<T>);\n\t\t\t};\n\t\t\tipcRenderer.on(channel, handler);\n\t\t\treturn () => ipcRenderer.removeListener(channel, handler);\n\t\t},\n\t\tsubscribeAll: (cb) => {\n\t\t\tif (typeof cb !== \"function\") {\n\t\t\t\tthrow new TypeError(\"Callback must be a function\");\n\t\t\t}\n\t\t\tconst channel = ch(channelPrefix, \"ns:update\");\n\t\t\tconst handler = (_: unknown, snap: Snapshot<unknown>) => cb(snap);\n\t\t\tipcRenderer.on(channel, handler);\n\t\t\treturn () => ipcRenderer.removeListener(channel, handler);\n\t\t},\n\n\t\t// Service RPC call\n\t\tcallService: async <T = unknown>(\n\t\t\tserviceId: string,\n\t\t\tmethod: string,\n\t\t\t...args: unknown[]\n\t\t): Promise<T> => {\n\t\t\tvalidateId(serviceId);\n\t\t\tvalidateId(method);\n\n\t\t\t// Validate all arguments\n\t\t\tfor (const arg of args) {\n\t\t\t\tvalidateIPCValue(arg);\n\t\t\t}\n\n\t\t\tconst channel = ch(channelPrefix, \"svc:call\");\n\t\t\tconst result: ServiceCallResult = await ipcRenderer.invoke(\n\t\t\t\tchannel,\n\t\t\t\tserviceId,\n\t\t\t\tmethod,\n\t\t\t\targs,\n\t\t\t);\n\n\t\t\tif (!result.success) {\n\t\t\t\t// Reconstruct error from Main\n\t\t\t\tconst error = new Error(result.error?.message || \"Service call failed\");\n\t\t\t\terror.name = result.error?.code || \"ServiceError\";\n\t\t\t\tif (result.error?.stack) {\n\t\t\t\t\terror.stack = result.error.stack;\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\n\t\t\treturn result.result as T;\n\t\t},\n\n\t\t// Subscribe to service events\n\t\tsubscribeServiceEvent: (\n\t\t\tserviceId: string,\n\t\t\teventName: string,\n\t\t\tcb: (data: unknown) => void,\n\t\t) => {\n\t\t\tvalidateId(serviceId);\n\t\t\tvalidateId(eventName);\n\t\t\tif (typeof cb !== \"function\") {\n\t\t\t\tthrow new TypeError(\"Callback must be a function\");\n\t\t\t}\n\t\t\tconst channel = ch(channelPrefix, \"svc:event\");\n\t\t\tconst handler = (\n\t\t\t\t_: unknown,\n\t\t\t\tpayload: { serviceId: string; eventName: string; data: unknown },\n\t\t\t) => {\n\t\t\t\tif (payload.serviceId !== serviceId || payload.eventName !== eventName)\n\t\t\t\t\treturn;\n\t\t\t\tcb(payload.data);\n\t\t\t};\n\t\t\tipcRenderer.on(channel, handler);\n\t\t\treturn () => ipcRenderer.removeListener(channel, handler);\n\t\t},\n\t};\n\n\tcontextBridge.exposeInMainWorld(globalName, api);\n\treturn api;\n}\n"]}

package/dist/types-CyJJt8gf.d.mts

@@ -0,0 +1,25 @@
+type Snapshot<T> = {
+    id: string;
+    rev: number;
+    value: T;
+};
+type ErrorHandler = (error: NanoStoreIPCError) => void;
+declare class NanoStoreIPCError extends Error {
+    code: "STORE_NOT_FOUND" | "RENDERER_WRITE_DISABLED" | "SERIALIZATION_FAILED" | "IPC_FAILED" | "SERVICE_NOT_FOUND" | "SERVICE_METHOD_NOT_FOUND" | "ALREADY_INITIALIZED";
+    storeId?: string | undefined;
+    originalError?: unknown | undefined;
+    constructor(message: string, code: "STORE_NOT_FOUND" | "RENDERER_WRITE_DISABLED" | "SERIALIZATION_FAILED" | "IPC_FAILED" | "SERVICE_NOT_FOUND" | "SERVICE_METHOD_NOT_FOUND" | "ALREADY_INITIALIZED", storeId?: string | undefined, originalError?: unknown | undefined);
+}
+type ServiceHandler = (...args: unknown[]) => Promise<unknown>;
+type ServiceHandlers = Record<string, ServiceHandler>;
+type ServiceHooks = {
+    beforeAll?: (methodName: string, args: unknown[]) => void | Promise<void>;
+    afterAll?: (methodName: string, result: unknown, duration: number) => void | Promise<void>;
+};
+type ServiceDefinition<T extends ServiceHandlers = ServiceHandlers> = {
+    handlers: T;
+    beforeAll?: (methodName: string, args: unknown[]) => void | Promise<void>;
+    afterAll?: (methodName: string, result: unknown, duration: number) => void | Promise<void>;
+};
+
+export { type ErrorHandler as E, NanoStoreIPCError as N, type Snapshot as S, type ServiceHandlers as a, type ServiceDefinition as b, type ServiceHooks as c };

package/dist/types-CyJJt8gf.d.ts

@@ -0,0 +1,25 @@
+type Snapshot<T> = {
+    id: string;
+    rev: number;
+    value: T;
+};
+type ErrorHandler = (error: NanoStoreIPCError) => void;
+declare class NanoStoreIPCError extends Error {
+    code: "STORE_NOT_FOUND" | "RENDERER_WRITE_DISABLED" | "SERIALIZATION_FAILED" | "IPC_FAILED" | "SERVICE_NOT_FOUND" | "SERVICE_METHOD_NOT_FOUND" | "ALREADY_INITIALIZED";
+    storeId?: string | undefined;
+    originalError?: unknown | undefined;
+    constructor(message: string, code: "STORE_NOT_FOUND" | "RENDERER_WRITE_DISABLED" | "SERIALIZATION_FAILED" | "IPC_FAILED" | "SERVICE_NOT_FOUND" | "SERVICE_METHOD_NOT_FOUND" | "ALREADY_INITIALIZED", storeId?: string | undefined, originalError?: unknown | undefined);
+}
+type ServiceHandler = (...args: unknown[]) => Promise<unknown>;
+type ServiceHandlers = Record<string, ServiceHandler>;
+type ServiceHooks = {
+    beforeAll?: (methodName: string, args: unknown[]) => void | Promise<void>;
+    afterAll?: (methodName: string, result: unknown, duration: number) => void | Promise<void>;
+};
+type ServiceDefinition<T extends ServiceHandlers = ServiceHandlers> = {
+    handlers: T;
+    beforeAll?: (methodName: string, args: unknown[]) => void | Promise<void>;
+    afterAll?: (methodName: string, result: unknown, duration: number) => void | Promise<void>;
+};
+
+export { type ErrorHandler as E, NanoStoreIPCError as N, type Snapshot as S, type ServiceHandlers as a, type ServiceDefinition as b, type ServiceHooks as c };

package/dist/universal/index.d.mts

@@ -0,0 +1,124 @@
+import { a as ServiceHandlers, c as ServiceHooks, E as ErrorHandler } from '../types-CyJJt8gf.mjs';
+import * as nanostores from 'nanostores';
+import { WritableAtom } from 'nanostores';
+
+interface DefineServiceOptions<THandlers extends ServiceHandlers> {
+    /**
+     * Service identifier - must be unique across your app
+     */
+    id: string;
+    /**
+     * Service method handlers
+     * Main: executed locally
+     * Renderer: creates RPC proxy
+     */
+    handlers: THandlers;
+    /**
+     * Optional middleware hooks for Main process only
+     */
+    hooks?: ServiceHooks;
+    /**
+     * Window global name used by preload exposure.
+     * Default: "nanostoreIPC"
+     */
+    globalName?: string;
+}
+type ServiceProxy<THandlers extends ServiceHandlers> = {
+    [K in keyof THandlers]: THandlers[K] extends (...args: infer Args) => Promise<infer Return> ? (...args: Args) => Promise<Return> : never;
+} & {
+    /**
+     * Subscribe to service events (Renderer only)
+     */
+    on: (eventName: string, callback: (data: unknown) => void) => () => void;
+    /**
+     * Broadcast an event to all renderer windows (Main only)
+     */
+    broadcast: (eventName: string, data?: unknown) => void;
+};
+/**
+ * Define a service that works in both Main and Renderer processes.
+ *
+ * **Main Process:**
+ * - Registers handlers to be called via IPC
+ * - Returns proxy with broadcast() method for sending events
+ * - Handlers execute locally
+ *
+ * **Renderer Process:**
+ * - Returns RPC proxy that calls Main process via IPC
+ * - Returns proxy with on() method for listening to events
+ * - All methods are async and execute remotely
+ *
+ * @example
+ * ```ts
+ * // shared/services/todoService.ts
+ * export const todoService = defineService({
+ *   id: 'todos',
+ *   handlers: {
+ *     async addTodo(text: string) {
+ *       const todo = { id: Date.now(), text };
+ *       todos.push(todo);
+ *       todoService.broadcast('todoAdded', todo); // Main only
+ *       return todo;
+ *     },
+ *     async getTodos() {
+ *       return todos;
+ *     }
+ *   }
+ * });
+ *
+ * // Main process (electron/main.ts)
+ * import './shared/services/todoService'; // Auto-registers
+ *
+ * // Renderer (React component)
+ * const todo = await todoService.addTodo('Buy milk'); // RPC call
+ * todoService.on('todoAdded', (todo) => {
+ *   console.log('New todo:', todo);
+ * });
+ * ```
+ */
+declare function defineService<THandlers extends ServiceHandlers>(options: DefineServiceOptions<THandlers>): ServiceProxy<THandlers>;
+
+interface SyncedAtomOptions<T> {
+    /**
+     * If true, renderer writes are blocked even if main allows writes.
+     * Useful to force "actions only" mutability later without breaking API.
+     */
+    rendererCanSet?: boolean;
+    /**
+     * Optional: warn when IPC is not available (e.g. during SSR/tests).
+     */
+    warnIfNoIPC?: boolean;
+    /**
+     * Optional: channel prefix to match init/expose
+     * If you set it here, you must also pass it to expose/init.
+     * If omitted, uses unprefixed channels.
+     */
+    channelPrefix?: string;
+    /**
+     * Window global name used by preload exposure.
+     * Default: "nanostoreIPC"
+     */
+    globalName?: string;
+    /**
+     * Error handler called when errors occur in IPC operations.
+     */
+    onError?: ErrorHandler;
+    /**
+     * Optional value validator. Return false to reject the value.
+     * Can be used for runtime validation (e.g., with Zod).
+     */
+    validateValue?: (value: T) => boolean | Promise<boolean>;
+}
+/**
+ * syncedAtom(id, initial):
+ * - In Electron Main: creates a real atom and registers it for IPC broadcast.
+ * - In Electron Renderer: creates a proxy atom and syncs it via preload-exposed IPC API.
+ * - Outside Electron: behaves as a normal atom(initial).
+ *
+ * No central "bridge definition" required; ID is the single piece of shared contract.
+ */
+declare function syncedAtom<T>(id: string, initial: T, options?: SyncedAtomOptions<T>): (nanostores.PreinitializedWritableAtom<T> & object) | (WritableAtom<T> & {
+    destroy: () => void;
+});
+
+export { type DefineServiceOptions, type SyncedAtomOptions, defineService, syncedAtom };

package/dist/universal/index.d.ts

@@ -0,0 +1,124 @@
+import { a as ServiceHandlers, c as ServiceHooks, E as ErrorHandler } from '../types-CyJJt8gf.js';
+import * as nanostores from 'nanostores';
+import { WritableAtom } from 'nanostores';
+
+interface DefineServiceOptions<THandlers extends ServiceHandlers> {
+    /**
+     * Service identifier - must be unique across your app
+     */
+    id: string;
+    /**
+     * Service method handlers
+     * Main: executed locally
+     * Renderer: creates RPC proxy
+     */
+    handlers: THandlers;
+    /**
+     * Optional middleware hooks for Main process only
+     */
+    hooks?: ServiceHooks;
+    /**
+     * Window global name used by preload exposure.
+     * Default: "nanostoreIPC"
+     */
+    globalName?: string;
+}
+type ServiceProxy<THandlers extends ServiceHandlers> = {
+    [K in keyof THandlers]: THandlers[K] extends (...args: infer Args) => Promise<infer Return> ? (...args: Args) => Promise<Return> : never;
+} & {
+    /**
+     * Subscribe to service events (Renderer only)
+     */
+    on: (eventName: string, callback: (data: unknown) => void) => () => void;
+    /**
+     * Broadcast an event to all renderer windows (Main only)
+     */
+    broadcast: (eventName: string, data?: unknown) => void;
+};
+/**
+ * Define a service that works in both Main and Renderer processes.
+ *
+ * **Main Process:**
+ * - Registers handlers to be called via IPC
+ * - Returns proxy with broadcast() method for sending events
+ * - Handlers execute locally
+ *
+ * **Renderer Process:**
+ * - Returns RPC proxy that calls Main process via IPC
+ * - Returns proxy with on() method for listening to events
+ * - All methods are async and execute remotely
+ *
+ * @example
+ * ```ts
+ * // shared/services/todoService.ts
+ * export const todoService = defineService({
+ *   id: 'todos',
+ *   handlers: {
+ *     async addTodo(text: string) {
+ *       const todo = { id: Date.now(), text };
+ *       todos.push(todo);
+ *       todoService.broadcast('todoAdded', todo); // Main only
+ *       return todo;
+ *     },
+ *     async getTodos() {
+ *       return todos;
+ *     }
+ *   }
+ * });
+ *
+ * // Main process (electron/main.ts)
+ * import './shared/services/todoService'; // Auto-registers
+ *
+ * // Renderer (React component)
+ * const todo = await todoService.addTodo('Buy milk'); // RPC call
+ * todoService.on('todoAdded', (todo) => {
+ *   console.log('New todo:', todo);
+ * });
+ * ```
+ */
+declare function defineService<THandlers extends ServiceHandlers>(options: DefineServiceOptions<THandlers>): ServiceProxy<THandlers>;
+
+interface SyncedAtomOptions<T> {
+    /**
+     * If true, renderer writes are blocked even if main allows writes.
+     * Useful to force "actions only" mutability later without breaking API.
+     */
+    rendererCanSet?: boolean;
+    /**
+     * Optional: warn when IPC is not available (e.g. during SSR/tests).
+     */
+    warnIfNoIPC?: boolean;
+    /**
+     * Optional: channel prefix to match init/expose
+     * If you set it here, you must also pass it to expose/init.
+     * If omitted, uses unprefixed channels.
+     */
+    channelPrefix?: string;
+    /**
+     * Window global name used by preload exposure.
+     * Default: "nanostoreIPC"
+     */
+    globalName?: string;
+    /**
+     * Error handler called when errors occur in IPC operations.
+     */
+    onError?: ErrorHandler;
+    /**
+     * Optional value validator. Return false to reject the value.
+     * Can be used for runtime validation (e.g., with Zod).
+     */
+    validateValue?: (value: T) => boolean | Promise<boolean>;
+}
+/**
+ * syncedAtom(id, initial):
+ * - In Electron Main: creates a real atom and registers it for IPC broadcast.
+ * - In Electron Renderer: creates a proxy atom and syncs it via preload-exposed IPC API.
+ * - Outside Electron: behaves as a normal atom(initial).
+ *
+ * No central "bridge definition" required; ID is the single piece of shared contract.
+ */
+declare function syncedAtom<T>(id: string, initial: T, options?: SyncedAtomOptions<T>): (nanostores.PreinitializedWritableAtom<T> & object) | (WritableAtom<T> & {
+    destroy: () => void;
+});
+
+export { type DefineServiceOptions, type SyncedAtomOptions, defineService, syncedAtom };