@vkma.dev/bridge 0.0.0-stage → 0.2.1

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { BridgeTap, BridgeTapEvent, createTap } from "./tap.js";
+import { AnyIOMethodName, AnyMethodName, AnyReceiveMethodName, AnyReceiveOnlyMethodName, AnyRequestMethodName, AnyRequestOnlyMethodName, ErrorData, ErrorDataAPIError, ErrorDataAuthError, ErrorDataClientError, FailedResponseEventName, ReceiveData, RequestIdProp, RequestProps, ResultResponseEventName, SendOptions, VKBridge, VKBridgeErrorEvent, VKBridgeEvent, VKBridgeEventBase, VKBridgeIOEvent, VKBridgeReceiveOnlyEvent, VKBridgeResultEvent, VKBridgeSend, VKBridgeSubscribeHandler, VkmaBridge } from "./types.js";
+import { RequestIdPolicy, VkmaBridgeOptions, createVKBridge } from "./bridge.js";
+import { Middleware, MiddlewareAPI, applyMiddleware } from "./middleware.js";
+import { LaunchParams, parseURLSearchParamsForGetLaunchParams } from "./launch-params.js";
+import { IOMethodName, MethodName, ReceiveMethodName, ReceiveOnlyMethodName, RequestMethodName, RequestOnlyMethodName, WidgetType } from "./deprecated.js";
+import { ReceiveDataMap, ReceiveEventMap, RequestPropsMap } from "@vkma.dev/bridge-schema";
+export * from "@vkma.dev/bridge-schema";
+//#region src/index.d.ts
+export interface DevtoolsBridgeHandle {
+  tap: BridgeTap;
+  send: (name: string, params?: Record<string, unknown>) => Promise<unknown>;
+}
+declare const bridge: VkmaBridge;
+/**
+ * Subscribe to outgoing `send` calls of the default instance.
+ */
+export declare function onSend(listener: (event: BridgeTapEvent & {
+  direction: "out";
+}) => void): () => void;
+/**
+ * Subscribe to everything incoming on the default instance: paired responses
+ * and unsolicited events.
+ */
+export declare function onEvent(listener: (event: BridgeTapEvent & {
+  direction: "in";
+}) => void): () => void;
+/** The shared tap of the default instance (buffered until first subscribe). */
+export declare const bridgeTap: BridgeTap;
+/** The `globalThis` key the devtools collector looks the handle up by. */
+export declare const devtoolsBridgeGlobalKey = "__vkmaDevtoolsBridge";
+//#endregion
+export { type AnyIOMethodName, type AnyMethodName, type AnyReceiveMethodName, type AnyReceiveOnlyMethodName, type AnyRequestMethodName, type AnyRequestOnlyMethodName, type ErrorData, type ErrorDataAPIError, type ErrorDataAuthError, type ErrorDataClientError, type FailedResponseEventName, type IOMethodName, type LaunchParams, type MethodName, type Middleware, type MiddlewareAPI, type ReceiveData, type ReceiveDataMap, type ReceiveEventMap, type ReceiveMethodName, type ReceiveOnlyMethodName, type RequestIdPolicy, type RequestIdProp, type RequestMethodName, type RequestOnlyMethodName, type RequestProps, type RequestPropsMap, type ResultResponseEventName, type SendOptions, type VKBridge, type VKBridgeErrorEvent, type VKBridgeEvent, type VKBridgeEventBase, type VKBridgeIOEvent, type VKBridgeReceiveOnlyEvent, type VKBridgeResultEvent, type VKBridgeSend, type VKBridgeSubscribeHandler, type VkmaBridge, type VkmaBridgeOptions, type WidgetType, applyMiddleware, createTap, createVKBridge, bridge as default, parseURLSearchParamsForGetLaunchParams };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;iBAyEiB;EAChB,KAAK;EACL,OAAO,cAAc,SAAS,4BAA4B;;cA2BrD,QAAQ;;;;wBAKE,OACf,WAAW,OAAO;EAAmB;;;;;;wBAStB,QACf,WAAW,OAAO;EAAmB;;;qBAMzB,WAAW;;qBAGX"}

package/dist/index.js

