@iota/graphql-transport 0.18.1 → 0.19.1

package/dist/cjs/graphql-websocket-client.d.ts

@@ -0,0 +1,84 @@
+import type { GraphQLDocument } from '@iota/iota-sdk/graphql';
+interface ConnectionInitMessage {
+    type: 'connection_init';
+    payload?: Record<string, unknown>;
+}
+interface SubscribeMessage {
+    id: string;
+    type: 'subscribe';
+    payload: {
+        query: string;
+        variables?: Record<string, unknown>;
+        operationName?: string;
+        extensions?: Record<string, unknown>;
+    };
+}
+interface CompleteMessage {
+    id: string;
+    type: 'complete';
+}
+interface PongMessage {
+    type: 'pong';
+    payload?: Record<string, unknown>;
+}
+/** The socket or handshake failed, as opposed to the server refusing one operation. */
+export declare class GraphQLWebSocketConnectionError extends Error {
+}
+export type GraphQLSubscriptionVariables = Record<string, unknown>;
+export type GraphQLSubscriptionRequest<T = any> = {
+    query: GraphQLDocument;
+    /** Resolved on every send, so a resubscribe can carry a resume cursor. */
+    variables?: GraphQLSubscriptionVariables | (() => GraphQLSubscriptionVariables | undefined);
+    onMessage: (data: T) => void;
+    onError?: (errors: Array<{
+        message: string;
+    }>) => void;
+    onComplete?: () => void;
+    signal?: AbortSignal;
+};
+/**
+ * Configuration options for the GraphQL WebSocket client.
+ */
+export type GraphQLWebSocketClientOptions = {
+    /**
+     * Custom WebSocket class to use.
+     * Defaults to the global WebSocket class, if available.
+     */
+    WebSocketConstructor?: typeof WebSocket;
+    /**
+     * Optional payload to send with the `connection_init` message.
+     * Can be used for authentication tokens or other connection-level metadata.
+     */
+    connectionParams?: Record<string, unknown> | undefined;
+    /**
+     * Milliseconds to wait for the `connection_ack` message before timing out.
+     * @default 30000
+     */
+    connectionAckTimeout?: number;
+    /**
+     * Milliseconds between reconnection attempts.
+     * @default 3000
+     */
+    reconnectTimeout?: number;
+    /**
+     * Maximum number of reconnection attempts before giving up.
+     * @default 5
+     */
+    maxReconnects?: number;
+    /**
+     * Milliseconds to wait for the server to refuse the operation. graphql-ws does not
+     * acknowledge a `subscribe`, so an `error` frame is the only signal. Inside this window it
+     * rejects `subscribe()`, after it it goes to `onError`. Messages arrive throughout.
+     * @default 250
+     */
+    startupErrorGrace?: number;
+};
+export declare class GraphQLWebSocketClient {
+    #private;
+    constructor(endpoint: string, options?: GraphQLWebSocketClientOptions);
+    subscribe<T>(request: GraphQLSubscriptionRequest<T>): Promise<() => Promise<boolean>>;
+    send(message: ConnectionInitMessage | SubscribeMessage | CompleteMessage | PongMessage): Promise<WebSocket>;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=graphql-websocket-client.d.ts.map

package/dist/cjs/graphql-websocket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-websocket-client.d.ts","sourceRoot":"","sources":["../../src/graphql-websocket-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,UAAU,qBAAqB;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAOD,UAAU,gBAAgB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC;CACL;AAiBD,UAAU,eAAe;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;CACpB;AAOD,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AASD,uFAAuF;AACvF,qBAAa,+BAAgC,SAAQ,KAAK;CAAG;AAE7D,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGnE,MAAM,MAAM,0BAA0B,CAAC,CAAC,GAAG,GAAG,IAAI;IAC9C,KAAK,EAAE,eAAe,CAAC;IACvB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,4BAA4B,GAAG,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC,CAAC;IAC5F,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IACxC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,SAAS,CAAC;IACxC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvD;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAqCF,qBAAa,sBAAsB;;gBASnB,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,6BAAkC;IAYnE,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IA6CrF,IAAI,CACN,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,eAAe,GAAG,WAAW,GAClF,OAAO,CAAC,SAAS,CAAC;IAMrB,KAAK,IAAI,IAAI;CA0JhB"}

package/dist/cjs/graphql-websocket-client.js

@@ -0,0 +1,324 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __privateWrapper = (obj, member, setter, getter) => ({
+  set _(value) {
+    __privateSet(obj, member, value, setter);
+  },
+  get _() {
+    return __privateGet(obj, member, getter);
+  }
+});
+var graphql_websocket_client_exports = {};
+__export(graphql_websocket_client_exports, {
+  GraphQLWebSocketClient: () => GraphQLWebSocketClient,
+  GraphQLWebSocketConnectionError: () => GraphQLWebSocketConnectionError
+});
+module.exports = __toCommonJS(graphql_websocket_client_exports);
+var import_graphql = require("graphql");
+var _endpoint, _options, _subscriptionId, _disconnects, _webSocket, _connectionPromise, _subscriptions, _GraphQLWebSocketClient_instances, nextId_fn, setupWebSocket_fn, scheduleReconnect_fn, reconnect_fn, _request, _active, _socket, _startingUp, _startupError;
+class GraphQLWebSocketConnectionError extends Error {
+}
+const DEFAULT_OPTIONS = {
+  WebSocketConstructor: typeof WebSocket !== "undefined" ? WebSocket : void 0,
+  connectionParams: void 0,
+  connectionAckTimeout: 3e4,
+  reconnectTimeout: 3e3,
+  maxReconnects: 5,
+  startupErrorGrace: 250
+};
+function toQueryString(query) {
+  if (typeof query === "string") {
+    return query;
+  }
+  return "kind" in query ? (0, import_graphql.print)(query) : String(query);
+}
+function toWebSocketUrl(httpUrl) {
+  const url = new URL(httpUrl);
+  url.protocol = url.protocol.replace("http", "ws");
+  return url.toString();
+}
+class GraphQLWebSocketClient {
+  constructor(endpoint, options = {}) {
+    __privateAdd(this, _GraphQLWebSocketClient_instances);
+    __privateAdd(this, _endpoint);
+    __privateAdd(this, _options);
+    __privateAdd(this, _subscriptionId, 0);
+    __privateAdd(this, _disconnects, 0);
+    __privateAdd(this, _webSocket, null);
+    __privateAdd(this, _connectionPromise, null);
+    __privateAdd(this, _subscriptions, /* @__PURE__ */ new Map());
+    __privateSet(this, _options, { ...DEFAULT_OPTIONS, ...options });
+    if (!__privateGet(this, _options).WebSocketConstructor) {
+      throw new GraphQLWebSocketConnectionError(
+        "Missing WebSocket constructor. Provide a WebSocketConstructor option or ensure the global WebSocket is available."
+      );
+    }
+    __privateSet(this, _endpoint, endpoint.startsWith("ws") ? endpoint : toWebSocketUrl(endpoint));
+  }
+  async subscribe(request) {
+    if (request.signal?.aborted) {
+      return async () => false;
+    }
+    const subscription = new GraphQLSubscription(request);
+    const id = __privateMethod(this, _GraphQLWebSocketClient_instances, nextId_fn).call(this);
+    __privateGet(this, _subscriptions).set(id, subscription);
+    try {
+      await subscription.subscribe(this, id);
+    } catch (e) {
+      __privateGet(this, _subscriptions).delete(id);
+      throw e;
+    }
+    const startupError = await subscription.settleStartup(__privateGet(this, _options).startupErrorGrace);
+    if (startupError) {
+      __privateGet(this, _subscriptions).delete(id);
+      throw new Error(
+        `GraphQL subscription was rejected: ${startupError.map((error) => error.message).join(", ")}`
+      );
+    }
+    const cleanup = async () => {
+      const result = await subscription.unsubscribe(this, id);
+      __privateGet(this, _subscriptions).delete(id);
+      return result;
+    };
+    if (request.signal?.aborted) {
+      await cleanup();
+      return async () => false;
+    }
+    request.signal?.addEventListener("abort", cleanup, { once: true });
+    return cleanup;
+  }
+  async send(message) {
+    const ws = await __privateMethod(this, _GraphQLWebSocketClient_instances, setupWebSocket_fn).call(this);
+    ws.send(JSON.stringify(message));
+    return ws;
+  }
+  close() {
+    for (const subscription of __privateGet(this, _subscriptions).values()) {
+      subscription.onComplete();
+    }
+    __privateGet(this, _subscriptions).clear();
+    __privateGet(this, _webSocket)?.close();
+    __privateSet(this, _webSocket, null);
+    __privateSet(this, _connectionPromise, null);
+    __privateSet(this, _disconnects, 0);
+  }
+}
+_endpoint = new WeakMap();
+_options = new WeakMap();
+_subscriptionId = new WeakMap();
+_disconnects = new WeakMap();
+_webSocket = new WeakMap();
+_connectionPromise = new WeakMap();
+_subscriptions = new WeakMap();
+_GraphQLWebSocketClient_instances = new WeakSet();
+nextId_fn = function() {
+  __privateSet(this, _subscriptionId, __privateGet(this, _subscriptionId) + 1);
+  return String(__privateGet(this, _subscriptionId));
+};
+setupWebSocket_fn = function() {
+  if (__privateGet(this, _connectionPromise)) {
+    return __privateGet(this, _connectionPromise);
+  }
+  __privateSet(this, _connectionPromise, new Promise((resolve, reject) => {
+    const ws = new (__privateGet(this, _options)).WebSocketConstructor(
+      __privateGet(this, _endpoint),
+      "graphql-transport-ws"
+    );
+    __privateSet(this, _webSocket, ws);
+    const ackTimeout = setTimeout(() => {
+      ws.close();
+      reject(new GraphQLWebSocketConnectionError("Connection acknowledgement timeout"));
+    }, __privateGet(this, _options).connectionAckTimeout);
+    let acknowledged = false;
+    ws.addEventListener("open", () => {
+      const initMessage = {
+        type: "connection_init",
+        ...__privateGet(this, _options).connectionParams ? { payload: __privateGet(this, _options).connectionParams } : {}
+      };
+      ws.send(JSON.stringify(initMessage));
+    });
+    ws.addEventListener("message", ({ data }) => {
+      let message;
+      try {
+        message = JSON.parse(data);
+      } catch (error) {
+        console.error(
+          new Error(`Failed to parse GraphQL WebSocket message: ${data}`, {
+            cause: error
+          })
+        );
+        return;
+      }
+      switch (message.type) {
+        case "connection_ack":
+          clearTimeout(ackTimeout);
+          acknowledged = true;
+          __privateSet(this, _disconnects, 0);
+          resolve(ws);
+          break;
+        case "next":
+          __privateGet(this, _subscriptions).get(message.id)?.onMessage(message.payload);
+          break;
+        case "error":
+          __privateGet(this, _subscriptions).get(message.id)?.onError(message.payload);
+          __privateGet(this, _subscriptions).delete(message.id);
+          break;
+        case "complete":
+          __privateGet(this, _subscriptions).get(message.id)?.onComplete();
+          __privateGet(this, _subscriptions).delete(message.id);
+          break;
+        case "ping":
+          ws.send(JSON.stringify({ type: "pong" }));
+          break;
+      }
+    });
+    ws.addEventListener("close", () => {
+      if (__privateGet(this, _webSocket) !== ws) {
+        return;
+      }
+      __privateSet(this, _connectionPromise, null);
+      __privateSet(this, _webSocket, null);
+      if (!acknowledged) {
+        clearTimeout(ackTimeout);
+        reject(
+          new GraphQLWebSocketConnectionError(
+            "WebSocket closed before connection was acknowledged"
+          )
+        );
+      }
+      __privateMethod(this, _GraphQLWebSocketClient_instances, scheduleReconnect_fn).call(this);
+    });
+    ws.addEventListener("error", () => {
+      if (!acknowledged) {
+        clearTimeout(ackTimeout);
+        reject(new GraphQLWebSocketConnectionError("WebSocket connection error"));
+      }
+    });
+  }));
+  return __privateGet(this, _connectionPromise);
+};
+scheduleReconnect_fn = function() {
+  const live = [...__privateGet(this, _subscriptions).values()].filter(
+    (subscription) => subscription.isActive
+  );
+  if (live.length === 0) {
+    return;
+  }
+  __privateWrapper(this, _disconnects)._++;
+  if (__privateGet(this, _disconnects) > __privateGet(this, _options).maxReconnects) {
+    for (const subscription of live) {
+      subscription.onError([{ message: "WebSocket connection lost" }]);
+    }
+    __privateGet(this, _subscriptions).clear();
+    return;
+  }
+  setTimeout(() => {
+    __privateMethod(this, _GraphQLWebSocketClient_instances, reconnect_fn).call(this);
+  }, __privateGet(this, _options).reconnectTimeout);
+};
+reconnect_fn = async function() {
+  const entries = [...__privateGet(this, _subscriptions).entries()].filter(
+    ([, subscription]) => subscription.socket !== __privateGet(this, _webSocket)
+  );
+  await Promise.allSettled(
+    entries.map(([id, subscription]) => subscription.subscribe(this, id))
+  );
+};
+class GraphQLSubscription {
+  constructor(request) {
+    // oxlint-disable-next-line @typescript-eslint/no-explicit-any
+    __privateAdd(this, _request);
+    __privateAdd(this, _active, false);
+    __privateAdd(this, _socket, null);
+    __privateAdd(this, _startingUp, true);
+    __privateAdd(this, _startupError, null);
+    __privateSet(this, _request, request);
+  }
+  get isActive() {
+    return __privateGet(this, _active);
+  }
+  /** The socket this operation's `subscribe` frame was last sent on. */
+  get socket() {
+    return __privateGet(this, _socket);
+  }
+  async subscribe(client, id) {
+    const variables = typeof __privateGet(this, _request).variables === "function" ? __privateGet(this, _request).variables() : __privateGet(this, _request).variables;
+    __privateSet(this, _socket, await client.send({
+      id,
+      type: "subscribe",
+      payload: {
+        query: toQueryString(__privateGet(this, _request).query),
+        ...variables ? { variables } : {}
+      }
+    }));
+    __privateSet(this, _active, true);
+  }
+  async unsubscribe(client, id) {
+    if (!__privateGet(this, _active)) return false;
+    __privateSet(this, _active, false);
+    try {
+      await client.send({ id, type: "complete" });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  onMessage(payload) {
+    if (!__privateGet(this, _active)) return;
+    if (payload.errors && payload.errors.length > 0) {
+      __privateGet(this, _request).onError?.(payload.errors);
+      return;
+    }
+    if (payload.data != null) {
+      __privateGet(this, _request).onMessage(payload.data);
+    }
+  }
+  /** Closes the startup window and reports an error the server sent inside it, if any. */
+  async settleStartup(grace) {
+    await new Promise((resolve) => setTimeout(resolve, grace));
+    __privateSet(this, _startingUp, false);
+    return __privateGet(this, _startupError);
+  }
+  onError(errors) {
+    __privateSet(this, _active, false);
+    if (__privateGet(this, _startingUp)) {
+      __privateSet(this, _startupError, errors);
+      return;
+    }
+    __privateGet(this, _request).onError?.(errors);
+  }
+  onComplete() {
+    __privateSet(this, _active, false);
+    __privateGet(this, _request).onComplete?.();
+  }
+}
+_request = new WeakMap();
+_active = new WeakMap();
+_socket = new WeakMap();
+_startingUp = new WeakMap();
+_startupError = new WeakMap();
+//# sourceMappingURL=graphql-websocket-client.js.map

package/dist/cjs/graphql-websocket-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/graphql-websocket-client.ts"],
+  "sourcesContent": ["// Copyright (c) 2026 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { GraphQLDocument } from '@iota/iota-sdk/graphql';\nimport { print } from 'graphql';\n\ninterface ConnectionInitMessage {\n    type: 'connection_init';\n    payload?: Record<string, unknown>;\n}\n\ninterface ConnectionAckMessage {\n    type: 'connection_ack';\n    payload?: Record<string, unknown>;\n}\n\ninterface SubscribeMessage {\n    id: string;\n    type: 'subscribe';\n    payload: {\n        query: string;\n        variables?: Record<string, unknown>;\n        operationName?: string;\n        extensions?: Record<string, unknown>;\n    };\n}\n\ninterface NextMessage {\n    id: string;\n    type: 'next';\n    payload: {\n        data?: unknown;\n        errors?: Array<{ message: string }>;\n    };\n}\n\ninterface ErrorMessage {\n    id: string;\n    type: 'error';\n    payload: Array<{ message: string }>;\n}\n\ninterface CompleteMessage {\n    id: string;\n    type: 'complete';\n}\n\ninterface PingMessage {\n    type: 'ping';\n    payload?: Record<string, unknown>;\n}\n\ninterface PongMessage {\n    type: 'pong';\n    payload?: Record<string, unknown>;\n}\n\ntype ServerMessage =\n    | ConnectionAckMessage\n    | NextMessage\n    | ErrorMessage\n    | CompleteMessage\n    | PingMessage;\n\n/** The socket or handshake failed, as opposed to the server refusing one operation. */\nexport class GraphQLWebSocketConnectionError extends Error {}\n\nexport type GraphQLSubscriptionVariables = Record<string, unknown>;\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport type GraphQLSubscriptionRequest<T = any> = {\n    query: GraphQLDocument;\n    /** Resolved on every send, so a resubscribe can carry a resume cursor. */\n    variables?: GraphQLSubscriptionVariables | (() => GraphQLSubscriptionVariables | undefined);\n    onMessage: (data: T) => void;\n    onError?: (errors: Array<{ message: string }>) => void;\n    onComplete?: () => void;\n    signal?: AbortSignal;\n};\n\n/**\n * Configuration options for the GraphQL WebSocket client.\n */\nexport type GraphQLWebSocketClientOptions = {\n    /**\n     * Custom WebSocket class to use.\n     * Defaults to the global WebSocket class, if available.\n     */\n    WebSocketConstructor?: typeof WebSocket;\n    /**\n     * Optional payload to send with the `connection_init` message.\n     * Can be used for authentication tokens or other connection-level metadata.\n     */\n    connectionParams?: Record<string, unknown> | undefined;\n    /**\n     * Milliseconds to wait for the `connection_ack` message before timing out.\n     * @default 30000\n     */\n    connectionAckTimeout?: number;\n    /**\n     * Milliseconds between reconnection attempts.\n     * @default 3000\n     */\n    reconnectTimeout?: number;\n    /**\n     * Maximum number of reconnection attempts before giving up.\n     * @default 5\n     */\n    maxReconnects?: number;\n    /**\n     * Milliseconds to wait for the server to refuse the operation. graphql-ws does not\n     * acknowledge a `subscribe`, so an `error` frame is the only signal. Inside this window it\n     * rejects `subscribe()`, after it it goes to `onError`. Messages arrive throughout.\n     * @default 250\n     */\n    startupErrorGrace?: number;\n};\n\ntype ResolvedGraphQLWebSocketClientOptions = {\n    WebSocketConstructor: typeof WebSocket;\n    connectionParams: Record<string, unknown> | undefined;\n    connectionAckTimeout: number;\n    reconnectTimeout: number;\n    maxReconnects: number;\n    startupErrorGrace: number;\n};\n\nconst DEFAULT_OPTIONS: ResolvedGraphQLWebSocketClientOptions = {\n    WebSocketConstructor: (typeof WebSocket !== 'undefined'\n        ? WebSocket\n        : undefined) as typeof WebSocket,\n    connectionParams: undefined,\n    connectionAckTimeout: 30_000,\n    reconnectTimeout: 3_000,\n    maxReconnects: 5,\n    startupErrorGrace: 250,\n};\n\n/** Codegen's string-mode documents stringify themselves; only a real AST needs printing. */\nfunction toQueryString(query: GraphQLDocument): string {\n    if (typeof query === 'string') {\n        return query;\n    }\n\n    return 'kind' in query ? print(query) : String(query);\n}\n\nfunction toWebSocketUrl(httpUrl: string): string {\n    const url = new URL(httpUrl);\n    url.protocol = url.protocol.replace('http', 'ws');\n    return url.toString();\n}\n\nexport class GraphQLWebSocketClient {\n    #endpoint: string;\n    #options: ResolvedGraphQLWebSocketClientOptions;\n    #subscriptionId = 0;\n    #disconnects = 0;\n    #webSocket: WebSocket | null = null;\n    #connectionPromise: Promise<WebSocket> | null = null;\n    #subscriptions = new Map<string, GraphQLSubscription>();\n\n    constructor(endpoint: string, options: GraphQLWebSocketClientOptions = {}) {\n        this.#options = { ...DEFAULT_OPTIONS, ...options };\n\n        if (!this.#options.WebSocketConstructor) {\n            throw new GraphQLWebSocketConnectionError(\n                'Missing WebSocket constructor. Provide a WebSocketConstructor option or ensure the global WebSocket is available.',\n            );\n        }\n\n        this.#endpoint = endpoint.startsWith('ws') ? endpoint : toWebSocketUrl(endpoint);\n    }\n\n    async subscribe<T>(request: GraphQLSubscriptionRequest<T>): Promise<() => Promise<boolean>> {\n        if (request.signal?.aborted) {\n            return async () => false;\n        }\n\n        const subscription = new GraphQLSubscription(request);\n        const id = this.#nextId();\n        this.#subscriptions.set(id, subscription);\n\n        try {\n            await subscription.subscribe(this, id);\n        } catch (e) {\n            this.#subscriptions.delete(id);\n            throw e;\n        }\n\n        const startupError = await subscription.settleStartup(this.#options.startupErrorGrace);\n\n        if (startupError) {\n            this.#subscriptions.delete(id);\n            throw new Error(\n                `GraphQL subscription was rejected: ${startupError\n                    .map((error) => error.message)\n                    .join(', ')}`,\n            );\n        }\n\n        const cleanup = async () => {\n            const result = await subscription.unsubscribe(this, id);\n            this.#subscriptions.delete(id);\n            return result;\n        };\n\n        // A listener added to an already-aborted signal never runs, and the handshake\n        // above is awaited.\n        if (request.signal?.aborted) {\n            await cleanup();\n            return async () => false;\n        }\n\n        request.signal?.addEventListener('abort', cleanup, { once: true });\n\n        return cleanup;\n    }\n\n    async send(\n        message: ConnectionInitMessage | SubscribeMessage | CompleteMessage | PongMessage,\n    ): Promise<WebSocket> {\n        const ws = await this.#setupWebSocket();\n        ws.send(JSON.stringify(message));\n        return ws;\n    }\n\n    close(): void {\n        for (const subscription of this.#subscriptions.values()) {\n            subscription.onComplete();\n        }\n        this.#subscriptions.clear();\n        this.#webSocket?.close();\n        this.#webSocket = null;\n        this.#connectionPromise = null;\n        this.#disconnects = 0;\n    }\n\n    #nextId(): string {\n        this.#subscriptionId += 1;\n        return String(this.#subscriptionId);\n    }\n\n    #setupWebSocket(): Promise<WebSocket> {\n        if (this.#connectionPromise) {\n            return this.#connectionPromise;\n        }\n\n        this.#connectionPromise = new Promise<WebSocket>((resolve, reject) => {\n            const ws = new this.#options.WebSocketConstructor(\n                this.#endpoint,\n                'graphql-transport-ws',\n            );\n            this.#webSocket = ws;\n\n            // Timeout for the connection_ack\n            const ackTimeout = setTimeout(() => {\n                ws.close();\n                reject(new GraphQLWebSocketConnectionError('Connection acknowledgement timeout'));\n            }, this.#options.connectionAckTimeout);\n\n            let acknowledged = false;\n\n            ws.addEventListener('open', () => {\n                const initMessage: ConnectionInitMessage = {\n                    type: 'connection_init',\n                    ...(this.#options.connectionParams\n                        ? { payload: this.#options.connectionParams }\n                        : {}),\n                };\n                ws.send(JSON.stringify(initMessage));\n            });\n\n            ws.addEventListener('message', ({ data }: { data: string }) => {\n                let message: ServerMessage;\n                try {\n                    message = JSON.parse(data) as ServerMessage;\n                } catch (error) {\n                    console.error(\n                        new Error(`Failed to parse GraphQL WebSocket message: ${data}`, {\n                            cause: error,\n                        }),\n                    );\n                    return;\n                }\n\n                switch (message.type) {\n                    case 'connection_ack':\n                        clearTimeout(ackTimeout);\n                        acknowledged = true;\n                        this.#disconnects = 0;\n                        resolve(ws);\n                        break;\n\n                    case 'next':\n                        this.#subscriptions.get(message.id)?.onMessage(message.payload);\n                        break;\n\n                    case 'error':\n                        this.#subscriptions.get(message.id)?.onError(message.payload);\n                        this.#subscriptions.delete(message.id);\n                        break;\n\n                    case 'complete':\n                        this.#subscriptions.get(message.id)?.onComplete();\n                        this.#subscriptions.delete(message.id);\n                        break;\n\n                    case 'ping':\n                        // Respond to server keep-alive\n                        ws.send(JSON.stringify({ type: 'pong' } satisfies PongMessage));\n                        break;\n                }\n            });\n\n            ws.addEventListener('close', () => {\n                if (this.#webSocket !== ws) {\n                    return;\n                }\n\n                this.#connectionPromise = null;\n                this.#webSocket = null;\n\n                if (!acknowledged) {\n                    clearTimeout(ackTimeout);\n                    reject(\n                        new GraphQLWebSocketConnectionError(\n                            'WebSocket closed before connection was acknowledged',\n                        ),\n                    );\n                }\n\n                this.#scheduleReconnect();\n            });\n\n            ws.addEventListener('error', () => {\n                if (!acknowledged) {\n                    clearTimeout(ackTimeout);\n                    reject(new GraphQLWebSocketConnectionError('WebSocket connection error'));\n                }\n            });\n        });\n\n        return this.#connectionPromise;\n    }\n\n    #scheduleReconnect(): void {\n        const live = [...this.#subscriptions.values()].filter(\n            (subscription) => subscription.isActive,\n        );\n\n        if (live.length === 0) {\n            return;\n        }\n\n        this.#disconnects++;\n\n        if (this.#disconnects > this.#options.maxReconnects) {\n            for (const subscription of live) {\n                subscription.onError([{ message: 'WebSocket connection lost' }]);\n            }\n            this.#subscriptions.clear();\n            return;\n        }\n\n        setTimeout(() => {\n            this.#reconnect();\n        }, this.#options.reconnectTimeout);\n    }\n\n    async #reconnect(): Promise<void> {\n        // A subscribe() during the reconnect delay is already live on the new socket.\n        // A duplicate id makes graphql-transport-ws close the connection with 4409.\n        const entries = [...this.#subscriptions.entries()].filter(\n            ([, subscription]) => subscription.socket !== this.#webSocket,\n        );\n\n        await Promise.allSettled(\n            entries.map(([id, subscription]) => subscription.subscribe(this, id)),\n        );\n    }\n}\n\nclass GraphQLSubscription {\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    #request: GraphQLSubscriptionRequest<any>;\n    #active = false;\n    #socket: WebSocket | null = null;\n    #startingUp = true;\n    #startupError: Array<{ message: string }> | null = null;\n\n    constructor(request: GraphQLSubscriptionRequest) {\n        this.#request = request;\n    }\n\n    get isActive(): boolean {\n        return this.#active;\n    }\n\n    /** The socket this operation's `subscribe` frame was last sent on. */\n    get socket(): WebSocket | null {\n        return this.#socket;\n    }\n\n    async subscribe(client: GraphQLWebSocketClient, id: string): Promise<void> {\n        const variables =\n            typeof this.#request.variables === 'function'\n                ? this.#request.variables()\n                : this.#request.variables;\n\n        this.#socket = await client.send({\n            id,\n            type: 'subscribe',\n            payload: {\n                query: toQueryString(this.#request.query),\n                ...(variables ? { variables } : {}),\n            },\n        });\n        this.#active = true;\n    }\n\n    async unsubscribe(client: GraphQLWebSocketClient, id: string): Promise<boolean> {\n        if (!this.#active) return false;\n        this.#active = false;\n        try {\n            await client.send({ id, type: 'complete' });\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    onMessage(payload: NextMessage['payload']): void {\n        if (!this.#active) return;\n\n        if (payload.errors && payload.errors.length > 0) {\n            this.#request.onError?.(payload.errors);\n            return;\n        }\n\n        if (payload.data != null) {\n            this.#request.onMessage(payload.data);\n        }\n    }\n\n    /** Closes the startup window and reports an error the server sent inside it, if any. */\n    async settleStartup(grace: number): Promise<Array<{ message: string }> | null> {\n        await new Promise((resolve) => setTimeout(resolve, grace));\n        this.#startingUp = false;\n        return this.#startupError;\n    }\n\n    onError(errors: ErrorMessage['payload']): void {\n        this.#active = false;\n\n        if (this.#startingUp) {\n            this.#startupError = errors;\n            return;\n        }\n\n        this.#request.onError?.(errors);\n    }\n\n    onComplete(): void {\n        this.#active = false;\n        this.#request.onComplete?.();\n    }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/index.d.ts

@@ -1,2 +1,3 @@
 export * from './transport.js';
+export * from './graphql-websocket-client.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC"}

package/dist/cjs/index.js

@@ -16,4 +16,5 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 module.exports = __toCommonJS(index_exports);
 __reExport(index_exports, require("./transport.js"), module.exports);
+__reExport(index_exports, require("./graphql-websocket-client.js"), module.exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nexport * from './transport.js';\n"],
-  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAIA,0BAAc,2BAJd;",
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nexport * from './transport.js';\nexport * from './graphql-websocket-client.js';\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAIA,0BAAc,2BAJd;AAKA,0BAAc,0CALd;",
   "names": []
 }

package/dist/cjs/mappers/bcs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bcs.d.ts","sourceRoot":"","sources":["../../../src/mappers/bcs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CA6ChE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,UAGjE"}
+{"version":3,"file":"bcs.d.ts","sourceRoot":"","sources":["../../../src/mappers/bcs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAuDhE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,UAGjE"}

package/dist/cjs/mappers/bcs.js

@@ -57,12 +57,20 @@ function layoutToBcs(layout) {
     if (structName === "0x2::object::ID") {
       struct = struct.transform({
         input: (id) => typeof id === "string" ? { bytes: id } : id,
-        output: (id) => id.id
+        output: (id) => id.bytes
       });
-      return struct;
     }
+    if (structName === "0x1::string::String" || structName === "0x1::ascii::String") {
+      const encoder = new TextEncoder();
+      const decoder = new TextDecoder();
+      struct = struct.transform({
+        input: (str) => typeof str === "string" ? { bytes: Array.from(encoder.encode(str)) } : str,
+        output: (obj) => decoder.decode(Uint8Array.from(obj.bytes))
+      });
+    }
+    return struct;
   }
-  throw new Error(`Unknown layout: ${layout}`);
+  throw new Error(`Unknown layout: ${JSON.stringify(layout)}`);
 }
 function mapJsonToBcs(json, layout) {
   const schema = layoutToBcs(layout);

package/dist/cjs/mappers/bcs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/mappers/bcs.ts"],
-  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { toBase64 } from '@iota/bcs';\nimport type { BcsType } from '@iota/bcs';\nimport { bcs } from '@iota/iota-sdk/bcs';\n\nimport type { MoveTypeLayout } from './move.js';\nimport { toShortTypeString } from './util.js';\n\nexport function layoutToBcs(layout: MoveTypeLayout): BcsType<any> {\n    switch (layout) {\n        case 'address':\n            return bcs.Address;\n        case 'bool':\n            return bcs.Bool;\n        case 'u8':\n            return bcs.U8;\n        case 'u16':\n            return bcs.U16;\n        case 'u32':\n            return bcs.U32;\n        case 'u64':\n            return bcs.U64;\n        case 'u128':\n            return bcs.U128;\n        case 'u256':\n            return bcs.U256;\n    }\n\n    if ('vector' in layout) {\n        return bcs.vector(layoutToBcs(layout.vector));\n    }\n\n    if ('struct' in layout) {\n        const fields: Record<string, BcsType<any>> = {};\n\n        for (const { name, layout: field } of layout.struct.fields) {\n            fields[name] = layoutToBcs(field);\n        }\n\n        let struct = bcs.struct(layout.struct.type, fields);\n        const structName = toShortTypeString(layout.struct.type);\n\n        if (structName === '0x2::object::ID') {\n            struct = struct.transform({\n                input: (id: any) => (typeof id === 'string' ? { bytes: id } : id) as never,\n                output: (id) => id.id,\n            });\n\n            return struct;\n        }\n    }\n\n    throw new Error(`Unknown layout: ${layout}`);\n}\n\nexport function mapJsonToBcs(json: unknown, layout: MoveTypeLayout) {\n    const schema = layoutToBcs(layout);\n    return toBase64(schema.serialize(json).toBytes());\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,iBAAyB;AAEzB,IAAAA,cAAoB;AAGpB,kBAAkC;AAE3B,SAAS,YAAY,QAAsC;AAC9D,UAAQ,QAAQ;AAAA,IACZ,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,EACnB;AAEA,MAAI,YAAY,QAAQ;AACpB,WAAO,gBAAI,OAAO,YAAY,OAAO,MAAM,CAAC;AAAA,EAChD;AAEA,MAAI,YAAY,QAAQ;AACpB,UAAM,SAAuC,CAAC;AAE9C,eAAW,EAAE,MAAM,QAAQ,MAAM,KAAK,OAAO,OAAO,QAAQ;AACxD,aAAO,IAAI,IAAI,YAAY,KAAK;AAAA,IACpC;AAEA,QAAI,SAAS,gBAAI,OAAO,OAAO,OAAO,MAAM,MAAM;AAClD,UAAM,iBAAa,+BAAkB,OAAO,OAAO,IAAI;AAEvD,QAAI,eAAe,mBAAmB;AAClC,eAAS,OAAO,UAAU;AAAA,QACtB,OAAO,CAAC,OAAa,OAAO,OAAO,WAAW,EAAE,OAAO,GAAG,IAAI;AAAA,QAC9D,QAAQ,CAAC,OAAO,GAAG;AAAA,MACvB,CAAC;AAED,aAAO;AAAA,IACX;AAAA,EACJ;AAEA,QAAM,IAAI,MAAM,mBAAmB,MAAM,EAAE;AAC/C;AAEO,SAAS,aAAa,MAAe,QAAwB;AAChE,QAAM,SAAS,YAAY,MAAM;AACjC,aAAO,qBAAS,OAAO,UAAU,IAAI,EAAE,QAAQ,CAAC;AACpD;",
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// Modifications Copyright (c) 2024 IOTA Stiftung\n// SPDX-License-Identifier: Apache-2.0\n\nimport { toBase64 } from '@iota/bcs';\nimport type { BcsType } from '@iota/bcs';\nimport { bcs } from '@iota/iota-sdk/bcs';\n\nimport type { MoveTypeLayout } from './move.js';\nimport { toShortTypeString } from './util.js';\n\nexport function layoutToBcs(layout: MoveTypeLayout): BcsType<any> {\n    switch (layout) {\n        case 'address':\n            return bcs.Address;\n        case 'bool':\n            return bcs.Bool;\n        case 'u8':\n            return bcs.U8;\n        case 'u16':\n            return bcs.U16;\n        case 'u32':\n            return bcs.U32;\n        case 'u64':\n            return bcs.U64;\n        case 'u128':\n            return bcs.U128;\n        case 'u256':\n            return bcs.U256;\n    }\n\n    if ('vector' in layout) {\n        return bcs.vector(layoutToBcs(layout.vector));\n    }\n\n    if ('struct' in layout) {\n        const fields: Record<string, BcsType<any>> = {};\n\n        for (const { name, layout: field } of layout.struct.fields) {\n            fields[name] = layoutToBcs(field);\n        }\n\n        let struct: BcsType<any> = bcs.struct(layout.struct.type, fields);\n        const structName = toShortTypeString(layout.struct.type);\n\n        if (structName === '0x2::object::ID') {\n            struct = struct.transform({\n                input: (id) => (typeof id === 'string' ? { bytes: id } : id) as never,\n                output: (id) => id.bytes,\n            });\n        }\n\n        if (structName === '0x1::string::String' || structName === '0x1::ascii::String') {\n            const encoder = new TextEncoder();\n            const decoder = new TextDecoder();\n            struct = struct.transform({\n                input: (str) =>\n                    typeof str === 'string' ? { bytes: Array.from(encoder.encode(str)) } : str,\n                output: (obj) => decoder.decode(Uint8Array.from(obj.bytes)),\n            });\n        }\n\n        return struct;\n    }\n\n    throw new Error(`Unknown layout: ${JSON.stringify(layout)}`);\n}\n\nexport function mapJsonToBcs(json: unknown, layout: MoveTypeLayout) {\n    const schema = layoutToBcs(layout);\n    return toBase64(schema.serialize(json).toBytes());\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,iBAAyB;AAEzB,IAAAA,cAAoB;AAGpB,kBAAkC;AAE3B,SAAS,YAAY,QAAsC;AAC9D,UAAQ,QAAQ;AAAA,IACZ,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,IACf,KAAK;AACD,aAAO,gBAAI;AAAA,EACnB;AAEA,MAAI,YAAY,QAAQ;AACpB,WAAO,gBAAI,OAAO,YAAY,OAAO,MAAM,CAAC;AAAA,EAChD;AAEA,MAAI,YAAY,QAAQ;AACpB,UAAM,SAAuC,CAAC;AAE9C,eAAW,EAAE,MAAM,QAAQ,MAAM,KAAK,OAAO,OAAO,QAAQ;AACxD,aAAO,IAAI,IAAI,YAAY,KAAK;AAAA,IACpC;AAEA,QAAI,SAAuB,gBAAI,OAAO,OAAO,OAAO,MAAM,MAAM;AAChE,UAAM,iBAAa,+BAAkB,OAAO,OAAO,IAAI;AAEvD,QAAI,eAAe,mBAAmB;AAClC,eAAS,OAAO,UAAU;AAAA,QACtB,OAAO,CAAC,OAAQ,OAAO,OAAO,WAAW,EAAE,OAAO,GAAG,IAAI;AAAA,QACzD,QAAQ,CAAC,OAAO,GAAG;AAAA,MACvB,CAAC;AAAA,IACL;AAEA,QAAI,eAAe,yBAAyB,eAAe,sBAAsB;AAC7E,YAAM,UAAU,IAAI,YAAY;AAChC,YAAM,UAAU,IAAI,YAAY;AAChC,eAAS,OAAO,UAAU;AAAA,QACtB,OAAO,CAAC,QACJ,OAAO,QAAQ,WAAW,EAAE,OAAO,MAAM,KAAK,QAAQ,OAAO,GAAG,CAAC,EAAE,IAAI;AAAA,QAC3E,QAAQ,CAAC,QAAQ,QAAQ,OAAO,WAAW,KAAK,IAAI,KAAK,CAAC;AAAA,MAC9D,CAAC;AAAA,IACL;AAEA,WAAO;AAAA,EACX;AAEA,QAAM,IAAI,MAAM,mBAAmB,KAAK,UAAU,MAAM,CAAC,EAAE;AAC/D;AAEO,SAAS,aAAa,MAAe,QAAwB;AAChE,QAAM,SAAS,YAAY,MAAM;AACjC,aAAO,qBAAS,OAAO,UAAU,IAAI,EAAE,QAAQ,CAAC;AACpD;",
   "names": ["import_bcs"]
 }

package/dist/cjs/mappers/subscription.d.ts

@@ -0,0 +1,33 @@
+import type { IotaTransactionBlockResponse } from '@iota/iota-sdk/client';
+import type { SubscribeEventsSubscription, SubscribeTransactionsSubscription, SubscriptionEventFilter, SubscriptionTransactionFilter } from '../generated/queries.js';
+type SubscriptionEvent = Extract<SubscribeEventsSubscription['events'], {
+    __typename: 'Event';
+}>;
+type SubscriptionTransaction = Extract<SubscribeTransactionsSubscription['transactions'], {
+    __typename: 'TransactionBlock';
+}>;
+/**
+ * `SubscriptionEventFilter` only supports `emittingModule`, the module that emitted the
+ * event. `MoveEventModule` selects the module the struct was declared in, a different set.
+ * An empty filter means no filter; anything inexpressible throws so the caller falls back.
+ */
+export declare function mapRpcEventFilterToGraphQL(rpcFilter: Record<string, unknown>): SubscriptionEventFilter | undefined;
+export declare function mapRpcTransactionFilterToGraphQL(rpcFilter: Record<string, unknown>): SubscriptionTransactionFilter | undefined;
+export declare function mapSubscriptionEvent(event: SubscriptionEvent): {
+    bcs: any;
+    bcsEncoding: string;
+    id: {
+        eventSeq: string;
+        txDigest: string;
+    };
+    packageId: any;
+    parsedJson: any;
+    sender: any;
+    timestampMs: string | undefined;
+    transactionModule: string;
+    type: string;
+};
+/** `iotax_subscribeTransaction` delivers `TransactionEffects`, decoded from the effects BCS. */
+export declare function mapSubscriptionTransaction(tx: SubscriptionTransaction): IotaTransactionBlockResponse['effects'];
+export {};
+//# sourceMappingURL=subscription.d.ts.map

package/dist/cjs/mappers/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/mappers/subscription.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,4BAA4B,EAAuB,MAAM,uBAAuB,CAAC;AAE/F,OAAO,KAAK,EACR,2BAA2B,EAC3B,iCAAiC,EACjC,uBAAuB,EACvB,6BAA6B,EAChC,MAAM,yBAAyB,CAAC;AAKjC,KAAK,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC,QAAQ,CAAC,EAAE;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEjG,KAAK,uBAAuB,GAAG,OAAO,CAClC,iCAAiC,CAAC,cAAc,CAAC,EACjD;IAAE,UAAU,EAAE,kBAAkB,CAAA;CAAE,CACrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,CACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,uBAAuB,GAAG,SAAS,CAiBrC;AAED,wBAAgB,gCAAgC,CAC5C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,6BAA6B,GAAG,SAAS,CA4C3C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB;;;;;;;;;;;;;EAmB5D;AAED,gGAAgG;AAChG,wBAAgB,0BAA0B,CACtC,EAAE,EAAE,uBAAuB,GAC5B,4BAA4B,CAAC,SAAS,CAAC,CAEzC"}