@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.
- package/dist/DevtoolsPlugin.native.js +39 -0
- package/dist/DevtoolsPlugin.native.js.map +1 -1
- package/dist/cjs/index.cjs +33 -0
- package/dist/cjs/index.cjs.map +1 -1
- package/dist/index.legacy-esm.js +33 -0
- package/dist/index.mjs +33 -0
- package/dist/index.mjs.map +1 -1
- package/package.json +5 -5
- package/src/__tests__/plugin.test.ts +81 -0
- package/src/helpers/getNowTime.ts +1 -1
- package/src/plugin.ts +31 -0
- package/src/reducer.ts +10 -0
- package/types/plugin.d.ts +8 -0
package/dist/cjs/index.cjs
CHANGED
|
@@ -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 = {
|
package/dist/cjs/index.cjs.map
CHANGED
|
@@ -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"]}
|
package/dist/index.legacy-esm.js
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,
|
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,
|
package/dist/index.mjs.map
CHANGED
|
@@ -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.
|
|
9
|
+
"version": "1.0.0--canary.38.1480",
|
|
10
10
|
"main": "dist/cjs/index.cjs",
|
|
11
11
|
"dependencies": {
|
|
12
|
-
"@player-devtools/messenger": "0.
|
|
13
|
-
"@player-devtools/types": "0.
|
|
14
|
-
"@player-devtools/utils": "0.
|
|
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": "
|
|
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
|
+
});
|
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
|