@@ -0,0 +1,64 @@
+import { version } from "./package.js";
+import { createTap } from "./tap.js";
+import { createVKBridge } from "./bridge.js";
+import { applyMiddleware } from "./middleware.js";
+import { parseURLSearchParamsForGetLaunchParams } from "./launch-params.js";
+export * from "@vkma.dev/bridge-schema";
+//#region src/index.ts
+/**
+* @vkma.dev/bridge — an independent VK Bridge for VK Mini Apps.
+*
+* The default export is a ready singleton; `createVKBridge` builds additional
+* instances. Every instance carries an always-on tap (see `onSend`/`onEvent`
+* and `tap`), which is what the VKMA devtools observe — no opt-in required.
+*
+* Merely importing this module publishes the page-wide devtools handle on
+* `globalThis.__vkmaDevtoolsBridge` (`{ tap, send }`), so the devtools
+* collector — loaded as a separate script, never sharing a module graph with
+* the app — can observe and drive the app's own bridge instance.
+*/
+/**
+* The devtools bridge handle shared by every copy of this module on the page,
+* exposed on `globalThis` under a stable key so the devtools collector —
+* loaded as a separate script, never sharing a module graph with the app —
+* can observe and drive the app's own bridge instance:
+*
+* - `tap` — replay-buffered stream of sends, paired responses and events
+* - `send` — execute a bridge send inside the app (devtools "execute")
+*/
+const GLOBAL_KEY = "__vkmaDevtoolsBridge";
+const globalScope = globalThis;
+function sharedTap() {
+	const existing = globalScope[GLOBAL_KEY];
+	if (existing) return existing.tap;
+	const tap = createTap();
+	globalScope[GLOBAL_KEY] = {
+		tap,
+		send: (name, params) => bridge.send(name, params)
+	};
+	return tap;
+}
+/** Options of the page-wide default instance: it shares the global tap. */
+const defaultOptions = { tap: sharedTap() };
+const bridge = createVKBridge(version, defaultOptions);
+/**
+* Subscribe to outgoing `send` calls of the default instance.
+*/
+function onSend(listener) {
+	return bridge.onSend(listener);
+}
+/**
+* Subscribe to everything incoming on the default instance: paired responses
+* and unsolicited events.
+*/
+function onEvent(listener) {
+	return bridge.onEvent(listener);
+}
+/** The shared tap of the default instance (buffered until first subscribe). */
+const bridgeTap = bridge.tap;
+/** The `globalThis` key the devtools collector looks the handle up by. */
+const devtoolsBridgeGlobalKey = GLOBAL_KEY;
+//#endregion
+export { applyMiddleware, bridgeTap, createTap, createVKBridge, bridge as default, devtoolsBridgeGlobalKey, onEvent, onSend, parseURLSearchParamsForGetLaunchParams };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["packageJson.version"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @vkma.dev/bridge — an independent VK Bridge for VK Mini Apps.\n *\n * The default export is a ready singleton; `createVKBridge` builds additional\n * instances. Every instance carries an always-on tap (see `onSend`/`onEvent`\n * and `tap`), which is what the VKMA devtools observe — no opt-in required.\n *\n * Merely importing this module publishes the page-wide devtools handle on\n * `globalThis.__vkmaDevtoolsBridge` (`{ tap, send }`), so the devtools\n * collector — loaded as a separate script, never sharing a module graph with\n * the app — can observe and drive the app's own bridge instance.\n */\n\nimport packageJson from \"../package.json\" with { type: \"json\" };\nimport { createVKBridge, type VkmaBridgeOptions } from \"./bridge.ts\";\nimport { createTap, type BridgeTap, type BridgeTapEvent } from \"./tap.ts\";\n\nexport { createVKBridge, type RequestIdPolicy, type VkmaBridgeOptions } from \"./bridge.ts\";\nimport type { VkmaBridge } from \"./types.ts\";\nexport { applyMiddleware, type Middleware, type MiddlewareAPI } from \"./middleware.ts\";\nexport { parseURLSearchParamsForGetLaunchParams, type LaunchParams } from \"./launch-params.ts\";\nexport { createTap } from \"./tap.ts\";\nexport type {\n\tSendOptions,\n\tVKBridge,\n\tVKBridgeErrorEvent,\n\tVKBridgeEvent,\n\tVKBridgeEventBase,\n\tVKBridgeIOEvent,\n\tVKBridgeReceiveOnlyEvent,\n\tVKBridgeResultEvent,\n\tVKBridgeSend,\n\tVKBridgeSubscribeHandler,\n\tVkmaBridge,\n\tAnyIOMethodName,\n\tAnyMethodName,\n\tAnyReceiveMethodName,\n\tAnyReceiveOnlyMethodName,\n\tAnyRequestMethodName,\n\tAnyRequestOnlyMethodName,\n\tErrorData,\n\tErrorDataAPIError,\n\tErrorDataAuthError,\n\tErrorDataClientError,\n\tFailedResponseEventName,\n\tRequestIdProp,\n\tRequestProps,\n\tReceiveData,\n\tResultResponseEventName,\n} from \"./types.ts\";\nexport type {\n\tRequestMethodName,\n\tReceiveMethodName,\n\tRequestOnlyMethodName,\n\tReceiveOnlyMethodName,\n\tMethodName,\n\tIOMethodName,\n\tWidgetType,\n} from \"./deprecated.ts\";\nexport type { ReceiveDataMap, ReceiveEventMap, RequestPropsMap } from \"@vkma.dev/bridge-schema\";\nexport * from \"@vkma.dev/bridge-schema\";\n\n/**\n * The devtools bridge handle shared by every copy of this module on the page,\n * exposed on `globalThis` under a stable key so the devtools collector —\n * loaded as a separate script, never sharing a module graph with the app —\n * can observe and drive the app's own bridge instance:\n *\n * - `tap` — replay-buffered stream of sends, paired responses and events\n * - `send` — execute a bridge send inside the app (devtools \"execute\")\n */\nconst GLOBAL_KEY = \"__vkmaDevtoolsBridge\";\n\nexport interface DevtoolsBridgeHandle {\n\ttap: BridgeTap;\n\tsend: (name: string, params?: Record<string, unknown>) => Promise<unknown>;\n}\n\nconst globalScope = globalThis as typeof globalThis & {\n\t[GLOBAL_KEY]?: DevtoolsBridgeHandle;\n};\n\nfunction sharedTap(): BridgeTap {\n\tconst existing = globalScope[GLOBAL_KEY];\n\tif (existing) {\n\t\treturn existing.tap;\n\t}\n\tconst tap = createTap();\n\tglobalScope[GLOBAL_KEY] = {\n\t\ttap,\n\t\t// The collector executes arbitrary method names — the handle stays\n\t\t// stringly typed by design.\n\t\tsend: (name, params) => bridge.send(name as never, params as never),\n\t};\n\treturn tap;\n}\n\n/** Options of the page-wide default instance: it shares the global tap. */\nconst defaultOptions: VkmaBridgeOptions = {\n\ttap: sharedTap(),\n};\n\nconst bridge: VkmaBridge = createVKBridge(packageJson.version, defaultOptions);\n\n/**\n * Subscribe to outgoing `send` calls of the default instance.\n */\nexport function onSend(\n\tlistener: (event: BridgeTapEvent & { direction: \"out\" }) => void,\n): () => void {\n\treturn bridge.onSend(listener);\n}\n\n/**\n * Subscribe to everything incoming on the default instance: paired responses\n * and unsolicited events.\n */\nexport function onEvent(\n\tlistener: (event: BridgeTapEvent & { direction: \"in\" }) => void,\n): () => void {\n\treturn bridge.onEvent(listener);\n}\n\n/** The shared tap of the default instance (buffered until first subscribe). */\nexport const bridgeTap: BridgeTap = bridge.tap;\n\n/** The `globalThis` key the devtools collector looks the handle up by. */\nexport const devtoolsBridgeGlobalKey = GLOBAL_KEY;\n\nexport { bridge as default };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEA,MAAM,aAAa;AAOnB,MAAM,cAAc;AAIpB,SAAS,YAAuB;CAC/B,MAAM,WAAW,YAAY;CAC7B,IAAI,UACH,OAAO,SAAS;CAEjB,MAAM,MAAM,UAAU;CACtB,YAAY,cAAc;EACzB;EAGA,OAAO,MAAM,WAAW,OAAO,KAAK,MAAe,MAAe;CACnE;CACA,OAAO;AACR;;AAGA,MAAM,iBAAoC,EACzC,KAAK,UAAU,EAChB;AAEA,MAAM,SAAqB,eAAeA,SAAqB,cAAc;;;;AAK7E,SAAgB,OACf,UACa;CACb,OAAO,OAAO,OAAO,QAAQ;AAC9B;;;;;AAMA,SAAgB,QACf,UACa;CACb,OAAO,OAAO,QAAQ,QAAQ;AAC/B;;AAGA,MAAa,YAAuB,OAAO;;AAG3C,MAAa,0BAA0B"}

package/dist/launch-params.d.ts

@@ -0,0 +1,26 @@
+import { GetLaunchParamsResponse } from "@vkma.dev/bridge-schema";
+//#region src/launch-params.d.ts
+/**
+ * Launch params as they appear in the URL — a superset of
+ * `GetLaunchParamsResponse` with the URL-only keys. The OK (Odnoklassniki)
+ * keys (`vk_client`, `vk_ok_*`, `vk_original_vk_id`, `vk_are_pushes_enabled`)
+ * come from the catalogue as optional — vk.com hosts never send them.
+ */
+export interface LaunchParams extends GetLaunchParamsResponse {
+  vk_chat_id: string;
+  vk_is_recommended: number;
+  vk_profile_id: number;
+  vk_has_profile_button: number;
+  vk_testing_group_id: number;
+  odr_enabled: undefined | 1;
+}
+/**
+ * Parses launch params out of a query string (à la
+ * `location.search.slice(1)`), field by field, keeping only the known keys
+ * with validated values.
+ *
+ * @see https://dev.vk.ru/mini-apps/development/launch-params
+ */
+export declare const parseURLSearchParamsForGetLaunchParams: (searchParams: string) => Partial<LaunchParams>;
+//#endregion
+//# sourceMappingURL=launch-params.d.ts.map

package/dist/launch-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-params.d.ts","names":[],"sources":["../src/launch-params.ts"],"mappings":";;;;;;;;iBAkCiB,qBAAqB;EACrC;EACA;EACA;EACA;EACA;EACA;;;;;;;;;qBAUY,yCAAsC,yBAEhD,QAAQ"}

package/dist/launch-params.js

@@ -0,0 +1,103 @@
+//#region src/launch-params.ts
+const LANGUAGES = /* @__PURE__ */ new Set([
+	"ru",
+	"uk",
+	"ua",
+	"en",
+	"be",
+	"kz",
+	"pt",
+	"es"
+]);
+const GROUP_ROLES = /* @__PURE__ */ new Set([
+	"admin",
+	"editor",
+	"member",
+	"moder",
+	"none"
+]);
+const PLATFORMS = /* @__PURE__ */ new Set([
+	"desktop_web",
+	"desktop_web_messenger",
+	"desktop_app_messenger",
+	"desktop_web_ok",
+	"mobile_web",
+	"mobile_web_ok",
+	"mobile_android",
+	"mobile_android_ok",
+	"mobile_android_messenger",
+	"mobile_iphone",
+	"mobile_iphone_ok",
+	"mobile_iphone_messenger",
+	"mobile_ipad"
+]);
+/**
+* Parses launch params out of a query string (à la
+* `location.search.slice(1)`), field by field, keeping only the known keys
+* with validated values.
+*
+* @see https://dev.vk.ru/mini-apps/development/launch-params
+*/
+const parseURLSearchParamsForGetLaunchParams = (searchParams) => {
+	const launchParams = {};
+	try {
+		const parsedSearchParams = new URLSearchParams(searchParams);
+		const convertToggleStateFromStringToNumber = (value) => {
+			switch (value) {
+				case "0":
+				case "false": return 0;
+				case "1":
+				case "true": return 1;
+				default: return;
+			}
+		};
+		parsedSearchParams.forEach((value, query) => {
+			switch (query) {
+				case "vk_ts":
+				case "vk_is_recommended":
+				case "vk_profile_id":
+				case "vk_has_profile_button":
+				case "vk_testing_group_id":
+				case "vk_user_id":
+				case "vk_app_id":
+				case "vk_group_id":
+				case "vk_ok_app_id":
+				case "vk_ok_user_id":
+				case "vk_original_vk_id":
+					launchParams[query] = Number(value);
+					break;
+				case "sign":
+				case "vk_chat_id":
+				case "vk_ref":
+				case "vk_ok_ref":
+				case "vk_client":
+				case "vk_access_token_settings":
+					launchParams[query] = value;
+					break;
+				case "odr_enabled":
+					launchParams.odr_enabled = value === "1" ? 1 : void 0;
+					break;
+				case "vk_is_app_user":
+				case "vk_are_notifications_enabled":
+				case "vk_are_pushes_enabled":
+				case "vk_is_favorite":
+					launchParams[query] = convertToggleStateFromStringToNumber(value);
+					break;
+				case "vk_language":
+					launchParams.vk_language = LANGUAGES.has(value) ? value : void 0;
+					break;
+				case "vk_viewer_group_role":
+					launchParams.vk_viewer_group_role = GROUP_ROLES.has(value) ? value : void 0;
+					break;
+				case "vk_platform": launchParams.vk_platform = PLATFORMS.has(value) ? value : void 0;
+			}
+		});
+	} catch (error) {
+		console.warn(error);
+	}
+	return launchParams;
+};
+//#endregion
+export { parseURLSearchParamsForGetLaunchParams };
+
+//# sourceMappingURL=launch-params.js.map

package/dist/launch-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-params.js","names":[],"sources":["../src/launch-params.ts"],"sourcesContent":["/**\n * Launch params: parsing the `vk_*` query string every mini app is opened\n * with, into the typed shape of the catalogue's `GetLaunchParamsResponse`\n * plus the extra keys only present in the URL form.\n */\n\nimport type { GetLaunchParamsResponse } from \"@vkma.dev/bridge-schema\";\n\nconst LANGUAGES = new Set([\"ru\", \"uk\", \"ua\", \"en\", \"be\", \"kz\", \"pt\", \"es\"]);\n\nconst GROUP_ROLES = new Set([\"admin\", \"editor\", \"member\", \"moder\", \"none\"]);\n\nconst PLATFORMS = new Set([\n\t\"desktop_web\",\n\t\"desktop_web_messenger\",\n\t\"desktop_app_messenger\",\n\t\"desktop_web_ok\",\n\t\"mobile_web\",\n\t\"mobile_web_ok\",\n\t\"mobile_android\",\n\t\"mobile_android_ok\",\n\t\"mobile_android_messenger\",\n\t\"mobile_iphone\",\n\t\"mobile_iphone_ok\",\n\t\"mobile_iphone_messenger\",\n\t\"mobile_ipad\",\n]);\n\n/**\n * Launch params as they appear in the URL — a superset of\n * `GetLaunchParamsResponse` with the URL-only keys. The OK (Odnoklassniki)\n * keys (`vk_client`, `vk_ok_*`, `vk_original_vk_id`, `vk_are_pushes_enabled`)\n * come from the catalogue as optional — vk.com hosts never send them.\n */\nexport interface LaunchParams extends GetLaunchParamsResponse {\n\tvk_chat_id: string;\n\tvk_is_recommended: number;\n\tvk_profile_id: number;\n\tvk_has_profile_button: number;\n\tvk_testing_group_id: number;\n\todr_enabled: undefined | 1;\n}\n\n/**\n * Parses launch params out of a query string (à la\n * `location.search.slice(1)`), field by field, keeping only the known keys\n * with validated values.\n *\n * @see https://dev.vk.ru/mini-apps/development/launch-params\n */\nexport const parseURLSearchParamsForGetLaunchParams = (\n\tsearchParams: string,\n): Partial<LaunchParams> => {\n\tconst launchParams: Partial<LaunchParams> = {};\n\n\ttry {\n\t\tconst parsedSearchParams = new URLSearchParams(searchParams);\n\n\t\tconst convertToggleStateFromStringToNumber = (value: string): 0 | 1 | undefined => {\n\t\t\t// OK hosts serialize toggles both ways (\"true\"/\"false\" and \"0\"/\"1\")\n\t\t\tswitch (value) {\n\t\t\t\tcase \"0\":\n\t\t\t\tcase \"false\":\n\t\t\t\t\treturn 0;\n\t\t\t\tcase \"1\":\n\t\t\t\tcase \"true\":\n\t\t\t\t\treturn 1;\n\t\t\t\tdefault:\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t};\n\n\t\tparsedSearchParams.forEach((value, query) => {\n\t\t\tswitch (query) {\n\t\t\t\tcase \"vk_ts\":\n\t\t\t\tcase \"vk_is_recommended\":\n\t\t\t\tcase \"vk_profile_id\":\n\t\t\t\tcase \"vk_has_profile_button\":\n\t\t\t\tcase \"vk_testing_group_id\":\n\t\t\t\tcase \"vk_user_id\":\n\t\t\t\tcase \"vk_app_id\":\n\t\t\t\tcase \"vk_group_id\":\n\t\t\t\tcase \"vk_ok_app_id\":\n\t\t\t\tcase \"vk_ok_user_id\":\n\t\t\t\tcase \"vk_original_vk_id\":\n\t\t\t\t\tlaunchParams[query] = Number(value);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"sign\":\n\t\t\t\tcase \"vk_chat_id\":\n\t\t\t\tcase \"vk_ref\":\n\t\t\t\tcase \"vk_ok_ref\":\n\t\t\t\tcase \"vk_client\":\n\t\t\t\tcase \"vk_access_token_settings\":\n\t\t\t\t\tlaunchParams[query] = value;\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"odr_enabled\":\n\t\t\t\t\tlaunchParams.odr_enabled = value === \"1\" ? 1 : undefined;\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"vk_is_app_user\":\n\t\t\t\tcase \"vk_are_notifications_enabled\":\n\t\t\t\tcase \"vk_are_pushes_enabled\":\n\t\t\t\tcase \"vk_is_favorite\": {\n\t\t\t\t\tlaunchParams[query] = convertToggleStateFromStringToNumber(value);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase \"vk_language\": {\n\t\t\t\t\tlaunchParams.vk_language = LANGUAGES.has(value)\n\t\t\t\t\t\t? (value as Partial<LaunchParams>[\"vk_language\"])\n\t\t\t\t\t\t: undefined;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase \"vk_viewer_group_role\": {\n\t\t\t\t\tlaunchParams.vk_viewer_group_role = GROUP_ROLES.has(value)\n\t\t\t\t\t\t? (value as Partial<LaunchParams>[\"vk_viewer_group_role\"])\n\t\t\t\t\t\t: undefined;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase \"vk_platform\": {\n\t\t\t\t\tlaunchParams.vk_platform = PLATFORMS.has(value)\n\t\t\t\t\t\t? (value as Partial<LaunchParams>[\"vk_platform\"])\n\t\t\t\t\t\t: undefined;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t} catch (error) {\n\t\tconsole.warn(error);\n\t}\n\n\treturn launchParams;\n};\n"],"mappings":";AAQA,MAAM,4BAAY,IAAI,IAAI;CAAC;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;AAAI,CAAC;AAE1E,MAAM,8BAAc,IAAI,IAAI;CAAC;CAAS;CAAU;CAAU;CAAS;AAAM,CAAC;AAE1E,MAAM,4BAAY,IAAI,IAAI;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD,CAAC;;;;;;;;AAwBD,MAAa,0CACZ,iBAC2B;CAC3B,MAAM,eAAsC,CAAC;CAE7C,IAAI;EACH,MAAM,qBAAqB,IAAI,gBAAgB,YAAY;EAE3D,MAAM,wCAAwC,UAAqC;GAElF,QAAQ,OAAR;IACC,KAAK;IACL,KAAK,SACJ,OAAO;IACR,KAAK;IACL,KAAK,QACJ,OAAO;IACR,SACC;GACF;EACD;EAEA,mBAAmB,SAAS,OAAO,UAAU;GAC5C,QAAQ,OAAR;IACC,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;KACJ,aAAa,SAAS,OAAO,KAAK;KAClC;IACD,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;KACJ,aAAa,SAAS;KACtB;IACD,KAAK;KACJ,aAAa,cAAc,UAAU,MAAM,IAAI,KAAA;KAC/C;IACD,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;KACJ,aAAa,SAAS,qCAAqC,KAAK;KAChE;IAED,KAAK;KACJ,aAAa,cAAc,UAAU,IAAI,KAAK,IAC1C,QACD,KAAA;KACH;IAED,KAAK;KACJ,aAAa,uBAAuB,YAAY,IAAI,KAAK,IACrD,QACD,KAAA;KACH;IAED,KAAK,eACJ,aAAa,cAAc,UAAU,IAAI,KAAK,IAC1C,QACD,KAAA;GAGL;EACD,CAAC;CACF,SAAS,OAAO;EACf,QAAQ,KAAK,KAAK;CACnB;CAEA,OAAO;AACR"}

