react-broadcast-sync 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { useBroadcastChannel } from './hooks/useBroadcastChannel';
+export { BroadcastProvider, useBroadcastProvider } from './BroadcastProvider';
+export type { BroadcastOptions, SendMessageOptions, BroadcastMessage, BroadcastActions } from './types/types';

package/dist/index.esm.js

@@ -0,0 +1,2 @@
+import e,{useState as r,useRef as t,useMemo as n,useCallback as s,useEffect as o,createContext as a,useContext as c}from"react";import{jsx as i}from"react/jsx-runtime";const l="__INTERNAL__",u=()=>Math.random().toString(36).substr(2,9),d=(e,r)=>{const t=`${u()}-${e}-${r}`;return btoa(t).replace(/=+$/,"")},p=e=>!!e.expirationDate&&e.expirationDate<Date.now(),E=(e,r,t="")=>{const n=btoa(`react-broadcast-sync:${e}:${`${r}-${t}`}`);return`${l}:${e}:${n}`},f=e=>e.startsWith(`${l}:`),h=(e,r)=>{let t,n=null,s=null,o=null;const a=function(...a){s=a,o=this,null!==n&&clearTimeout(n),n=setTimeout((()=>{n=null,null!==s&&(t=e.apply(o,s),s=null,o=null)}),r)};return a.cancel=()=>{null!==n&&(clearTimeout(n),n=null,s=null,o=null)},a.flush=()=>(null!==n&&(clearTimeout(n),n=null,null!==s&&(t=e.apply(o,s),s=null,o=null)),t),a},v=(e,r,t)=>{if("undefined"==typeof process||!process.env||"true"!==process.env.REACT_APP_DEBUG_BROADCAST)return;const n=`[${(new Date).toISOString()}] [react-broadcast-sync]`;switch(e){case"info":console.log(n,r,t||"");break;case"warn":console.warn(n,r,t||"");break;case"error":console.error(n,r,t||"")}},g={created:e=>v("info","Channel created:",e),closed:e=>v("info","Channel closed:",e)},S={sent:e=>v("info","Message sent:",e),received:e=>v("info","Message received:",e),cleared:e=>v("info","Message cleared:",e),expired:e=>v("info","Message expired:",e),duplicate:e=>v("warn","Duplicate message ignored:",e)},A={started:()=>v("info","Cleanup started"),completed:e=>v("info","Cleanup completed:",{removedCount:e})},m=e=>v("error","Error:",e),C="CLEAR_MESSAGE",L="CLEAR_ALL_MESSAGES",M=(e,a={})=>{const{sourceName:c,cleaningInterval:i=1e3,keepLatestMessage:l=!1,registeredTypes:v=[],namespace:M="",deduplicationTTL:y=3e5,cleanupDebounceMs:_=0}=a,[b,w]=r([]),[D,R]=r([]),[$,G]=r(null),B=t(null),x=t(new Map),T=t(c||`tab-${u()}`).current,P=t({CLEAR_MESSAGE:E(C,e,M),CLEAR_ALL_MESSAGES:E(L,e,M)}).current,I=n((()=>`${e}-${M}`),[e,M]),k=s((()=>{w((e=>e.filter((e=>!p(e)))))}),[]),N=t(_>0?h(k,_):Object.assign(k,{cancel:()=>{}})).current,j=s((e=>{G(e),setTimeout((()=>G(null)),3e3)}),[]),O=s((e=>{var r;w((r=>r.filter((r=>r.id!==e)))),R((r=>r.filter((r=>r.id!==e)))),null===(r=B.current)||void 0===r||r.postMessage({id:e,type:P.CLEAR_MESSAGE,source:T}),S.cleared(e)}),[T,P.CLEAR_MESSAGE]),F=s((()=>{var e;w([]),R([]),null===(e=B.current)||void 0===e||e.postMessage({id:P.CLEAR_ALL_MESSAGES,type:P.CLEAR_ALL_MESSAGES,source:T})}),[T,P.CLEAR_ALL_MESSAGES]),U=s((e=>{var r;R((r=>r.filter((r=>r.id!==e)))),null===(r=B.current)||void 0===r||r.postMessage({id:e,type:P.CLEAR_MESSAGE,source:T})}),[T,P.CLEAR_MESSAGE]),W=s(((e,r,t={})=>{const n=B.current;if(!n){const e="Channel not available";return m(e),void j(e)}try{const s=((e,r,t,n={})=>{var s;const o=Date.now();return{id:d(t,o),type:e,message:r,timestamp:o,source:t,expirationDate:null!==(s=n.expirationDate)&&void 0!==s?s:n.expirationDuration?o+n.expirationDuration:void 0}})(e,r,T,t);n.postMessage(s),S.sent(s),R((e=>[...e,s]))}catch(e){const r="Failed to send message";m(r),j(r)}}),[T,j]),q=s((e=>{try{const r=e.data;if(S.received(r),!(e=>Boolean(e&&"object"==typeof e&&"id"in e))(r))return;if(r.source===T)return;if(!f(r.type)&&v.length>0&&!v.includes(r.type))return;if(p(r))return void S.expired(r.id);if((e=>e&&"object"==typeof e&&"string"==typeof e.id&&"string"==typeof e.source&&"string"==typeof e.type&&f(e.type))(r)){if(r.type===P.CLEAR_MESSAGE)return void w((e=>e.filter((e=>!(e.id===r.id&&e.source===r.source)))));if(r.type===P.CLEAR_ALL_MESSAGES)return void w((e=>e.filter((e=>e.source!==r.source))))}const t=Date.now(),n=x.current.get(r.id);if(n&&t-n<y)return void S.duplicate(r.id);x.current.set(r.id,t),w((e=>l?[r]:[...e,r]))}catch(e){const r="Error processing broadcast message";m(r),j(r)}}),[T,v,l,j,P,y]);return o((()=>{if("undefined"==typeof BroadcastChannel){const e="BroadcastChannel is not supported in this browser. Please check browser compatibility.";return m(e),void j(e)}const e=new BroadcastChannel(I);return B.current=e,g.created(I),e.addEventListener("message",q),()=>{e.removeEventListener("message",q),e.close(),g.closed(I)}}),[I,q,j]),o((()=>{if(i<=0)return;const e=setInterval((()=>{A.started();const e=b.length;N(),A.completed(e-b.length)}),i);return()=>{var r;clearInterval(e),_>0&&(null===(r=N.cancel)||void 0===r||r.call(N))}}),[i,N,_]),o((()=>{const e=setInterval((()=>{const e=Date.now();for(const[r,t]of x.current.entries())e-t>=y&&x.current.delete(r)}),6e4);return()=>clearInterval(e)}),[y]),{channelName:I,messages:b,sentMessages:D,postMessage:W,clearMessage:O,clearAllMessages:F,clearSentMessage:U,error:$}},y=a(void 0);class _ extends e.Component{constructor(){super(...arguments),this.state={hasError:!1}}static getDerivedStateFromError(){return{hasError:!0}}componentDidCatch(e){console.error("BroadcastChannel error:",e)}render(){return this.state.hasError?i("div",{children:"Error occurred in BroadcastProvider"}):this.props.children}}const b=({children:r,channelName:s})=>{const{messages:a,error:c}=M(s),[l,u]=e.useState(null),d=t(null);o((()=>{if("undefined"==typeof BroadcastChannel)return void u("BroadcastChannel is not supported in this browser. Please check browser compatibility.");const e=new BroadcastChannel(s);return d.current=e,()=>{e.close()}}),[s]);const p=n((()=>({messages:a,error:l||c,channel:d.current})),[a,l,c]);return i(_,{children:i(y.Provider,{value:p,children:r})})},w=()=>{const e=c(y);if(!e)throw new Error("useBroadcastProvider must be used within a BroadcastProvider");return e};export{b as BroadcastProvider,M as useBroadcastChannel,w as useBroadcastProvider};
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/utils/messageUtils.ts","../src/utils/debug.ts","../src/hooks/useBroadcastChannel.ts","../src/BroadcastProvider.tsx"],"sourcesContent":[null,null,null,null],"names":["INTERNAL_PREFIX","generateRandomPart","Math","random","toString","substr","generateMessageId","source","timestamp","raw","btoa","replace","isMessageExpired","message","expirationDate","Date","now","getInternalMessageType","baseType","channelName","namespace","hash","isInternalType","type","startsWith","debounce","fn","wait","result","timeoutId","lastArgs","lastThis","debounced","args","this","clearTimeout","setTimeout","apply","cancel","flush","log","level","data","process","env","REACT_APP_DEBUG_BROADCAST","prefix","toISOString","console","warn","error","debug","created","closed","sent","received","cleared","messageId","expired","duplicate","started","completed","removedCount","INTERNAL_MESSAGE_TYPES","useBroadcastChannel","options","sourceName","cleaningInterval","keepLatestMessage","registeredTypes","deduplicationTTL","cleanupDebounceMs","messages","setMessages","useState","sentMessages","setSentMessages","setError","channel","useRef","receivedMessageIds","Map","current","internalTypes","CLEAR_MESSAGE","CLEAR_ALL_MESSAGES","resolvedChannelName","useMemo","performCleanup","useCallback","prev","filter","msg","debouncedCleanup","Object","assign","setErrorMessage","clearMessage","id","_a","postMessage","clearAllMessages","clearSentMessage","messageType","messageContent","channelCurrent","createMessage","content","expirationDuration","undefined","e","handleMessage","event","Boolean","isValidMessage","length","includes","isValidInternalClearMessage","receivedAt","get","set","useEffect","BroadcastChannel","bc","addEventListener","removeEventListener","close","interval","setInterval","before","clearInterval","call","entries","delete","BroadcastChannelContext","createContext","ErrorBoundary","React","Component","constructor","state","hasError","getDerivedStateFromError","componentDidCatch","render","_jsx","props","children","BroadcastProvider","hookError","value","Provider","useBroadcastProvider","context","useContext","Error"],"mappings":"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"}

