react-aws-iot v2.1.2

react-aws-iot

Usage

1. Set up the provider high in your tree. No props required

import { AWSIOTProvider } from "react-aws-iot";

export default () => (
  <AWSIOTProvider>
    //Whatever goes in here - doesn't matter
    <ApolloHooksProvider client={client}>...</ApolloHooksProvider>
  </AWSIOTProvider>
);

2. In whatever component is going to be aware of your connection information, use the useIOTSettings hook to make that connection. Like React, its smart enough to make changes only when the underlying data changes, so it stays calm.

const DataFetchingComponent = () => {
  const { data, loading, error } = useQuery(MY_QUERY);
  const {
    region,
    accessKeyId,
    secretKey,
    sessionToken,
    host,
    iotTopic
  } = data.getMyStuff;
  useIOTSettings({
    region,
    accessKeyId,
    secretKey,
    sessionToken,
    host,
    iotTopic
  });
  //...
};

3. And where you want to listen for messages, use useIOT.

import { useIOT } from "react-aws-iot";
const MessageAwareComponent = () => {
  const { message, send, error, status, messageText, messageObj } = useIOT();
};

Note messageObj is a personal favorite because it has translated the raw bytearray to text (via messageText) and then decoded it as JSON. Makes a destructured view of the message a one-step process:

const { messageObj: { key, value} } = useIOT()