package/dist/middleware.d.ts

@@ -0,0 +1,25 @@
+import { VKBridge, VKBridgeSend, VKBridgeSubscribeHandler } from "./types.js";
+//#region src/middleware.d.ts
+/**
+ * API that can use middleware.
+ */
+export interface MiddlewareAPI<S extends VKBridgeSend = VKBridgeSend, L extends VKBridgeSubscribeHandler = VKBridgeSubscribeHandler> {
+  send: S;
+  subscribe(listener: L): void;
+}
+/**
+ * A middleware is a higher-order function that composes a dispatch function
+ * to return a new `send` function.
+ */
+export type Middleware<S extends VKBridgeSend = VKBridgeSend> = (api: MiddlewareAPI<S>) => (next: S) => S;
+/**
+ * Creates the VK Bridge enhancer that applies middleware to the `send`
+ * method. This is handy for a variety of tasks such as logging every sent
+ * event.
+ *
+ * @param middlewares The middleware chain to be applied.
+ * @returns The VK Bridge enhancer applying the middleware.
+ */
+export declare function applyMiddleware(...middlewares: Array<Middleware | undefined | null>): (bridge: VKBridge) => VKBridge;
+//#endregion
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","names":[],"sources":["../src/middleware.ts"],"mappings":";;;;;iBAUiB,cAChB,UAAU,eAAe,cACzB,UAAU,2BAA2B;EAErC,MAAM;EACN,UAAU,UAAU;;;;;;YAOT,WAAW,UAAU,eAAe,iBAC/C,KAAK,cAAc,QACd,MAAM,MAAM;;;;;;;;;wBAUF,mBACZ,aAAa,MAAM,kCACnB,QAAQ,aAAa"}