package/dist/types/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Options for configuring the broadcast channel
+ */
+export interface BroadcastOptions {
+    /** Custom source name for this instance */
+    sourceName?: string;
+    /** Interval in milliseconds for cleaning expired messages (default: 1000) */
+    cleaningInterval?: number;
+    /** If true, only the latest message is kept */
+    keepLatestMessage?: boolean;
+    /** Array of allowed message types */
+    registeredTypes?: string[];
+    /** Channel namespace for isolation */
+    namespace?: string;
+    /** TTL for deduplication in milliseconds (default: 5 minutes) */
+    deduplicationTTL?: number;
+    /** Debounce time for messages cleanup in milliseconds (default: 1000) */
+    cleanupDebounceMs?: number;
+}
+/**
+ * Options for sending messages
+ */
+export interface SendMessageOptions {
+    /** Message expiration duration in milliseconds */
+    expirationDuration?: number;
+    /** Specific expiration timestamp */
+    expirationDate?: number;
+}
+/**
+ * Structure of a broadcast message
+ */
+export interface BroadcastMessage {
+    /** Unique message identifier */
+    id: string;
+    /** Message type for categorization */
+    type: string;
+    /** Message content */
+    message: any;
+    /** Creation timestamp */
+    timestamp: number;
+    /** Source identifier */
+    source: string;
+    /** Optional expiration timestamp */
+    expirationDate?: number;
+}
+/**
+ * Actions and state provided by the broadcast channel hook
+ */
+export interface BroadcastActions {
+    /** The resolved channel name including namespace */
+    channelName: string;
+    /** Array of received messages */
+    messages: BroadcastMessage[];
+    /** Array of sent messages */
+    sentMessages: BroadcastMessage[];
+    /** Function to send a message */
+    postMessage: (messageType: string, messageContent: any, options?: SendMessageOptions) => void;
+    /** Function to clear a specific message */
+    clearMessage: (id: string) => void;
+    /** Function to clear all messages */
+    clearAllMessages: () => void;
+    /** Function to clear a specific sent message */
+    clearSentMessage: (id: string) => void;
+    /** Current error state */
+    error: string | null;
+}

