shared-state-bridge 1.0.0

package/dist/index.cjs

@@ -0,0 +1,125 @@
+'use strict';
+
+// src/core/utils.ts
+function isFunction(value) {
+  return typeof value === "function";
+}
+
+// src/core/registry.ts
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("shared-state-bridge.registry");
+function getRegistry() {
+  const g = globalThis;
+  if (!g[REGISTRY_KEY]) {
+    g[REGISTRY_KEY] = /* @__PURE__ */ new Map();
+  }
+  return g[REGISTRY_KEY];
+}
+function registerBridge(name, bridge) {
+  const registry = getRegistry();
+  if (registry.has(name)) {
+    throw new Error(
+      `[shared-state-bridge] A bridge named "${name}" already exists. Use getBridge("${name}") to access it, or destroy the existing one first.`
+    );
+  }
+  registry.set(name, bridge);
+}
+function unregisterBridge(name) {
+  getRegistry().delete(name);
+}
+function getBridge(name) {
+  const registry = getRegistry();
+  const bridge = registry.get(name);
+  if (!bridge) {
+    throw new Error(
+      `[shared-state-bridge] No bridge named "${name}" found. Make sure createBridge({ name: "${name}" }) is called before getBridge().`
+    );
+  }
+  return bridge;
+}
+function hasBridge(name) {
+  return getRegistry().has(name);
+}
+function listBridges() {
+  return Array.from(getRegistry().keys());
+}
+
+// src/core/bridge.ts
+function createBridge(config) {
+  const { name, initialState, plugins = [] } = config;
+  let state = initialState;
+  const frozenInitialState = initialState;
+  const listeners = /* @__PURE__ */ new Set();
+  let isDestroyed = false;
+  const getState = () => state;
+  const getInitialState = () => frozenInitialState;
+  const getName = () => name;
+  const setState = (partial, replace) => {
+    if (isDestroyed) return;
+    const previousState = state;
+    const nextPartial = isFunction(partial) ? partial(state) : partial;
+    if (replace) {
+      state = nextPartial;
+    } else {
+      state = Object.assign({}, state, nextPartial);
+    }
+    if (!Object.is(state, previousState)) {
+      listeners.forEach((listener) => listener(state, previousState));
+      plugins.forEach((plugin) => plugin.onStateChange?.(state, previousState));
+    }
+  };
+  const subscribe = (selectorOrListener, listenerOrUndefined, options) => {
+    if (isDestroyed) return () => {
+    };
+    if (typeof listenerOrUndefined === "undefined") {
+      const listener = selectorOrListener;
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+    const selector = selectorOrListener;
+    const selectorListener = listenerOrUndefined;
+    const equalityFn = options?.equalityFn ?? Object.is;
+    let previousSlice = selector(state);
+    const internalListener = (currentState) => {
+      const nextSlice = selector(currentState);
+      if (!equalityFn(previousSlice, nextSlice)) {
+        const prevSlice = previousSlice;
+        previousSlice = nextSlice;
+        selectorListener(nextSlice, prevSlice);
+      }
+    };
+    listeners.add(internalListener);
+    if (options?.fireImmediately) {
+      selectorListener(previousSlice, previousSlice);
+    }
+    return () => {
+      listeners.delete(internalListener);
+    };
+  };
+  const destroy = () => {
+    if (isDestroyed) return;
+    unregisterBridge(name);
+    plugins.forEach((plugin) => plugin.onDestroy?.());
+    listeners.clear();
+    isDestroyed = true;
+  };
+  const api = {
+    getState,
+    setState,
+    subscribe,
+    getInitialState,
+    destroy,
+    getName
+  };
+  registerBridge(name, api);
+  plugins.forEach((plugin) => plugin.onInit?.(api));
+  return api;
+}
+
+exports.createBridge = createBridge;
+exports.getBridge = getBridge;
+exports.hasBridge = hasBridge;
+exports.listBridges = listBridges;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/utils.ts","../src/core/registry.ts","../src/core/bridge.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Shallow equality comparison for objects.\n * Returns true if both arguments have the same keys with Object.is-equal values.\n */\nexport function shallowEqual<T>(a: T, b: T): boolean {\n  if (Object.is(a, b)) return true\n  if (typeof a !== 'object' || typeof b !== 'object') return false\n  if (a === null || b === null) return false\n\n  const keysA = Object.keys(a as object)\n  const keysB = Object.keys(b as object)\n\n  if (keysA.length !== keysB.length) return false\n\n  for (const key of keysA) {\n    if (\n      !Object.prototype.hasOwnProperty.call(b, key) ||\n      !Object.is(\n        (a as Record<string, unknown>)[key],\n        (b as Record<string, unknown>)[key],\n      )\n    ) {\n      return false\n    }\n  }\n\n  return true\n}\n\n/** Type guard for functions */\nexport function isFunction(value: unknown): value is (...args: unknown[]) => unknown {\n  return typeof value === 'function'\n}\n\n/**\n * Throttle function execution. Executes at most once per intervalMs.\n * Trailing calls are preserved (the last call during a throttle window\n * will fire after the interval).\n */\nexport function throttle<T extends (...args: never[]) => void>(\n  fn: T,\n  intervalMs: number,\n): ((...args: Parameters<T>) => void) {\n  let lastCall = 0\n  let timeoutId: ReturnType<typeof setTimeout> | null = null\n  let latestArgs: Parameters<T>\n\n  return (...args: Parameters<T>) => {\n    latestArgs = args\n    const now = Date.now()\n    const remaining = intervalMs - (now - lastCall)\n\n    if (remaining <= 0) {\n      if (timeoutId) {\n        clearTimeout(timeoutId)\n        timeoutId = null\n      }\n      lastCall = now\n      fn(...latestArgs)\n    } else if (!timeoutId) {\n      timeoutId = setTimeout(() => {\n        lastCall = Date.now()\n        timeoutId = null\n        fn(...latestArgs)\n      }, remaining)\n    }\n  }\n}\n","import type { State, BridgeApi } from './types'\n\n/**\n * Unique symbol key for the global registry.\n *\n * Symbol.for() returns the SAME symbol across all modules, even if\n * shared-state-bridge is accidentally duplicated in node_modules.\n * This is the critical trick that makes cross-package sharing work\n * in monorepos.\n */\nconst REGISTRY_KEY = Symbol.for('shared-state-bridge.registry')\n\nfunction getRegistry(): Map<string, BridgeApi<State>> {\n  const g = globalThis as Record<symbol, Map<string, BridgeApi<State>>>\n  if (!g[REGISTRY_KEY]) {\n    g[REGISTRY_KEY] = new Map()\n  }\n  return g[REGISTRY_KEY]\n}\n\n/**\n * Register a bridge in the global registry.\n * Throws if a bridge with the same name already exists.\n * @internal Called by createBridge\n */\nexport function registerBridge<T extends State>(\n  name: string,\n  bridge: BridgeApi<T>,\n): void {\n  const registry = getRegistry()\n  if (registry.has(name)) {\n    throw new Error(\n      `[shared-state-bridge] A bridge named \"${name}\" already exists. ` +\n        `Use getBridge(\"${name}\") to access it, or destroy the existing one first.`,\n    )\n  }\n  registry.set(name, bridge as BridgeApi<State>)\n}\n\n/**\n * Remove a bridge from the global registry.\n * @internal Called by bridge.destroy()\n */\nexport function unregisterBridge(name: string): void {\n  getRegistry().delete(name)\n}\n\n/**\n * Retrieve a bridge by name from the global registry.\n *\n * Use the generic parameter to assert the expected state shape:\n * ```ts\n * const auth = getBridge<AuthState>('auth')\n * ```\n *\n * @throws If no bridge with that name exists\n */\nexport function getBridge<T extends State = State>(name: string): BridgeApi<T> {\n  const registry = getRegistry()\n  const bridge = registry.get(name)\n  if (!bridge) {\n    throw new Error(\n      `[shared-state-bridge] No bridge named \"${name}\" found. ` +\n        `Make sure createBridge({ name: \"${name}\" }) is called before getBridge().`,\n    )\n  }\n  return bridge as unknown as BridgeApi<T>\n}\n\n/** Check if a bridge exists without throwing */\nexport function hasBridge(name: string): boolean {\n  return getRegistry().has(name)\n}\n\n/** List all registered bridge names (useful for debugging) */\nexport function listBridges(): string[] {\n  return Array.from(getRegistry().keys())\n}\n","import type {\n  State,\n  BridgeConfig,\n  BridgeApi,\n  Listener,\n  SelectorListener,\n  SubscribeOptions,\n} from './types'\nimport { isFunction } from './utils'\nimport { registerBridge, unregisterBridge } from './registry'\n\n/**\n * Create a new Bridge store instance.\n *\n * The bridge is automatically registered in the global registry under\n * `config.name`, making it accessible from any package in a monorepo\n * via `getBridge(name)`.\n *\n * @example\n * ```ts\n * const bridge = createBridge({\n *   name: 'app',\n *   initialState: { count: 0, theme: 'light' },\n * })\n *\n * bridge.setState({ count: 1 })\n * bridge.subscribe(state => console.log(state))\n * ```\n */\nexport function createBridge<T extends State>(config: BridgeConfig<T>): BridgeApi<T> {\n  const { name, initialState, plugins = [] } = config\n\n  let state: T = initialState\n  const frozenInitialState: T = initialState\n  const listeners = new Set<Listener<T>>()\n  let isDestroyed = false\n\n  const getState = (): T => state\n\n  const getInitialState = (): T => frozenInitialState\n\n  const getName = (): string => name\n\n  const setState: BridgeApi<T>['setState'] = (\n    partial: Partial<T> | ((state: T) => Partial<T>) | T | ((state: T) => T),\n    replace?: boolean,\n  ): void => {\n    if (isDestroyed) return\n\n    const previousState = state\n    const nextPartial = isFunction(partial) ? partial(state) : partial\n\n    if (replace) {\n      state = nextPartial as T\n    } else {\n      state = Object.assign({}, state, nextPartial)\n    }\n\n    if (!Object.is(state, previousState)) {\n      listeners.forEach((listener) => listener(state, previousState))\n      plugins.forEach((plugin) => plugin.onStateChange?.(state, previousState))\n    }\n  }\n\n  const subscribe: BridgeApi<T>['subscribe'] = <U = T>(\n    selectorOrListener:\n      | Listener<T>\n      | ((state: T) => U),\n    listenerOrUndefined?: SelectorListener<T, U>,\n    options?: SubscribeOptions<U>,\n  ): (() => void) => {\n    if (isDestroyed) return () => {}\n\n    // Overload 1: subscribe(listener)\n    if (typeof listenerOrUndefined === 'undefined') {\n      const listener = selectorOrListener as Listener<T>\n      listeners.add(listener)\n      return () => {\n        listeners.delete(listener)\n      }\n    }\n\n    // Overload 2: subscribe(selector, listener, options?)\n    const selector = selectorOrListener as (state: T) => U\n    const selectorListener = listenerOrUndefined\n    const equalityFn = options?.equalityFn ?? Object.is\n    let previousSlice = selector(state)\n\n    const internalListener: Listener<T> = (currentState) => {\n      const nextSlice = selector(currentState)\n      if (!equalityFn(previousSlice, nextSlice)) {\n        const prevSlice = previousSlice\n        previousSlice = nextSlice\n        selectorListener(nextSlice, prevSlice)\n      }\n    }\n\n    listeners.add(internalListener)\n\n    if (options?.fireImmediately) {\n      selectorListener(previousSlice, previousSlice)\n    }\n\n    return () => {\n      listeners.delete(internalListener)\n    }\n  }\n\n  const destroy = (): void => {\n    if (isDestroyed) return\n    unregisterBridge(name)\n    plugins.forEach((plugin) => plugin.onDestroy?.())\n    listeners.clear()\n    isDestroyed = true\n  }\n\n  const api: BridgeApi<T> = {\n    getState,\n    setState,\n    subscribe,\n    getInitialState,\n    destroy,\n    getName,\n  }\n\n  registerBridge(name, api)\n  plugins.forEach((plugin) => plugin.onInit?.(api))\n\n  return api\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,114 @@
+/** State must be a plain object */
+type State = Record<string, unknown>;
+/** Full-state change listener */
+type Listener<T extends State> = (state: T, previousState: T) => void;
+/** Selector-based change listener */
+type SelectorListener<_T extends State, U> = (slice: U, previousSlice: U) => void;
+/** setState accepts partial updates or an updater function */
+interface SetState<T extends State> {
+    (partial: Partial<T> | ((state: T) => Partial<T>)): void;
+    (state: T | ((state: T) => T), replace: true): void;
+}
+/** Subscribe overloads: full-state or selector-based */
+interface Subscribe<T extends State> {
+    (listener: Listener<T>): () => void;
+    <U>(selector: (state: T) => U, listener: SelectorListener<T, U>, options?: SubscribeOptions<U>): () => void;
+}
+interface SubscribeOptions<U> {
+    equalityFn?: (a: U, b: U) => boolean;
+    fireImmediately?: boolean;
+}
+/** Plugin lifecycle hooks */
+interface BridgePlugin<T extends State> {
+    name: string;
+    onInit?: (bridge: BridgeApi<T>) => void;
+    onStateChange?: (state: T, previousState: T) => void;
+    onDestroy?: () => void;
+}
+/** Configuration for createBridge */
+interface BridgeConfig<T extends State> {
+    /** Unique name for global registry lookup */
+    name: string;
+    /** Initial state value */
+    initialState: T;
+    /** Optional plugins (e.g. persist) */
+    plugins?: BridgePlugin<T>[];
+}
+/** The bridge instance API */
+interface BridgeApi<T extends State> {
+    getState: () => T;
+    setState: SetState<T>;
+    subscribe: Subscribe<T>;
+    getInitialState: () => T;
+    destroy: () => void;
+    getName: () => string;
+}
+/** Storage adapter interface for persistence */
+interface PersistAdapter {
+    getItem: (key: string) => string | null | Promise<string | null>;
+    setItem: (key: string, value: string) => void | Promise<void>;
+    removeItem: (key: string) => void | Promise<void>;
+}
+/** Persistence plugin options */
+interface PersistOptions<T extends State> {
+    /** Storage adapter (localStorageAdapter, asyncStorageAdapter, etc.) */
+    adapter: PersistAdapter;
+    /** Storage key */
+    key: string;
+    /** Only persist these keys */
+    pick?: (keyof T)[];
+    /** Exclude these keys from persistence */
+    omit?: (keyof T)[];
+    /** Custom serializer (default: JSON.stringify) */
+    serialize?: (state: unknown) => string;
+    /** Custom deserializer (default: JSON.parse) */
+    deserialize?: (raw: string) => unknown;
+    /** Schema version for migrations */
+    version?: number;
+    /** Migration function when version changes */
+    migrate?: (persisted: unknown, version: number) => Partial<T>;
+    /** Throttle writes in ms (default: 100) */
+    throttleMs?: number;
+}
+/** Selector function type */
+type Selector<T extends State, U> = (state: T) => U;
+/** Equality function type */
+type EqualityFn<U> = (a: U, b: U) => boolean;
+
+/**
+ * Create a new Bridge store instance.
+ *
+ * The bridge is automatically registered in the global registry under
+ * `config.name`, making it accessible from any package in a monorepo
+ * via `getBridge(name)`.
+ *
+ * @example
+ * ```ts
+ * const bridge = createBridge({
+ *   name: 'app',
+ *   initialState: { count: 0, theme: 'light' },
+ * })
+ *
+ * bridge.setState({ count: 1 })
+ * bridge.subscribe(state => console.log(state))
+ * ```
+ */
+declare function createBridge<T extends State>(config: BridgeConfig<T>): BridgeApi<T>;
+
+/**
+ * Retrieve a bridge by name from the global registry.
+ *
+ * Use the generic parameter to assert the expected state shape:
+ * ```ts
+ * const auth = getBridge<AuthState>('auth')
+ * ```
+ *
+ * @throws If no bridge with that name exists
+ */
+declare function getBridge<T extends State = State>(name: string): BridgeApi<T>;
+/** Check if a bridge exists without throwing */
+declare function hasBridge(name: string): boolean;
+/** List all registered bridge names (useful for debugging) */
+declare function listBridges(): string[];
+
+export { type BridgeApi, type BridgeConfig, type BridgePlugin, type EqualityFn, type Listener, type PersistAdapter, type PersistOptions, type Selector, type SelectorListener, type SetState, type State, type Subscribe, type SubscribeOptions, createBridge, getBridge, hasBridge, listBridges };

package/dist/index.d.ts

@@ -0,0 +1,114 @@
+/** State must be a plain object */
+type State = Record<string, unknown>;
+/** Full-state change listener */
+type Listener<T extends State> = (state: T, previousState: T) => void;
+/** Selector-based change listener */
+type SelectorListener<_T extends State, U> = (slice: U, previousSlice: U) => void;
+/** setState accepts partial updates or an updater function */
+interface SetState<T extends State> {
+    (partial: Partial<T> | ((state: T) => Partial<T>)): void;
+    (state: T | ((state: T) => T), replace: true): void;
+}
+/** Subscribe overloads: full-state or selector-based */
+interface Subscribe<T extends State> {
+    (listener: Listener<T>): () => void;
+    <U>(selector: (state: T) => U, listener: SelectorListener<T, U>, options?: SubscribeOptions<U>): () => void;
+}
+interface SubscribeOptions<U> {
+    equalityFn?: (a: U, b: U) => boolean;
+    fireImmediately?: boolean;
+}
+/** Plugin lifecycle hooks */
+interface BridgePlugin<T extends State> {
+    name: string;
+    onInit?: (bridge: BridgeApi<T>) => void;
+    onStateChange?: (state: T, previousState: T) => void;
+    onDestroy?: () => void;
+}
+/** Configuration for createBridge */
+interface BridgeConfig<T extends State> {
+    /** Unique name for global registry lookup */
+    name: string;
+    /** Initial state value */
+    initialState: T;
+    /** Optional plugins (e.g. persist) */
+    plugins?: BridgePlugin<T>[];
+}
+/** The bridge instance API */
+interface BridgeApi<T extends State> {
+    getState: () => T;
+    setState: SetState<T>;
+    subscribe: Subscribe<T>;
+    getInitialState: () => T;
+    destroy: () => void;
+    getName: () => string;
+}
+/** Storage adapter interface for persistence */
+interface PersistAdapter {
+    getItem: (key: string) => string | null | Promise<string | null>;
+    setItem: (key: string, value: string) => void | Promise<void>;
+    removeItem: (key: string) => void | Promise<void>;
+}
+/** Persistence plugin options */
+interface PersistOptions<T extends State> {
+    /** Storage adapter (localStorageAdapter, asyncStorageAdapter, etc.) */
+    adapter: PersistAdapter;
+    /** Storage key */
+    key: string;
+    /** Only persist these keys */
+    pick?: (keyof T)[];
+    /** Exclude these keys from persistence */
+    omit?: (keyof T)[];
+    /** Custom serializer (default: JSON.stringify) */
+    serialize?: (state: unknown) => string;
+    /** Custom deserializer (default: JSON.parse) */
+    deserialize?: (raw: string) => unknown;
+    /** Schema version for migrations */
+    version?: number;
+    /** Migration function when version changes */
+    migrate?: (persisted: unknown, version: number) => Partial<T>;
+    /** Throttle writes in ms (default: 100) */
+    throttleMs?: number;
+}
+/** Selector function type */
+type Selector<T extends State, U> = (state: T) => U;
+/** Equality function type */
+type EqualityFn<U> = (a: U, b: U) => boolean;
+
+/**
+ * Create a new Bridge store instance.
+ *
+ * The bridge is automatically registered in the global registry under
+ * `config.name`, making it accessible from any package in a monorepo
+ * via `getBridge(name)`.
+ *
+ * @example
+ * ```ts
+ * const bridge = createBridge({
+ *   name: 'app',
+ *   initialState: { count: 0, theme: 'light' },
+ * })
+ *
+ * bridge.setState({ count: 1 })
+ * bridge.subscribe(state => console.log(state))
+ * ```
+ */
+declare function createBridge<T extends State>(config: BridgeConfig<T>): BridgeApi<T>;
+
+/**
+ * Retrieve a bridge by name from the global registry.
+ *
+ * Use the generic parameter to assert the expected state shape:
+ * ```ts
+ * const auth = getBridge<AuthState>('auth')
+ * ```
+ *
+ * @throws If no bridge with that name exists
+ */
+declare function getBridge<T extends State = State>(name: string): BridgeApi<T>;
+/** Check if a bridge exists without throwing */
+declare function hasBridge(name: string): boolean;
+/** List all registered bridge names (useful for debugging) */
+declare function listBridges(): string[];
+
+export { type BridgeApi, type BridgeConfig, type BridgePlugin, type EqualityFn, type Listener, type PersistAdapter, type PersistOptions, type Selector, type SelectorListener, type SetState, type State, type Subscribe, type SubscribeOptions, createBridge, getBridge, hasBridge, listBridges };

package/dist/index.js

@@ -0,0 +1,120 @@
+// src/core/utils.ts
+function isFunction(value) {
+  return typeof value === "function";
+}
+
+// src/core/registry.ts
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("shared-state-bridge.registry");
+function getRegistry() {
+  const g = globalThis;
+  if (!g[REGISTRY_KEY]) {
+    g[REGISTRY_KEY] = /* @__PURE__ */ new Map();
+  }
+  return g[REGISTRY_KEY];
+}
+function registerBridge(name, bridge) {
+  const registry = getRegistry();
+  if (registry.has(name)) {
+    throw new Error(
+      `[shared-state-bridge] A bridge named "${name}" already exists. Use getBridge("${name}") to access it, or destroy the existing one first.`
+    );
+  }
+  registry.set(name, bridge);
+}
+function unregisterBridge(name) {
+  getRegistry().delete(name);
+}
+function getBridge(name) {
+  const registry = getRegistry();
+  const bridge = registry.get(name);
+  if (!bridge) {
+    throw new Error(
+      `[shared-state-bridge] No bridge named "${name}" found. Make sure createBridge({ name: "${name}" }) is called before getBridge().`
+    );
+  }
+  return bridge;
+}
+function hasBridge(name) {
+  return getRegistry().has(name);
+}
+function listBridges() {
+  return Array.from(getRegistry().keys());
+}
+
+// src/core/bridge.ts
+function createBridge(config) {
+  const { name, initialState, plugins = [] } = config;
+  let state = initialState;
+  const frozenInitialState = initialState;
+  const listeners = /* @__PURE__ */ new Set();
+  let isDestroyed = false;
+  const getState = () => state;
+  const getInitialState = () => frozenInitialState;
+  const getName = () => name;
+  const setState = (partial, replace) => {
+    if (isDestroyed) return;
+    const previousState = state;
+    const nextPartial = isFunction(partial) ? partial(state) : partial;
+    if (replace) {
+      state = nextPartial;
+    } else {
+      state = Object.assign({}, state, nextPartial);
+    }
+    if (!Object.is(state, previousState)) {
+      listeners.forEach((listener) => listener(state, previousState));
+      plugins.forEach((plugin) => plugin.onStateChange?.(state, previousState));
+    }
+  };
+  const subscribe = (selectorOrListener, listenerOrUndefined, options) => {
+    if (isDestroyed) return () => {
+    };
+    if (typeof listenerOrUndefined === "undefined") {
+      const listener = selectorOrListener;
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+    const selector = selectorOrListener;
+    const selectorListener = listenerOrUndefined;
+    const equalityFn = options?.equalityFn ?? Object.is;
+    let previousSlice = selector(state);
+    const internalListener = (currentState) => {
+      const nextSlice = selector(currentState);
+      if (!equalityFn(previousSlice, nextSlice)) {
+        const prevSlice = previousSlice;
+        previousSlice = nextSlice;
+        selectorListener(nextSlice, prevSlice);
+      }
+    };
+    listeners.add(internalListener);
+    if (options?.fireImmediately) {
+      selectorListener(previousSlice, previousSlice);
+    }
+    return () => {
+      listeners.delete(internalListener);
+    };
+  };
+  const destroy = () => {
+    if (isDestroyed) return;
+    unregisterBridge(name);
+    plugins.forEach((plugin) => plugin.onDestroy?.());
+    listeners.clear();
+    isDestroyed = true;
+  };
+  const api = {
+    getState,
+    setState,
+    subscribe,
+    getInitialState,
+    destroy,
+    getName
+  };
+  registerBridge(name, api);
+  plugins.forEach((plugin) => plugin.onInit?.(api));
+  return api;
+}
+
+export { createBridge, getBridge, hasBridge, listBridges };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/utils.ts","../src/core/registry.ts","../src/core/bridge.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Shallow equality comparison for objects.\n * Returns true if both arguments have the same keys with Object.is-equal values.\n */\nexport function shallowEqual<T>(a: T, b: T): boolean {\n  if (Object.is(a, b)) return true\n  if (typeof a !== 'object' || typeof b !== 'object') return false\n  if (a === null || b === null) return false\n\n  const keysA = Object.keys(a as object)\n  const keysB = Object.keys(b as object)\n\n  if (keysA.length !== keysB.length) return false\n\n  for (const key of keysA) {\n    if (\n      !Object.prototype.hasOwnProperty.call(b, key) ||\n      !Object.is(\n        (a as Record<string, unknown>)[key],\n        (b as Record<string, unknown>)[key],\n      )\n    ) {\n      return false\n    }\n  }\n\n  return true\n}\n\n/** Type guard for functions */\nexport function isFunction(value: unknown): value is (...args: unknown[]) => unknown {\n  return typeof value === 'function'\n}\n\n/**\n * Throttle function execution. Executes at most once per intervalMs.\n * Trailing calls are preserved (the last call during a throttle window\n * will fire after the interval).\n */\nexport function throttle<T extends (...args: never[]) => void>(\n  fn: T,\n  intervalMs: number,\n): ((...args: Parameters<T>) => void) {\n  let lastCall = 0\n  let timeoutId: ReturnType<typeof setTimeout> | null = null\n  let latestArgs: Parameters<T>\n\n  return (...args: Parameters<T>) => {\n    latestArgs = args\n    const now = Date.now()\n    const remaining = intervalMs - (now - lastCall)\n\n    if (remaining <= 0) {\n      if (timeoutId) {\n        clearTimeout(timeoutId)\n        timeoutId = null\n      }\n      lastCall = now\n      fn(...latestArgs)\n    } else if (!timeoutId) {\n      timeoutId = setTimeout(() => {\n        lastCall = Date.now()\n        timeoutId = null\n        fn(...latestArgs)\n      }, remaining)\n    }\n  }\n}\n","import type { State, BridgeApi } from './types'\n\n/**\n * Unique symbol key for the global registry.\n *\n * Symbol.for() returns the SAME symbol across all modules, even if\n * shared-state-bridge is accidentally duplicated in node_modules.\n * This is the critical trick that makes cross-package sharing work\n * in monorepos.\n */\nconst REGISTRY_KEY = Symbol.for('shared-state-bridge.registry')\n\nfunction getRegistry(): Map<string, BridgeApi<State>> {\n  const g = globalThis as Record<symbol, Map<string, BridgeApi<State>>>\n  if (!g[REGISTRY_KEY]) {\n    g[REGISTRY_KEY] = new Map()\n  }\n  return g[REGISTRY_KEY]\n}\n\n/**\n * Register a bridge in the global registry.\n * Throws if a bridge with the same name already exists.\n * @internal Called by createBridge\n */\nexport function registerBridge<T extends State>(\n  name: string,\n  bridge: BridgeApi<T>,\n): void {\n  const registry = getRegistry()\n  if (registry.has(name)) {\n    throw new Error(\n      `[shared-state-bridge] A bridge named \"${name}\" already exists. ` +\n        `Use getBridge(\"${name}\") to access it, or destroy the existing one first.`,\n    )\n  }\n  registry.set(name, bridge as BridgeApi<State>)\n}\n\n/**\n * Remove a bridge from the global registry.\n * @internal Called by bridge.destroy()\n */\nexport function unregisterBridge(name: string): void {\n  getRegistry().delete(name)\n}\n\n/**\n * Retrieve a bridge by name from the global registry.\n *\n * Use the generic parameter to assert the expected state shape:\n * ```ts\n * const auth = getBridge<AuthState>('auth')\n * ```\n *\n * @throws If no bridge with that name exists\n */\nexport function getBridge<T extends State = State>(name: string): BridgeApi<T> {\n  const registry = getRegistry()\n  const bridge = registry.get(name)\n  if (!bridge) {\n    throw new Error(\n      `[shared-state-bridge] No bridge named \"${name}\" found. ` +\n        `Make sure createBridge({ name: \"${name}\" }) is called before getBridge().`,\n    )\n  }\n  return bridge as unknown as BridgeApi<T>\n}\n\n/** Check if a bridge exists without throwing */\nexport function hasBridge(name: string): boolean {\n  return getRegistry().has(name)\n}\n\n/** List all registered bridge names (useful for debugging) */\nexport function listBridges(): string[] {\n  return Array.from(getRegistry().keys())\n}\n","import type {\n  State,\n  BridgeConfig,\n  BridgeApi,\n  Listener,\n  SelectorListener,\n  SubscribeOptions,\n} from './types'\nimport { isFunction } from './utils'\nimport { registerBridge, unregisterBridge } from './registry'\n\n/**\n * Create a new Bridge store instance.\n *\n * The bridge is automatically registered in the global registry under\n * `config.name`, making it accessible from any package in a monorepo\n * via `getBridge(name)`.\n *\n * @example\n * ```ts\n * const bridge = createBridge({\n *   name: 'app',\n *   initialState: { count: 0, theme: 'light' },\n * })\n *\n * bridge.setState({ count: 1 })\n * bridge.subscribe(state => console.log(state))\n * ```\n */\nexport function createBridge<T extends State>(config: BridgeConfig<T>): BridgeApi<T> {\n  const { name, initialState, plugins = [] } = config\n\n  let state: T = initialState\n  const frozenInitialState: T = initialState\n  const listeners = new Set<Listener<T>>()\n  let isDestroyed = false\n\n  const getState = (): T => state\n\n  const getInitialState = (): T => frozenInitialState\n\n  const getName = (): string => name\n\n  const setState: BridgeApi<T>['setState'] = (\n    partial: Partial<T> | ((state: T) => Partial<T>) | T | ((state: T) => T),\n    replace?: boolean,\n  ): void => {\n    if (isDestroyed) return\n\n    const previousState = state\n    const nextPartial = isFunction(partial) ? partial(state) : partial\n\n    if (replace) {\n      state = nextPartial as T\n    } else {\n      state = Object.assign({}, state, nextPartial)\n    }\n\n    if (!Object.is(state, previousState)) {\n      listeners.forEach((listener) => listener(state, previousState))\n      plugins.forEach((plugin) => plugin.onStateChange?.(state, previousState))\n    }\n  }\n\n  const subscribe: BridgeApi<T>['subscribe'] = <U = T>(\n    selectorOrListener:\n      | Listener<T>\n      | ((state: T) => U),\n    listenerOrUndefined?: SelectorListener<T, U>,\n    options?: SubscribeOptions<U>,\n  ): (() => void) => {\n    if (isDestroyed) return () => {}\n\n    // Overload 1: subscribe(listener)\n    if (typeof listenerOrUndefined === 'undefined') {\n      const listener = selectorOrListener as Listener<T>\n      listeners.add(listener)\n      return () => {\n        listeners.delete(listener)\n      }\n    }\n\n    // Overload 2: subscribe(selector, listener, options?)\n    const selector = selectorOrListener as (state: T) => U\n    const selectorListener = listenerOrUndefined\n    const equalityFn = options?.equalityFn ?? Object.is\n    let previousSlice = selector(state)\n\n    const internalListener: Listener<T> = (currentState) => {\n      const nextSlice = selector(currentState)\n      if (!equalityFn(previousSlice, nextSlice)) {\n        const prevSlice = previousSlice\n        previousSlice = nextSlice\n        selectorListener(nextSlice, prevSlice)\n      }\n    }\n\n    listeners.add(internalListener)\n\n    if (options?.fireImmediately) {\n      selectorListener(previousSlice, previousSlice)\n    }\n\n    return () => {\n      listeners.delete(internalListener)\n    }\n  }\n\n  const destroy = (): void => {\n    if (isDestroyed) return\n    unregisterBridge(name)\n    plugins.forEach((plugin) => plugin.onDestroy?.())\n    listeners.clear()\n    isDestroyed = true\n  }\n\n  const api: BridgeApi<T> = {\n    getState,\n    setState,\n    subscribe,\n    getInitialState,\n    destroy,\n    getName,\n  }\n\n  registerBridge(name, api)\n  plugins.forEach((plugin) => plugin.onInit?.(api))\n\n  return api\n}\n"]}

package/dist/persist.cjs

@@ -0,0 +1,147 @@
+'use strict';
+
+// src/core/utils.ts
+function throttle(fn, intervalMs) {
+  let lastCall = 0;
+  let timeoutId = null;
+  let latestArgs;
+  return (...args) => {
+    latestArgs = args;
+    const now = Date.now();
+    const remaining = intervalMs - (now - lastCall);
+    if (remaining <= 0) {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+        timeoutId = null;
+      }
+      lastCall = now;
+      fn(...latestArgs);
+    } else if (!timeoutId) {
+      timeoutId = setTimeout(() => {
+        lastCall = Date.now();
+        timeoutId = null;
+        fn(...latestArgs);
+      }, remaining);
+    }
+  };
+}
+
+// src/persist/plugin.ts
+function persist(options) {
+  const {
+    adapter,
+    key,
+    pick,
+    omit,
+    serialize = JSON.stringify,
+    deserialize = JSON.parse,
+    version = 0,
+    migrate,
+    throttleMs = 100
+  } = options;
+  let writeToStorage = null;
+  function filterState(state) {
+    if (pick) {
+      const filtered = {};
+      for (const k of pick) {
+        if (k in state) {
+          filtered[k] = state[k];
+        }
+      }
+      return filtered;
+    }
+    if (omit) {
+      const filtered = { ...state };
+      for (const k of omit) {
+        delete filtered[k];
+      }
+      return filtered;
+    }
+    return state;
+  }
+  return {
+    name: "persist",
+    onInit: (bridge) => {
+      writeToStorage = throttle((state) => {
+        const filtered = filterState(state);
+        const envelope = { state: filtered, version };
+        adapter.setItem(key, serialize(envelope));
+      }, throttleMs);
+      const hydrate = async () => {
+        try {
+          const raw = await adapter.getItem(key);
+          if (raw === null) return;
+          const envelope = deserialize(raw);
+          let persisted = envelope.state;
+          const persistedVersion = envelope.version ?? 0;
+          if (persistedVersion !== version) {
+            if (migrate) {
+              persisted = migrate(persisted, persistedVersion);
+            } else {
+              await adapter.removeItem(key);
+              return;
+            }
+          }
+          bridge.setState(persisted);
+        } catch {
+        }
+      };
+      hydrate();
+    },
+    onStateChange: (state) => {
+      writeToStorage?.(state);
+    },
+    onDestroy: () => {
+      writeToStorage = null;
+    }
+  };
+}
+
+// src/persist/adapters.ts
+var localStorageAdapter = {
+  getItem: (key) => {
+    try {
+      return globalThis.localStorage.getItem(key);
+    } catch {
+      return null;
+    }
+  },
+  setItem: (key, value) => {
+    try {
+      globalThis.localStorage.setItem(key, value);
+    } catch {
+    }
+  },
+  removeItem: (key) => {
+    try {
+      globalThis.localStorage.removeItem(key);
+    } catch {
+    }
+  }
+};
+function asyncStorageAdapter(asyncStorage) {
+  return {
+    getItem: (key) => asyncStorage.getItem(key),
+    setItem: (key, value) => asyncStorage.setItem(key, value),
+    removeItem: (key) => asyncStorage.removeItem(key)
+  };
+}
+function memoryAdapter() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    getItem: (key) => store.get(key) ?? null,
+    setItem: (key, value) => {
+      store.set(key, value);
+    },
+    removeItem: (key) => {
+      store.delete(key);
+    }
+  };
+}
+
+exports.asyncStorageAdapter = asyncStorageAdapter;
+exports.localStorageAdapter = localStorageAdapter;
+exports.memoryAdapter = memoryAdapter;
+exports.persist = persist;
+//# sourceMappingURL=persist.cjs.map
+//# sourceMappingURL=persist.cjs.map