chatjs-hooks

chatjs-hooks

React hooks for ChatGPT widgets.

Installation

npm install chatjs-hooks

Usage

useWidgetProps

Get data passed from your MCP tool to your React widget:

import React from 'react';
import { useWidgetProps } from 'chatjs-hooks';

export default function MyWidget() {
  const { message, count } = useWidgetProps();
  
  return (
    <div>
      <h1>{message}</h1>
      <p>Count: {count}</p>
    </div>
  );
}

useWidgetState

Manage stateful data that persists in ChatGPT:

import React from 'react';
import { useWidgetState } from 'chatjs-hooks';

export default function Counter() {
  const [state, setState] = useWidgetState({ count: 0 });
  
  return (
    <button onClick={() => setState({ count: state.count + 1 })}>
      Count: {state?.count || 0}
    </button>
  );
}

useOpenAiGlobal

Access ChatGPT global values like theme, display mode, etc:

import React from 'react';
import { useOpenAiGlobal } from 'chatjs-hooks';

export default function ThemedWidget() {
  const theme = useOpenAiGlobal('theme');
  const displayMode = useOpenAiGlobal('displayMode');
  
  return (
    <div className={`theme-${theme} mode-${displayMode}`}>
      <h1>Themed Widget</h1>
    </div>
  );
}

TypeScript

This package is written in TypeScript and includes type definitions.

import { useWidgetProps } from 'chatjs-hooks';

interface MyWidgetProps {
  message: string;
  count: number;
}

export default function MyWidget() {
  const { message, count } = useWidgetProps<MyWidgetProps>();
  // message and count are properly typed!
}

License

MIT