package/dist/useBroadcastChannel.d.ts

@@ -0,0 +1,3 @@
+import { BroadcastActions, BroadcastOptions } from './types/types';
+export declare const useBroadcastChannel: (channelName: string, options?: BroadcastOptions) => BroadcastActions;
+export default useBroadcastChannel;

package/dist/utils/debug.d.ts

@@ -0,0 +1,18 @@
+export declare const debug: {
+    channel: {
+        created: (channelName: string) => void;
+        closed: (channelName: string) => void;
+    };
+    message: {
+        sent: (message: any) => void;
+        received: (message: any) => void;
+        cleared: (messageId: string) => void;
+        expired: (messageId: string) => void;
+        duplicate: (messageId: string) => void;
+    };
+    cleanup: {
+        started: () => void;
+        completed: (removedCount: number) => void;
+    };
+    error: (error: string) => void;
+};

package/dist/utils/messageUtils.d.ts

@@ -0,0 +1,22 @@
+export declare const generateRandomPart: () => string;
+export declare const generateSourceName: () => string;
+export declare const generateMessageId: (source: string, timestamp: number) => string;
+export declare const isValidMessage: (message: any) => boolean;
+export declare const isMessageExpired: (message: {
+    expirationDate?: number;
+}) => boolean;
+export declare const createMessage: (type: string, content: any, source: string, options?: {
+    expirationDate?: number;
+    expirationDuration?: number;
+}) => any;
+export declare const getInternalMessageType: (baseType: "CLEAR_MESSAGE" | "CLEAR_ALL_MESSAGES", channelName: string, namespace?: string) => string;
+export declare const isInternalType: (type: string) => boolean;
+export declare const isValidInternalClearMessage: (message: any) => message is {
+    id: string;
+    type: string;
+    source: string;
+};
+export declare const debounce: <T extends (...args: any[]) => any>(fn: T, wait: number) => ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+    flush: () => ReturnType<T> | undefined;
+};

