@concord-consortium/lara-interactive-api 1.10.0-pre.2 → 1.11.0-pre.0

package/api.d.ts

@@ -1,4 +1,6 @@
 import { IInitInteractive, INavigationOptions, IAuthInfo, ISupportedFeatures, IShowModal, ICloseModal, IGetInteractiveListOptions, IGetInteractiveListResponse, ISetLinkedInteractives, IGetLibraryInteractiveListRequest, IJwtResponse, ICustomMessageHandler, ICustomMessagesHandledMap, IGetInteractiveSnapshotOptions, IGetInteractiveSnapshotResponse, IAddLinkedInteractiveStateListenerOptions, IDecoratedContentEvent, ITextDecorationHandler, WriteAttachmentParams, ReadAttachmentParams, GetAttachmentUrlParams, IGetReportItemAnswerHandler, IReportItemAnswer, OnUnloadFunction, IReportItemHandlerMetadata, ICustomMessage } from "./types";
+import { PubSubChannel } from "./pubsub";
+export { PubSubChannel };
 export declare const getInitInteractiveMessage: <InteractiveState = {}, AuthoredState = {}, GlobalInteractiveState = {}>() => Promise<IInitInteractive<InteractiveState, AuthoredState, GlobalInteractiveState> | null>;
 export declare const getMode: () => Promise<"runtime" | "authoring" | "report" | "reportItem" | undefined>;
 export declare const getInteractiveState: <InteractiveState>() => InteractiveState | null;
@@ -117,3 +119,4 @@ export declare const getAttachmentUrl: (params: GetAttachmentUrlParams) => Promi
 export declare const sendReportItemAnswer: (request: Omit<IReportItemAnswer, "requestId">) => void;
 export declare const setOnUnload: (onUnload?: OnUnloadFunction<{}> | undefined) => void;
 export declare const sendCustomMessage: (customMessage: ICustomMessage) => void;
+export declare const createPubSubChannel: (channelId: string, channelInfo?: any) => PubSubChannel;

package/client.d.ts

@@ -1,6 +1,7 @@
 import * as iframePhone from "iframe-phone";
 import { ClientMessage, ICustomMessagesHandledMap, ISupportedFeaturesRequest, ServerMessage, OnUnloadFunction } from "./types";
 import { ManagedState } from "./managed-state";
+import { PubSubChannel } from "./pubsub";
 export declare const getClient: () => Client;
 /**
  * This class is intended to provide basic helpers (like `post()` or `add/removeListener`), maintain client-specific
@@ -21,5 +22,6 @@ export declare class Client {
     removeListener(message: ServerMessage, requestId?: number, callback?: iframePhone.ListenerCallback): boolean;
     setSupportedFeatures: (request: ISupportedFeaturesRequest) => void;
     setOnUnload: (onUnload?: OnUnloadFunction<{}> | undefined) => void;
+    createPubSubChannel(channelId: string, channelInfo?: any): PubSubChannel;
     private connect;
 }

package/index-bundle.d.ts

@@ -168,8 +168,8 @@ interface ICustomReportFieldsInteractiveState {
         };
     };
 }
-declare type IRuntimeClientMessage = "interactiveState" | "height" | "hint" | "getAttachmentUrl" | "getAuthInfo" | "supportedFeatures" | "navigation" | "getFirebaseJWT" | "authoredState" | "authoringCustomReportFields" | "runtimeCustomReportValues" | "showModal" | "closeModal" | "getLibraryInteractiveList" | "getInteractiveSnapshot" | "addLinkedInteractiveStateListener" | "removeLinkedInteractiveStateListener" | "decoratedContentEvent" | "customMessage";
-declare type IRuntimeServerMessage = "attachmentUrl" | "authInfo" | "getInteractiveState" | "initInteractive" | "firebaseJWT" | "closedModal" | "customMessage" | "libraryInteractiveList" | "interactiveSnapshot" | "contextMembership" | "linkedInteractiveState" | "decorateContent";
+declare type IRuntimeClientMessage = "interactiveState" | "height" | "hint" | "getAttachmentUrl" | "getAuthInfo" | "supportedFeatures" | "navigation" | "getFirebaseJWT" | "authoredState" | "authoringCustomReportFields" | "runtimeCustomReportValues" | "showModal" | "closeModal" | "getLibraryInteractiveList" | "getInteractiveSnapshot" | "addLinkedInteractiveStateListener" | "removeLinkedInteractiveStateListener" | "decoratedContentEvent" | "customMessage" | "createChannel" | "publish" | "subscribe" | "unsubscribe";
+declare type IRuntimeServerMessage = "attachmentUrl" | "authInfo" | "getInteractiveState" | "initInteractive" | "firebaseJWT" | "closedModal" | "customMessage" | "libraryInteractiveList" | "interactiveSnapshot" | "contextMembership" | "linkedInteractiveState" | "decorateContent" | "pubSubMessage" | "pubSubChannelInfo";
 declare type IAuthoringClientMessage = "getInteractiveList" | "setLinkedInteractives" | "getFirebaseJWT";
 declare type IAuthoringServerMessage = "interactiveList" | "firebaseJWT";
 declare type IReportItemClientMessage = "reportItemAnswer" | "reportItemClientReady";
@@ -480,6 +480,38 @@ interface IMediaLibrary {
  * The @concord-consortium/object-storage package implements both the in-memory and Firebase backends.
  */
 declare type IOpaqueObjectStorageConfig = Record<string, unknown>;
