@player-devtools/plugin 0.16.1-next.2 → 1.0.0--canary.38.1480

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -52,6 +52,14 @@ var reducer = (state, transaction) => {
52
52
  };
53
53
  draft.messages.push(message);
54
54
  });
55
+ case "PLAYER_DEVTOOLS_PLAYER_STOPPED":
56
+ return (0, import_immer.produce)(state, (draft) => {
57
+ const message = {
58
+ type: "PLAYER_DEVTOOLS_PLAYER_STOPPED",
59
+ payload: transaction.payload
60
+ };
61
+ draft.messages.push(message);
62
+ });
55
63
  case "PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE":
56
64
  return (0, import_immer.produce)(state, (draft) => {
57
65
  const { payload } = transaction;
@@ -153,6 +161,8 @@ var DevtoolsPlugin = class {
153
161
  this.options = options;
154
162
  this.name = "DevtoolsPlugin";
155
163
  this.loggedWarning = false;
164
+ /** True once devtools has been told about this player */
165
+ this.announced = false;
156
166
  this.store = (0, import_utils3.useStateReducer)(reducer, INITIAL_STATE);
157
167
  this.lastProcessedInteraction = 0;
158
168
  this.store.subscribe(({ interactions }) => {
@@ -199,6 +209,20 @@ var DevtoolsPlugin = class {
199
209
  _messenger_: true
200
210
  };
201
211
  this.store.dispatch(transaction);
212
+ this.announced = true;
213
+ }
214
+ dispatchPlayerStopped() {
215
+ const transaction = {
216
+ id: -1,
217
+ type: "PLAYER_DEVTOOLS_PLAYER_STOPPED",
218
+ payload: { pluginID: this.pluginID },
219
+ sender: this.options.playerID,
220
+ context: "player",
221
+ target: "player",
222
+ timestamp: Date.now(),
223
+ _messenger_: true
224
+ };
225
+ this.store.dispatch(transaction);
202
226
  }
203
227
  // By default, we'll only write to the keys defined in data -- if undefined, data will be cleared
204
228
  dispatchDataUpdate(data) {
@@ -254,6 +278,15 @@ var DevtoolsPlugin = class {
254
278
  if (!this.checkIfDevtoolsIsActive()) return;
255
279
  this.dispatchPlayerInit();
256
280
  }
281
+ /**
282
+ * Tell devtools this plugin is gone. Call it before the messenger is destroyed.
283
+ * Safe to call more than once.
284
+ */
285
+ teardown() {
286
+ if (!this.announced) return;
287
+ this.announced = false;
288
+ this.dispatchPlayerStopped();
289
+ }
257
290
  };
258
291
  // Annotate the CommonJS export names for ESM import in node:
259
292
  0 && (module.exports = {
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/index.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/plugin.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/reducer.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/constants.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/getNowTime.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/uuid.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/genDataChangeTransaction.ts"],"sourcesContent":["export {\n DevtoolsPlugin,\n type DevtoolsPluginOptions,\n type PluginStore,\n type DevtoolsHandler,\n} from \"./plugin\";\nexport * from \"./helpers\";\nexport { PLUGIN_INACTIVE_WARNING } from \"./constants\";\n","import type { Messenger } from \"@player-devtools/messenger\";\nimport {\n PluginData,\n DevtoolsPluginsStore,\n PlayerInitEvent,\n ExtensionSupportedEvents,\n Transaction,\n DevtoolsPluginInteractionEvent,\n} from \"@player-devtools/types\";\nimport { dsetAssign } from \"@player-devtools/utils\";\nimport type { DataModel, Player, PlayerPlugin } from \"@player-ui/player\";\nimport { produce } from \"immer\";\nimport {\n useStateReducer,\n type Store,\n type Unsubscribe,\n} from \"@player-devtools/utils\";\nimport { reducer } from \"./reducer\";\nimport { PLUGIN_INACTIVE_WARNING, INTERACTIONS } from \"./constants\";\nimport { genDataChangeTransaction } from \"./helpers\";\nimport { dequal } from \"dequal\";\n\nexport interface DevtoolsHandler {\n // TODO: Could return bool to signifiy handled to avoid double processing?\n processInteraction(interaction: DevtoolsPluginInteractionEvent): void;\n checkIfDevtoolsIsActive(): boolean;\n log?(message: string): void;\n}\n\nexport interface DevtoolsPluginOptions {\n playerID: string;\n pluginData: PluginData;\n handler: DevtoolsHandler;\n}\n\nconst INITIAL_STATE: DevtoolsPluginsStore = {\n messages: [],\n plugins: {},\n interactions: [],\n currentPlayer: \"\",\n};\n\n// TODO: Rename to DevtoolsPluginStore? Need to rename DevtoolsPluginsStore to DevtoolsPluginState\nexport type PluginStore = Store<\n DevtoolsPluginsStore,\n Transaction<ExtensionSupportedEvents>\n>;\n\n/** Entrypoint for devtools plugins with platform-agnostic components */\nexport class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {\n name: string = \"DevtoolsPlugin\";\n\n private loggedWarning = false;\n\n store: PluginStore = useStateReducer(reducer, INITIAL_STATE);\n protected lastProcessedInteraction = 0;\n\n get pluginID(): string {\n return this.options.pluginData.id;\n }\n\n get playerID(): string {\n return this.options.playerID;\n }\n\n constructor(protected options: DevtoolsPluginOptions) {\n this.store.subscribe(({ interactions }) => {\n const start = this.lastProcessedInteraction;\n const end = interactions.length ?? 0;\n if (start < end) {\n // Advance the cursor BEFORE processing: `processInteraction` may\n // dispatch synchronously (e.g. SELECTED_PLAYER_CHANGE), which re-enters\n // this subscriber. Advancing first makes that re-entrant pass a no-op\n // instead of reprocessing the same interactions.\n this.lastProcessedInteraction = end;\n interactions\n .slice(start, end)\n .forEach(this.processInteraction.bind(this));\n }\n });\n }\n\n registerMessenger(\n messenger: Messenger<ExtensionSupportedEvents>,\n ): Unsubscribe {\n // Propagate new messages from state to devtools via the messenger\n let lastMessageIndex = -1;\n return this.store.subscribe(({ messages }) => {\n const start = lastMessageIndex + 1;\n if (messages.length > start) {\n const newlyAdded = messages.slice(start);\n lastMessageIndex = messages.length - 1;\n for (const msg of newlyAdded) {\n messenger.sendMessage(msg);\n }\n }\n });\n }\n\n protected dispatchPlayerInit(): void {\n // Initial plugin content\n const transaction: Transaction<PlayerInitEvent> = {\n id: -1,\n type: \"PLAYER_DEVTOOLS_PLAYER_INIT\",\n payload: {\n plugins: {\n [this.pluginID]: this.options.pluginData,\n },\n },\n sender: this.options.playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n\n this.store.dispatch(transaction);\n }\n\n // By default, we'll only write to the keys defined in data -- if undefined, data will be cleared\n protected dispatchDataUpdate(data?: DataModel): void {\n const state = this.store.getState();\n\n const { plugins } = produce(this.store.getState(), (draft) => {\n if (!data)\n dsetAssign(draft, [\"plugins\", this.pluginID, \"flow\", \"data\"], data);\n else\n Object.entries(data).forEach(([key, value]) => {\n dsetAssign(\n draft,\n [\"plugins\", this.pluginID, \"flow\", \"data\", key],\n value,\n );\n });\n });\n\n const newData = plugins[this.pluginID]!.flow.data;\n if (dequal(state.plugins[this.pluginID]?.flow?.data, newData)) return;\n\n const transaction = genDataChangeTransaction({\n playerID: this.playerID,\n pluginID: this.pluginID,\n data: newData,\n });\n\n this.store.dispatch(transaction);\n }\n\n checkIfDevtoolsIsActive(): boolean {\n const isActive = this.options.handler.checkIfDevtoolsIsActive();\n if (!isActive && !this.loggedWarning) {\n this.options.handler.log?.(PLUGIN_INACTIVE_WARNING);\n this.loggedWarning = true;\n }\n\n return isActive;\n }\n\n processInteraction(interaction: DevtoolsPluginInteractionEvent): void {\n this.options.handler.processInteraction(interaction);\n\n const {\n payload: { type, payload },\n } = interaction;\n\n if (type === INTERACTIONS.PLAYER_SELECTED && payload) {\n this.store.dispatch({\n id: -1,\n type: \"PLAYER_DEVTOOLS_SELECTED_PLAYER_CHANGE\",\n payload: { playerID: payload },\n sender: this.playerID,\n context: \"player\",\n target: this.playerID,\n timestamp: Date.now(),\n _messenger_: true,\n });\n }\n }\n\n apply(player: Player): void {\n if (!this.checkIfDevtoolsIsActive()) return;\n\n this.dispatchPlayerInit();\n }\n}\n","import { produce } from \"immer\";\nimport { dequal } from \"dequal\";\nimport type {\n DevtoolsDataChangeEvent,\n DevtoolsPluginsStore,\n ExtensionSupportedEvents,\n PlayerInitEvent,\n Transaction,\n} from \"@player-devtools/types\";\nimport { dsetAssign } from \"@player-devtools/utils\";\n\nconst containsInteraction = (\n interactions: DevtoolsPluginsStore[\"interactions\"],\n interaction: DevtoolsPluginsStore[\"interactions\"][number],\n) => {\n return interactions.filter((i) => dequal(i, interaction)).length > 0;\n};\n\n/** devtools plugin state reducer */\nexport const reducer = (\n state: DevtoolsPluginsStore,\n transaction: Transaction<ExtensionSupportedEvents>,\n): DevtoolsPluginsStore => {\n switch (transaction.type) {\n case \"PLAYER_DEVTOOLS_PLAYER_INIT\":\n return produce(state, (draft) => {\n const { payload } = transaction;\n dsetAssign(draft, [\"plugins\"], payload.plugins);\n\n const message: PlayerInitEvent = {\n type: \"PLAYER_DEVTOOLS_PLAYER_INIT\",\n payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\":\n return produce(state, (draft) => {\n const { payload } = transaction;\n\n if (!payload.data) return state;\n\n try {\n dsetAssign(\n draft,\n [\"plugins\", transaction.payload.pluginID, \"flow\", \"data\"],\n transaction.payload.data,\n );\n } catch {\n console.error(\"error setting data:\", transaction.payload.data);\n }\n const message: DevtoolsDataChangeEvent = {\n type: \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\",\n payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLUGIN_INTERACTION\":\n return produce(state, (draft) => {\n if (containsInteraction(draft.interactions, transaction)) return state;\n\n dsetAssign(\n draft,\n [\"interactions\"],\n [...draft.interactions, transaction],\n );\n });\n case \"PLAYER_DEVTOOLS_SELECTED_PLAYER_CHANGE\": {\n const { playerID } = transaction.payload;\n\n if (!playerID) return state;\n return produce(state, (draft) => {\n dsetAssign(draft, [\"currentPlayer\"], playerID);\n });\n }\n default:\n return state;\n }\n};\n","export const INTERACTIONS = {\n PLAYER_SELECTED: \"player-selected\",\n};\n\nexport const PLUGIN_INACTIVE_WARNING =\n \"The plugin has been registered, but the Player development tools are not active. If you are working in a production environment, it is recommended to remove the plugin. To activate, enable through the browser extension popup for web or configure the FlipperClient for mobile.\";\n","export const getNowTime = globalThis.performance\n ? () => globalThis.performance.now()\n : () => Date.now();\n","import { getNowTime } from \"./getNowTime\";\n\n// TODO: Either polyfill crypto or use this (pulled from SO)\nexport function generateUUID(): string {\n // Public Domain/MIT\n let d = new Date().getTime(); //Timestamp\n let d2 = getNowTime() * 1000;\n return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, function (c) {\n let r = Math.random() * 16; //random number between 0 and 16\n if (d > 0) {\n //Use timestamp until depleted\n r = (d + r) % 16 | 0;\n d = Math.floor(d / 16);\n } else {\n //Use microseconds since page-load if supported\n r = (d2 + r) % 16 | 0;\n d2 = Math.floor(d2 / 16);\n }\n return (c === \"x\" ? r : (r & 0x3) | 0x8).toString(16);\n });\n}\n","import type {\n DevtoolsDataChangeEvent,\n Transaction,\n} from \"@player-devtools/types\";\nimport type { Flow } from \"@player-ui/player\";\n\nconst NOOP_ID = -1;\n\n/**\n * Generates a data change transaction for the player devtools plugin.\n *\n * This function creates a transaction object that represents a change in data\n * within a player devtools plugin. The transaction includes details such as the\n * plugin ID, the changed data, and the player ID. It is used to communicate\n * changes between the plugin and devtools.\n */\nexport const genDataChangeTransaction = ({\n playerID,\n data,\n pluginID,\n}: {\n playerID: string;\n data: Flow[\"data\"];\n pluginID: string;\n}): Transaction<DevtoolsDataChangeEvent> => {\n return {\n id: NOOP_ID,\n type: \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\",\n payload: {\n pluginID,\n data,\n },\n sender: playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n};\n"],"mappings":"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","names":["import_utils","import_immer","import_dequal"]}
1
+ {"version":3,"sources":["../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/index.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/plugin.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/reducer.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/constants.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/getNowTime.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/uuid.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/genDataChangeTransaction.ts"],"sourcesContent":["export {\n DevtoolsPlugin,\n type DevtoolsPluginOptions,\n type PluginStore,\n type DevtoolsHandler,\n} from \"./plugin\";\nexport * from \"./helpers\";\nexport { PLUGIN_INACTIVE_WARNING } from \"./constants\";\n","import type { Messenger } from \"@player-devtools/messenger\";\nimport {\n PluginData,\n DevtoolsPluginsStore,\n PlayerInitEvent,\n PlayerStoppedEvent,\n ExtensionSupportedEvents,\n Transaction,\n DevtoolsPluginInteractionEvent,\n} from \"@player-devtools/types\";\nimport { dsetAssign } from \"@player-devtools/utils\";\nimport type { DataModel, Player, PlayerPlugin } from \"@player-ui/player\";\nimport { produce } from \"immer\";\nimport {\n useStateReducer,\n type Store,\n type Unsubscribe,\n} from \"@player-devtools/utils\";\nimport { reducer } from \"./reducer\";\nimport { PLUGIN_INACTIVE_WARNING, INTERACTIONS } from \"./constants\";\nimport { genDataChangeTransaction } from \"./helpers\";\nimport { dequal } from \"dequal\";\n\nexport interface DevtoolsHandler {\n // TODO: Could return bool to signifiy handled to avoid double processing?\n processInteraction(interaction: DevtoolsPluginInteractionEvent): void;\n checkIfDevtoolsIsActive(): boolean;\n log?(message: string): void;\n}\n\nexport interface DevtoolsPluginOptions {\n playerID: string;\n pluginData: PluginData;\n handler: DevtoolsHandler;\n}\n\nconst INITIAL_STATE: DevtoolsPluginsStore = {\n messages: [],\n plugins: {},\n interactions: [],\n currentPlayer: \"\",\n};\n\n// TODO: Rename to DevtoolsPluginStore? Need to rename DevtoolsPluginsStore to DevtoolsPluginState\nexport type PluginStore = Store<\n DevtoolsPluginsStore,\n Transaction<ExtensionSupportedEvents>\n>;\n\n/** Entrypoint for devtools plugins with platform-agnostic components */\nexport class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {\n name: string = \"DevtoolsPlugin\";\n\n private loggedWarning = false;\n\n /** True once devtools has been told about this player */\n private announced = false;\n\n store: PluginStore = useStateReducer(reducer, INITIAL_STATE);\n protected lastProcessedInteraction = 0;\n\n get pluginID(): string {\n return this.options.pluginData.id;\n }\n\n get playerID(): string {\n return this.options.playerID;\n }\n\n constructor(protected options: DevtoolsPluginOptions) {\n this.store.subscribe(({ interactions }) => {\n const start = this.lastProcessedInteraction;\n const end = interactions.length ?? 0;\n if (start < end) {\n // Advance the cursor BEFORE processing: `processInteraction` may\n // dispatch synchronously (e.g. SELECTED_PLAYER_CHANGE), which re-enters\n // this subscriber. Advancing first makes that re-entrant pass a no-op\n // instead of reprocessing the same interactions.\n this.lastProcessedInteraction = end;\n interactions\n .slice(start, end)\n .forEach(this.processInteraction.bind(this));\n }\n });\n }\n\n registerMessenger(\n messenger: Messenger<ExtensionSupportedEvents>,\n ): Unsubscribe {\n // Propagate new messages from state to devtools via the messenger\n let lastMessageIndex = -1;\n return this.store.subscribe(({ messages }) => {\n const start = lastMessageIndex + 1;\n if (messages.length > start) {\n const newlyAdded = messages.slice(start);\n lastMessageIndex = messages.length - 1;\n for (const msg of newlyAdded) {\n messenger.sendMessage(msg);\n }\n }\n });\n }\n\n protected dispatchPlayerInit(): void {\n // Initial plugin content\n const transaction: Transaction<PlayerInitEvent> = {\n id: -1,\n type: \"PLAYER_DEVTOOLS_PLAYER_INIT\",\n payload: {\n plugins: {\n [this.pluginID]: this.options.pluginData,\n },\n },\n sender: this.options.playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n\n this.store.dispatch(transaction);\n this.announced = true;\n }\n\n protected dispatchPlayerStopped(): void {\n const transaction: Transaction<PlayerStoppedEvent> = {\n id: -1,\n type: \"PLAYER_DEVTOOLS_PLAYER_STOPPED\",\n payload: { pluginID: this.pluginID },\n sender: this.options.playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n\n this.store.dispatch(transaction);\n }\n\n // By default, we'll only write to the keys defined in data -- if undefined, data will be cleared\n protected dispatchDataUpdate(data?: DataModel): void {\n const state = this.store.getState();\n\n const { plugins } = produce(this.store.getState(), (draft) => {\n if (!data)\n dsetAssign(draft, [\"plugins\", this.pluginID, \"flow\", \"data\"], data);\n else\n Object.entries(data).forEach(([key, value]) => {\n dsetAssign(\n draft,\n [\"plugins\", this.pluginID, \"flow\", \"data\", key],\n value,\n );\n });\n });\n\n const newData = plugins[this.pluginID]!.flow.data;\n if (dequal(state.plugins[this.pluginID]?.flow?.data, newData)) return;\n\n const transaction = genDataChangeTransaction({\n playerID: this.playerID,\n pluginID: this.pluginID,\n data: newData,\n });\n\n this.store.dispatch(transaction);\n }\n\n checkIfDevtoolsIsActive(): boolean {\n const isActive = this.options.handler.checkIfDevtoolsIsActive();\n if (!isActive && !this.loggedWarning) {\n this.options.handler.log?.(PLUGIN_INACTIVE_WARNING);\n this.loggedWarning = true;\n }\n\n return isActive;\n }\n\n processInteraction(interaction: DevtoolsPluginInteractionEvent): void {\n this.options.handler.processInteraction(interaction);\n\n const {\n payload: { type, payload },\n } = interaction;\n\n if (type === INTERACTIONS.PLAYER_SELECTED && payload) {\n this.store.dispatch({\n id: -1,\n type: \"PLAYER_DEVTOOLS_SELECTED_PLAYER_CHANGE\",\n payload: { playerID: payload },\n sender: this.playerID,\n context: \"player\",\n target: this.playerID,\n timestamp: Date.now(),\n _messenger_: true,\n });\n }\n }\n\n apply(player: Player): void {\n if (!this.checkIfDevtoolsIsActive()) return;\n\n this.dispatchPlayerInit();\n }\n\n /**\n * Tell devtools this plugin is gone. Call it before the messenger is destroyed.\n * Safe to call more than once.\n */\n teardown(): void {\n if (!this.announced) return;\n this.announced = false;\n\n this.dispatchPlayerStopped();\n }\n}\n","import { produce } from \"immer\";\nimport { dequal } from \"dequal\";\nimport type {\n DevtoolsDataChangeEvent,\n DevtoolsPluginsStore,\n ExtensionSupportedEvents,\n PlayerInitEvent,\n PlayerStoppedEvent,\n Transaction,\n} from \"@player-devtools/types\";\nimport { dsetAssign } from \"@player-devtools/utils\";\n\nconst containsInteraction = (\n interactions: DevtoolsPluginsStore[\"interactions\"],\n interaction: DevtoolsPluginsStore[\"interactions\"][number],\n) => {\n return interactions.filter((i) => dequal(i, interaction)).length > 0;\n};\n\n/** devtools plugin state reducer */\nexport const reducer = (\n state: DevtoolsPluginsStore,\n transaction: Transaction<ExtensionSupportedEvents>,\n): DevtoolsPluginsStore => {\n switch (transaction.type) {\n case \"PLAYER_DEVTOOLS_PLAYER_INIT\":\n return produce(state, (draft) => {\n const { payload } = transaction;\n dsetAssign(draft, [\"plugins\"], payload.plugins);\n\n const message: PlayerInitEvent = {\n type: \"PLAYER_DEVTOOLS_PLAYER_INIT\",\n payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLAYER_STOPPED\":\n return produce(state, (draft) => {\n const message: PlayerStoppedEvent = {\n type: \"PLAYER_DEVTOOLS_PLAYER_STOPPED\",\n payload: transaction.payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\":\n return produce(state, (draft) => {\n const { payload } = transaction;\n\n if (!payload.data) return state;\n\n try {\n dsetAssign(\n draft,\n [\"plugins\", transaction.payload.pluginID, \"flow\", \"data\"],\n transaction.payload.data,\n );\n } catch {\n console.error(\"error setting data:\", transaction.payload.data);\n }\n const message: DevtoolsDataChangeEvent = {\n type: \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\",\n payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLUGIN_INTERACTION\":\n return produce(state, (draft) => {\n if (containsInteraction(draft.interactions, transaction)) return state;\n\n dsetAssign(\n draft,\n [\"interactions\"],\n [...draft.interactions, transaction],\n );\n });\n case \"PLAYER_DEVTOOLS_SELECTED_PLAYER_CHANGE\": {\n const { playerID } = transaction.payload;\n\n if (!playerID) return state;\n return produce(state, (draft) => {\n dsetAssign(draft, [\"currentPlayer\"], playerID);\n });\n }\n default:\n return state;\n }\n};\n","export const INTERACTIONS = {\n PLAYER_SELECTED: \"player-selected\",\n};\n\nexport const PLUGIN_INACTIVE_WARNING =\n \"The plugin has been registered, but the Player development tools are not active. If you are working in a production environment, it is recommended to remove the plugin. To activate, enable through the browser extension popup for web or configure the FlipperClient for mobile.\";\n","export const getNowTime: () => number = globalThis.performance\n ? () => globalThis.performance.now()\n : () => Date.now();\n","import { getNowTime } from \"./getNowTime\";\n\n// TODO: Either polyfill crypto or use this (pulled from SO)\nexport function generateUUID(): string {\n // Public Domain/MIT\n let d = new Date().getTime(); //Timestamp\n let d2 = getNowTime() * 1000;\n return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, function (c) {\n let r = Math.random() * 16; //random number between 0 and 16\n if (d > 0) {\n //Use timestamp until depleted\n r = (d + r) % 16 | 0;\n d = Math.floor(d / 16);\n } else {\n //Use microseconds since page-load if supported\n r = (d2 + r) % 16 | 0;\n d2 = Math.floor(d2 / 16);\n }\n return (c === \"x\" ? r : (r & 0x3) | 0x8).toString(16);\n });\n}\n","import type {\n DevtoolsDataChangeEvent,\n Transaction,\n} from \"@player-devtools/types\";\nimport type { Flow } from \"@player-ui/player\";\n\nconst NOOP_ID = -1;\n\n/**\n * Generates a data change transaction for the player devtools plugin.\n *\n * This function creates a transaction object that represents a change in data\n * within a player devtools plugin. The transaction includes details such as the\n * plugin ID, the changed data, and the player ID. It is used to communicate\n * changes between the plugin and devtools.\n */\nexport const genDataChangeTransaction = ({\n playerID,\n data,\n pluginID,\n}: {\n playerID: string;\n data: Flow[\"data\"];\n pluginID: string;\n}): Transaction<DevtoolsDataChangeEvent> => {\n return {\n id: NOOP_ID,\n type: \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\",\n payload: {\n pluginID,\n data,\n },\n sender: playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n};\n"],"mappings":"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","names":["import_utils","import_immer","import_dequal"]}
@@ -24,6 +24,14 @@ var reducer = (state, transaction) => {
24
24
  };
25
25
  draft.messages.push(message);
26
26
  });
27
+ case "PLAYER_DEVTOOLS_PLAYER_STOPPED":
28
+ return produce(state, (draft) => {
29
+ const message = {
30
+ type: "PLAYER_DEVTOOLS_PLAYER_STOPPED",
31
+ payload: transaction.payload
32
+ };
33
+ draft.messages.push(message);
34
+ });
27
35
  case "PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE":
28
36
  return produce(state, (draft) => {
29
37
  const { payload } = transaction;
@@ -125,6 +133,8 @@ var DevtoolsPlugin = class {
125
133
  this.options = options;
126
134
  this.name = "DevtoolsPlugin";
127
135
  this.loggedWarning = false;
136
+ /** True once devtools has been told about this player */
137
+ this.announced = false;
128
138
  this.store = useStateReducer(reducer, INITIAL_STATE);
129
139
  this.lastProcessedInteraction = 0;
130
140
  this.store.subscribe(({ interactions }) => {
@@ -171,6 +181,20 @@ var DevtoolsPlugin = class {
171
181
  _messenger_: true
172
182
  };
173
183
  this.store.dispatch(transaction);
184
+ this.announced = true;
185
+ }
186
+ dispatchPlayerStopped() {
187
+ const transaction = {
188
+ id: -1,
189
+ type: "PLAYER_DEVTOOLS_PLAYER_STOPPED",
190
+ payload: { pluginID: this.pluginID },
191
+ sender: this.options.playerID,
192
+ context: "player",
193
+ target: "player",
194
+ timestamp: Date.now(),
195
+ _messenger_: true
196
+ };
197
+ this.store.dispatch(transaction);
174
198
  }
175
199
  // By default, we'll only write to the keys defined in data -- if undefined, data will be cleared
176
200
  dispatchDataUpdate(data) {
@@ -226,6 +250,15 @@ var DevtoolsPlugin = class {
226
250
  if (!this.checkIfDevtoolsIsActive()) return;
227
251
  this.dispatchPlayerInit();
228
252
  }
253
+ /**
254
+ * Tell devtools this plugin is gone. Call it before the messenger is destroyed.
255
+ * Safe to call more than once.
256
+ */
257
+ teardown() {
258
+ if (!this.announced) return;
259
+ this.announced = false;
260
+ this.dispatchPlayerStopped();
261
+ }
229
262
  };
230
263
  export {
231
264
  DevtoolsPlugin,
package/dist/index.mjs CHANGED
@@ -24,6 +24,14 @@ var reducer = (state, transaction) => {
24
24
  };
25
25
  draft.messages.push(message);
26
26
  });
27
+ case "PLAYER_DEVTOOLS_PLAYER_STOPPED":
28
+ return produce(state, (draft) => {
29
+ const message = {
30
+ type: "PLAYER_DEVTOOLS_PLAYER_STOPPED",
31
+ payload: transaction.payload
32
+ };
33
+ draft.messages.push(message);
34
+ });
27
35
  case "PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE":
28
36
  return produce(state, (draft) => {
29
37
  const { payload } = transaction;
@@ -125,6 +133,8 @@ var DevtoolsPlugin = class {
125
133
  this.options = options;
126
134
  this.name = "DevtoolsPlugin";
127
135
  this.loggedWarning = false;
136
+ /** True once devtools has been told about this player */
137
+ this.announced = false;
128
138
  this.store = useStateReducer(reducer, INITIAL_STATE);
129
139
  this.lastProcessedInteraction = 0;
130
140
  this.store.subscribe(({ interactions }) => {
@@ -171,6 +181,20 @@ var DevtoolsPlugin = class {
171
181
  _messenger_: true
172
182
  };
173
183
  this.store.dispatch(transaction);
184
+ this.announced = true;
185
+ }
186
+ dispatchPlayerStopped() {
187
+ const transaction = {
188
+ id: -1,
189
+ type: "PLAYER_DEVTOOLS_PLAYER_STOPPED",
190
+ payload: { pluginID: this.pluginID },
191
+ sender: this.options.playerID,
192
+ context: "player",
193
+ target: "player",
194
+ timestamp: Date.now(),
195
+ _messenger_: true
196
+ };
197
+ this.store.dispatch(transaction);
174
198
  }
175
199
  // By default, we'll only write to the keys defined in data -- if undefined, data will be cleared
176
200
  dispatchDataUpdate(data) {
@@ -226,6 +250,15 @@ var DevtoolsPlugin = class {
226
250
  if (!this.checkIfDevtoolsIsActive()) return;
227
251
  this.dispatchPlayerInit();
228
252
  }
253
+ /**
254
+ * Tell devtools this plugin is gone. Call it before the messenger is destroyed.
255
+ * Safe to call more than once.
256
+ */
257
+ teardown() {
258
+ if (!this.announced) return;
259
+ this.announced = false;
260
+ this.dispatchPlayerStopped();
261
+ }
229
262
  };
230
263
  export {
231
264
  DevtoolsPlugin,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/plugin.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/reducer.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/constants.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/getNowTime.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/uuid.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/genDataChangeTransaction.ts"],"sourcesContent":["import type { Messenger } from \"@player-devtools/messenger\";\nimport {\n PluginData,\n DevtoolsPluginsStore,\n PlayerInitEvent,\n ExtensionSupportedEvents,\n Transaction,\n DevtoolsPluginInteractionEvent,\n} from \"@player-devtools/types\";\nimport { dsetAssign } from \"@player-devtools/utils\";\nimport type { DataModel, Player, PlayerPlugin } from \"@player-ui/player\";\nimport { produce } from \"immer\";\nimport {\n useStateReducer,\n type Store,\n type Unsubscribe,\n} from \"@player-devtools/utils\";\nimport { reducer } from \"./reducer\";\nimport { PLUGIN_INACTIVE_WARNING, INTERACTIONS } from \"./constants\";\nimport { genDataChangeTransaction } from \"./helpers\";\nimport { dequal } from \"dequal\";\n\nexport interface DevtoolsHandler {\n // TODO: Could return bool to signifiy handled to avoid double processing?\n processInteraction(interaction: DevtoolsPluginInteractionEvent): void;\n checkIfDevtoolsIsActive(): boolean;\n log?(message: string): void;\n}\n\nexport interface DevtoolsPluginOptions {\n playerID: string;\n pluginData: PluginData;\n handler: DevtoolsHandler;\n}\n\nconst INITIAL_STATE: DevtoolsPluginsStore = {\n messages: [],\n plugins: {},\n interactions: [],\n currentPlayer: \"\",\n};\n\n// TODO: Rename to DevtoolsPluginStore? Need to rename DevtoolsPluginsStore to DevtoolsPluginState\nexport type PluginStore = Store<\n DevtoolsPluginsStore,\n Transaction<ExtensionSupportedEvents>\n>;\n\n/** Entrypoint for devtools plugins with platform-agnostic components */\nexport class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {\n name: string = \"DevtoolsPlugin\";\n\n private loggedWarning = false;\n\n store: PluginStore = useStateReducer(reducer, INITIAL_STATE);\n protected lastProcessedInteraction = 0;\n\n get pluginID(): string {\n return this.options.pluginData.id;\n }\n\n get playerID(): string {\n return this.options.playerID;\n }\n\n constructor(protected options: DevtoolsPluginOptions) {\n this.store.subscribe(({ interactions }) => {\n const start = this.lastProcessedInteraction;\n const end = interactions.length ?? 0;\n if (start < end) {\n // Advance the cursor BEFORE processing: `processInteraction` may\n // dispatch synchronously (e.g. SELECTED_PLAYER_CHANGE), which re-enters\n // this subscriber. Advancing first makes that re-entrant pass a no-op\n // instead of reprocessing the same interactions.\n this.lastProcessedInteraction = end;\n interactions\n .slice(start, end)\n .forEach(this.processInteraction.bind(this));\n }\n });\n }\n\n registerMessenger(\n messenger: Messenger<ExtensionSupportedEvents>,\n ): Unsubscribe {\n // Propagate new messages from state to devtools via the messenger\n let lastMessageIndex = -1;\n return this.store.subscribe(({ messages }) => {\n const start = lastMessageIndex + 1;\n if (messages.length > start) {\n const newlyAdded = messages.slice(start);\n lastMessageIndex = messages.length - 1;\n for (const msg of newlyAdded) {\n messenger.sendMessage(msg);\n }\n }\n });\n }\n\n protected dispatchPlayerInit(): void {\n // Initial plugin content\n const transaction: Transaction<PlayerInitEvent> = {\n id: -1,\n type: \"PLAYER_DEVTOOLS_PLAYER_INIT\",\n payload: {\n plugins: {\n [this.pluginID]: this.options.pluginData,\n },\n },\n sender: this.options.playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n\n this.store.dispatch(transaction);\n }\n\n // By default, we'll only write to the keys defined in data -- if undefined, data will be cleared\n protected dispatchDataUpdate(data?: DataModel): void {\n const state = this.store.getState();\n\n const { plugins } = produce(this.store.getState(), (draft) => {\n if (!data)\n dsetAssign(draft, [\"plugins\", this.pluginID, \"flow\", \"data\"], data);\n else\n Object.entries(data).forEach(([key, value]) => {\n dsetAssign(\n draft,\n [\"plugins\", this.pluginID, \"flow\", \"data\", key],\n value,\n );\n });\n });\n\n const newData = plugins[this.pluginID]!.flow.data;\n if (dequal(state.plugins[this.pluginID]?.flow?.data, newData)) return;\n\n const transaction = genDataChangeTransaction({\n playerID: this.playerID,\n pluginID: this.pluginID,\n data: newData,\n });\n\n this.store.dispatch(transaction);\n }\n\n checkIfDevtoolsIsActive(): boolean {\n const isActive = this.options.handler.checkIfDevtoolsIsActive();\n if (!isActive && !this.loggedWarning) {\n this.options.handler.log?.(PLUGIN_INACTIVE_WARNING);\n this.loggedWarning = true;\n }\n\n return isActive;\n }\n\n processInteraction(interaction: DevtoolsPluginInteractionEvent): void {\n this.options.handler.processInteraction(interaction);\n\n const {\n payload: { type, payload },\n } = interaction;\n\n if (type === INTERACTIONS.PLAYER_SELECTED && payload) {\n this.store.dispatch({\n id: -1,\n type: \"PLAYER_DEVTOOLS_SELECTED_PLAYER_CHANGE\",\n payload: { playerID: payload },\n sender: this.playerID,\n context: \"player\",\n target: this.playerID,\n timestamp: Date.now(),\n _messenger_: true,\n });\n }\n }\n\n apply(player: Player): void {\n if (!this.checkIfDevtoolsIsActive()) return;\n\n this.dispatchPlayerInit();\n }\n}\n","import { produce } from \"immer\";\nimport { dequal } from \"dequal\";\nimport type {\n DevtoolsDataChangeEvent,\n DevtoolsPluginsStore,\n ExtensionSupportedEvents,\n PlayerInitEvent,\n Transaction,\n} from \"@player-devtools/types\";\nimport { dsetAssign } from \"@player-devtools/utils\";\n\nconst containsInteraction = (\n interactions: DevtoolsPluginsStore[\"interactions\"],\n interaction: DevtoolsPluginsStore[\"interactions\"][number],\n) => {\n return interactions.filter((i) => dequal(i, interaction)).length > 0;\n};\n\n/** devtools plugin state reducer */\nexport const reducer = (\n state: DevtoolsPluginsStore,\n transaction: Transaction<ExtensionSupportedEvents>,\n): DevtoolsPluginsStore => {\n switch (transaction.type) {\n case \"PLAYER_DEVTOOLS_PLAYER_INIT\":\n return produce(state, (draft) => {\n const { payload } = transaction;\n dsetAssign(draft, [\"plugins\"], payload.plugins);\n\n const message: PlayerInitEvent = {\n type: \"PLAYER_DEVTOOLS_PLAYER_INIT\",\n payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\":\n return produce(state, (draft) => {\n const { payload } = transaction;\n\n if (!payload.data) return state;\n\n try {\n dsetAssign(\n draft,\n [\"plugins\", transaction.payload.pluginID, \"flow\", \"data\"],\n transaction.payload.data,\n );\n } catch {\n console.error(\"error setting data:\", transaction.payload.data);\n }\n const message: DevtoolsDataChangeEvent = {\n type: \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\",\n payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLUGIN_INTERACTION\":\n return produce(state, (draft) => {\n if (containsInteraction(draft.interactions, transaction)) return state;\n\n dsetAssign(\n draft,\n [\"interactions\"],\n [...draft.interactions, transaction],\n );\n });\n case \"PLAYER_DEVTOOLS_SELECTED_PLAYER_CHANGE\": {\n const { playerID } = transaction.payload;\n\n if (!playerID) return state;\n return produce(state, (draft) => {\n dsetAssign(draft, [\"currentPlayer\"], playerID);\n });\n }\n default:\n return state;\n }\n};\n","export const INTERACTIONS = {\n PLAYER_SELECTED: \"player-selected\",\n};\n\nexport const PLUGIN_INACTIVE_WARNING =\n \"The plugin has been registered, but the Player development tools are not active. If you are working in a production environment, it is recommended to remove the plugin. To activate, enable through the browser extension popup for web or configure the FlipperClient for mobile.\";\n","export const getNowTime = globalThis.performance\n ? () => globalThis.performance.now()\n : () => Date.now();\n","import { getNowTime } from \"./getNowTime\";\n\n// TODO: Either polyfill crypto or use this (pulled from SO)\nexport function generateUUID(): string {\n // Public Domain/MIT\n let d = new Date().getTime(); //Timestamp\n let d2 = getNowTime() * 1000;\n return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, function (c) {\n let r = Math.random() * 16; //random number between 0 and 16\n if (d > 0) {\n //Use timestamp until depleted\n r = (d + r) % 16 | 0;\n d = Math.floor(d / 16);\n } else {\n //Use microseconds since page-load if supported\n r = (d2 + r) % 16 | 0;\n d2 = Math.floor(d2 / 16);\n }\n return (c === \"x\" ? r : (r & 0x3) | 0x8).toString(16);\n });\n}\n","import type {\n DevtoolsDataChangeEvent,\n Transaction,\n} from \"@player-devtools/types\";\nimport type { Flow } from \"@player-ui/player\";\n\nconst NOOP_ID = -1;\n\n/**\n * Generates a data change transaction for the player devtools plugin.\n *\n * This function creates a transaction object that represents a change in data\n * within a player devtools plugin. The transaction includes details such as the\n * plugin ID, the changed data, and the player ID. It is used to communicate\n * changes between the plugin and devtools.\n */\nexport const genDataChangeTransaction = ({\n playerID,\n data,\n pluginID,\n}: {\n playerID: string;\n data: Flow[\"data\"];\n pluginID: string;\n}): Transaction<DevtoolsDataChangeEvent> => {\n return {\n id: NOOP_ID,\n type: \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\",\n payload: {\n pluginID,\n data,\n },\n sender: playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n};\n"],"mappings":"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","names":["dsetAssign","produce","dequal","produce","dsetAssign"]}
1
+ {"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/plugin.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/reducer.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/constants.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/getNowTime.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/uuid.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/plugin/core/src/helpers/genDataChangeTransaction.ts"],"sourcesContent":["import type { Messenger } from \"@player-devtools/messenger\";\nimport {\n PluginData,\n DevtoolsPluginsStore,\n PlayerInitEvent,\n PlayerStoppedEvent,\n ExtensionSupportedEvents,\n Transaction,\n DevtoolsPluginInteractionEvent,\n} from \"@player-devtools/types\";\nimport { dsetAssign } from \"@player-devtools/utils\";\nimport type { DataModel, Player, PlayerPlugin } from \"@player-ui/player\";\nimport { produce } from \"immer\";\nimport {\n useStateReducer,\n type Store,\n type Unsubscribe,\n} from \"@player-devtools/utils\";\nimport { reducer } from \"./reducer\";\nimport { PLUGIN_INACTIVE_WARNING, INTERACTIONS } from \"./constants\";\nimport { genDataChangeTransaction } from \"./helpers\";\nimport { dequal } from \"dequal\";\n\nexport interface DevtoolsHandler {\n // TODO: Could return bool to signifiy handled to avoid double processing?\n processInteraction(interaction: DevtoolsPluginInteractionEvent): void;\n checkIfDevtoolsIsActive(): boolean;\n log?(message: string): void;\n}\n\nexport interface DevtoolsPluginOptions {\n playerID: string;\n pluginData: PluginData;\n handler: DevtoolsHandler;\n}\n\nconst INITIAL_STATE: DevtoolsPluginsStore = {\n messages: [],\n plugins: {},\n interactions: [],\n currentPlayer: \"\",\n};\n\n// TODO: Rename to DevtoolsPluginStore? Need to rename DevtoolsPluginsStore to DevtoolsPluginState\nexport type PluginStore = Store<\n DevtoolsPluginsStore,\n Transaction<ExtensionSupportedEvents>\n>;\n\n/** Entrypoint for devtools plugins with platform-agnostic components */\nexport class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {\n name: string = \"DevtoolsPlugin\";\n\n private loggedWarning = false;\n\n /** True once devtools has been told about this player */\n private announced = false;\n\n store: PluginStore = useStateReducer(reducer, INITIAL_STATE);\n protected lastProcessedInteraction = 0;\n\n get pluginID(): string {\n return this.options.pluginData.id;\n }\n\n get playerID(): string {\n return this.options.playerID;\n }\n\n constructor(protected options: DevtoolsPluginOptions) {\n this.store.subscribe(({ interactions }) => {\n const start = this.lastProcessedInteraction;\n const end = interactions.length ?? 0;\n if (start < end) {\n // Advance the cursor BEFORE processing: `processInteraction` may\n // dispatch synchronously (e.g. SELECTED_PLAYER_CHANGE), which re-enters\n // this subscriber. Advancing first makes that re-entrant pass a no-op\n // instead of reprocessing the same interactions.\n this.lastProcessedInteraction = end;\n interactions\n .slice(start, end)\n .forEach(this.processInteraction.bind(this));\n }\n });\n }\n\n registerMessenger(\n messenger: Messenger<ExtensionSupportedEvents>,\n ): Unsubscribe {\n // Propagate new messages from state to devtools via the messenger\n let lastMessageIndex = -1;\n return this.store.subscribe(({ messages }) => {\n const start = lastMessageIndex + 1;\n if (messages.length > start) {\n const newlyAdded = messages.slice(start);\n lastMessageIndex = messages.length - 1;\n for (const msg of newlyAdded) {\n messenger.sendMessage(msg);\n }\n }\n });\n }\n\n protected dispatchPlayerInit(): void {\n // Initial plugin content\n const transaction: Transaction<PlayerInitEvent> = {\n id: -1,\n type: \"PLAYER_DEVTOOLS_PLAYER_INIT\",\n payload: {\n plugins: {\n [this.pluginID]: this.options.pluginData,\n },\n },\n sender: this.options.playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n\n this.store.dispatch(transaction);\n this.announced = true;\n }\n\n protected dispatchPlayerStopped(): void {\n const transaction: Transaction<PlayerStoppedEvent> = {\n id: -1,\n type: \"PLAYER_DEVTOOLS_PLAYER_STOPPED\",\n payload: { pluginID: this.pluginID },\n sender: this.options.playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n\n this.store.dispatch(transaction);\n }\n\n // By default, we'll only write to the keys defined in data -- if undefined, data will be cleared\n protected dispatchDataUpdate(data?: DataModel): void {\n const state = this.store.getState();\n\n const { plugins } = produce(this.store.getState(), (draft) => {\n if (!data)\n dsetAssign(draft, [\"plugins\", this.pluginID, \"flow\", \"data\"], data);\n else\n Object.entries(data).forEach(([key, value]) => {\n dsetAssign(\n draft,\n [\"plugins\", this.pluginID, \"flow\", \"data\", key],\n value,\n );\n });\n });\n\n const newData = plugins[this.pluginID]!.flow.data;\n if (dequal(state.plugins[this.pluginID]?.flow?.data, newData)) return;\n\n const transaction = genDataChangeTransaction({\n playerID: this.playerID,\n pluginID: this.pluginID,\n data: newData,\n });\n\n this.store.dispatch(transaction);\n }\n\n checkIfDevtoolsIsActive(): boolean {\n const isActive = this.options.handler.checkIfDevtoolsIsActive();\n if (!isActive && !this.loggedWarning) {\n this.options.handler.log?.(PLUGIN_INACTIVE_WARNING);\n this.loggedWarning = true;\n }\n\n return isActive;\n }\n\n processInteraction(interaction: DevtoolsPluginInteractionEvent): void {\n this.options.handler.processInteraction(interaction);\n\n const {\n payload: { type, payload },\n } = interaction;\n\n if (type === INTERACTIONS.PLAYER_SELECTED && payload) {\n this.store.dispatch({\n id: -1,\n type: \"PLAYER_DEVTOOLS_SELECTED_PLAYER_CHANGE\",\n payload: { playerID: payload },\n sender: this.playerID,\n context: \"player\",\n target: this.playerID,\n timestamp: Date.now(),\n _messenger_: true,\n });\n }\n }\n\n apply(player: Player): void {\n if (!this.checkIfDevtoolsIsActive()) return;\n\n this.dispatchPlayerInit();\n }\n\n /**\n * Tell devtools this plugin is gone. Call it before the messenger is destroyed.\n * Safe to call more than once.\n */\n teardown(): void {\n if (!this.announced) return;\n this.announced = false;\n\n this.dispatchPlayerStopped();\n }\n}\n","import { produce } from \"immer\";\nimport { dequal } from \"dequal\";\nimport type {\n DevtoolsDataChangeEvent,\n DevtoolsPluginsStore,\n ExtensionSupportedEvents,\n PlayerInitEvent,\n PlayerStoppedEvent,\n Transaction,\n} from \"@player-devtools/types\";\nimport { dsetAssign } from \"@player-devtools/utils\";\n\nconst containsInteraction = (\n interactions: DevtoolsPluginsStore[\"interactions\"],\n interaction: DevtoolsPluginsStore[\"interactions\"][number],\n) => {\n return interactions.filter((i) => dequal(i, interaction)).length > 0;\n};\n\n/** devtools plugin state reducer */\nexport const reducer = (\n state: DevtoolsPluginsStore,\n transaction: Transaction<ExtensionSupportedEvents>,\n): DevtoolsPluginsStore => {\n switch (transaction.type) {\n case \"PLAYER_DEVTOOLS_PLAYER_INIT\":\n return produce(state, (draft) => {\n const { payload } = transaction;\n dsetAssign(draft, [\"plugins\"], payload.plugins);\n\n const message: PlayerInitEvent = {\n type: \"PLAYER_DEVTOOLS_PLAYER_INIT\",\n payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLAYER_STOPPED\":\n return produce(state, (draft) => {\n const message: PlayerStoppedEvent = {\n type: \"PLAYER_DEVTOOLS_PLAYER_STOPPED\",\n payload: transaction.payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\":\n return produce(state, (draft) => {\n const { payload } = transaction;\n\n if (!payload.data) return state;\n\n try {\n dsetAssign(\n draft,\n [\"plugins\", transaction.payload.pluginID, \"flow\", \"data\"],\n transaction.payload.data,\n );\n } catch {\n console.error(\"error setting data:\", transaction.payload.data);\n }\n const message: DevtoolsDataChangeEvent = {\n type: \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\",\n payload,\n };\n\n draft.messages.push(message);\n });\n case \"PLAYER_DEVTOOLS_PLUGIN_INTERACTION\":\n return produce(state, (draft) => {\n if (containsInteraction(draft.interactions, transaction)) return state;\n\n dsetAssign(\n draft,\n [\"interactions\"],\n [...draft.interactions, transaction],\n );\n });\n case \"PLAYER_DEVTOOLS_SELECTED_PLAYER_CHANGE\": {\n const { playerID } = transaction.payload;\n\n if (!playerID) return state;\n return produce(state, (draft) => {\n dsetAssign(draft, [\"currentPlayer\"], playerID);\n });\n }\n default:\n return state;\n }\n};\n","export const INTERACTIONS = {\n PLAYER_SELECTED: \"player-selected\",\n};\n\nexport const PLUGIN_INACTIVE_WARNING =\n \"The plugin has been registered, but the Player development tools are not active. If you are working in a production environment, it is recommended to remove the plugin. To activate, enable through the browser extension popup for web or configure the FlipperClient for mobile.\";\n","export const getNowTime: () => number = globalThis.performance\n ? () => globalThis.performance.now()\n : () => Date.now();\n","import { getNowTime } from \"./getNowTime\";\n\n// TODO: Either polyfill crypto or use this (pulled from SO)\nexport function generateUUID(): string {\n // Public Domain/MIT\n let d = new Date().getTime(); //Timestamp\n let d2 = getNowTime() * 1000;\n return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, function (c) {\n let r = Math.random() * 16; //random number between 0 and 16\n if (d > 0) {\n //Use timestamp until depleted\n r = (d + r) % 16 | 0;\n d = Math.floor(d / 16);\n } else {\n //Use microseconds since page-load if supported\n r = (d2 + r) % 16 | 0;\n d2 = Math.floor(d2 / 16);\n }\n return (c === \"x\" ? r : (r & 0x3) | 0x8).toString(16);\n });\n}\n","import type {\n DevtoolsDataChangeEvent,\n Transaction,\n} from \"@player-devtools/types\";\nimport type { Flow } from \"@player-ui/player\";\n\nconst NOOP_ID = -1;\n\n/**\n * Generates a data change transaction for the player devtools plugin.\n *\n * This function creates a transaction object that represents a change in data\n * within a player devtools plugin. The transaction includes details such as the\n * plugin ID, the changed data, and the player ID. It is used to communicate\n * changes between the plugin and devtools.\n */\nexport const genDataChangeTransaction = ({\n playerID,\n data,\n pluginID,\n}: {\n playerID: string;\n data: Flow[\"data\"];\n pluginID: string;\n}): Transaction<DevtoolsDataChangeEvent> => {\n return {\n id: NOOP_ID,\n type: \"PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE\",\n payload: {\n pluginID,\n data,\n },\n sender: playerID,\n context: \"player\",\n target: \"player\",\n timestamp: Date.now(),\n _messenger_: true,\n };\n};\n"],"mappings":"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","names":["dsetAssign","produce","dequal","produce","dsetAssign"]}
package/package.json CHANGED
@@ -6,12 +6,12 @@
6
6
  "types"
7
7
  ],
8
8
  "name": "@player-devtools/plugin",
9
- "version": "0.16.1-next.2",
9
+ "version": "1.0.0--canary.38.1480",
10
10
  "main": "dist/cjs/index.cjs",
11
11
  "dependencies": {
12
- "@player-devtools/messenger": "0.16.1-next.2",
13
- "@player-devtools/types": "0.16.1-next.2",
14
- "@player-devtools/utils": "0.16.1-next.2",
12
+ "@player-devtools/messenger": "1.0.0--canary.38.1480",
13
+ "@player-devtools/types": "1.0.0--canary.38.1480",
14
+ "@player-devtools/utils": "1.0.0--canary.38.1480",
15
15
  "@swc/core": "1.3.74",
16
16
  "dequal": "^2.0.2",
17
17
  "immer": "^10.0.3",
@@ -30,6 +30,6 @@
30
30
  }
31
31
  },
32
32
  "peerDependencies": {
33
- "@player-ui/player": ">=0.15.4"
33
+ "@player-ui/player": "1.3.0"
34
34
  }
35
35
  }
@@ -1,4 +1,6 @@
1
1
  import { describe, it, expect, vi } from "vitest";
2
+ import type { Messenger } from "@player-devtools/messenger";
3
+ import type { Player } from "@player-ui/player";
2
4
  import type {
3
5
  DevtoolsPluginInteractionEvent,
4
6
  ExtensionSupportedEvents,
@@ -93,3 +95,82 @@ describe("DevtoolsPlugin.processInteraction", () => {
93
95
  );
94
96
  });
95
97
  });
98
+
99
+ describe("DevtoolsPlugin.teardown", () => {
100
+ const player = {} as Player;
101
+
102
+ /** A fake messenger that records the event types it is sent. */
103
+ function setupWithMessenger() {
104
+ const ctx = setup();
105
+ const sent: Array<string> = [];
106
+ ctx.plugin.registerMessenger({
107
+ sendMessage: (message: { type: string }) => sent.push(message.type),
108
+ } as unknown as Messenger<ExtensionSupportedEvents>);
109
+ return { ...ctx, sent };
110
+ }
111
+
112
+ it("sends PLAYER_STOPPED over the messenger after PLAYER_INIT", () => {
113
+ const { plugin, sent } = setupWithMessenger();
114
+
115
+ plugin.apply(player);
116
+ plugin.teardown();
117
+
118
+ expect(sent).toEqual([
119
+ "PLAYER_DEVTOOLS_PLAYER_INIT",
120
+ "PLAYER_DEVTOOLS_PLAYER_STOPPED",
121
+ ]);
122
+ });
123
+
124
+ it("only sends PLAYER_STOPPED once", () => {
125
+ const { plugin, sent } = setupWithMessenger();
126
+
127
+ plugin.apply(player);
128
+ plugin.teardown();
129
+ plugin.teardown();
130
+
131
+ expect(sent.filter((t) => t === "PLAYER_DEVTOOLS_PLAYER_STOPPED")).toEqual([
132
+ "PLAYER_DEVTOOLS_PLAYER_STOPPED",
133
+ ]);
134
+ });
135
+
136
+ it("does nothing if the plugin never announced itself", () => {
137
+ const { plugin, sent } = setupWithMessenger();
138
+
139
+ plugin.teardown();
140
+
141
+ expect(sent).toEqual([]);
142
+ });
143
+
144
+ it("does nothing if devtools was inactive when applied", () => {
145
+ const plugin = new DevtoolsPlugin({
146
+ playerID: "player-a",
147
+ pluginData: pluginData(),
148
+ handler: {
149
+ processInteraction: vi.fn(),
150
+ checkIfDevtoolsIsActive: () => false,
151
+ },
152
+ });
153
+ const sent: Array<string> = [];
154
+ plugin.registerMessenger({
155
+ sendMessage: (message: { type: string }) => sent.push(message.type),
156
+ } as unknown as Messenger<ExtensionSupportedEvents>);
157
+
158
+ plugin.apply(player);
159
+ plugin.teardown();
160
+
161
+ expect(sent).toEqual([]);
162
+ });
163
+
164
+ it("can announce and retire again if re-applied", () => {
165
+ const { plugin, sent } = setupWithMessenger();
166
+
167
+ plugin.apply(player);
168
+ plugin.teardown();
169
+ plugin.apply(player);
170
+ plugin.teardown();
171
+
172
+ expect(
173
+ sent.filter((t) => t === "PLAYER_DEVTOOLS_PLAYER_STOPPED"),
174
+ ).toHaveLength(2);
175
+ });
176
+ });
@@ -1,3 +1,3 @@
1
- export const getNowTime = globalThis.performance
1
+ export const getNowTime: () => number = globalThis.performance
2
2
  ? () => globalThis.performance.now()
3
3
  : () => Date.now();
package/src/plugin.ts CHANGED
@@ -3,6 +3,7 @@ import {
3
3
  PluginData,
4
4
  DevtoolsPluginsStore,
5
5
  PlayerInitEvent,
6
+ PlayerStoppedEvent,
6
7
  ExtensionSupportedEvents,
7
8
  Transaction,
8
9
  DevtoolsPluginInteractionEvent,
@@ -52,6 +53,9 @@ export class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {
52
53
 
53
54
  private loggedWarning = false;
54
55
 
56
+ /** True once devtools has been told about this player */
57
+ private announced = false;
58
+
55
59
  store: PluginStore = useStateReducer(reducer, INITIAL_STATE);
56
60
  protected lastProcessedInteraction = 0;
57
61
 
@@ -114,6 +118,22 @@ export class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {
114
118
  _messenger_: true,
115
119
  };
116
120
 
121
+ this.store.dispatch(transaction);
122
+ this.announced = true;
123
+ }
124
+
125
+ protected dispatchPlayerStopped(): void {
126
+ const transaction: Transaction<PlayerStoppedEvent> = {
127
+ id: -1,
128
+ type: "PLAYER_DEVTOOLS_PLAYER_STOPPED",
129
+ payload: { pluginID: this.pluginID },
130
+ sender: this.options.playerID,
131
+ context: "player",
132
+ target: "player",
133
+ timestamp: Date.now(),
134
+ _messenger_: true,
135
+ };
136
+
117
137
  this.store.dispatch(transaction);
118
138
  }
119
139
 
@@ -182,4 +202,15 @@ export class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {
182
202
 
183
203
  this.dispatchPlayerInit();
184
204
  }
205
+
206
+ /**
207
+ * Tell devtools this plugin is gone. Call it before the messenger is destroyed.
208
+ * Safe to call more than once.
209
+ */
210
+ teardown(): void {
211
+ if (!this.announced) return;
212
+ this.announced = false;
213
+
214
+ this.dispatchPlayerStopped();
215
+ }
185
216
  }
package/src/reducer.ts CHANGED
@@ -5,6 +5,7 @@ import type {
5
5
  DevtoolsPluginsStore,
6
6
  ExtensionSupportedEvents,
7
7
  PlayerInitEvent,
8
+ PlayerStoppedEvent,
8
9
  Transaction,
9
10
  } from "@player-devtools/types";
10
11
  import { dsetAssign } from "@player-devtools/utils";
@@ -32,6 +33,15 @@ export const reducer = (
32
33
  payload,
33
34
  };
34
35
 
36
+ draft.messages.push(message);
37
+ });
38
+ case "PLAYER_DEVTOOLS_PLAYER_STOPPED":
39
+ return produce(state, (draft) => {
40
+ const message: PlayerStoppedEvent = {
41
+ type: "PLAYER_DEVTOOLS_PLAYER_STOPPED",
42
+ payload: transaction.payload,
43
+ };
44
+
35
45
  draft.messages.push(message);
36
46
  });