package/eslint.config.js

@@ -0,0 +1,29 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import prettierPlugin from 'eslint-plugin-prettier';
+
+export default [
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    files: ['src/**/*.{ts,tsx}'],
+    ignores: ['**/*', '!src/**/*.{ts,tsx}'],
+    plugins: {
+      react: reactPlugin,
+      'react-hooks': reactHooksPlugin,
+      prettier: prettierPlugin,
+    },
+    rules: {
+      'react/react-in-jsx-scope': 'off',
+      'react/prop-types': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        { argsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      'prettier/prettier': 'error',
+    },
+  },
+];

package/jest.config.cjs

@@ -0,0 +1,10 @@
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'jsdom',
+    transform: {
+      '^.+\\.(ts|tsx)$': 'ts-jest',
+    },
+    testMatch: ['**/src/tests/**/*.test.(ts|tsx)'],
+    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  };
+  

package/jest.setup.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "react-broadcast-sync",
+  "version": "1.0.0",
+  "description": "A lightweight React hook and provider for syncing state across browser tabs using BroadcastChannel API.",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "rollup -c rollup.config.mjs",
+    "prepare": "npm run build && husky install",
+    "test": "jest",
+    "lint": "eslint . --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "release": "semantic-release",
+    "lint-staged": "lint-staged"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "keywords": [
+    "react",
+    "hooks",
+    "broadcastchannel",
+    "sync",
+    "cross-tab",
+    "state-management"
+  ],
+  "author": "Idan Shalem <idanshalem25@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/IdanShalem/react-broadcast-sync.git"
+  },
+  "bugs": {
+    "url": "https://github.com/IdanShalem/react-broadcast-sync/issues"
+  },
+  "homepage": "https://github.com/IdanShalem/react-broadcast-sync#readme",
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": false
+    },
+    "react-dom": {
+      "optional": false
+    }
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.24.0",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.24.0",
+    "@babel/plugin-transform-runtime": "^7.24.0",
+    "@babel/preset-react": "^7.26.3",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@rollup/plugin-babel": "^6.0.4",
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.3",
+    "@semantic-release/npm": "^12.0.1",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/react-hooks": "^8.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.1.6",
+    "@vitejs/plugin-react": "^4.3.4",
+    "commitlint": "^19.8.1",
+    "eslint": "^9.27.0",
+    "eslint-plugin-prettier": "^5.4.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "husky": "^8.0.3",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^30.0.0-beta.3",
+    "lint-staged": "^16.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "rollup": "^4.38.0",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "semantic-release": "^24.2.5",
+    "ts-jest": "^29.3.4",
+    "typescript": ">=4.0.0",
+    "typescript-eslint": "^8.33.0"
+  }
+}

package/rollup.config.mjs