+interface IPubSubCreateChannel {
+    channelId: string;
+    channelInfo: any;
+    timestamp: number;
+}
+interface IPubSubPublish {
+    channelId: string;
+    message: any;
+    timestamp: number;
+}
+interface IPubSubSubscribe {
+    channelId: string;
+    subscriptionId: string;
+}
+interface IPubSubUnsubscribe {
+    channelId: string;
+    subscriptionId: string;
+}
+interface IPubSubMessage {
+    channelId: string;
+    message: any;
+    publisherId: string;
+    timestamp: number;
+}
+interface IPubSubChannelInfo {
+    channelId: string;
+    channelInfo: any;
+    publisherId: string;
+    timestamp: number;
+}
+declare type PubSubMessageHandler = (message: any, publisherId: string) => void;
+declare type PubSubChannelInfoHandler = (channelInfo: any, publisherId: string) => void;
 
 declare type ChoiceId = string;
 interface IAuthoringMetadataBase {
@@ -546,6 +578,70 @@ declare type IRuntimeMetadata = IRuntimeInteractiveMetadata | IRuntimeOpenRespon
 
 declare const inIframe: () => boolean;
 
+declare type ManagedStateEvent = "interactiveStateUpdated" | "globalInteractiveStateUpdated" | "authoredStateUpdated" | "initInteractive";
+declare class ManagedState {
+    interactiveStateDirty: boolean;
+    private _initMessage;
+    private _interactiveState;
+    private _authoredState;
+    private _globalInteractiveState;
+    private emitter;
+    get initMessage(): any;
+    set initMessage(value: any);
+    get interactiveState(): any;
+    set interactiveState(value: any);
+    get authoredState(): any;
+    set authoredState(value: any);
+    get globalInteractiveState(): any;
+    set globalInteractiveState(value: any);
+    emit(event: ManagedStateEvent, content?: any): void;
+    on(event: ManagedStateEvent, handler: any): void;
+    off(event: ManagedStateEvent, handler: any): void;
+    once(event: ManagedStateEvent, handler: any): void;
+}
+
+declare const getClient: () => Client;
+/**
+ * This class is intended to provide basic helpers (like `post()` or `add/removeListener`), maintain client-specific
+ * state, and generally be as minimal as possible. Most of the client-specific helpers and logic can be implemented
+ * in api.ts or hooks.ts (or both so the client app has choice).
+ */
+declare class Client {
+    phone: iframePhone.IFrameEndpoint;
+    managedState: ManagedState;
+    customMessagesHandled: ICustomMessagesHandledMap;
+    private listeners;
+    private requestId;
+    private onUnload;
+    constructor();
+    getNextRequestId(): number;
+    post(message: ClientMessage, content?: any): void;
+    addListener(message: ServerMessage, callback: iframePhone.ListenerCallback, requestId?: number): boolean;
+    removeListener(message: ServerMessage, requestId?: number, callback?: iframePhone.ListenerCallback): boolean;
+    setSupportedFeatures: (request: ISupportedFeaturesRequest) => void;
+    setOnUnload: (onUnload?: OnUnloadFunction<{}> | undefined) => void;
+    createPubSubChannel(channelId: string, channelInfo?: any): PubSubChannel;
+    private connect;
+}
+
+declare class PubSubChannel {
+    private client;
+    private channelId;
+    private channelInfo;
+    private subscriptions;
+    private listenersRegistered;
+    constructor(client: Client, channelId: string, channelInfo?: any);
+    publish(message: any): void;
+    subscribe(handler: PubSubMessageHandler, onChannelInfo?: PubSubChannelInfoHandler): () => void;
+    dispose(): void;
+    getChannelId(): string;
+    getChannelInfo(): any;
+    setChannelInfo(channelInfo: any): void;
+    private registerListeners;
+    private createChannel;
+    private unsubscribe;
+}
+
 declare const getInitInteractiveMessage: <InteractiveState = {}, AuthoredState = {}, GlobalInteractiveState = {}>() => Promise<IInitInteractive<InteractiveState, AuthoredState, GlobalInteractiveState> | null>;
 declare const getMode: () => Promise<"runtime" | "authoring" | "report" | "reportItem" | undefined>;
 declare const getInteractiveState: <InteractiveState>() => InteractiveState | null;
@@ -664,6 +760,7 @@ declare const getAttachmentUrl: (params: GetAttachmentUrlParams) => Promise<stri
 declare const sendReportItemAnswer: (request: Omit<IReportItemAnswer, "requestId">) => void;
 declare const setOnUnload: (onUnload?: OnUnloadFunction<{}> | undefined) => void;
 declare const sendCustomMessage: (customMessage: ICustomMessage) => void;
+declare const createPubSubChannel: (channelId: string, channelInfo?: any) => PubSubChannel;
 
 declare type UpdateFunc<S> = (prevState: S | null) => S;
 declare const useInteractiveState: <InteractiveState>() => {
@@ -695,49 +792,4 @@ interface IUseAccessibilityProps {
 }
 declare const useAccessibility: (props?: IUseAccessibilityProps | undefined) => IAccessibilitySettings;
 
-declare type ManagedStateEvent = "interactiveStateUpdated" | "globalInteractiveStateUpdated" | "authoredStateUpdated" | "initInteractive";
-declare class ManagedState {
-    interactiveStateDirty: boolean;
-    private _initMessage;
-    private _interactiveState;
-    private _authoredState;
-    private _globalInteractiveState;
-    private emitter;
-    get initMessage(): any;
-    set initMessage(value: any);
-    get interactiveState(): any;
-    set interactiveState(value: any);
-    get authoredState(): any;
-    set authoredState(value: any);
-    get globalInteractiveState(): any;
-    set globalInteractiveState(value: any);
-    emit(event: ManagedStateEvent, content?: any): void;
-    on(event: ManagedStateEvent, handler: any): void;
-    off(event: ManagedStateEvent, handler: any): void;
-    once(event: ManagedStateEvent, handler: any): void;
-}
-
-declare const getClient: () => Client;
-/**
- * This class is intended to provide basic helpers (like `post()` or `add/removeListener`), maintain client-specific
- * state, and generally be as minimal as possible. Most of the client-specific helpers and logic can be implemented
- * in api.ts or hooks.ts (or both so the client app has choice).
- */
-declare class Client {
-    phone: iframePhone.IFrameEndpoint;
-    managedState: ManagedState;
-    customMessagesHandled: ICustomMessagesHandledMap;
-    private listeners;
-    private requestId;
-    private onUnload;
-    constructor();
-    getNextRequestId(): number;
-    post(message: ClientMessage, content?: any): void;
-    addListener(message: ServerMessage, callback: iframePhone.ListenerCallback, requestId?: number): boolean;
-    removeListener(message: ServerMessage, requestId?: number, callback?: iframePhone.ListenerCallback): boolean;
-    setSupportedFeatures: (request: ISupportedFeaturesRequest) => void;
-    setOnUnload: (onUnload?: OnUnloadFunction<{}> | undefined) => void;
-    private connect;
-}
-
-export { AttachmentInfoMap, ChoiceId, Client, ClientMessage, DefaultAccessibilitySettings, DeprecatedRuntimeClientMessage, DeprecatedRuntimeServerMessage, GetAttachmentUrlParams, GlobalIFrameSaverClientMessage, GlobalIFrameSaverServerMessage, IAccessibilitySettings, IAddLinkedInteractiveStateListenerOptions, IAddLinkedInteractiveStateListenerRequest, IAttachmentInfo, IAttachmentUrlRequest, IAttachmentUrlResponse, IAuthInfo, IAuthoringClientMessage, IAuthoringCustomReportField, IAuthoringCustomReportFields, IAuthoringImageQuestionMetadata, IAuthoringInitInteractive, IAuthoringInteractiveMetadata, IAuthoringMetadata, IAuthoringMetadataBase, IAuthoringMultipleChoiceChoiceMetadata, IAuthoringMultipleChoiceMetadata, IAuthoringOpenResponseMetadata, IAuthoringServerMessage, IBaseShowModal, ICloseModal, IContextMember, IContextMembership, ICustomMessage, ICustomMessageHandler, ICustomMessageOptions, ICustomMessagesHandledMap, ICustomReportFieldsAuthoredState, ICustomReportFieldsAuthoredStateField, ICustomReportFieldsInteractiveState, IDataset, IDecoratedContentEvent, IGetAuthInfoRequest, IGetAuthInfoResponse, IGetFirebaseJwtRequest, IGetFirebaseJwtResponse, IGetInteractiveListOptions, IGetInteractiveListRequest, IGetInteractiveListResponse, IGetInteractiveSnapshotOptions, IGetInteractiveSnapshotRequest, IGetInteractiveSnapshotResponse, IGetInteractiveState, IGetLibraryInteractiveListOptions, IGetLibraryInteractiveListRequest, IGetLibraryInteractiveListResponse, IGetReportItemAnswer, IGetReportItemAnswerHandler, IHintRequest, IHostFeatureSupport, IHostFeatures, IHostModalSupport, IInitInteractive, IInteractiveListResponseItem, IInteractiveStateProps, IInteractiveStateWithDataset, IJwtClaims, IJwtResponse, ILibraryInteractiveListResponseItem, ILinkedInteractive, ILinkedInteractiveStateResponse, IMediaLibrary, IMediaLibraryItem, IMediaLibraryItemType, INavigationOptions, IOpaqueObjectStorageConfig, IPortalClaims, IRemoveLinkedInteractiveStateListenerRequest, IReportInitInteractive, IReportItemAnswer, IReportItemAnswerItem, IReportItemAnswerItemAnswerText, IReportItemAnswerItemAttachment, IReportItemAnswerItemHtml, IReportItemAnswerItemLinks, IReportItemAnswerItemScore, IReportItemClientMessage, IReportItemHandlerMetadata, IReportItemInitInteractive, IReportItemServerMessage, IRuntimeClientMessage, IRuntimeCustomReportValues, IRuntimeImageQuestionMetadata, IRuntimeInitInteractive, IRuntimeInteractiveMetadata, IRuntimeMetadata, IRuntimeMetadataBase, IRuntimeMultipleChoiceMetadata, IRuntimeOpenResponseMetadata, IRuntimeServerMessage, ISetLinkedInteractives, IShowAlert, IShowDialog, IShowLightbox, IShowModal, ISupportedFeatures, ISupportedFeaturesRequest, ITextDecorationHandler, ITextDecorationHandlerInfo, ITextDecorationInfo, IThemeInfo, IUseAccessibilityProps, IUseReportItemOptions, IWriteAttachmentRequest, IframePhoneServerMessage, InitInteractiveMode, InteractiveItemId, LoggerClientMessage, ModalType, OnUnloadFunction, ReadAttachmentParams, ReportItemsType, ServerMessage, WriteAttachmentParams, addAuthoredStateListener, addCustomMessageListener, addDecorateContentListener, addGetReportItemAnswerListener, addGlobalInteractiveStateListener, addInteractiveStateListener, addLinkedInteractiveStateListener, closeModal, flushStateUpdates, getAttachmentUrl, getAuthInfo, getAuthoredState, getClient, getFirebaseJwt, getGlobalInteractiveState, getInitInteractiveMessage, getInteractiveList, getInteractiveSnapshot, getInteractiveState, getLibraryInteractiveList, getMode, inIframe, log, notifyReportItemClientReady, postDecoratedContentEvent, readAttachment, removeAuthoredStateListener, removeCustomMessageListener, removeDecorateContentListener, removeGetReportItemAnswerListener, removeGlobalInteractiveStateListener, removeInteractiveStateListener, removeLinkedInteractiveStateListener, sendCustomMessage, sendReportItemAnswer, setAuthoredState, setGlobalInteractiveState, setHeight, setHint, setInteractiveState, setInteractiveStateTimeout, setLinkedInteractives, setNavigation, setOnUnload, setSupportedFeatures, showModal, useAccessibility, useAuthoredState, useAutoSetHeight, useCustomMessages, useDecorateContent, useGlobalInteractiveState, useInitMessage, useInteractiveState, useReportItem, writeAttachment };
+export { AttachmentInfoMap, ChoiceId, Client, ClientMessage, DefaultAccessibilitySettings, DeprecatedRuntimeClientMessage, DeprecatedRuntimeServerMessage, GetAttachmentUrlParams, GlobalIFrameSaverClientMessage, GlobalIFrameSaverServerMessage, IAccessibilitySettings, IAddLinkedInteractiveStateListenerOptions, IAddLinkedInteractiveStateListenerRequest, IAttachmentInfo, IAttachmentUrlRequest, IAttachmentUrlResponse, IAuthInfo, IAuthoringClientMessage, IAuthoringCustomReportField, IAuthoringCustomReportFields, IAuthoringImageQuestionMetadata, IAuthoringInitInteractive, IAuthoringInteractiveMetadata, IAuthoringMetadata, IAuthoringMetadataBase, IAuthoringMultipleChoiceChoiceMetadata, IAuthoringMultipleChoiceMetadata, IAuthoringOpenResponseMetadata, IAuthoringServerMessage, IBaseShowModal, ICloseModal, IContextMember, IContextMembership, ICustomMessage, ICustomMessageHandler, ICustomMessageOptions, ICustomMessagesHandledMap, ICustomReportFieldsAuthoredState, ICustomReportFieldsAuthoredStateField, ICustomReportFieldsInteractiveState, IDataset, IDecoratedContentEvent, IGetAuthInfoRequest, IGetAuthInfoResponse, IGetFirebaseJwtRequest, IGetFirebaseJwtResponse, IGetInteractiveListOptions, IGetInteractiveListRequest, IGetInteractiveListResponse, IGetInteractiveSnapshotOptions, IGetInteractiveSnapshotRequest, IGetInteractiveSnapshotResponse, IGetInteractiveState, IGetLibraryInteractiveListOptions, IGetLibraryInteractiveListRequest, IGetLibraryInteractiveListResponse, IGetReportItemAnswer, IGetReportItemAnswerHandler, IHintRequest, IHostFeatureSupport, IHostFeatures, IHostModalSupport, IInitInteractive, IInteractiveListResponseItem, IInteractiveStateProps, IInteractiveStateWithDataset, IJwtClaims, IJwtResponse, ILibraryInteractiveListResponseItem, ILinkedInteractive, ILinkedInteractiveStateResponse, IMediaLibrary, IMediaLibraryItem, IMediaLibraryItemType, INavigationOptions, IOpaqueObjectStorageConfig, IPortalClaims, IPubSubChannelInfo, IPubSubCreateChannel, IPubSubMessage, IPubSubPublish, IPubSubSubscribe, IPubSubUnsubscribe, IRemoveLinkedInteractiveStateListenerRequest, IReportInitInteractive, IReportItemAnswer, IReportItemAnswerItem, IReportItemAnswerItemAnswerText, IReportItemAnswerItemAttachment, IReportItemAnswerItemHtml, IReportItemAnswerItemLinks, IReportItemAnswerItemScore, IReportItemClientMessage, IReportItemHandlerMetadata, IReportItemInitInteractive, IReportItemServerMessage, IRuntimeClientMessage, IRuntimeCustomReportValues, IRuntimeImageQuestionMetadata, IRuntimeInitInteractive, IRuntimeInteractiveMetadata, IRuntimeMetadata, IRuntimeMetadataBase, IRuntimeMultipleChoiceMetadata, IRuntimeOpenResponseMetadata, IRuntimeServerMessage, ISetLinkedInteractives, IShowAlert, IShowDialog, IShowLightbox, IShowModal, ISupportedFeatures, ISupportedFeaturesRequest, ITextDecorationHandler, ITextDecorationHandlerInfo, ITextDecorationInfo, IThemeInfo, IUseAccessibilityProps, IUseReportItemOptions, IWriteAttachmentRequest, IframePhoneServerMessage, InitInteractiveMode, InteractiveItemId, LoggerClientMessage, ModalType, OnUnloadFunction, PubSubChannel, PubSubChannelInfoHandler, PubSubMessageHandler, ReadAttachmentParams, ReportItemsType, ServerMessage, WriteAttachmentParams, addAuthoredStateListener, addCustomMessageListener, addDecorateContentListener, addGetReportItemAnswerListener, addGlobalInteractiveStateListener, addInteractiveStateListener, addLinkedInteractiveStateListener, closeModal, createPubSubChannel, flushStateUpdates, getAttachmentUrl, getAuthInfo, getAuthoredState, getClient, getFirebaseJwt, getGlobalInteractiveState, getInitInteractiveMessage, getInteractiveList, getInteractiveSnapshot, getInteractiveState, getLibraryInteractiveList, getMode, inIframe, log, notifyReportItemClientReady, postDecoratedContentEvent, readAttachment, removeAuthoredStateListener, removeCustomMessageListener, removeDecorateContentListener, removeGetReportItemAnswerListener, removeGlobalInteractiveStateListener, removeInteractiveStateListener, removeLinkedInteractiveStateListener, sendCustomMessage, sendReportItemAnswer, setAuthoredState, setGlobalInteractiveState, setHeight, setHint, setInteractiveState, setInteractiveStateTimeout, setLinkedInteractives, setNavigation, setOnUnload, setSupportedFeatures, showModal, useAccessibility, useAuthoredState, useAutoSetHeight, useCustomMessages, useDecorateContent, useGlobalInteractiveState, useInitMessage, useInteractiveState, useReportItem, writeAttachment };

package/index.js

@@ -2268,6 +2268,77 @@ module.exports = {
 };
 
 
+/***/ }),
+
+/***/ "./node_modules/nanoid/index.browser.js":
+/*!**********************************************!*\
+  !*** ./node_modules/nanoid/index.browser.js ***!
+  \**********************************************/
+/*! exports provided: nanoid, customAlphabet, customRandom, urlAlphabet, random */
+/***/ (function(module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "nanoid", function() { return nanoid; });
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "customAlphabet", function() { return customAlphabet; });
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "customRandom", function() { return customRandom; });
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "random", function() { return random; });
+/* harmony import */ var _url_alphabet_index_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./url-alphabet/index.js */ "./node_modules/nanoid/url-alphabet/index.js");
+/* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "urlAlphabet", function() { return _url_alphabet_index_js__WEBPACK_IMPORTED_MODULE_0__["urlAlphabet"]; });
+
+
+let random = bytes => crypto.getRandomValues(new Uint8Array(bytes))
+let customRandom = (alphabet, defaultSize, getRandom) => {
+  let mask = (2 << (Math.log(alphabet.length - 1) / Math.LN2)) - 1
+  let step = -~((1.6 * mask * defaultSize) / alphabet.length)
+  return (size = defaultSize) => {
+    let id = ''
+    while (true) {
+      let bytes = getRandom(step)
+      let j = step | 0
+      while (j--) {
+        id += alphabet[bytes[j] & mask] || ''
+        if (id.length === size) return id
+      }
+    }
+  }
+}
+let customAlphabet = (alphabet, size = 21) =>
+  customRandom(alphabet, size, random)
+let nanoid = (size = 21) =>
+  crypto.getRandomValues(new Uint8Array(size)).reduce((id, byte) => {
+    byte &= 63
+    if (byte < 36) {
+      id += byte.toString(36)
+    } else if (byte < 62) {
+      id += (byte - 26).toString(36).toUpperCase()
+    } else if (byte > 62) {
+      id += '-'
+    } else {
+      id += '_'
+    }
+    return id
+  }, '')
+
+
+
+/***/ }),
+
+/***/ "./node_modules/nanoid/url-alphabet/index.js":
+/*!***************************************************!*\
+  !*** ./node_modules/nanoid/url-alphabet/index.js ***!
+  \***************************************************/
+/*! exports provided: urlAlphabet */
+/***/ (function(module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "urlAlphabet", function() { return urlAlphabet; });
+let urlAlphabet =
+  'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict'
+
+
+
 /***/ }),
 
 /***/ "./node_modules/process/browser.js":