37
47
  case "PLAYER_DEVTOOLS_PLUGIN_DATA_CHANGE":
package/types/plugin.d.ts CHANGED
@@ -18,6 +18,8 @@ export declare class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {
18
18
  protected options: DevtoolsPluginOptions;
19
19
  name: string;
20
20
  private loggedWarning;
21
+ /** True once devtools has been told about this player */
22
+ private announced;
21
23
  store: PluginStore;
22
24
  protected lastProcessedInteraction: number;
23
25
  get pluginID(): string;
@@ -25,9 +27,15 @@ export declare class DevtoolsPlugin implements PlayerPlugin, DevtoolsHandler {
25
27
  constructor(options: DevtoolsPluginOptions);
26
28
  registerMessenger(messenger: Messenger<ExtensionSupportedEvents>): Unsubscribe;
27
29
  protected dispatchPlayerInit(): void;
30
+ protected dispatchPlayerStopped(): void;
28
31
  protected dispatchDataUpdate(data?: DataModel): void;
29
32
  checkIfDevtoolsIsActive(): boolean;
30
33
  processInteraction(interaction: DevtoolsPluginInteractionEvent): void;
31
34
  apply(player: Player): void;
35
+ /**
36
+ * Tell devtools this plugin is gone. Call it before the messenger is destroyed.
37
+ * Safe to call more than once.
38
+ */
39
+ teardown(): void;
32
40
  }
33
41
  //# sourceMappingURL=plugin.d.ts.map