@@ -0,0 +1,92 @@
+import babel from '@rollup/plugin-babel';
+import resolve from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import typescript from '@rollup/plugin-typescript';
+import peerDepsExternal from 'rollup-plugin-peer-deps-external';
+import terser from '@rollup/plugin-terser';
+
+const external = [
+  'react',
+  'react-dom',
+  'react/jsx-runtime',
+  /^react\//,
+  /^react-dom\//,
+  'typescript',
+  'tslib',
+  '@babel/runtime'
+];
+
+export default {
+  input: 'src/index.ts',
+  output: [
+    {
+      file: 'dist/index.esm.js',
+      format: 'es',
+      sourcemap: true,
+      globals: {
+        react: 'React',
+        'react-dom': 'ReactDOM',
+        typescript: 'ts',
+        tslib: 'tslib',
+        '@babel/runtime': 'babelRuntime'
+      },
+      exports: 'named'
+    },
+    {
+      file: 'dist/index.cjs.js',
+      format: 'cjs',
+      sourcemap: true,
+      globals: {
+        react: 'React',
+        'react-dom': 'ReactDOM',
+        typescript: 'ts',
+        tslib: 'tslib',
+        '@babel/runtime': 'babelRuntime'
+      },
+      exports: 'named'
+    },
+  ],
+  plugins: [
+    peerDepsExternal({
+      includeDependencies: false
+    }),
+    resolve({
+      mainFields: ['module', 'main'],
+      extensions: ['.js', '.jsx', '.ts', '.tsx'],
+      preferBuiltins: true,
+      dedupe: ['react', 'react-dom']
+    }),
+    commonjs({
+      include: /node_modules/,
+      transformMixedEsModules: true,
+      requireReturnsDefault: 'auto'
+    }),
+    typescript({ 
+      tsconfig: './tsconfig.json',
+      exclude: ['**/__tests__/**', '**/*.test.ts', '**/*.test.tsx'],
+      declaration: true,
+      declarationDir: './dist',
+      emitDeclarationOnly: false,
+      sourceMap: true
+    }),
+    babel({
+      babelHelpers: 'runtime',
+      presets: [
+        ['@babel/preset-react', {
+          runtime: 'automatic',
+          development: process.env.NODE_ENV === 'development'
+        }]
+      ],
+      plugins: [
+        ['@babel/plugin-transform-runtime', {
+          regenerator: true,
+          useESModules: true
+        }]
+      ],
+      extensions: ['.js', '.jsx', '.ts', '.tsx'],
+      exclude: 'node_modules/**'
+    }),
+    terser()
+  ],
+  external
+};

package/src/BroadcastProvider.tsx

@@ -0,0 +1,80 @@
+import React, { createContext, useContext, useEffect, useMemo, useRef } from 'react';
+import { useBroadcastChannel } from './hooks/useBroadcastChannel';  
+import { BroadcastMessage } from './types/types';
+
+interface BroadcastContextValue {
+  messages: BroadcastMessage[];
+  error: string | null;
+  channel: BroadcastChannel | null;
+}
+
+const BroadcastChannelContext = createContext<BroadcastContextValue | undefined>(undefined);
+
+interface ErrorBoundaryProps {
+  children: React.ReactNode;
+}
+
+class ErrorBoundary extends React.Component<ErrorBoundaryProps, { hasError: boolean }> {
+  state = { hasError: false };
+
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+
+  componentDidCatch(error: Error) {
+    console.error('BroadcastChannel error:', error);
+  }
+
+  render() {
+    if (this.state.hasError) {
+      return <div>Error occurred in BroadcastProvider</div>;
+    }
+    return this.props.children;
+  }
+}
+
+interface BroadcastProviderProps {
+  channelName: string;
+  children: React.ReactNode;
+}
+
+export const BroadcastProvider: React.FC<BroadcastProviderProps> = ({ children, channelName }) => {
+  const { messages, error: hookError } = useBroadcastChannel(channelName); 
+
+  const [error, setError] = React.useState<string | null>(null);
+  const channel = useRef<BroadcastChannel | null>(null);
+
+  useEffect(() => {
+    if (typeof BroadcastChannel === 'undefined') {
+      setError('BroadcastChannel is not supported in this browser. Please check browser compatibility.');
+      return;
+    }
+    const bc = new BroadcastChannel(channelName);
+    channel.current = bc;
+
+    return () => {
+      bc.close();
+    };
+  }, [channelName]);
+
+  const value = useMemo(
+    () => ({ messages, error: error || hookError, channel: channel.current }),
+    [messages, error, hookError]
+  );
+
+  return (
+    <ErrorBoundary>
+      <BroadcastChannelContext.Provider value={value}>
+        {children}
+      </BroadcastChannelContext.Provider>
+    </ErrorBoundary>
+  );
+};
+
+export const useBroadcastProvider = (): BroadcastContextValue => {
+  const context = useContext(BroadcastChannelContext);
+  if (!context) {
+    throw new Error('useBroadcastProvider must be used within a BroadcastProvider');
+  }
+  return context;
+};