@@ -4618,9 +4689,11 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sendCustomMessage = exports.setOnUnload = exports.sendReportItemAnswer = exports.getAttachmentUrl = exports.readAttachment = exports.writeAttachment = exports.getLibraryInteractiveList = exports.getInteractiveSnapshot = exports.setLinkedInteractives = exports.getInteractiveList = exports.closeModal = exports.showModal = exports.removeLinkedInteractiveStateListener = exports.addLinkedInteractiveStateListener = exports.removeGlobalInteractiveStateListener = exports.addGlobalInteractiveStateListener = exports.removeAuthoredStateListener = exports.addAuthoredStateListener = exports.removeInteractiveStateListener = exports.addInteractiveStateListener = exports.log = exports.getFirebaseJwt = exports.getAuthInfo = exports.setNavigation = exports.setHint = exports.postDecoratedContentEvent = exports.setHeight = exports.setSupportedFeatures = exports.notifyReportItemClientReady = exports.removeGetReportItemAnswerListener = exports.addGetReportItemAnswerListener = exports.removeDecorateContentListener = exports.addDecorateContentListener = exports.removeCustomMessageListener = exports.addCustomMessageListener = exports.setGlobalInteractiveState = exports.getGlobalInteractiveState = exports.setAuthoredState = exports.getAuthoredState = exports.flushStateUpdates = exports.setInteractiveState = exports.setInteractiveStateTimeout = exports.getInteractiveState = exports.getMode = exports.getInitInteractiveMessage = void 0;
+exports.createPubSubChannel = exports.sendCustomMessage = exports.setOnUnload = exports.sendReportItemAnswer = exports.getAttachmentUrl = exports.readAttachment = exports.writeAttachment = exports.getLibraryInteractiveList = exports.getInteractiveSnapshot = exports.setLinkedInteractives = exports.getInteractiveList = exports.closeModal = exports.showModal = exports.removeLinkedInteractiveStateListener = exports.addLinkedInteractiveStateListener = exports.removeGlobalInteractiveStateListener = exports.addGlobalInteractiveStateListener = exports.removeAuthoredStateListener = exports.addAuthoredStateListener = exports.removeInteractiveStateListener = exports.addInteractiveStateListener = exports.log = exports.getFirebaseJwt = exports.getAuthInfo = exports.setNavigation = exports.setHint = exports.postDecoratedContentEvent = exports.setHeight = exports.setSupportedFeatures = exports.notifyReportItemClientReady = exports.removeGetReportItemAnswerListener = exports.addGetReportItemAnswerListener = exports.removeDecorateContentListener = exports.addDecorateContentListener = exports.removeCustomMessageListener = exports.addCustomMessageListener = exports.setGlobalInteractiveState = exports.getGlobalInteractiveState = exports.setAuthoredState = exports.getAuthoredState = exports.flushStateUpdates = exports.setInteractiveState = exports.setInteractiveStateTimeout = exports.getInteractiveState = exports.getMode = exports.getInitInteractiveMessage = exports.PubSubChannel = void 0;
 var client_1 = __webpack_require__(/*! ./client */ "./src/interactive-api-client/client.ts");
 var uuid_1 = __webpack_require__(/*! uuid */ "./node_modules/uuid/dist/esm-browser/index.js");
