@webext-core/messaging 2.3.0 → 3.0.0

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/lib/index.js DELETED
@@ -1,37 +0,0 @@
1
- import {
2
- __spreadProps,
3
- __spreadValues,
4
- defineGenericMessanging
5
- } from "./chunk-BQLFSFFZ.js";
6
-
7
- // src/extension.ts
8
- import Browser from "webextension-polyfill";
9
- function defineExtensionMessaging(config) {
10
- return defineGenericMessanging(__spreadProps(__spreadValues({}, config), {
11
- sendMessage(message, arg) {
12
- if (arg == null) {
13
- return Browser.runtime.sendMessage(message);
14
- }
15
- const options = typeof arg === "number" ? { tabId: arg } : arg;
16
- return Browser.tabs.sendMessage(
17
- options.tabId,
18
- message,
19
- // Pass frameId if specified
20
- options.frameId != null ? { frameId: options.frameId } : void 0
21
- );
22
- },
23
- addRootListener(processMessage) {
24
- const listener = (message, sender) => {
25
- if (typeof message === "object")
26
- return processMessage(__spreadProps(__spreadValues({}, message), { sender }));
27
- else
28
- return processMessage(message);
29
- };
30
- Browser.runtime.onMessage.addListener(listener);
31
- return () => Browser.runtime.onMessage.removeListener(listener);
32
- }
33
- }));
34
- }
35
- export {
36
- defineExtensionMessaging
37
- };
package/lib/page.cjs DELETED
@@ -1,296 +0,0 @@
1
- "use strict";
2
- var __defProp = Object.defineProperty;
3
- var __defProps = Object.defineProperties;
4
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
- var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
6
- var __getOwnPropNames = Object.getOwnPropertyNames;
7
- var __getOwnPropSymbols = Object.getOwnPropertySymbols;
8
- var __hasOwnProp = Object.prototype.hasOwnProperty;
9
- var __propIsEnum = Object.prototype.propertyIsEnumerable;
10
- var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
11
- var __spreadValues = (a, b) => {
12
- for (var prop in b || (b = {}))
13
- if (__hasOwnProp.call(b, prop))
14
- __defNormalProp(a, prop, b[prop]);
15
- if (__getOwnPropSymbols)
16
- for (var prop of __getOwnPropSymbols(b)) {
17
- if (__propIsEnum.call(b, prop))
18
- __defNormalProp(a, prop, b[prop]);
19
- }
20
- return a;
21
- };
22
- var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
23
- var __objRest = (source, exclude) => {
24
- var target = {};
25
- for (var prop in source)
26
- if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
27
- target[prop] = source[prop];
28
- if (source != null && __getOwnPropSymbols)
29
- for (var prop of __getOwnPropSymbols(source)) {
30
- if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
31
- target[prop] = source[prop];
32
- }
33
- return target;
34
- };
35
- var __export = (target, all) => {
36
- for (var name in all)
37
- __defProp(target, name, { get: all[name], enumerable: true });
38
- };
39
- var __copyProps = (to, from, except, desc) => {
40
- if (from && typeof from === "object" || typeof from === "function") {
41
- for (let key of __getOwnPropNames(from))
42
- if (!__hasOwnProp.call(to, key) && key !== except)
43
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
44
- }
45
- return to;
46
- };
47
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
48
- var __async = (__this, __arguments, generator) => {
49
- return new Promise((resolve, reject) => {
50
- var fulfilled = (value) => {
51
- try {
52
- step(generator.next(value));
53
- } catch (e) {
54
- reject(e);
55
- }
56
- };
57
- var rejected = (value) => {
58
- try {
59
- step(generator.throw(value));
60
- } catch (e) {
61
- reject(e);
62
- }
63
- };
64
- var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
65
- step((generator = generator.apply(__this, __arguments)).next());
66
- });
67
- };
68
-
69
- // src/page.ts
70
- var page_exports = {};
71
- __export(page_exports, {
72
- defineCustomEventMessaging: () => defineCustomEventMessaging,
73
- defineWindowMessaging: () => defineWindowMessaging
74
- });
75
- module.exports = __toCommonJS(page_exports);
76
-
77
- // src/window.ts
78
- var import_uid = require("uid");
79
-
80
- // src/generic.ts
81
- var import_serialize_error = require("serialize-error");
82
- function defineGenericMessanging(config) {
83
- let removeRootListener;
84
- let perTypeListeners = {};
85
- function cleanupRootListener() {
86
- if (Object.entries(perTypeListeners).length === 0) {
87
- removeRootListener == null ? void 0 : removeRootListener();
88
- removeRootListener = void 0;
89
- }
90
- }
91
- let idSeq = Math.floor(Math.random() * 1e4);
92
- function getNextId() {
93
- return idSeq++;
94
- }
95
- return {
96
- sendMessage(type, data, ...args) {
97
- return __async(this, null, function* () {
98
- var _a2, _b, _c, _d;
99
- const _message = {
100
- id: getNextId(),
101
- type,
102
- data,
103
- timestamp: Date.now()
104
- };
105
- const message = (_b = yield (_a2 = config.verifyMessageData) == null ? void 0 : _a2.call(config, _message)) != null ? _b : _message;
106
- (_c = config.logger) == null ? void 0 : _c.debug(`[messaging] sendMessage {id=${message.id}} \u2500\u1405`, message, ...args);
107
- const response = yield config.sendMessage(message, ...args);
108
- const { res, err } = response != null ? response : { err: new Error("No response") };
109
- (_d = config.logger) == null ? void 0 : _d.debug(`[messaging] sendMessage {id=${message.id}} \u140A\u2500`, { res, err });
110
- if (err != null)
111
- throw (0, import_serialize_error.deserializeError)(err);
112
- return res;
113
- });
114
- },
115
- onMessage(type, onReceived) {
116
- var _a2, _b, _c;
117
- if (removeRootListener == null) {
118
- (_a2 = config.logger) == null ? void 0 : _a2.debug(
119
- `[messaging] "${type}" initialized the message listener for this context`
120
- );
121
- removeRootListener = config.addRootListener((message) => {
122
- var _a3, _b2;
123
- if (typeof message.type != "string" || typeof message.timestamp !== "number") {
124
- if (config.breakError) {
125
- return;
126
- }
127
- const err = Error(
128
- `[messaging] Unknown message format, must include the 'type' & 'timestamp' fields, received: ${JSON.stringify(
129
- message
130
- )}`
131
- );
132
- (_a3 = config.logger) == null ? void 0 : _a3.error(err);
133
- throw err;
134
- }
135
- (_b2 = config == null ? void 0 : config.logger) == null ? void 0 : _b2.debug("[messaging] Received message", message);
136
- const listener = perTypeListeners[message.type];
137
- if (listener == null)
138
- return;
139
- const res = listener(message);
140
- return Promise.resolve(res).then((res2) => {
141
- var _a4, _b3;
142
- return (_b3 = (_a4 = config.verifyMessageData) == null ? void 0 : _a4.call(config, res2)) != null ? _b3 : res2;
143
- }).then((res2) => {
144
- var _a4;
145
- (_a4 = config == null ? void 0 : config.logger) == null ? void 0 : _a4.debug(`[messaging] onMessage {id=${message.id}} \u2500\u1405`, { res: res2 });
146
- return { res: res2 };
147
- }).catch((err) => {
148
- var _a4;
149
- (_a4 = config == null ? void 0 : config.logger) == null ? void 0 : _a4.debug(`[messaging] onMessage {id=${message.id}} \u2500\u1405`, { err });
150
- return { err: (0, import_serialize_error.serializeError)(err) };
151
- });
152
- });
153
- }
154
- if (perTypeListeners[type] != null) {
155
- const err = Error(
156
- `[messaging] In this JS context, only one listener can be setup for ${type}`
157
- );
158
- (_b = config.logger) == null ? void 0 : _b.error(err);
159
- throw err;
160
- }
161
- perTypeListeners[type] = onReceived;
162
- (_c = config.logger) == null ? void 0 : _c.log(`[messaging] Added listener for ${type}`);
163
- return () => {
164
- delete perTypeListeners[type];
165
- cleanupRootListener();
166
- };
167
- },
168
- removeAllListeners() {
169
- Object.keys(perTypeListeners).forEach((type) => {
170
- delete perTypeListeners[type];
171
- });
172
- cleanupRootListener();
173
- }
174
- };
175
- }
176
-
177
- // src/window.ts
178
- var REQUEST_TYPE = "@webext-core/messaging/window";
179
- var RESPONSE_TYPE = "@webext-core/messaging/window/response";
180
- function defineWindowMessaging(config) {
181
- const namespace = config.namespace;
182
- const instanceId = (0, import_uid.uid)();
183
- let removeAdditionalListeners = [];
184
- const sendWindowMessage = (message, targetOrigin) => new Promise((res) => {
185
- const responseListener = (event) => {
186
- if (event.data.type === RESPONSE_TYPE && event.data.namespace === namespace && event.data.instanceId !== instanceId && event.data.message.type === message.type) {
187
- res(event.data.response);
188
- removeResponseListener();
189
- }
190
- };
191
- const removeResponseListener = () => window.removeEventListener("message", responseListener);
192
- removeAdditionalListeners.push(removeResponseListener);
193
- window.addEventListener("message", responseListener);
194
- window.postMessage(
195
- { type: REQUEST_TYPE, message, senderOrigin: location.origin, namespace, instanceId },
196
- targetOrigin != null ? targetOrigin : "*"
197
- );
198
- });
199
- const messenger = defineGenericMessanging(__spreadProps(__spreadValues({}, config), {
200
- sendMessage(message, targetOrigin) {
201
- return sendWindowMessage(message, targetOrigin);
202
- },
203
- addRootListener(processMessage) {
204
- const listener = (event) => __async(this, null, function* () {
205
- if (event.data.type !== REQUEST_TYPE || event.data.namespace !== namespace || event.data.instanceId === instanceId)
206
- return;
207
- const response = yield processMessage(event.data.message);
208
- window.postMessage(
209
- { type: RESPONSE_TYPE, response, instanceId, message: event.data.message, namespace },
210
- event.data.senderOrigin
211
- );
212
- });
213
- window.addEventListener("message", listener);
214
- return () => window.removeEventListener("message", listener);
215
- },
216
- verifyMessageData(data) {
217
- return structuredClone(data);
218
- }
219
- }));
220
- return __spreadProps(__spreadValues({}, messenger), {
221
- removeAllListeners() {
222
- messenger.removeAllListeners();
223
- removeAdditionalListeners.forEach((removeListener) => removeListener());
224
- removeAdditionalListeners = [];
225
- }
226
- });
227
- }
228
-
229
- // src/custom-event.ts
230
- var import_uid2 = require("uid");
231
-
232
- // src/utils.ts
233
- function prepareCustomEventDict(data, options = { targetScope: window != null ? window : void 0 }) {
234
- return typeof cloneInto !== "undefined" ? cloneInto(data, options.targetScope) : data;
235
- }
236
-
237
- // src/custom-event.ts
238
- var REQUEST_EVENT = "@webext-core/messaging/custom-events";
239
- var RESPONSE_EVENT = "@webext-core/messaging/custom-events/response";
240
- function defineCustomEventMessaging(config) {
241
- const namespace = config.namespace;
242
- const instanceId = (0, import_uid2.uid)();
243
- const removeAdditionalListeners = [];
244
- const sendCustomMessage = (requestEvent) => new Promise((res) => {
245
- const responseListener = (e) => {
246
- const { detail } = e;
247
- if (detail.namespace === namespace && detail.instanceId !== instanceId && detail.message.type === requestEvent.detail.message.type) {
248
- res(detail.response);
249
- }
250
- };
251
- removeAdditionalListeners.push(
252
- () => window.removeEventListener(RESPONSE_EVENT, responseListener)
253
- );
254
- window.addEventListener(RESPONSE_EVENT, responseListener);
255
- window.dispatchEvent(requestEvent);
256
- });
257
- const messenger = defineGenericMessanging(__spreadProps(__spreadValues({}, config), {
258
- sendMessage(message) {
259
- const reqDetail = { message, namespace, instanceId };
260
- const requestEvent = new CustomEvent(REQUEST_EVENT, {
261
- detail: prepareCustomEventDict(reqDetail)
262
- });
263
- return sendCustomMessage(requestEvent);
264
- },
265
- addRootListener(processMessage) {
266
- const requestListener = (e) => __async(this, null, function* () {
267
- const _a = e, { detail } = _a, event = __objRest(_a, ["detail"]);
268
- if (detail.namespace !== namespace || detail.instanceId === instanceId)
269
- return;
270
- const message = __spreadProps(__spreadValues({}, detail.message), { event });
271
- const response = yield processMessage(message);
272
- const resDetail = { response, message, instanceId, namespace };
273
- const responseEvent = new CustomEvent(RESPONSE_EVENT, {
274
- detail: prepareCustomEventDict(resDetail)
275
- });
276
- window.dispatchEvent(responseEvent);
277
- });
278
- window.addEventListener(REQUEST_EVENT, requestListener);
279
- return () => window.removeEventListener(REQUEST_EVENT, requestListener);
280
- },
281
- verifyMessageData(data) {
282
- return structuredClone(data);
283
- }
284
- }));
285
- return __spreadProps(__spreadValues({}, messenger), {
286
- removeAllListeners() {
287
- messenger.removeAllListeners();
288
- removeAdditionalListeners.forEach((removeListener) => removeListener());
289
- }
290
- });
291
- }
292
- // Annotate the CommonJS export names for ESM import in node:
293
- 0 && (module.exports = {
294
- defineCustomEventMessaging,
295
- defineWindowMessaging
296
- });
package/lib/page.d.ts DELETED
@@ -1,92 +0,0 @@
1
- import { N as NamespaceMessagingConfig, G as GenericMessenger } from './generic-683db69b.js';
2
-
3
- /**
4
- * Configuration passed into `defineWindowMessaging`.
5
- */
6
- interface WindowMessagingConfig extends NamespaceMessagingConfig {
7
- }
8
- /**
9
- * For a `WindowMessenger`, `sendMessage` requires an additional argument, the `targetOrigin`. It
10
- * defines which frames inside the page should receive the message.
11
- *
12
- * > See <https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage#targetorigin> for more
13
- * details.
14
- */
15
- type WindowSendMessageArgs = [targetOrigin?: string];
16
- type WindowMessenger<TProtocolMap extends Record<string, any>> = GenericMessenger<TProtocolMap, {}, WindowSendMessageArgs>;
17
- /**
18
- * Returns a `WindowMessenger`. It is backed by the `window.postMessage` API. It can be used to
19
- * communicate between:
20
- *
21
- * - Content script and website
22
- * - Content script and injected script
23
- *
24
- * @example
25
- * interface WebsiteMessengerSchema {
26
- * initInjectedScript(data: ...): void;
27
- * }
28
- *
29
- * export const websiteMessenger = defineWindowMessaging<initInjectedScript>();
30
- *
31
- * // Content script
32
- * websiteMessenger.sendMessage("initInjectedScript", ...);
33
- *
34
- * // Injected script
35
- * websiteMessenger.onMessage("initInjectedScript", (...) => {
36
- * // ...
37
- * })
38
- *
39
- * @link Spec diagrams
40
- * https://mermaid.live/edit#pako:eNqVlG9v2jAQxr-KZamvGv7YyYBYVSTGWgmpwAs6VZqQJpMc1BOxM8fZoIjvPieBACUVLC8SO3ru7vc4l9viUEWAGU7hdwYyhG-CLzWPZxLZa67WaKCkAWka01CLxDzMdSsobkKmhtsAUuy2SPIY0oSHwNBCKbQrMyRcGxGKhEuDbAT5qSTiKVJyBGnKl_CJKgUZ5br8eaa0-yPaUP6C0EDUeoX5VBi4hKP_A0dvgqM3wvWlMm-gi-Nb15ybe4k25_oTNPcmNPcKWrm8uzvWRF_Ld2NlAKk_oA_FnCodQ4PJaPR9PBz0X4aTMXp6nrwW6NP-6BH1p-j58enlkNsCoXKVX9WnbATB_f6AWcHWMpsE2AwnQi7JDNeFNNb7fmFILKXSlu-vLILP1HnOUkv3uCdqDemlOAgaVRWWS2phqjoXluipJVJriX6wRE8s0auWSGWJXLdEjpZovSV6ZqlcHjtBoVDFcSZFyG0LrIQ85D9rCfqhJcbnYUIWHRGJxQK0HRbHBrPJsINj0DEXkR0z2zz5DNs_I4YZZnYZwYJnK5ND7qyUZ0ZNNzLEzOgMHKxVtnzDbMFXqd1lSWTr7WdU9db2P2ZbvMasQYjX9AnteaRN3HbP7XgO3mBG3U6z533p-W637bue5-4c_K6UTUGbpOtT36edLvXaLu06GCJhlB6Vc7EYj0WJH4U-p9r9Aynbsqc
41
- */
42
- declare function defineWindowMessaging<TProtocolMap extends Record<string, any> = Record<string, any>>(config: WindowMessagingConfig): WindowMessenger<TProtocolMap>;
43
-
44
- /**
45
- * Configuration passed into `defineCustomEventMessaging`.
46
- */
47
- interface CustomEventMessagingConfig extends NamespaceMessagingConfig {
48
- }
49
- /**
50
- * Additional fields available on the `Message` from a `CustomEventMessenger`.
51
- */
52
- interface CustomEventMessage {
53
- /**
54
- * The event that was fired, resulting in the message being passed.
55
- */
56
- event: CustomEvent;
57
- }
58
- /**
59
- * Messenger returned by `defineCustomEventMessenger`.
60
- */
61
- type CustomEventMessenger<TProtocolMap extends Record<string, any>> = GenericMessenger<TProtocolMap, CustomEventMessage, [
62
- ]>;
63
- /**
64
- * Creates a `CustomEventMessenger`. This messenger is backed by the `CustomEvent` APIs. It can be
65
- * used to communicate between:
66
- *
67
- * - Content script and website
68
- * - Content script and injected script
69
- *
70
- * `sendMessage` does not accept any additional arguments..
71
- *
72
- * @example
73
- * interface WebsiteMessengerSchema {
74
- * initInjectedScript(data: ...): void;
75
- * }
76
- *
77
- * export const websiteMessenger = defineCustomEventMessenger<initInjectedScript>();
78
- *
79
- * // Content script
80
- * websiteMessenger.sendMessage("initInjectedScript", ...);
81
- *
82
- * // Injected script
83
- * websiteMessenger.onMessage("initInjectedScript", (...) => {
84
- * // ...
85
- * })
86
- *
87
- * * @link Spec diagrams
88
- * https://mermaid.live/edit#pako:eNqVlG9v2jAQxr-KZamvGv7YyYBYVSTGWgmpwAs6VZqQJpMc1BOxM8fZoIjvPieBACUVLC8SO3ru7vc4l9viUEWAGU7hdwYyhG-CLzWPZxLZa67WaKCkAWka01CLxDzMdSsobkKmhtsAUuy2SPIY0oSHwNBCKbQrMyRcGxGKhEuDbAT5qSTiKVJyBGnKl_CJKgUZ5br8eaa0-yPaUP6C0EDUeoX5VBi4hKP_A0dvgqM3wvWlMm-gi-Nb15ybe4k25_oTNPcmNPcKWrm8uzvWRF_Ld2NlAKk_oA_FnCodQ4PJaPR9PBz0X4aTMXp6nrwW6NP-6BH1p-j58enlkNsCoXKVX9WnbATB_f6AWcHWMpsE2AwnQi7JDNeFNNb7fmFILKXSlu-vLILP1HnOUkv3uCdqDemlOAgaVRWWS2phqjoXluipJVJriX6wRE8s0auWSGWJXLdEjpZovSV6ZqlcHjtBoVDFcSZFyG0LrIQ85D9rCfqhJcbnYUIWHRGJxQK0HRbHBrPJsINj0DEXkR0z2zz5DNs_I4YZZnYZwYJnK5ND7qyUZ0ZNNzLEzOgMHKxVtnzDbMFXqd1lSWTr7WdU9db2P2ZbvMasQYjX9AnteaRN3HbP7XgO3mBG3U6z533p-W637bue5-4c_K6UTUGbpOtT36edLvXaLu06GCJhlB6Vc7EYj0WJH4U-p9r9Aynbsqc
89
- */
90
- declare function defineCustomEventMessaging<TProtocolMap extends Record<string, any> = Record<string, any>>(config: CustomEventMessagingConfig): CustomEventMessenger<TProtocolMap>;
91
-
92
- export { CustomEventMessage, CustomEventMessagingConfig, CustomEventMessenger, WindowMessagingConfig, WindowMessenger, WindowSendMessageArgs, defineCustomEventMessaging, defineWindowMessaging };