@atlaskit/editor-synced-block-provider 3.30.3 → 3.30.4

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @atlaskit/editor-synced-block-provider
 
+## 3.30.4
+
+### Patch Changes
+
+- [`610719fffa0ba`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/610719fffa0ba) -
+  Move subscription API to pass in environment for subscription instead
+- Updated dependencies
+
 ## 3.30.3
 
 ### Patch Changes

package/dist/cjs/clients/block-service/blockSubscription.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.subscribeToBlockUpdates = void 0;
 var _graphqlWs = require("graphql-ws");
 var _coreUtils = require("@atlaskit/editor-common/core-utils");
-var _utils = require("../../utils/utils");
+var _sharedSubscriptionUtils = require("./sharedSubscriptionUtils");
 var GRAPHQL_WS_ENDPOINT = '/gateway/api/graphql/subscriptions';
 var blockServiceClient = null;
 var getBlockServiceClient = function getBlockServiceClient() {
@@ -25,56 +25,6 @@ var getBlockServiceClient = function getBlockServiceClient() {
   }
   return blockServiceClient;
 };
-var SUBSCRIPTION_QUERY = "\nsubscription EDITOR_SYNCED_BLOCK_ON_BLOCK_UPDATED($resourceId: ID!) {\n\tblockService_onBlockUpdated(resourceId: $resourceId) {\n\t\tblockAri\n\t\tblockInstanceId\n\t\tcontent\n\t\tcontentUpdatedAt\n\t\tcreatedAt\n\t\tcreatedBy\n\t\tdeletionReason\n\t\tproduct\n\t\tsourceAri\n\t\tstatus\n\t}\n}\n";
-/**
- * Extracts the resourceId from a block ARI.
- * Block ARI format: ari:cloud:blocks:<cloudId>:synced-block/<resourceId>
- * @param blockAri - The block ARI string
- * @returns The resourceId portion of the ARI
- */
-var extractResourceIdFromBlockAri = function extractResourceIdFromBlockAri(blockAri) {
-  // eslint-disable-next-line require-unicode-regexp
-  var match = blockAri.match(/ari:cloud:blocks:[^:]+:synced-block\/(.+)$/);
-  return (match === null || match === void 0 ? void 0 : match[1]) || null;
-};
-
-/**
- * Parses the subscription payload into a standardized format.
- * @param payload - The raw subscription payload
- * @returns Parsed block data or null if parsing fails
- */
-var parseSubscriptionPayload = function parseSubscriptionPayload(payload) {
-  try {
-    var resourceId = extractResourceIdFromBlockAri(payload.blockAri);
-    if (!resourceId) {
-      return null;
-    }
-    var createdAt;
-    if (payload.createdAt !== undefined && payload.createdAt !== null) {
-      try {
-        // BE returns microseconds, convert to milliseconds
-        createdAt = new Date(payload.createdAt / 1000).toISOString();
-      } catch (_unused) {
-        createdAt = undefined;
-      }
-    }
-    return {
-      blockAri: payload.blockAri,
-      blockInstanceId: payload.blockInstanceId,
-      content: JSON.parse(payload.content),
-      contentUpdatedAt: (0, _utils.convertContentUpdatedAt)(payload.contentUpdatedAt),
-      createdAt: createdAt,
-      createdBy: payload.createdBy,
-      product: payload.product,
-      resourceId: resourceId,
-      sourceAri: payload.sourceAri,
-      status: payload.status
-    };
-  } catch (_unused2) {
-    return null;
-  }
-};
-
 /**
  * Creates a GraphQL subscription to block updates using the shared graphql-ws client.
  *
@@ -90,7 +40,7 @@ var subscribeToBlockUpdates = exports.subscribeToBlockUpdates = function subscri
     return function () {};
   }
   var unsubscribe = client.subscribe({
-    query: SUBSCRIPTION_QUERY,
+    query: _sharedSubscriptionUtils.BLOCK_SERVICE_SUBSCRIPTION_QUERY,
     variables: {
       resourceId: blockAri
     },
@@ -99,7 +49,7 @@ var subscribeToBlockUpdates = exports.subscribeToBlockUpdates = function subscri
     next: function next(value) {
       var _value$data;
       if ((_value$data = value.data) !== null && _value$data !== void 0 && _value$data.blockService_onBlockUpdated) {
-        var parsed = parseSubscriptionPayload(value.data.blockService_onBlockUpdated);
+        var parsed = (0, _sharedSubscriptionUtils.parseSubscriptionPayload)(value.data.blockService_onBlockUpdated);
         if (parsed !== null) {
           onData(parsed);
         } else {

package/dist/cjs/clients/block-service/sharedSubscriptionUtils.js

@@ -0,0 +1,82 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.parseSubscriptionPayload = exports.extractResourceIdFromBlockAri = exports.convertTimestampToISOString = exports.BLOCK_SERVICE_SUBSCRIPTION_QUERY = void 0;
+var _utils = require("../../utils/utils");
+/**
+ * Shared GraphQL subscription query for block updates.
+ * This is the canonical subscription query used across all implementations.
+ */
+var BLOCK_SERVICE_SUBSCRIPTION_QUERY = exports.BLOCK_SERVICE_SUBSCRIPTION_QUERY = "\nsubscription EDITOR_SYNCED_BLOCK_ON_BLOCK_UPDATED($resourceId: ID!) {\n\tblockService_onBlockUpdated(resourceId: $resourceId) {\n\t\tblockAri\n\t\tblockInstanceId\n\t\tcontent\n\t\tcontentUpdatedAt\n\t\tcreatedAt\n\t\tcreatedBy\n\t\tdeletionReason\n\t\tproduct\n\t\tsourceAri\n\t\tstatus\n\t}\n}\n";
+
+/**
+ * Raw subscription payload from the GraphQL subscription.
+ * This represents the exact shape returned by the blockService_onBlockUpdated subscription.
+ */
+
+/**
+ * Parsed and normalized block subscription data.
+ * This is the standardized format used across different subscription implementations.
+ */
+
+/**
+ * Extracts the resourceId from a block ARI.
+ * Block ARI format: ari:cloud:blocks:<cloudId>:synced-block/<resourceId>
+ * @param blockAri - The block ARI string
+ * @returns The resourceId portion of the ARI
+ */
+var extractResourceIdFromBlockAri = exports.extractResourceIdFromBlockAri = function extractResourceIdFromBlockAri(blockAri) {
+  // eslint-disable-next-line require-unicode-regexp
+  var match = blockAri.match(/ari:cloud:blocks:[^:]+:synced-block\/(.+)$/);
+  return (match === null || match === void 0 ? void 0 : match[1]) || null;
+};
+
+/**
+ * Converts a timestamp to ISO string.
+ * @param timestamp - Timestamp in milliseconds
+ * @returns ISO string or undefined if conversion fails
+ */
+var convertTimestampToISOString = exports.convertTimestampToISOString = function convertTimestampToISOString(timestamp) {
+  if (timestamp === undefined || timestamp === null) {
+    return undefined;
+  }
+  try {
+    return new Date(timestamp).toISOString();
+  } catch (_unused) {
+    return undefined;
+  }
+};
+
+/**
+ * Parses the raw subscription payload into a standardized format.
+ * This function handles all the data transformation and error handling consistently
+ * across different subscription implementations.
+ * 
+ * @param payload - The raw subscription payload
+ * @returns Parsed block data or null if parsing fails
+ */
+var parseSubscriptionPayload = exports.parseSubscriptionPayload = function parseSubscriptionPayload(payload) {
+  try {
+    var resourceId = extractResourceIdFromBlockAri(payload.blockAri);
+    if (!resourceId) {
+      return null;
+    }
+    var createdAt = convertTimestampToISOString(payload.createdAt);
+    return {
+      blockAri: payload.blockAri,
+      blockInstanceId: payload.blockInstanceId,
+      content: JSON.parse(payload.content),
+      contentUpdatedAt: (0, _utils.convertContentUpdatedAt)(payload.contentUpdatedAt),
+      createdAt: createdAt,
+      createdBy: payload.createdBy,
+      product: payload.product,
+      resourceId: resourceId,
+      sourceAri: payload.sourceAri,
+      status: payload.status
+    };
+  } catch (_unused2) {
+    return null;
+  }
+};