package/dist/middleware.js

@@ -0,0 +1,31 @@
+//#region src/middleware.ts
+/**
+* Creates the VK Bridge enhancer that applies middleware to the `send`
+* method. This is handy for a variety of tasks such as logging every sent
+* event.
+*
+* @param middlewares The middleware chain to be applied.
+* @returns The VK Bridge enhancer applying the middleware.
+*/
+function applyMiddleware(...middlewares) {
+	if (middlewares.includes(void 0) || middlewares.includes(null)) return applyMiddleware(...middlewares.filter((item) => typeof item === "function"));
+	return (bridge) => {
+		if (middlewares.length === 0) return bridge;
+		let send = () => {
+			throw new Error("Sending events while constructing your middleware is not allowed. Other middleware would not be applied to this send.");
+		};
+		const middlewareAPI = {
+			subscribe: bridge.subscribe,
+			send: ((...args) => bridge.send(...args))
+		};
+		send = middlewares.filter((item) => typeof item === "function").map((middleware) => middleware(middlewareAPI)).reduce((a, b) => (next) => a(b(next)))(bridge.send);
+		return {
+			...bridge,
+			send
+		};
+	};
+}
+//#endregion
+export { applyMiddleware };
+
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","names":[],"sources":["../src/middleware.ts"],"sourcesContent":["/**\n * Redux-style middleware over `send`: compose logging, metrics or caching\n * around the dispatch without touching the transport.\n */\n\nimport type { VKBridge, VKBridgeSend, VKBridgeSubscribeHandler } from \"./types.ts\";\n\n/**\n * API that can use middleware.\n */\nexport interface MiddlewareAPI<\n\tS extends VKBridgeSend = VKBridgeSend,\n\tL extends VKBridgeSubscribeHandler = VKBridgeSubscribeHandler,\n> {\n\tsend: S;\n\tsubscribe(listener: L): void;\n}\n\n/**\n * A middleware is a higher-order function that composes a dispatch function\n * to return a new `send` function.\n */\nexport type Middleware<S extends VKBridgeSend = VKBridgeSend> = (\n\tapi: MiddlewareAPI<S>,\n) => (next: S) => S;\n\n/**\n * Creates the VK Bridge enhancer that applies middleware to the `send`\n * method. This is handy for a variety of tasks such as logging every sent\n * event.\n *\n * @param middlewares The middleware chain to be applied.\n * @returns The VK Bridge enhancer applying the middleware.\n */\nexport function applyMiddleware(\n\t...middlewares: Array<Middleware | undefined | null>\n): (bridge: VKBridge) => VKBridge {\n\tif (middlewares.includes(undefined) || middlewares.includes(null)) {\n\t\treturn applyMiddleware(\n\t\t\t...middlewares.filter((item): item is Middleware => typeof item === \"function\"),\n\t\t);\n\t}\n\n\treturn bridge => {\n\t\tif (middlewares.length === 0) {\n\t\t\treturn bridge;\n\t\t}\n\n\t\tlet send: VKBridgeSend = () => {\n\t\t\tthrow new Error(\n\t\t\t\t\"Sending events while constructing your middleware is not allowed. \" +\n\t\t\t\t\t\"Other middleware would not be applied to this send.\",\n\t\t\t);\n\t\t};\n\n\t\tconst middlewareAPI: MiddlewareAPI = {\n\t\t\tsubscribe: bridge.subscribe,\n\t\t\tsend: ((...args: Parameters<VKBridgeSend>) => bridge.send(...args)) as VKBridgeSend,\n\t\t};\n\n\t\tconst chain = middlewares\n\t\t\t.filter((item): item is Middleware => typeof item === \"function\")\n\t\t\t.map(middleware => middleware(middlewareAPI))\n\t\t\t.reduce((a, b) => next => a(b(next)));\n\n\t\tsend = chain(bridge.send);\n\n\t\treturn { ...bridge, send };\n\t};\n}\n"],"mappings":";;;;;;;;;AAkCA,SAAgB,gBACf,GAAG,aAC8B;CACjC,IAAI,YAAY,SAAS,KAAA,CAAS,KAAK,YAAY,SAAS,IAAI,GAC/D,OAAO,gBACN,GAAG,YAAY,QAAQ,SAA6B,OAAO,SAAS,UAAU,CAC/E;CAGD,QAAO,WAAU;EAChB,IAAI,YAAY,WAAW,GAC1B,OAAO;EAGR,IAAI,aAA2B;GAC9B,MAAM,IAAI,MACT,uHAED;EACD;EAEA,MAAM,gBAA+B;GACpC,WAAW,OAAO;GAClB,QAAQ,GAAG,SAAmC,OAAO,KAAK,GAAG,IAAI;EAClE;EAOA,OALc,YACZ,QAAQ,SAA6B,OAAO,SAAS,UAAU,CAAC,CAChE,KAAI,eAAc,WAAW,aAAa,CAAC,CAAC,CAC5C,QAAQ,GAAG,OAAM,SAAQ,EAAE,EAAE,IAAI,CAAC,CAEzB,CAAC,CAAC,OAAO,IAAI;EAExB,OAAO;GAAE,GAAG;GAAQ;EAAK;CAC1B;AACD"}