+var pubsub_1 = __webpack_require__(/*! ./pubsub */ "./src/interactive-api-client/pubsub.ts");
+Object.defineProperty(exports, "PubSubChannel", { enumerable: true, get: function () { return pubsub_1.PubSubChannel; } });
 var THROW_NOT_IMPLEMENTED_YET = function (method) {
     throw new Error(method + " is not yet implemented in the client!");
 };
@@ -5126,6 +5199,10 @@ var sendCustomMessage = function (customMessage) {
     (0, client_1.getClient)().post("customMessage", customMessage);
 };
 exports.sendCustomMessage = sendCustomMessage;
+var createPubSubChannel = function (channelId, channelInfo) {
+    return (0, client_1.getClient)().createPubSubChannel(channelId, channelInfo);
+};
+exports.createPubSubChannel = createPubSubChannel;
 
 
 /***/ }),
@@ -5205,6 +5282,7 @@ exports.Client = exports.getClient = void 0;
 var iframePhone = __webpack_require__(/*! iframe-phone */ "./node_modules/iframe-phone/main.js");
 var in_frame_1 = __webpack_require__(/*! ./in-frame */ "./src/interactive-api-client/in-frame.ts");
 var managed_state_1 = __webpack_require__(/*! ./managed-state */ "./src/interactive-api-client/managed-state.ts");