package/dist/cjs/index.js

@@ -3,6 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "BLOCK_SERVICE_SUBSCRIPTION_QUERY", {
+  enumerable: true,
+  get: function get() {
+    return _sharedSubscriptionUtils.BLOCK_SERVICE_SUBSCRIPTION_QUERY;
+  }
+});
 Object.defineProperty(exports, "BlockError", {
   enumerable: true,
   get: function get() {
@@ -57,6 +63,12 @@ Object.defineProperty(exports, "convertPMNodesToSyncBlockNodes", {
     return _utils.convertPMNodesToSyncBlockNodes;
   }
 });
+Object.defineProperty(exports, "convertRelayResponseToSyncBlockInstance", {
+  enumerable: true,
+  get: function get() {
+    return _relayResponseConverter.convertRelayResponseToSyncBlockInstance;
+  }
+});
 Object.defineProperty(exports, "convertSyncBlockJSONNodeToSyncBlockNode", {
   enumerable: true,
   get: function get() {
@@ -75,6 +87,18 @@ Object.defineProperty(exports, "convertToSyncBlockData", {
     return _blockServiceAPI.convertToSyncBlockData;
   }
 });
+Object.defineProperty(exports, "createRelayBlockSubscription", {
+  enumerable: true,
+  get: function get() {
+    return _relaySubscriptionUtils.createRelayBlockSubscription;
+  }
+});
+Object.defineProperty(exports, "createRelaySubscriptionFunction", {
+  enumerable: true,
+  get: function get() {
+    return _relaySubscriptionUtils.createRelaySubscriptionFunction;
+  }
+});
 Object.defineProperty(exports, "createResourceIdForReference", {
   enumerable: true,
   get: function get() {
@@ -183,6 +207,12 @@ Object.defineProperty(exports, "parseResourceId", {
     return _resourceId.parseResourceId;
   }
 });
+Object.defineProperty(exports, "parseSubscriptionPayload", {
+  enumerable: true,
+  get: function get() {
+    return _sharedSubscriptionUtils.parseSubscriptionPayload;
+  }
+});
 Object.defineProperty(exports, "rebaseTransaction", {
   enumerable: true,
   get: function get() {
@@ -259,6 +289,9 @@ var _syncBlockProvider = require("./providers/syncBlockProvider");
 var _referenceSyncBlockStoreManager = require("./store-manager/referenceSyncBlockStoreManager");
 var _syncBlockInMemorySessionCache = require("./store-manager/syncBlockInMemorySessionCache");
 var _syncBlockStoreManager = require("./store-manager/syncBlockStoreManager");
+var _sharedSubscriptionUtils = require("./clients/block-service/sharedSubscriptionUtils");
+var _relayResponseConverter = require("./utils/relayResponseConverter");
+var _relaySubscriptionUtils = require("./utils/relaySubscriptionUtils");
 var _resolveSyncBlockInstance = require("./utils/resolveSyncBlockInstance");
 var _resourceId = require("./utils/resourceId");
 var _utils = require("./utils/utils");

package/dist/cjs/providers/block-service/blockServiceAPI.js

@@ -18,6 +18,7 @@ var _blockService = require("../../clients/block-service/blockService");
 var _blockSubscription = require("../../clients/block-service/blockSubscription");
 var _types = require("../../common/types");
 var _errorHandling = require("../../utils/errorHandling");
+var _relaySubscriptionUtils = require("../../utils/relaySubscriptionUtils");
 var _resourceId2 = require("../../utils/resourceId");
 var _utils = require("../../utils/utils");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
@@ -427,10 +428,12 @@ var _batchFetchData = exports.batchFetchData = /*#__PURE__*/function () {
 var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
   function BlockServiceADFFetchProvider(_ref4) {
     var cloudId = _ref4.cloudId,
-      parentAri = _ref4.parentAri;
+      parentAri = _ref4.parentAri,
+      relayEnvironment = _ref4.relayEnvironment;
     (0, _classCallCheck2.default)(this, BlockServiceADFFetchProvider);
     this.cloudId = cloudId;
     this.parentAri = parentAri;
+    this.relayEnvironment = relayEnvironment;
   }
 
   // resourceId of the reference synced block.
@@ -615,6 +618,7 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
     }()
     /**
      * Subscribes to real-time updates for a specific block using GraphQL WebSocket subscriptions.
+     * If a Relay environment is provided, uses Relay subscriptions; otherwise falls back to WebSocket.
      * @param resourceId - The resource ID of the block to subscribe to
      * @param onUpdate - Callback function invoked when the block is updated
      * @param onError - Optional callback function invoked on subscription errors
@@ -628,6 +632,14 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
         cloudId: this.cloudId,
         resourceId: resourceId
       });
+
+      // If Relay environment is available, use Relay subscriptions
+      if (this.relayEnvironment && (0, _platformFeatureFlags.fg)('platform_synced_block_patch_3')) {
+        var relaySubscribeToBlockUpdates = (0, _relaySubscriptionUtils.createRelaySubscriptionFunction)(this.cloudId, this.relayEnvironment);
+        return relaySubscribeToBlockUpdates(resourceId, onUpdate, onError);
+      }
+
+      // Fall back to WebSocket subscriptions
       return (0, _blockSubscription.subscribeToBlockUpdates)(blockAri, function (parsedData) {
         // Convert ParsedBlockSubscriptionData to SyncBlockInstance
         var syncBlockInstance = {
@@ -979,11 +991,13 @@ var createBlockServiceAPIProviders = function createBlockServiceAPIProviders(_re
     parentAri = _ref6.parentAri,
     parentId = _ref6.parentId,
     product = _ref6.product,
-    getVersion = _ref6.getVersion;
+    getVersion = _ref6.getVersion,
+    relayEnvironment = _ref6.relayEnvironment;
   return {
     fetchProvider: new BlockServiceADFFetchProvider({
       cloudId: cloudId,
-      parentAri: parentAri
+      parentAri: parentAri,
+      relayEnvironment: relayEnvironment
     }),
     writeProvider: new BlockServiceADFWriteProvider({
       cloudId: cloudId,
@@ -999,16 +1013,18 @@ var useMemoizedBlockServiceAPIProviders = exports.useMemoizedBlockServiceAPIProv
     parentAri = _ref7.parentAri,
     parentId = _ref7.parentId,
     product = _ref7.product,
-    getVersion = _ref7.getVersion;
+    getVersion = _ref7.getVersion,
+    relayEnvironment = _ref7.relayEnvironment;
   return (0, _react.useMemo)(function () {
     return createBlockServiceAPIProviders({
       cloudId: cloudId,
       parentAri: parentAri,
       parentId: parentId,
       product: product,
-      getVersion: getVersion
+      getVersion: getVersion,
+      relayEnvironment: relayEnvironment
     });
-  }, [cloudId, parentAri, parentId, product, getVersion]);
+  }, [cloudId, parentAri, parentId, product, getVersion, relayEnvironment]);
 };
 var createBlockServiceFetchOnlyAPIProvider = function createBlockServiceFetchOnlyAPIProvider(_ref8) {
   var cloudId = _ref8.cloudId,

package/dist/cjs/utils/__generated__/relaySubscriptionUtilsSubscription.graphql.js

@@ -0,0 +1,94 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+/**
+ * @generated SignedSource<<559b4fb25d0e5bc72be383427a939e2d>>
+ * @relayHash 38684212c43376e58fea2d6095011652
+ * @lightSyntaxTransform
+ * @nogrep
+ * @codegen-command: yarn relay
+ */
+
+/* tslint:disable */
+/* eslint-disable */
+// @ts-nocheck
+
+// @relayRequestID c84045a1f05bd1e73ade0a9d8b18462cc3dad5dcae1ebabab76b13135411c530
+
+var node = function () {
+  var v0 = [{
+      "defaultValue": null,
+      "kind": "LocalArgument",
+      "name": "resourceId"
+    }],
+    v1 = [{
+      "args": [{
+        "kind": "Variable",
+        "name": "resourceId",
+        "variableName": "resourceId"
+      }],
+      "concreteType": "BlockServiceBlockPayload",
+      "kind": "LinkedField",
+      "name": "blockService_onBlockUpdated",
+      "plural": false,
+      "selections": [{
+        "kind": "ScalarField",
+        "name": "blockAri"
+      }, {
+        "kind": "ScalarField",
+        "name": "blockInstanceId"
+      }, {
+        "kind": "ScalarField",
+        "name": "content"
+      }, {
+        "kind": "ScalarField",
+        "name": "contentUpdatedAt"
+      }, {
+        "kind": "ScalarField",
+        "name": "createdAt"
+      }, {
+        "kind": "ScalarField",
+        "name": "createdBy"
+      }, {
+        "kind": "ScalarField",
+        "name": "deletionReason"
+      }, {
+        "kind": "ScalarField",
+        "name": "product"
+      }, {
+        "kind": "ScalarField",
+        "name": "sourceAri"
+      }, {
+        "kind": "ScalarField",
+        "name": "status"
+      }]
+    }];
+  return {
+    "fragment": {
+      "argumentDefinitions": v0 /*: any*/,
+      "kind": "Fragment",
+      "name": "relaySubscriptionUtilsSubscription",
+      "selections": v1 /*: any*/,
+      "type": "Subscription"
+    },
+    "kind": "Request",
+    "operation": {
+      "argumentDefinitions": v0 /*: any*/,
+      "kind": "Operation",
+      "name": "relaySubscriptionUtilsSubscription",
+      "selections": v1 /*: any*/
+    },
+    "params": {
+      "id": "c84045a1f05bd1e73ade0a9d8b18462cc3dad5dcae1ebabab76b13135411c530",
+      "metadata": {},
+      "name": "relaySubscriptionUtilsSubscription",
+      "operationKind": "subscription",
+      "text": null
+    }
+  };
+}();
+node.hash = "6f3ebc87921555436cad753ec1aead2e";
+var _default = exports.default = node;

package/dist/cjs/utils/relayResponseConverter.js

@@ -0,0 +1,76 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.convertParsedDataToSyncBlockInstance = convertParsedDataToSyncBlockInstance;
+exports.convertRelayResponseToSyncBlockInstance = convertRelayResponseToSyncBlockInstance;
+var _sharedSubscriptionUtils = require("../clients/block-service/sharedSubscriptionUtils");
+var _validValue = require("./validValue");
+/**
+ * Converts parsed subscription data to SyncBlockInstance format.
+ *
+ * @param parsed - The parsed subscription data
+ * @param resourceId - The resource ID for the block
+ * @returns A SyncBlockInstance
+ */
+function convertParsedDataToSyncBlockInstance(parsed, resourceId) {
+  return {
+    data: {
+      content: parsed.content,
+      contentUpdatedAt: parsed.contentUpdatedAt,
+      resourceId: parsed.blockAri,
+      blockInstanceId: parsed.blockInstanceId,
+      sourceAri: parsed.sourceAri,
+      product: parsed.product,
+      createdAt: parsed.createdAt,
+      createdBy: parsed.createdBy,
+      status: (0, _validValue.normaliseSyncBlockStatus)(parsed.status)
+    },
+    resourceId: resourceId
+  };
+}
+
+/**
+ * Converts a Relay subscription response to SyncBlockInstance format using shared parsing logic.
+
+ * @param response - The Relay subscription response containing block update data
+ * @param resourceId - The resource ID for the block
+ * @returns A SyncBlockInstance or null if parsing fails
+ * 
+ * @example
+ * ```typescript
+ * // In a Relay subscription handler
+ * onNext: (response) => {
+ *   if (response?.blockService_onBlockUpdated) {
+ *     const syncBlockInstance = convertRelayResponseToSyncBlockInstance(
+ *       response.blockService_onBlockUpdated,
+ *       resourceId,
+ *     );
+ *     if (syncBlockInstance) {
+ *       onUpdate(syncBlockInstance);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+function convertRelayResponseToSyncBlockInstance(response, resourceId) {
+  var _response$contentUpda, _response$deletionRea;
+  var payload = {
+    blockAri: response.blockAri,
+    blockInstanceId: response.blockInstanceId,
+    content: response.content,
+    contentUpdatedAt: (_response$contentUpda = response.contentUpdatedAt) !== null && _response$contentUpda !== void 0 ? _response$contentUpda : undefined,
+    createdAt: response.createdAt,
+    createdBy: response.createdBy,
+    deletionReason: (_response$deletionRea = response.deletionReason) !== null && _response$deletionRea !== void 0 ? _response$deletionRea : undefined,
+    product: response.product,
+    sourceAri: response.sourceAri,
+    status: response.status
+  };
+  var parsed = (0, _sharedSubscriptionUtils.parseSubscriptionPayload)(payload);
+  if (!parsed) {
+    return null;
+  }
+  return convertParsedDataToSyncBlockInstance(parsed, resourceId);
+}

package/dist/cjs/utils/relaySubscriptionUtils.js

@@ -0,0 +1,130 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createRelayBlockSubscription = createRelayBlockSubscription;
+exports.createRelaySubscriptionFunction = createRelaySubscriptionFunction;
+var _relayRuntime = require("relay-runtime");
+var _ari = require("../clients/block-service/ari");
+var _blockSubscription = require("../clients/block-service/blockSubscription");
+var _relaySubscriptionUtilsSubscription = _interopRequireDefault(require("./__generated__/relaySubscriptionUtilsSubscription.graphql"));
+var _relayResponseConverter = require("./relayResponseConverter");
+/**
+ * Configuration for creating a Relay block subscription.
+ */
+
+/**
+ * Creates a Relay-based block subscription without needing to wrap providers.
+ * This is a clean utility function that can be used directly in components or hooks.
+ * 
+ * @param config - Configuration for the subscription
+ * @returns An unsubscribe function to dispose the subscription
+ * 
+ * @example
+ * ```typescript
+ * const unsubscribe = createRelayBlockSubscription({
+ *   relayEnvironment: environment,
+ *   cloudId: 'my-cloud-id',
+ *   resourceId: 'my-resource-id',
+ *   onUpdate: (blockInstance) => {
+ *     console.log('Block updated:', blockInstance);
+ *   },
+ *   onError: (error) => {
+ *     console.error('Subscription error:', error);
+ *   }
+ * });
+ * 
+ * // Later, when component unmounts or subscription is no longer needed
+ * unsubscribe();
+ * ```
+ */
+function createRelayBlockSubscription(config) {
+  var relayEnvironment = config.relayEnvironment,
+    cloudId = config.cloudId,
+    resourceId = config.resourceId,
+    onUpdate = config.onUpdate,
+    _onError = config.onError;
+
+  // Convert resourceId to blockAri for the subscription
+  var blockAri = (0, _ari.generateBlockAriFromReference)({
+    cloudId: cloudId,
+    resourceId: resourceId
+  });
+  var subscriptionQuery = _relaySubscriptionUtilsSubscription.default;
+
+  // Try to use Relay subscription first
+  try {
+    var disposable = (0, _relayRuntime.requestSubscription)(relayEnvironment, {
+      subscription: subscriptionQuery,
+      variables: {
+        resourceId: blockAri
+      },
+      onNext: function onNext(response) {
+        if (response !== null && response !== void 0 && response.blockService_onBlockUpdated) {
+          var syncBlockInstance = (0, _relayResponseConverter.convertRelayResponseToSyncBlockInstance)(response.blockService_onBlockUpdated, resourceId);
+          if (syncBlockInstance) {
+            onUpdate(syncBlockInstance);
+          } else {
+            _onError === null || _onError === void 0 || _onError(new Error('Failed to parse Relay block subscription payload'));
+          }
+        }
+      },
+      onError: function onError(error) {
+        _onError === null || _onError === void 0 || _onError(error);
+      }
+    });
+
+    // If subscription was successfully created, return the unsubscribe function
+    if (disposable) {
+      return function () {
+        disposable.dispose();
+      };
+    }
+  } catch (error) {
+    // If requestSubscription throws, fall back to WebSocket
+    _onError === null || _onError === void 0 || _onError(error instanceof Error ? error : new Error('Relay subscription failed'));
+  }
+
+  // Fallback to WebSocket subscription when Relay subscriptions aren't available
+  return (0, _blockSubscription.subscribeToBlockUpdates)(blockAri, function (parsedData) {
+    var syncBlockInstance = (0, _relayResponseConverter.convertParsedDataToSyncBlockInstance)(parsedData, parsedData.resourceId);
+    onUpdate(syncBlockInstance);
+  }, function (error) {
+    _onError === null || _onError === void 0 || _onError(error);
+  });
+}
+
+/**
+ * Hook-like function to create a subscription function that can be passed to providers.
+ * This creates a function with the same signature as subscribeToBlockUpdates that uses Relay.
+ * 
+ * @param cloudId - Cloud ID for generating block ARIs  
+ * @param relayEnvironment - Optional Relay environment. If not provided, will attempt to use global environment
+ * @returns A function that can be used as subscribeToBlockUpdates in provider configurations
+ * 
+ * @example
+ * ```typescript
+ * const relaySubscribeToBlockUpdates = createRelaySubscriptionFunction(cloudId, environment);
+ * 
+ * // Can be used directly as a subscribeToBlockUpdates replacement
+ * const unsubscribe = relaySubscribeToBlockUpdates(resourceId, onUpdate, onError);
+ * ```
+ */
+function createRelaySubscriptionFunction(cloudId, relayEnvironment) {
+  return function (resourceId, onUpdate, onError) {
+    var environment = relayEnvironment;
+    if (!environment) {
+      onError === null || onError === void 0 || onError(new Error('Relay environment not available'));
+      return function () {};
+    }
+    return createRelayBlockSubscription({
+      relayEnvironment: environment,
+      cloudId: cloudId,
+      resourceId: resourceId,
+      onUpdate: onUpdate,
+      onError: onError
+    });
+  };
+}