package/dist/package.js

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "0.2.0";
+//#endregion
+export { version };
+
+//# sourceMappingURL=package.js.map

package/dist/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/tap.d.ts

@@ -0,0 +1,35 @@
+//#region src/tap.d.ts
+/**
+ * Pure tap machinery: a tiny fan-out hub with a bounded replay buffer,
+ * detached from vk-bridge so it is unit-testable and tree-shakeable.
+ *
+ * The bridge wrapper always emits into the tap. When no devtools collector
+ * is attached (production), the buffer fills up once and every later emit
+ * costs a dropped-head push — effectively free.
+ */
+export interface BridgeTapEvent {
+  /** Monotonic within a page load; pairs a `response` with its `send`. */
+  id: number;
+  ts: number;
+  /** `out` — the app called send; `in` — VK sent something to the app. */
+  direction: "out" | "in";
+  /** `send` (out), `response` (in, paired), `event` (in, unsolicited). */
+  kind: "send" | "response" | "event";
+  name: string;
+  payload?: unknown;
+  /** Response pairing: the id of the originating `send` event. */
+  reqId?: number;
+  /** Only for `response`: whether the promise resolved or rejected. */
+  ok?: boolean;
+}
+export interface BridgeTap {
+  emit(event: Omit<BridgeTapEvent, "id" | "ts"> & {
+    ts?: number;
+  }): number;
+  subscribe(listener: (event: BridgeTapEvent) => void): () => void;
+  /** Events buffered before the first subscriber attached, oldest first. */
+  drain(): BridgeTapEvent[];
+}
+export declare function createTap(limit?: number): BridgeTap;
+//#endregion
+//# sourceMappingURL=tap.d.ts.map