+var pubsub_1 = __webpack_require__(/*! ./pubsub */ "./src/interactive-api-client/pubsub.ts");
 var parseJSONIfString = function (data) {
     // Note that we don't want to call JSON.parse for an empty string.
     try {
@@ -5327,6 +5405,9 @@ var Client = /** @class */ (function () {
         }
         return false;
     };
+    Client.prototype.createPubSubChannel = function (channelId, channelInfo) {
+        return new pubsub_1.PubSubChannel(this, channelId, channelInfo);
+    };
     Client.prototype.connect = function () {
         var _this = this;
         this.phone = iframePhone.getIFrameEndpoint();
@@ -5823,7 +5904,125 @@ Object.defineProperty(exports, "__esModule", { value: true });
 /*! exports provided: name, version, description, main, types, repository, author, license, bugs, homepage, dependencies, peerDependencies, default */
 /***/ (function(module) {
 
-module.exports = JSON.parse("{\"name\":\"@concord-consortium/lara-interactive-api\",\"version\":\"1.10.0-pre.2\",\"description\":\"LARA Interactive API client and types\",\"main\":\"./index.js\",\"types\":\"./index-bundle.d.ts\",\"repository\":{\"type\":\"git\",\"url\":\"git+https://github.com/concord-consortium/lara.git\"},\"author\":\"Concord Consortium\",\"license\":\"MIT\",\"bugs\":{\"url\":\"https://github.com/concord-consortium/lara/issues\"},\"homepage\":\"https://github.com/concord-consortium/lara/tree/master/lara-typescript/src/interactive-api-client#readme\",\"dependencies\":{\"iframe-phone\":\"^1.3.1\"},\"peerDependencies\":{\"react\":\">=16.9.0\",\"react-dom\":\">=16.9.0\"}}");
+module.exports = JSON.parse("{\"name\":\"@concord-consortium/lara-interactive-api\",\"version\":\"1.11.0-pre.0\",\"description\":\"LARA Interactive API client and types\",\"main\":\"./index.js\",\"types\":\"./index-bundle.d.ts\",\"repository\":{\"type\":\"git\",\"url\":\"git+https://github.com/concord-consortium/lara.git\"},\"author\":\"Concord Consortium\",\"license\":\"MIT\",\"bugs\":{\"url\":\"https://github.com/concord-consortium/lara/issues\"},\"homepage\":\"https://github.com/concord-consortium/lara/tree/master/lara-typescript/src/interactive-api-client#readme\",\"dependencies\":{\"iframe-phone\":\"^1.3.1\",\"nanoid\":\"^3.3.7\"},\"peerDependencies\":{\"react\":\">=16.9.0\",\"react-dom\":\">=16.9.0\"}}");
+
+/***/ }),
+
+/***/ "./src/interactive-api-client/pubsub.ts":
+/*!**********************************************!*\
+  !*** ./src/interactive-api-client/pubsub.ts ***!
+  \**********************************************/
+/*! no static exports found */
+/***/ (function(module, exports, __webpack_require__) {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PubSubChannel = void 0;
+var nanoid_1 = __webpack_require__(/*! nanoid */ "./node_modules/nanoid/index.browser.js");
+var PubSubChannel = /** @class */ (function () {
+    function PubSubChannel(client, channelId, channelInfo) {
+        this.subscriptions = new Map();
+        this.listenersRegistered = false;
+        this.client = client;
+        this.channelId = channelId;
+        this.channelInfo = channelInfo;
+        // Always create the channel on construction
+        this.createChannel();
+    }
+    PubSubChannel.prototype.publish = function (message) {
+        var publishMessage = {
+            channelId: this.channelId,
+            message: message,
+            timestamp: Date.now()
+        };
+        this.client.post("publish", publishMessage);
+    };
+    PubSubChannel.prototype.subscribe = function (handler, onChannelInfo) {
+        var _this = this;
+        var subscriptionId = (0, nanoid_1.nanoid)();
+        // Store handlers locally
+        this.subscriptions.set(subscriptionId, {
+            handler: handler,
+            channelInfoHandler: onChannelInfo
+        });
+        // Register listeners for pubSubMessage and pubSubChannelInfo if not already done
+        if (!this.listenersRegistered) {
+            this.registerListeners();
+        }
+        // Send subscribe message to host
+        var subscribeMessage = {
+            channelId: this.channelId,
+            subscriptionId: subscriptionId
+        };
+        this.client.post("subscribe", subscribeMessage);
+        // Return unsubscribe function
+        return function () {
+            _this.unsubscribe(subscriptionId);
+        };
+    };
+    PubSubChannel.prototype.dispose = function () {
+        var _this = this;
+        // Unsubscribe all subscriptions
+        var subscriptionIds = Array.from(this.subscriptions.keys());
+        subscriptionIds.forEach(function (subscriptionId) {
+            _this.unsubscribe(subscriptionId);
+        });
+    };
+    PubSubChannel.prototype.getChannelId = function () {
+        return this.channelId;
+    };
+    PubSubChannel.prototype.getChannelInfo = function () {
+        return this.channelInfo;
+    };
+    PubSubChannel.prototype.setChannelInfo = function (channelInfo) {
+        this.channelInfo = channelInfo;
+        this.createChannel();
+    };
+    PubSubChannel.prototype.registerListeners = function () {
+        var _this = this;
+        // Listen for pubSubMessage events for this channel
+        this.client.addListener("pubSubMessage", function (content) {
+            if (content.channelId === _this.channelId) {
+                _this.subscriptions.forEach(function (subscription) {
+                    subscription.handler(content.message, content.publisherId);
+                });
+            }
+        });
+        // Listen for pubSubChannelInfo events for this channel
+        this.client.addListener("pubSubChannelInfo", function (content) {
+            if (content.channelId === _this.channelId) {
+                _this.subscriptions.forEach(function (subscription) {
+                    if (subscription.channelInfoHandler) {
+                        subscription.channelInfoHandler(content.channelInfo, content.publisherId);
+                    }
+                });
+            }
+        });
+        this.listenersRegistered = true;
+    };
+    PubSubChannel.prototype.createChannel = function () {
+        var createMessage = {
+            channelId: this.channelId,
+            channelInfo: this.channelInfo,
+            timestamp: Date.now()
+        };
+        this.client.post("createChannel", createMessage);
+    };
+    PubSubChannel.prototype.unsubscribe = function (subscriptionId) {
+        // Remove local reference
+        this.subscriptions.delete(subscriptionId);
+        // Send unsubscribe message to host
+        var unsubscribeMessage = {
+            channelId: this.channelId,
+            subscriptionId: subscriptionId
+        };
+        this.client.post("unsubscribe", unsubscribeMessage);
+    };
+    return PubSubChannel;
+}());
+exports.PubSubChannel = PubSubChannel;
+
 
 /***/ }),
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@concord-consortium/lara-interactive-api",
-  "version": "1.10.0-pre.2",
+  "version": "1.11.0-pre.0",
   "description": "LARA Interactive API client and types",
   "main": "./index.js",
   "types": "./index-bundle.d.ts",
@@ -15,7 +15,8 @@
   },
   "homepage": "https://github.com/concord-consortium/lara/tree/master/lara-typescript/src/interactive-api-client#readme",
   "dependencies": {
-    "iframe-phone": "^1.3.1"
+    "iframe-phone": "^1.3.1",
+    "nanoid": "^3.3.7"
   },
   "peerDependencies": {
     "react": ">=16.9.0",

package/pubsub.d.ts

@@ -0,0 +1,19 @@
+import { PubSubMessageHandler, PubSubChannelInfoHandler } from "./types";
+import { Client } from "./client";
+export declare class PubSubChannel {
+    private client;
+    private channelId;
+    private channelInfo;
+    private subscriptions;
+    private listenersRegistered;
+    constructor(client: Client, channelId: string, channelInfo?: any);
+    publish(message: any): void;
+    subscribe(handler: PubSubMessageHandler, onChannelInfo?: PubSubChannelInfoHandler): () => void;
+    dispose(): void;
+    getChannelId(): string;
+    getChannelInfo(): any;
+    setChannelInfo(channelInfo: any): void;
+    private registerListeners;
+    private createChannel;
+    private unsubscribe;
+}

package/pubsub.spec.d.ts

@@ -0,0 +1 @@
+export {};