package/dist/tap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.d.ts","names":[],"sources":["../src/tap.ts"],"mappings":";;;;;;;;;iBASiB;;EAEhB;EACA;;EAEA;;EAEA;EACA;EACA;;EAEA;;EAEA;;iBAGgB;EAChB,KAAK,OAAO,KAAK;IAAiC;;EAClD,UAAU,WAAW,OAAO;;EAE5B,SAAS;;wBAKM,UAAU,iBAAuC"}

package/dist/tap.js

@@ -0,0 +1,39 @@
+//#region src/tap.ts
+const DEFAULT_BUFFER_LIMIT = 500;
+function createTap(limit = DEFAULT_BUFFER_LIMIT) {
+	let nextId = 0;
+	let buffer = [];
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		emit(partial) {
+			const event = {
+				...partial,
+				id: ++nextId,
+				ts: partial.ts ?? Date.now()
+			};
+			if (listeners.size === 0) {
+				if (buffer && buffer.length >= limit) buffer.shift();
+				buffer?.push(event);
+				return event.id;
+			}
+			for (const listener of listeners) listener(event);
+			return event.id;
+		},
+		subscribe(listener) {
+			listeners.add(listener);
+			const replay = buffer ?? [];
+			buffer = void 0;
+			for (const event of replay) listener(event);
+			return () => {
+				listeners.delete(listener);
+			};
+		},
+		drain() {
+			return buffer ? [...buffer] : [];
+		}
+	};
+}
+//#endregion
+export { createTap };
+
+//# sourceMappingURL=tap.js.map

package/dist/tap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.js","names":[],"sources":["../src/tap.ts"],"sourcesContent":["/**\n * Pure tap machinery: a tiny fan-out hub with a bounded replay buffer,\n * detached from vk-bridge so it is unit-testable and tree-shakeable.\n *\n * The bridge wrapper always emits into the tap. When no devtools collector\n * is attached (production), the buffer fills up once and every later emit\n * costs a dropped-head push — effectively free.\n */\n\nexport interface BridgeTapEvent {\n\t/** Monotonic within a page load; pairs a `response` with its `send`. */\n\tid: number;\n\tts: number;\n\t/** `out` — the app called send; `in` — VK sent something to the app. */\n\tdirection: \"out\" | \"in\";\n\t/** `send` (out), `response` (in, paired), `event` (in, unsolicited). */\n\tkind: \"send\" | \"response\" | \"event\";\n\tname: string;\n\tpayload?: unknown;\n\t/** Response pairing: the id of the originating `send` event. */\n\treqId?: number;\n\t/** Only for `response`: whether the promise resolved or rejected. */\n\tok?: boolean;\n}\n\nexport interface BridgeTap {\n\temit(event: Omit<BridgeTapEvent, \"id\" | \"ts\"> & { ts?: number }): number;\n\tsubscribe(listener: (event: BridgeTapEvent) => void): () => void;\n\t/** Events buffered before the first subscriber attached, oldest first. */\n\tdrain(): BridgeTapEvent[];\n}\n\nconst DEFAULT_BUFFER_LIMIT = 500;\n\nexport function createTap(limit: number = DEFAULT_BUFFER_LIMIT): BridgeTap {\n\tlet nextId = 0;\n\tlet buffer: BridgeTapEvent[] | undefined = [];\n\tconst listeners = new Set<(event: BridgeTapEvent) => void>();\n\n\treturn {\n\t\temit(partial) {\n\t\t\tconst event: BridgeTapEvent = {\n\t\t\t\t...partial,\n\t\t\t\tid: ++nextId,\n\t\t\t\tts: partial.ts ?? Date.now(),\n\t\t\t};\n\t\t\tif (listeners.size === 0) {\n\t\t\t\t// No collector yet (production or devtools not loaded): keep a\n\t\t\t\t// bounded replay so a late-attaching collector still sees recent\n\t\t\t\t// history, then stop growing work at the cap.\n\t\t\t\tif (buffer && buffer.length >= limit) {\n\t\t\t\t\tbuffer.shift();\n\t\t\t\t}\n\t\t\t\tbuffer?.push(event);\n\t\t\t\treturn event.id;\n\t\t\t}\n\t\t\tfor (const listener of listeners) {\n\t\t\t\tlistener(event);\n\t\t\t}\n\t\t\treturn event.id;\n\t\t},\n\t\tsubscribe(listener) {\n\t\t\tlisteners.add(listener);\n\t\t\tconst replay = buffer ?? [];\n\t\t\tbuffer = undefined;\n\t\t\tfor (const event of replay) {\n\t\t\t\tlistener(event);\n\t\t\t}\n\t\t\treturn () => {\n\t\t\t\tlisteners.delete(listener);\n\t\t\t};\n\t\t},\n\t\tdrain() {\n\t\t\treturn buffer ? [...buffer] : [];\n\t\t},\n\t};\n}\n"],"mappings":";AAgCA,MAAM,uBAAuB;AAE7B,SAAgB,UAAU,QAAgB,sBAAiC;CAC1E,IAAI,SAAS;CACb,IAAI,SAAuC,CAAC;CAC5C,MAAM,4BAAY,IAAI,IAAqC;CAE3D,OAAO;EACN,KAAK,SAAS;GACb,MAAM,QAAwB;IAC7B,GAAG;IACH,IAAI,EAAE;IACN,IAAI,QAAQ,MAAM,KAAK,IAAI;GAC5B;GACA,IAAI,UAAU,SAAS,GAAG;IAIzB,IAAI,UAAU,OAAO,UAAU,OAC9B,OAAO,MAAM;IAEd,QAAQ,KAAK,KAAK;IAClB,OAAO,MAAM;GACd;GACA,KAAK,MAAM,YAAY,WACtB,SAAS,KAAK;GAEf,OAAO,MAAM;EACd;EACA,UAAU,UAAU;GACnB,UAAU,IAAI,QAAQ;GACtB,MAAM,SAAS,UAAU,CAAC;GAC1B,SAAS,KAAA;GACT,KAAK,MAAM,SAAS,QACnB,SAAS,KAAK;GAEf,aAAa;IACZ,UAAU,OAAO,QAAQ;GAC1B;EACD;EACA,QAAQ;GACP,OAAO,SAAS,CAAC,GAAG,MAAM,IAAI,CAAC;EAChC;CACD;AACD"}

package/dist/types.d.ts

@@ -0,0 +1,214 @@
+import { BridgeTap, BridgeTapEvent } from "./tap.js";
+import { ReceiveDataMap, ReceiveEventMap, RequestPropsMap } from "@vkma.dev/bridge-schema";
+//#region src/types.d.ts
+/**
+ * Name of a method that can be sent.
+ */
+export type AnyRequestMethodName = keyof RequestPropsMap;
+/**
+ * Name of a method that can be received.
+ */
+export type AnyReceiveMethodName = keyof ReceiveDataMap;
+/**
+ * Name of a method that can be only sent.
+ */
+export type AnyRequestOnlyMethodName = Exclude<AnyRequestMethodName, AnyReceiveMethodName>;
+/**
+ * Name of a method that can be only received.
+ */
+export type AnyReceiveOnlyMethodName = Exclude<AnyReceiveMethodName, AnyRequestMethodName>;
+/**
+ * Type of any method name.
+ */
+export type AnyMethodName = AnyRequestMethodName | AnyReceiveMethodName;
+/**
+ * The name of the method that can be both sent and received.
+ */
+export type AnyIOMethodName = AnyRequestMethodName & AnyReceiveMethodName;
+/**
+ * Getter of request properties of a method.
+ */
+export type RequestProps<M extends AnyRequestMethodName = AnyRequestMethodName> = RequestPropsMap[M];
+/**
+ * Getter of response data of a method.
+ */
+export type ReceiveData<M extends AnyReceiveMethodName> = ReceiveDataMap[M];
+/**
+ * Property for matching a sent request with the received message.
+ */
+export type RequestIdProp = {
+  request_id?: number | string;
+};
+/**
+ * Extra per-send controls on top of the classic two-argument call.
+ */
+export interface SendOptions {
+  /** Reject the promise if no response arrives within this many milliseconds. */
+  timeout?: number;
+  /** Reject the promise when the signal aborts. */
+  signal?: AbortSignal;
+}
+/**
+ * Type of send function for methods that have props.
+ *
+ * @param method The method (event) name to send.
+ * @param props Method properties.
+ * @param options Timeout / abort controls.
+ * @returns The Promise object with response data.
+ */
+export type VKBridgeSend = <K extends AnyRequestMethodName>(method: K, props?: RequestProps<K> & RequestIdProp, options?: SendOptions) => Promise<K extends AnyReceiveMethodName ? ReceiveData<K> : void>;
+/**
+ * Name of the Result response event of a method (per the catalogue wiring).
+ */
+export type ResultResponseEventName<M extends AnyRequestMethodName> = M extends keyof ReceiveEventMap ? ReceiveEventMap[M]["result"] : never;
+/**
+ * Name of the Failed response event of a method (per the catalogue wiring).
+ */
+export type FailedResponseEventName<M extends AnyRequestMethodName> = M extends keyof ReceiveEventMap ? ReceiveEventMap[M]["failed"] : never;
+/**
+ * Client error data.
+ */
+export type ErrorDataClientError = {
+  error_code: number;
+  error_reason: string;
+  error_description?: string;
+};
+/**
+ * API error data.
+ */
+export type ErrorDataAPIError = {
+  error_code: number;
+  error_msg: string;
+  request_params: string[];
+};
+/**
+ * Auth error data.
+ */
+export type ErrorDataAuthError = {
+  error_code: number;
+  error_reason: string;
+  error_description?: string[];
+};
+/**
+ * Error data of a Failed response event.
+ */
+export type ErrorData = {
+  error_type: "client_error";
+  error_data: ErrorDataClientError;
+  request_id?: number | string;
+} | {
+  error_type: "api_error";
+  error_data: ErrorDataAPIError;
+  request_id?: number | string;
+} | {
+  error_type: "auth_error";
+  error_data: ErrorDataAuthError;
+  request_id?: number | string;
+};
+/**
+ * Generic event type for creating event types.
+ */
+export type VKBridgeEventBase<Type extends string, Data> = {
+  detail: {
+    type: Type;
+    data: Data;
+  };
+};
+/**
+ * Type of error event data.
+ */
+export type VKBridgeErrorEvent<M extends AnyReceiveMethodName> = VKBridgeEventBase<M extends AnyRequestMethodName ? FailedResponseEventName<M> : never, ErrorData>;
+/**
+ * Type of event that is a response to a request.
+ */
+export type VKBridgeIOEvent<M extends AnyIOMethodName> = { [K in M]: VKBridgeEventBase<ResultResponseEventName<K>, ReceiveData<K> & RequestIdProp>; }[M];
+/**
+ * Type of event that is not a response to a request.
+ */
+export type VKBridgeReceiveOnlyEvent<M extends AnyReceiveOnlyMethodName> = { [K in M]: VKBridgeEventBase<K, ReceiveData<K>>; }[M];
+/**
+ * Type of result event data.
+ */
+export type VKBridgeResultEvent<M extends AnyReceiveMethodName> = M extends AnyReceiveOnlyMethodName ? VKBridgeReceiveOnlyEvent<M> : M extends AnyIOMethodName ? VKBridgeIOEvent<M> : never;
+/**
+ * VK Bridge event.
+ */
+export type VKBridgeEvent<M extends AnyReceiveMethodName> = VKBridgeErrorEvent<M> | VKBridgeResultEvent<M>;
+/**
+ * Type of function that can be subscribed to VK Bridge events.
+ */
+export type VKBridgeSubscribeHandler = (event: VKBridgeEvent<AnyReceiveMethodName>) => void;
+/**
+ * VK Bridge interface — the classic drop-in surface.
+ */
+export interface VKBridge {
+  /**
+   * Sends an event to the runtime env and returns the Promise object with
+   * response data. In the case of Android/iOS application env is the
+   * application itself. In the case of the browser, the parent frame in
+   * which the event handlers is located.
+   *
+   * @param method The method (event) name to send.
+   * @param [props] Method properties.
+   * @param [options] Timeout / abort controls.
+   * @returns The Promise object with response data.
+   */
+  send: VKBridgeSend;
+  /**
+   * @alias send
+   * @deprecated
+   */
+  sendPromise: VKBridgeSend;
+  /**
+   * Adds an event listener. It will be called any time a data is received.
+   *
+   * @param listener A callback to be invoked on every event receive.
+   */
+  subscribe: (listener: VKBridgeSubscribeHandler) => void;
+  /**
+   * Removes an event listener which has been subscribed for event listening.
+   *
+   * @param listener A callback to unsubscribe.
+   */
+  unsubscribe: (listener: VKBridgeSubscribeHandler) => void;
+  /**
+   * Checks if a method is supported on runtime platform.
+   *
+   * @param method Method (event) name to check.
+   * @returns Result of checking.
+   * @deprecated This method is deprecated. Use supportsAsync instead.
+   */
+  supports: <K extends AnyRequestMethodName>(method: K) => boolean;
+  /**
+   * Checks if a method is supported on runtime platform.
+   *
+   * @param method Method (event) name to check.
+   * @returns The Promise object with result of checking.
+   */
+  supportsAsync: <K extends AnyRequestMethodName>(method: K) => Promise<boolean>;
+  /**
+   * Checks whether the runtime is a WebView.
+   */
+  isWebView: () => boolean;
+  isIframe: () => boolean;
+  isEmbedded: () => boolean;
+  isStandalone: () => boolean;
+}
+/**
+ * The full instance surface: the classic VK Bridge plus the always-on tap
+ * and its subscription helpers.
+ */
+export interface VkmaBridge extends VKBridge {
+  /** The replay-buffered stream of sends, paired responses and events. */
+  tap: BridgeTap;
+  /** Subscribe to outgoing `send` calls. */
+  onSend: (listener: (event: BridgeTapEvent & {
+    direction: "out";
+  }) => void) => () => void;
+  /** Subscribe to everything incoming: paired responses and unsolicited events. */
+  onEvent: (listener: (event: BridgeTapEvent & {
+    direction: "in";
+  }) => void) => () => void;
+}
+//#endregion
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;YAcY,6BAA6B;;;;YAK7B,6BAA6B;;;;YAK7B,2BAA2B,QAAQ,sBAAsB;;;;YAKzD,2BAA2B,QAAQ,sBAAsB;;;;YAKzD,gBAAgB,uBAAuB;;;;YAKvC,kBAAkB,uBAAuB;;;;YAKzC,aAAa,UAAU,uBAAuB,wBACzD,gBAAgB;;;;YAKL,YAAY,UAAU,wBAAwB,eAAe;;;;YAK7D;EAAkB;;;;;iBAKb;;EAEhB;;EAEA,SAAS;;;;;;;;;;YAWE,gBAAgB,UAAU,sBACrC,QAAQ,GACR,QAAQ,aAAa,KAAK,eAC1B,UAAU,gBACN,QAAQ,UAAU,uBAAuB,YAAY;;;;YAK9C,wBAAwB,UAAU,wBAC7C,gBAAgB,kBAAkB,gBAAgB;;;;YAKvC,wBAAwB,UAAU,wBAC7C,gBAAgB,kBAAkB,gBAAgB;;;;YAKvC;EACX;EACA;EACA;;;;;YAMW;EACX;EACA;EACA;;;;;YAMW;EACX;EACA;EACA;;;;;YAMW;EAET;EACA,YAAY;EACZ;;EAGA;EACA,YAAY;EACZ;;EAGA;EACA,YAAY;EACZ;;;;;YAMS,kBAAkB,qBAAqB;EAClD;IACC,MAAM;IACN,MAAM;;;;;;YAOI,mBAAmB,UAAU,wBAAwB,kBAChE,UAAU,uBAAuB,wBAAwB,YACzD;;;;YAMW,gBAAgB,UAAU,sBACpC,KAAK,IAAI,kBAAkB,wBAAwB,IAAI,YAAY,KAAK,kBACxE;;;;YAKU,yBAAyB,UAAU,+BAC7C,KAAK,IAAI,kBAAkB,GAAG,YAAY,OAC1C;;;;YAKU,oBAAoB,UAAU,wBAAwB,UAAU,2BACzE,yBAAyB,KACzB,UAAU,kBACT,gBAAgB;;;;YAMR,cAAc,UAAU,wBACjC,mBAAmB,KACnB,oBAAoB;;;;YAKX,4BAA4B,OAAO,cAAc;;;;iBAK5C;;;;;;;;;;;;EAYhB,MAAM;;;;;EAMN,aAAa;;;;;;EAOb,YAAY,UAAU;;;;;;EAOtB,cAAc,UAAU;;;;;;;;EASxB,WAAW,UAAU,sBAAsB,QAAQ;;;;;;;EAQnD,gBAAgB,UAAU,sBAAsB,QAAQ,MAAM;;;;EAK9D;EAEA;EAEA;EAEA;;;;;;iBAOgB,mBAAmB;;EAEnC,KAAK;;EAEL,SAAS,WAAW,OAAO;IAAmB;;;EAE9C,UAAU,WAAW,OAAO;IAAmB"}