@player-ui/async-node-plugin 0.11.0-next.1 → 0.11.0-next.2

package/dist/cjs/index.cjs

@@ -63,7 +63,7 @@ var asyncTransform = (assetId, wrapperAssetType, asset, flatten) => {
 
 // ../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/index.ts
 var AsyncNodePlugin = class {
-  constructor(options) {
+  constructor(options, asyncHandler) {
     this.hooks = {
       onAsyncNode: new import_tapable_ts.AsyncParallelBailHook()
     };
@@ -74,6 +74,14 @@ var AsyncNodePlugin = class {
         plugin.applyPlugin(this);
       });
     }
+    if (asyncHandler) {
+      this.hooks.onAsyncNode.tap(
+        "async",
+        async (node, callback) => {
+          return await asyncHandler(node, callback);
+        }
+      );
+    }
   }
   apply(player) {
     player.hooks.viewController.tap(this.name, (viewController) => {

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/index.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/transform.ts"],"sourcesContent":["import { NodeType, getNodeID } from \"@player-ui/player\";\nimport type {\n  Player,\n  PlayerPlugin,\n  Node,\n  ParseObjectOptions,\n  ParseObjectChildOptions,\n  ViewInstance,\n  Parser,\n  ViewPlugin,\n  Resolver,\n  Resolve,\n} from \"@player-ui/player\";\nimport { AsyncParallelBailHook } from \"tapable-ts\";\nimport queueMicrotask from \"queue-microtask\";\nimport { omit } from \"timm\";\n\nexport * from \"./types\";\nexport * from \"./transform\";\n\nexport interface AsyncNodePluginOptions {\n  /** A set of plugins to load  */\n  plugins?: AsyncNodeViewPlugin[];\n}\n\nexport interface AsyncNodeViewPlugin extends ViewPlugin {\n  /** Use this to tap into the async node plugin hooks */\n  applyPlugin: (asyncNodePlugin: AsyncNodePlugin) => void;\n\n  asyncNode: AsyncParallelBailHook<[Node.Async, (result: any) => void], any>;\n}\n\n/**\n * Async node plugin used to resolve async nodes in the content\n * If an async node is present, allow users to provide a replacement node to be rendered when ready\n */\nexport class AsyncNodePlugin implements PlayerPlugin {\n  private plugins: AsyncNodeViewPlugin[] | undefined;\n\n  constructor(options: AsyncNodePluginOptions) {\n    if (options?.plugins) {\n      this.plugins = options.plugins;\n      options.plugins.forEach((plugin) => {\n        plugin.applyPlugin(this);\n      });\n    }\n  }\n\n  public readonly hooks = {\n    onAsyncNode: new AsyncParallelBailHook<\n      [Node.Async, (result: any) => void],\n      any\n    >(),\n  };\n\n  name = \"AsyncNode\";\n\n  apply(player: Player) {\n    player.hooks.viewController.tap(this.name, (viewController) => {\n      viewController.hooks.view.tap(this.name, (view) => {\n        this.plugins?.forEach((plugin) => {\n          plugin.apply(view);\n        });\n      });\n    });\n  }\n}\n\nexport class AsyncNodePluginPlugin implements AsyncNodeViewPlugin {\n  public asyncNode = new AsyncParallelBailHook<\n    [Node.Async, (result: any) => void],\n    any\n  >();\n  private basePlugin: AsyncNodePlugin | undefined;\n\n  name = \"AsyncNode\";\n\n  private resolvedMapping = new Map<string, any>();\n\n  private currentView: ViewInstance | undefined;\n\n  /**\n   * Updates the node asynchronously based on the result provided.\n   * This method is responsible for handling the update logic of asynchronous nodes.\n   * It checks if the node needs to be updated based on the new result and updates the mapping accordingly.\n   * If an update is necessary, it triggers an asynchronous update on the view.\n   * @param node The asynchronous node that might be updated.\n   * @param result The result obtained from resolving the async node. This could be any data structure or value.\n   * @param options Options provided for node resolution, including a potential parseNode function to process the result.\n   * @param view The view instance where the node resides. This can be undefined if the view is not currently active.\n   */\n  private handleAsyncUpdate(\n    node: Node.Async,\n    result: any,\n    options: Resolve.NodeResolveOptions,\n    view: ViewInstance | undefined,\n  ) {\n    const parsedNode =\n      options.parseNode && result ? options.parseNode(result) : undefined;\n\n    if (this.resolvedMapping.get(node.id) !== parsedNode) {\n      this.resolvedMapping.set(node.id, parsedNode ? parsedNode : node);\n      view?.updateAsync();\n    }\n  }\n\n  /**\n   * Handles the asynchronous API integration for resolving nodes.\n   * This method sets up a hook on the resolver's `beforeResolve` event to process async nodes.\n   * @param resolver The resolver instance to attach the hook to.\n   * @param view\n   */\n  applyResolver(resolver: Resolver) {\n    resolver.hooks.beforeResolve.tap(this.name, (node, options) => {\n      let resolvedNode;\n      if (this.isAsync(node)) {\n        const mappedValue = this.resolvedMapping.get(node.id);\n        if (mappedValue) {\n          resolvedNode = mappedValue;\n        }\n      } else {\n        resolvedNode = null;\n      }\n\n      const newNode = resolvedNode || node;\n      if (!resolvedNode && node?.type === NodeType.Async) {\n        queueMicrotask(async () => {\n          const result = await this.basePlugin?.hooks.onAsyncNode.call(\n            node,\n            (result) => {\n              this.handleAsyncUpdate(node, result, options, this.currentView);\n            },\n          );\n          this.handleAsyncUpdate(node, result, options, this.currentView);\n        });\n\n        return node;\n      }\n      return newNode;\n    });\n  }\n\n  private isAsync(node: Node.Node | null): node is Node.Async {\n    return node?.type === NodeType.Async;\n  }\n\n  private isDeterminedAsync(obj: any) {\n    return obj && Object.prototype.hasOwnProperty.call(obj, \"async\");\n  }\n\n  applyParser(parser: Parser) {\n    parser.hooks.parseNode.tap(\n      this.name,\n      (\n        obj: any,\n        nodeType: Node.ChildrenTypes,\n        options: ParseObjectOptions,\n        childOptions?: ParseObjectChildOptions,\n      ) => {\n        if (this.isDeterminedAsync(obj)) {\n          const parsedAsync = parser.parseObject(\n            omit(obj, \"async\"),\n            nodeType,\n            options,\n          );\n          const parsedNodeId = getNodeID(parsedAsync);\n\n          if (parsedAsync === null || !parsedNodeId) {\n            return childOptions ? [] : null;\n          }\n\n          const asyncAST = parser.createASTNode(\n            {\n              id: parsedNodeId,\n              type: NodeType.Async,\n              value: parsedAsync,\n            },\n            obj,\n          );\n\n          if (childOptions) {\n            return asyncAST\n              ? [\n                  {\n                    path: [...childOptions.path, childOptions.key],\n                    value: asyncAST,\n                  },\n                ]\n              : [];\n          }\n\n          return asyncAST;\n        }\n      },\n    );\n  }\n\n  apply(view: ViewInstance): void {\n    this.currentView = view;\n    view.hooks.parser.tap(\"async\", this.applyParser.bind(this));\n    view.hooks.resolver.tap(\"async\", this.applyResolver.bind(this));\n  }\n\n  applyPlugin(asyncNodePlugin: AsyncNodePlugin): void {\n    this.basePlugin = asyncNodePlugin;\n  }\n}\n","import { Builder } from \"@player-ui/player\";\nimport type { AsyncTransformFunc } from \"./types\";\n\n/**\n * Util function to generate transform function for async asset\n * @param asset - async asset to apply beforeResolve transform\n * @param transformedAssetType: transformed asset type for rendering\n * @param wrapperAssetType: container asset type\n * @param flatten: flatten the streamed in content\n * @returns - wrapper asset with children of transformed asset and async node\n */\n\nexport const asyncTransform: AsyncTransformFunc = (\n  assetId,\n  wrapperAssetType,\n  asset,\n  flatten,\n) => {\n  const id = \"async-\" + assetId;\n\n  const asyncNode = Builder.asyncNode(id, flatten);\n  let multiNode;\n  let assetNode;\n\n  if (asset) {\n    assetNode = Builder.assetWrapper(asset);\n    multiNode = Builder.multiNode(assetNode, asyncNode);\n  } else {\n    multiNode = Builder.multiNode(asyncNode);\n  }\n\n  const wrapperAsset = Builder.asset({\n    id: wrapperAssetType + \"-\" + id,\n    type: wrapperAssetType,\n  });\n\n  Builder.addChild(wrapperAsset, [\"values\"], multiNode);\n\n  return wrapperAsset;\n};\n"],"mappings":"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","names":["import_player","queueMicrotask","result"]}
+{"version":3,"sources":["../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/index.ts","../../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/transform.ts"],"sourcesContent":["import { NodeType, getNodeID } from \"@player-ui/player\";\nimport type {\n  Player,\n  PlayerPlugin,\n  Node,\n  ParseObjectOptions,\n  ParseObjectChildOptions,\n  ViewInstance,\n  Parser,\n  ViewPlugin,\n  Resolver,\n  Resolve,\n} from \"@player-ui/player\";\nimport { AsyncParallelBailHook } from \"tapable-ts\";\nimport queueMicrotask from \"queue-microtask\";\nimport { omit } from \"timm\";\n\nexport * from \"./types\";\nexport * from \"./transform\";\n\nexport interface AsyncNodePluginOptions {\n  /** A set of plugins to load  */\n  plugins?: AsyncNodeViewPlugin[];\n}\n\nexport interface AsyncNodeViewPlugin extends ViewPlugin {\n  /** Use this to tap into the async node plugin hooks */\n  applyPlugin: (asyncNodePlugin: AsyncNodePlugin) => void;\n\n  asyncNode: AsyncParallelBailHook<[Node.Async, (result: any) => void], any>;\n}\nexport type AsyncHandler = (\n  node: Node.Async,\n  callback?: (result: any) => void,\n) => Promise<any>;\n\n/**\n * Async node plugin used to resolve async nodes in the content\n * If an async node is present, allow users to provide a replacement node to be rendered when ready\n */\nexport class AsyncNodePlugin implements PlayerPlugin {\n  private plugins: AsyncNodeViewPlugin[] | undefined;\n\n  constructor(options: AsyncNodePluginOptions, asyncHandler?: AsyncHandler) {\n    if (options?.plugins) {\n      this.plugins = options.plugins;\n      options.plugins.forEach((plugin) => {\n        plugin.applyPlugin(this);\n      });\n    }\n\n    if (asyncHandler) {\n      this.hooks.onAsyncNode.tap(\n        \"async\",\n        async (node: Node.Async, callback) => {\n          return await asyncHandler(node, callback);\n        },\n      );\n    }\n  }\n\n  public readonly hooks = {\n    onAsyncNode: new AsyncParallelBailHook<\n      [Node.Async, (result: any) => void],\n      any\n    >(),\n  };\n\n  name = \"AsyncNode\";\n\n  apply(player: Player) {\n    player.hooks.viewController.tap(this.name, (viewController) => {\n      viewController.hooks.view.tap(this.name, (view) => {\n        this.plugins?.forEach((plugin) => {\n          plugin.apply(view);\n        });\n      });\n    });\n  }\n}\n\nexport class AsyncNodePluginPlugin implements AsyncNodeViewPlugin {\n  public asyncNode = new AsyncParallelBailHook<\n    [Node.Async, (result: any) => void],\n    any\n  >();\n  private basePlugin: AsyncNodePlugin | undefined;\n\n  name = \"AsyncNode\";\n\n  private resolvedMapping = new Map<string, any>();\n\n  private currentView: ViewInstance | undefined;\n\n  /**\n   * Updates the node asynchronously based on the result provided.\n   * This method is responsible for handling the update logic of asynchronous nodes.\n   * It checks if the node needs to be updated based on the new result and updates the mapping accordingly.\n   * If an update is necessary, it triggers an asynchronous update on the view.\n   * @param node The asynchronous node that might be updated.\n   * @param result The result obtained from resolving the async node. This could be any data structure or value.\n   * @param options Options provided for node resolution, including a potential parseNode function to process the result.\n   * @param view The view instance where the node resides. This can be undefined if the view is not currently active.\n   */\n  private handleAsyncUpdate(\n    node: Node.Async,\n    result: any,\n    options: Resolve.NodeResolveOptions,\n    view: ViewInstance | undefined,\n  ) {\n    const parsedNode =\n      options.parseNode && result ? options.parseNode(result) : undefined;\n\n    if (this.resolvedMapping.get(node.id) !== parsedNode) {\n      this.resolvedMapping.set(node.id, parsedNode ? parsedNode : node);\n      view?.updateAsync();\n    }\n  }\n\n  /**\n   * Handles the asynchronous API integration for resolving nodes.\n   * This method sets up a hook on the resolver's `beforeResolve` event to process async nodes.\n   * @param resolver The resolver instance to attach the hook to.\n   * @param view\n   */\n  applyResolver(resolver: Resolver) {\n    resolver.hooks.beforeResolve.tap(this.name, (node, options) => {\n      let resolvedNode;\n      if (this.isAsync(node)) {\n        const mappedValue = this.resolvedMapping.get(node.id);\n        if (mappedValue) {\n          resolvedNode = mappedValue;\n        }\n      } else {\n        resolvedNode = null;\n      }\n\n      const newNode = resolvedNode || node;\n      if (!resolvedNode && node?.type === NodeType.Async) {\n        queueMicrotask(async () => {\n          const result = await this.basePlugin?.hooks.onAsyncNode.call(\n            node,\n            (result) => {\n              this.handleAsyncUpdate(node, result, options, this.currentView);\n            },\n          );\n          this.handleAsyncUpdate(node, result, options, this.currentView);\n        });\n\n        return node;\n      }\n      return newNode;\n    });\n  }\n\n  private isAsync(node: Node.Node | null): node is Node.Async {\n    return node?.type === NodeType.Async;\n  }\n\n  private isDeterminedAsync(obj: any) {\n    return obj && Object.prototype.hasOwnProperty.call(obj, \"async\");\n  }\n\n  applyParser(parser: Parser) {\n    parser.hooks.parseNode.tap(\n      this.name,\n      (\n        obj: any,\n        nodeType: Node.ChildrenTypes,\n        options: ParseObjectOptions,\n        childOptions?: ParseObjectChildOptions,\n      ) => {\n        if (this.isDeterminedAsync(obj)) {\n          const parsedAsync = parser.parseObject(\n            omit(obj, \"async\"),\n            nodeType,\n            options,\n          );\n          const parsedNodeId = getNodeID(parsedAsync);\n\n          if (parsedAsync === null || !parsedNodeId) {\n            return childOptions ? [] : null;\n          }\n\n          const asyncAST = parser.createASTNode(\n            {\n              id: parsedNodeId,\n              type: NodeType.Async,\n              value: parsedAsync,\n            },\n            obj,\n          );\n\n          if (childOptions) {\n            return asyncAST\n              ? [\n                  {\n                    path: [...childOptions.path, childOptions.key],\n                    value: asyncAST,\n                  },\n                ]\n              : [];\n          }\n\n          return asyncAST;\n        }\n      },\n    );\n  }\n\n  apply(view: ViewInstance): void {\n    this.currentView = view;\n    view.hooks.parser.tap(\"async\", this.applyParser.bind(this));\n    view.hooks.resolver.tap(\"async\", this.applyResolver.bind(this));\n  }\n\n  applyPlugin(asyncNodePlugin: AsyncNodePlugin): void {\n    this.basePlugin = asyncNodePlugin;\n  }\n}\n","import { Builder } from \"@player-ui/player\";\nimport type { AsyncTransformFunc } from \"./types\";\n\n/**\n * Util function to generate transform function for async asset\n * @param asset - async asset to apply beforeResolve transform\n * @param transformedAssetType: transformed asset type for rendering\n * @param wrapperAssetType: container asset type\n * @param flatten: flatten the streamed in content\n * @returns - wrapper asset with children of transformed asset and async node\n */\n\nexport const asyncTransform: AsyncTransformFunc = (\n  assetId,\n  wrapperAssetType,\n  asset,\n  flatten,\n) => {\n  const id = \"async-\" + assetId;\n\n  const asyncNode = Builder.asyncNode(id, flatten);\n  let multiNode;\n  let assetNode;\n\n  if (asset) {\n    assetNode = Builder.assetWrapper(asset);\n    multiNode = Builder.multiNode(assetNode, asyncNode);\n  } else {\n    multiNode = Builder.multiNode(asyncNode);\n  }\n\n  const wrapperAsset = Builder.asset({\n    id: wrapperAssetType + \"-\" + id,\n    type: wrapperAssetType,\n  });\n\n  Builder.addChild(wrapperAsset, [\"values\"], multiNode);\n\n  return wrapperAsset;\n};\n"],"mappings":"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","names":["import_player","queueMicrotask","result"]}

package/dist/index.legacy-esm.js

@@ -27,7 +27,7 @@ var asyncTransform = (assetId, wrapperAssetType, asset, flatten) => {
 
 // ../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/index.ts
 var AsyncNodePlugin = class {
-  constructor(options) {
+  constructor(options, asyncHandler) {
     this.hooks = {
       onAsyncNode: new AsyncParallelBailHook()
     };
@@ -38,6 +38,14 @@ var AsyncNodePlugin = class {
         plugin.applyPlugin(this);
       });
     }
+    if (asyncHandler) {
+      this.hooks.onAsyncNode.tap(
+        "async",
+        async (node, callback) => {
+          return await asyncHandler(node, callback);
+        }
+      );
+    }
   }
   apply(player) {
     player.hooks.viewController.tap(this.name, (viewController) => {

package/dist/index.mjs

@@ -27,7 +27,7 @@ var asyncTransform = (assetId, wrapperAssetType, asset, flatten) => {
 
 // ../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/index.ts
 var AsyncNodePlugin = class {
-  constructor(options) {
+  constructor(options, asyncHandler) {
     this.hooks = {
       onAsyncNode: new AsyncParallelBailHook()
     };
@@ -38,6 +38,14 @@ var AsyncNodePlugin = class {
         plugin.applyPlugin(this);
       });
     }
+    if (asyncHandler) {
+      this.hooks.onAsyncNode.tap(
+        "async",
+        async (node, callback) => {
+          return await asyncHandler(node, callback);
+        }
+      );
+    }
   }
   apply(player) {
     player.hooks.viewController.tap(this.name, (viewController) => {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/transform.ts"],"sourcesContent":["import { NodeType, getNodeID } from \"@player-ui/player\";\nimport type {\n  Player,\n  PlayerPlugin,\n  Node,\n  ParseObjectOptions,\n  ParseObjectChildOptions,\n  ViewInstance,\n  Parser,\n  ViewPlugin,\n  Resolver,\n  Resolve,\n} from \"@player-ui/player\";\nimport { AsyncParallelBailHook } from \"tapable-ts\";\nimport queueMicrotask from \"queue-microtask\";\nimport { omit } from \"timm\";\n\nexport * from \"./types\";\nexport * from \"./transform\";\n\nexport interface AsyncNodePluginOptions {\n  /** A set of plugins to load  */\n  plugins?: AsyncNodeViewPlugin[];\n}\n\nexport interface AsyncNodeViewPlugin extends ViewPlugin {\n  /** Use this to tap into the async node plugin hooks */\n  applyPlugin: (asyncNodePlugin: AsyncNodePlugin) => void;\n\n  asyncNode: AsyncParallelBailHook<[Node.Async, (result: any) => void], any>;\n}\n\n/**\n * Async node plugin used to resolve async nodes in the content\n * If an async node is present, allow users to provide a replacement node to be rendered when ready\n */\nexport class AsyncNodePlugin implements PlayerPlugin {\n  private plugins: AsyncNodeViewPlugin[] | undefined;\n\n  constructor(options: AsyncNodePluginOptions) {\n    if (options?.plugins) {\n      this.plugins = options.plugins;\n      options.plugins.forEach((plugin) => {\n        plugin.applyPlugin(this);\n      });\n    }\n  }\n\n  public readonly hooks = {\n    onAsyncNode: new AsyncParallelBailHook<\n      [Node.Async, (result: any) => void],\n      any\n    >(),\n  };\n\n  name = \"AsyncNode\";\n\n  apply(player: Player) {\n    player.hooks.viewController.tap(this.name, (viewController) => {\n      viewController.hooks.view.tap(this.name, (view) => {\n        this.plugins?.forEach((plugin) => {\n          plugin.apply(view);\n        });\n      });\n    });\n  }\n}\n\nexport class AsyncNodePluginPlugin implements AsyncNodeViewPlugin {\n  public asyncNode = new AsyncParallelBailHook<\n    [Node.Async, (result: any) => void],\n    any\n  >();\n  private basePlugin: AsyncNodePlugin | undefined;\n\n  name = \"AsyncNode\";\n\n  private resolvedMapping = new Map<string, any>();\n\n  private currentView: ViewInstance | undefined;\n\n  /**\n   * Updates the node asynchronously based on the result provided.\n   * This method is responsible for handling the update logic of asynchronous nodes.\n   * It checks if the node needs to be updated based on the new result and updates the mapping accordingly.\n   * If an update is necessary, it triggers an asynchronous update on the view.\n   * @param node The asynchronous node that might be updated.\n   * @param result The result obtained from resolving the async node. This could be any data structure or value.\n   * @param options Options provided for node resolution, including a potential parseNode function to process the result.\n   * @param view The view instance where the node resides. This can be undefined if the view is not currently active.\n   */\n  private handleAsyncUpdate(\n    node: Node.Async,\n    result: any,\n    options: Resolve.NodeResolveOptions,\n    view: ViewInstance | undefined,\n  ) {\n    const parsedNode =\n      options.parseNode && result ? options.parseNode(result) : undefined;\n\n    if (this.resolvedMapping.get(node.id) !== parsedNode) {\n      this.resolvedMapping.set(node.id, parsedNode ? parsedNode : node);\n      view?.updateAsync();\n    }\n  }\n\n  /**\n   * Handles the asynchronous API integration for resolving nodes.\n   * This method sets up a hook on the resolver's `beforeResolve` event to process async nodes.\n   * @param resolver The resolver instance to attach the hook to.\n   * @param view\n   */\n  applyResolver(resolver: Resolver) {\n    resolver.hooks.beforeResolve.tap(this.name, (node, options) => {\n      let resolvedNode;\n      if (this.isAsync(node)) {\n        const mappedValue = this.resolvedMapping.get(node.id);\n        if (mappedValue) {\n          resolvedNode = mappedValue;\n        }\n      } else {\n        resolvedNode = null;\n      }\n\n      const newNode = resolvedNode || node;\n      if (!resolvedNode && node?.type === NodeType.Async) {\n        queueMicrotask(async () => {\n          const result = await this.basePlugin?.hooks.onAsyncNode.call(\n            node,\n            (result) => {\n              this.handleAsyncUpdate(node, result, options, this.currentView);\n            },\n          );\n          this.handleAsyncUpdate(node, result, options, this.currentView);\n        });\n\n        return node;\n      }\n      return newNode;\n    });\n  }\n\n  private isAsync(node: Node.Node | null): node is Node.Async {\n    return node?.type === NodeType.Async;\n  }\n\n  private isDeterminedAsync(obj: any) {\n    return obj && Object.prototype.hasOwnProperty.call(obj, \"async\");\n  }\n\n  applyParser(parser: Parser) {\n    parser.hooks.parseNode.tap(\n      this.name,\n      (\n        obj: any,\n        nodeType: Node.ChildrenTypes,\n        options: ParseObjectOptions,\n        childOptions?: ParseObjectChildOptions,\n      ) => {\n        if (this.isDeterminedAsync(obj)) {\n          const parsedAsync = parser.parseObject(\n            omit(obj, \"async\"),\n            nodeType,\n            options,\n          );\n          const parsedNodeId = getNodeID(parsedAsync);\n\n          if (parsedAsync === null || !parsedNodeId) {\n            return childOptions ? [] : null;\n          }\n\n          const asyncAST = parser.createASTNode(\n            {\n              id: parsedNodeId,\n              type: NodeType.Async,\n              value: parsedAsync,\n            },\n            obj,\n          );\n\n          if (childOptions) {\n            return asyncAST\n              ? [\n                  {\n                    path: [...childOptions.path, childOptions.key],\n                    value: asyncAST,\n                  },\n                ]\n              : [];\n          }\n\n          return asyncAST;\n        }\n      },\n    );\n  }\n\n  apply(view: ViewInstance): void {\n    this.currentView = view;\n    view.hooks.parser.tap(\"async\", this.applyParser.bind(this));\n    view.hooks.resolver.tap(\"async\", this.applyResolver.bind(this));\n  }\n\n  applyPlugin(asyncNodePlugin: AsyncNodePlugin): void {\n    this.basePlugin = asyncNodePlugin;\n  }\n}\n","import { Builder } from \"@player-ui/player\";\nimport type { AsyncTransformFunc } from \"./types\";\n\n/**\n * Util function to generate transform function for async asset\n * @param asset - async asset to apply beforeResolve transform\n * @param transformedAssetType: transformed asset type for rendering\n * @param wrapperAssetType: container asset type\n * @param flatten: flatten the streamed in content\n * @returns - wrapper asset with children of transformed asset and async node\n */\n\nexport const asyncTransform: AsyncTransformFunc = (\n  assetId,\n  wrapperAssetType,\n  asset,\n  flatten,\n) => {\n  const id = \"async-\" + assetId;\n\n  const asyncNode = Builder.asyncNode(id, flatten);\n  let multiNode;\n  let assetNode;\n\n  if (asset) {\n    assetNode = Builder.assetWrapper(asset);\n    multiNode = Builder.multiNode(assetNode, asyncNode);\n  } else {\n    multiNode = Builder.multiNode(asyncNode);\n  }\n\n  const wrapperAsset = Builder.asset({\n    id: wrapperAssetType + \"-\" + id,\n    type: wrapperAssetType,\n  });\n\n  Builder.addChild(wrapperAsset, [\"values\"], multiNode);\n\n  return wrapperAsset;\n};\n"],"mappings":"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","names":["result"]}
+{"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/plugins/async-node/core/src/transform.ts"],"sourcesContent":["import { NodeType, getNodeID } from \"@player-ui/player\";\nimport type {\n  Player,\n  PlayerPlugin,\n  Node,\n  ParseObjectOptions,\n  ParseObjectChildOptions,\n  ViewInstance,\n  Parser,\n  ViewPlugin,\n  Resolver,\n  Resolve,\n} from \"@player-ui/player\";\nimport { AsyncParallelBailHook } from \"tapable-ts\";\nimport queueMicrotask from \"queue-microtask\";\nimport { omit } from \"timm\";\n\nexport * from \"./types\";\nexport * from \"./transform\";\n\nexport interface AsyncNodePluginOptions {\n  /** A set of plugins to load  */\n  plugins?: AsyncNodeViewPlugin[];\n}\n\nexport interface AsyncNodeViewPlugin extends ViewPlugin {\n  /** Use this to tap into the async node plugin hooks */\n  applyPlugin: (asyncNodePlugin: AsyncNodePlugin) => void;\n\n  asyncNode: AsyncParallelBailHook<[Node.Async, (result: any) => void], any>;\n}\nexport type AsyncHandler = (\n  node: Node.Async,\n  callback?: (result: any) => void,\n) => Promise<any>;\n\n/**\n * Async node plugin used to resolve async nodes in the content\n * If an async node is present, allow users to provide a replacement node to be rendered when ready\n */\nexport class AsyncNodePlugin implements PlayerPlugin {\n  private plugins: AsyncNodeViewPlugin[] | undefined;\n\n  constructor(options: AsyncNodePluginOptions, asyncHandler?: AsyncHandler) {\n    if (options?.plugins) {\n      this.plugins = options.plugins;\n      options.plugins.forEach((plugin) => {\n        plugin.applyPlugin(this);\n      });\n    }\n\n    if (asyncHandler) {\n      this.hooks.onAsyncNode.tap(\n        \"async\",\n        async (node: Node.Async, callback) => {\n          return await asyncHandler(node, callback);\n        },\n      );\n    }\n  }\n\n  public readonly hooks = {\n    onAsyncNode: new AsyncParallelBailHook<\n      [Node.Async, (result: any) => void],\n      any\n    >(),\n  };\n\n  name = \"AsyncNode\";\n\n  apply(player: Player) {\n    player.hooks.viewController.tap(this.name, (viewController) => {\n      viewController.hooks.view.tap(this.name, (view) => {\n        this.plugins?.forEach((plugin) => {\n          plugin.apply(view);\n        });\n      });\n    });\n  }\n}\n\nexport class AsyncNodePluginPlugin implements AsyncNodeViewPlugin {\n  public asyncNode = new AsyncParallelBailHook<\n    [Node.Async, (result: any) => void],\n    any\n  >();\n  private basePlugin: AsyncNodePlugin | undefined;\n\n  name = \"AsyncNode\";\n\n  private resolvedMapping = new Map<string, any>();\n\n  private currentView: ViewInstance | undefined;\n\n  /**\n   * Updates the node asynchronously based on the result provided.\n   * This method is responsible for handling the update logic of asynchronous nodes.\n   * It checks if the node needs to be updated based on the new result and updates the mapping accordingly.\n   * If an update is necessary, it triggers an asynchronous update on the view.\n   * @param node The asynchronous node that might be updated.\n   * @param result The result obtained from resolving the async node. This could be any data structure or value.\n   * @param options Options provided for node resolution, including a potential parseNode function to process the result.\n   * @param view The view instance where the node resides. This can be undefined if the view is not currently active.\n   */\n  private handleAsyncUpdate(\n    node: Node.Async,\n    result: any,\n    options: Resolve.NodeResolveOptions,\n    view: ViewInstance | undefined,\n  ) {\n    const parsedNode =\n      options.parseNode && result ? options.parseNode(result) : undefined;\n\n    if (this.resolvedMapping.get(node.id) !== parsedNode) {\n      this.resolvedMapping.set(node.id, parsedNode ? parsedNode : node);\n      view?.updateAsync();\n    }\n  }\n\n  /**\n   * Handles the asynchronous API integration for resolving nodes.\n   * This method sets up a hook on the resolver's `beforeResolve` event to process async nodes.\n   * @param resolver The resolver instance to attach the hook to.\n   * @param view\n   */\n  applyResolver(resolver: Resolver) {\n    resolver.hooks.beforeResolve.tap(this.name, (node, options) => {\n      let resolvedNode;\n      if (this.isAsync(node)) {\n        const mappedValue = this.resolvedMapping.get(node.id);\n        if (mappedValue) {\n          resolvedNode = mappedValue;\n        }\n      } else {\n        resolvedNode = null;\n      }\n\n      const newNode = resolvedNode || node;\n      if (!resolvedNode && node?.type === NodeType.Async) {\n        queueMicrotask(async () => {\n          const result = await this.basePlugin?.hooks.onAsyncNode.call(\n            node,\n            (result) => {\n              this.handleAsyncUpdate(node, result, options, this.currentView);\n            },\n          );\n          this.handleAsyncUpdate(node, result, options, this.currentView);\n        });\n\n        return node;\n      }\n      return newNode;\n    });\n  }\n\n  private isAsync(node: Node.Node | null): node is Node.Async {\n    return node?.type === NodeType.Async;\n  }\n\n  private isDeterminedAsync(obj: any) {\n    return obj && Object.prototype.hasOwnProperty.call(obj, \"async\");\n  }\n\n  applyParser(parser: Parser) {\n    parser.hooks.parseNode.tap(\n      this.name,\n      (\n        obj: any,\n        nodeType: Node.ChildrenTypes,\n        options: ParseObjectOptions,\n        childOptions?: ParseObjectChildOptions,\n      ) => {\n        if (this.isDeterminedAsync(obj)) {\n          const parsedAsync = parser.parseObject(\n            omit(obj, \"async\"),\n            nodeType,\n            options,\n          );\n          const parsedNodeId = getNodeID(parsedAsync);\n\n          if (parsedAsync === null || !parsedNodeId) {\n            return childOptions ? [] : null;\n          }\n\n          const asyncAST = parser.createASTNode(\n            {\n              id: parsedNodeId,\n              type: NodeType.Async,\n              value: parsedAsync,\n            },\n            obj,\n          );\n\n          if (childOptions) {\n            return asyncAST\n              ? [\n                  {\n                    path: [...childOptions.path, childOptions.key],\n                    value: asyncAST,\n                  },\n                ]\n              : [];\n          }\n\n          return asyncAST;\n        }\n      },\n    );\n  }\n\n  apply(view: ViewInstance): void {\n    this.currentView = view;\n    view.hooks.parser.tap(\"async\", this.applyParser.bind(this));\n    view.hooks.resolver.tap(\"async\", this.applyResolver.bind(this));\n  }\n\n  applyPlugin(asyncNodePlugin: AsyncNodePlugin): void {\n    this.basePlugin = asyncNodePlugin;\n  }\n}\n","import { Builder } from \"@player-ui/player\";\nimport type { AsyncTransformFunc } from \"./types\";\n\n/**\n * Util function to generate transform function for async asset\n * @param asset - async asset to apply beforeResolve transform\n * @param transformedAssetType: transformed asset type for rendering\n * @param wrapperAssetType: container asset type\n * @param flatten: flatten the streamed in content\n * @returns - wrapper asset with children of transformed asset and async node\n */\n\nexport const asyncTransform: AsyncTransformFunc = (\n  assetId,\n  wrapperAssetType,\n  asset,\n  flatten,\n) => {\n  const id = \"async-\" + assetId;\n\n  const asyncNode = Builder.asyncNode(id, flatten);\n  let multiNode;\n  let assetNode;\n\n  if (asset) {\n    assetNode = Builder.assetWrapper(asset);\n    multiNode = Builder.multiNode(assetNode, asyncNode);\n  } else {\n    multiNode = Builder.multiNode(asyncNode);\n  }\n\n  const wrapperAsset = Builder.asset({\n    id: wrapperAssetType + \"-\" + id,\n    type: wrapperAssetType,\n  });\n\n  Builder.addChild(wrapperAsset, [\"values\"], multiNode);\n\n  return wrapperAsset;\n};\n"],"mappings":";AAAA,SAAS,UAAU,iBAAiB;AAapC,SAAS,6BAA6B;AACtC,OAAO,oBAAoB;AAC3B,SAAS,YAAY;;;ACfrB,SAAS,eAAe;AAYjB,IAAM,iBAAqC,CAChD,SACA,kBACA,OACA,YACG;AACH,QAAM,KAAK,WAAW;AAEtB,QAAM,YAAY,QAAQ,UAAU,IAAI,OAAO;AAC/C,MAAI;AACJ,MAAI;AAEJ,MAAI,OAAO;AACT,gBAAY,QAAQ,aAAa,KAAK;AACtC,gBAAY,QAAQ,UAAU,WAAW,SAAS;AAAA,EACpD,OAAO;AACL,gBAAY,QAAQ,UAAU,SAAS;AAAA,EACzC;AAEA,QAAM,eAAe,QAAQ,MAAM;AAAA,IACjC,IAAI,mBAAmB,MAAM;AAAA,IAC7B,MAAM;AAAA,EACR,CAAC;AAED,UAAQ,SAAS,cAAc,CAAC,QAAQ,GAAG,SAAS;AAEpD,SAAO;AACT;;;ADCO,IAAM,kBAAN,MAA8C;AAAA,EAGnD,YAAY,SAAiC,cAA6B;AAkB1E,SAAgB,QAAQ;AAAA,MACtB,aAAa,IAAI,sBAGf;AAAA,IACJ;AAEA,gBAAO;AAxBL,QAAI,SAAS,SAAS;AACpB,WAAK,UAAU,QAAQ;AACvB,cAAQ,QAAQ,QAAQ,CAAC,WAAW;AAClC,eAAO,YAAY,IAAI;AAAA,MACzB,CAAC;AAAA,IACH;AAEA,QAAI,cAAc;AAChB,WAAK,MAAM,YAAY;AAAA,QACrB;AAAA,QACA,OAAO,MAAkB,aAAa;AACpC,iBAAO,MAAM,aAAa,MAAM,QAAQ;AAAA,QAC1C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAWA,MAAM,QAAgB;AACpB,WAAO,MAAM,eAAe,IAAI,KAAK,MAAM,CAAC,mBAAmB;AAC7D,qBAAe,MAAM,KAAK,IAAI,KAAK,MAAM,CAAC,SAAS;AACjD,aAAK,SAAS,QAAQ,CAAC,WAAW;AAChC,iBAAO,MAAM,IAAI;AAAA,QACnB,CAAC;AAAA,MACH,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;AAEO,IAAM,wBAAN,MAA2D;AAAA,EAA3D;AACL,SAAO,YAAY,IAAI,sBAGrB;AAGF,gBAAO;AAEP,SAAQ,kBAAkB,oBAAI,IAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcvC,kBACN,MACA,QACA,SACA,MACA;AACA,UAAM,aACJ,QAAQ,aAAa,SAAS,QAAQ,UAAU,MAAM,IAAI;AAE5D,QAAI,KAAK,gBAAgB,IAAI,KAAK,EAAE,MAAM,YAAY;AACpD,WAAK,gBAAgB,IAAI,KAAK,IAAI,aAAa,aAAa,IAAI;AAChE,YAAM,YAAY;AAAA,IACpB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAc,UAAoB;AAChC,aAAS,MAAM,cAAc,IAAI,KAAK,MAAM,CAAC,MAAM,YAAY;AAC7D,UAAI;AACJ,UAAI,KAAK,QAAQ,IAAI,GAAG;AACtB,cAAM,cAAc,KAAK,gBAAgB,IAAI,KAAK,EAAE;AACpD,YAAI,aAAa;AACf,yBAAe;AAAA,QACjB;AAAA,MACF,OAAO;AACL,uBAAe;AAAA,MACjB;AAEA,YAAM,UAAU,gBAAgB;AAChC,UAAI,CAAC,gBAAgB,MAAM,SAAS,SAAS,OAAO;AAClD,uBAAe,YAAY;AACzB,gBAAM,SAAS,MAAM,KAAK,YAAY,MAAM,YAAY;AAAA,YACtD;AAAA,YACA,CAACA,YAAW;AACV,mBAAK,kBAAkB,MAAMA,SAAQ,SAAS,KAAK,WAAW;AAAA,YAChE;AAAA,UACF;AACA,eAAK,kBAAkB,MAAM,QAAQ,SAAS,KAAK,WAAW;AAAA,QAChE,CAAC;AAED,eAAO;AAAA,MACT;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAAA,EAEQ,QAAQ,MAA4C;AAC1D,WAAO,MAAM,SAAS,SAAS;AAAA,EACjC;AAAA,EAEQ,kBAAkB,KAAU;AAClC,WAAO,OAAO,OAAO,UAAU,eAAe,KAAK,KAAK,OAAO;AAAA,EACjE;AAAA,EAEA,YAAY,QAAgB;AAC1B,WAAO,MAAM,UAAU;AAAA,MACrB,KAAK;AAAA,MACL,CACE,KACA,UACA,SACA,iBACG;AACH,YAAI,KAAK,kBAAkB,GAAG,GAAG;AAC/B,gBAAM,cAAc,OAAO;AAAA,YACzB,KAAK,KAAK,OAAO;AAAA,YACjB;AAAA,YACA;AAAA,UACF;AACA,gBAAM,eAAe,UAAU,WAAW;AAE1C,cAAI,gBAAgB,QAAQ,CAAC,cAAc;AACzC,mBAAO,eAAe,CAAC,IAAI;AAAA,UAC7B;AAEA,gBAAM,WAAW,OAAO;AAAA,YACtB;AAAA,cACE,IAAI;AAAA,cACJ,MAAM,SAAS;AAAA,cACf,OAAO;AAAA,YACT;AAAA,YACA;AAAA,UACF;AAEA,cAAI,cAAc;AAChB,mBAAO,WACH;AAAA,cACE;AAAA,gBACE,MAAM,CAAC,GAAG,aAAa,MAAM,aAAa,GAAG;AAAA,gBAC7C,OAAO;AAAA,cACT;AAAA,YACF,IACA,CAAC;AAAA,UACP;AAEA,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,MAA0B;AAC9B,SAAK,cAAc;AACnB,SAAK,MAAM,OAAO,IAAI,SAAS,KAAK,YAAY,KAAK,IAAI,CAAC;AAC1D,SAAK,MAAM,SAAS,IAAI,SAAS,KAAK,cAAc,KAAK,IAAI,CAAC;AAAA,EAChE;AAAA,EAEA,YAAY,iBAAwC;AAClD,SAAK,aAAa;AAAA,EACpB;AACF;","names":["result"]}

package/package.json

@@ -6,10 +6,10 @@
     "types"
   ],
   "name": "@player-ui/async-node-plugin",
-  "version": "0.11.0-next.1",
+  "version": "0.11.0-next.2",
   "main": "dist/cjs/index.cjs",
   "peerDependencies": {
-    "@player-ui/player": "0.11.0-next.1"
+    "@player-ui/player": "0.11.0-next.2"
   },
   "devDependencies": {
     "@player-ui/reference-assets-plugin": "workspace:*"

package/src/__tests__/index.test.ts

@@ -243,6 +243,92 @@ describe("view", () => {
     expect(view?.actions[1]).toBeUndefined();
   });
 
+  test("can handle multiple updates through callback mechanism - init with handler", async () => {
+    let deferredResolve: ((value: any) => void) | undefined;
+
+    let updateContent: any;
+
+    const asyncHandler = (
+      node: Node.Async,
+      callback: (content: any) => void,
+    ) => {
+      const result = new Promise((resolve) => {
+        deferredResolve = resolve; // Promise would be resolved only once
+      });
+
+      updateContent = callback;
+      // Return the result to follow the same mechanism as before
+      return result;
+    };
+
+    const plugin = new AsyncNodePlugin(
+      {
+        plugins: [new AsyncNodePluginPlugin()],
+      },
+      asyncHandler,
+    );
+
+    let updateNumber = 0;
+
+    const player = new Player({ plugins: [plugin] });
+
+    player.hooks.viewController.tap("async-node-test", (vc) => {
+      vc.hooks.view.tap("async-node-test", (view) => {
+        view.hooks.onUpdate.tap("async-node-test", (update) => {
+          updateNumber++;
+        });
+      });
+    });
+
+    player.start(basicFRFWithActions as any);
+
+    let view = (player.getState() as InProgressState).controllers.view
+      .currentView?.lastUpdate;
+
+    expect(view).toBeDefined();
+    expect(view?.actions[1]).toBeUndefined();
+
+    await waitFor(() => {
+      expect(updateNumber).toBe(1);
+      expect(deferredResolve).toBeDefined();
+    });
+
+    if (deferredResolve) {
+      deferredResolve({
+        asset: {
+          id: "next-label-action",
+          type: "action",
+          value: "dummy value",
+        },
+      });
+    }
+
+    await waitFor(() => {
+      expect(updateNumber).toBe(2);
+    });
+
+    view = (player.getState() as InProgressState).controllers.view.currentView
+      ?.lastUpdate;
+
+    expect(view?.actions[0].asset.type).toBe("action");
+    expect(view?.actions[1].asset.type).toBe("action");
+    expect(updateNumber).toBe(2);
+
+    if (deferredResolve) {
+      updateContent(null);
+    }
+
+    await waitFor(() => {
+      expect(updateNumber).toBe(3);
+    });
+
+    view = (player.getState() as InProgressState).controllers.view.currentView
+      ?.lastUpdate;
+
+    expect(view?.actions[0].asset.type).toBe("action");
+    expect(view?.actions[1]).toBeUndefined();
+  });
+
   test("replaces async nodes with provided node", async () => {
     const plugin = new AsyncNodePlugin({
       plugins: [new AsyncNodePluginPlugin()],
@@ -302,6 +388,69 @@ describe("view", () => {
     expect(view?.actions[1].asset.type).toBe("action");
   });
 
+  test("init with handler", async () => {
+    let deferredResolve: ((value: any) => void) | undefined;
+
+    const asyncHandler = (node: Node.Async) => {
+      return new Promise((resolve) => {
+        deferredResolve = resolve;
+      });
+    };
+
+    const plugin = new AsyncNodePlugin(
+      {
+        plugins: [new AsyncNodePluginPlugin()],
+      },
+      asyncHandler,
+    );
+
+    let updateNumber = 0;
+
+    const player = new Player({ plugins: [plugin] });
+
+    player.hooks.viewController.tap("async-node-test", (vc) => {
+      vc.hooks.view.tap("async-node-test", (view) => {
+        view.hooks.onUpdate.tap("async-node-test", (update) => {
+          updateNumber++;
+        });
+      });
+    });
+
+    player.start(basicFRFWithActions as any);
+
+    let view = (player.getState() as InProgressState).controllers.view
+      .currentView?.lastUpdate;
+
+    expect(view).toBeDefined();
+    expect(view?.actions[0].asset.type).toBe("action");
+    expect(view?.actions[1]).toBeUndefined();
+    expect(updateNumber).toBe(1);
+
+    await waitFor(() => {
+      expect(deferredResolve).toBeDefined();
+    });
+
+    if (deferredResolve) {
+      deferredResolve({
+        asset: {
+          id: "next-label-action",
+          type: "action",
+          value: "dummy value",
+        },
+      });
+    }
+
+    await waitFor(() => {
+      expect(updateNumber).toBe(2);
+    });
+
+    view = (player.getState() as InProgressState).controllers.view.currentView
+      ?.lastUpdate;
+
+    expect(view?.actions[0].asset.type).toBe("action");
+    expect(view?.actions[1].asset.type).toBe("action");
+  });
+
   test("replaces async nodes with multi node", async () => {
     const plugin = new AsyncNodePlugin({
       plugins: [new AsyncNodePluginPlugin()],

package/src/index.ts

@@ -29,6 +29,10 @@ export interface AsyncNodeViewPlugin extends ViewPlugin {
 
   asyncNode: AsyncParallelBailHook<[Node.Async, (result: any) => void], any>;
 }
+export type AsyncHandler = (
+  node: Node.Async,
+  callback?: (result: any) => void,
+) => Promise<any>;
 
 /**
  * Async node plugin used to resolve async nodes in the content
@@ -37,13 +41,22 @@ export interface AsyncNodeViewPlugin extends ViewPlugin {
 export class AsyncNodePlugin implements PlayerPlugin {
   private plugins: AsyncNodeViewPlugin[] | undefined;
 
-  constructor(options: AsyncNodePluginOptions) {
+  constructor(options: AsyncNodePluginOptions, asyncHandler?: AsyncHandler) {
     if (options?.plugins) {
       this.plugins = options.plugins;
       options.plugins.forEach((plugin) => {
         plugin.applyPlugin(this);
       });
     }
+
+    if (asyncHandler) {
+      this.hooks.onAsyncNode.tap(
+        "async",
+        async (node: Node.Async, callback) => {
+          return await asyncHandler(node, callback);
+        },
+      );
+    }
   }
 
   public readonly hooks = {

package/types/index.d.ts

@@ -11,13 +11,14 @@ export interface AsyncNodeViewPlugin extends ViewPlugin {
     applyPlugin: (asyncNodePlugin: AsyncNodePlugin) => void;
     asyncNode: AsyncParallelBailHook<[Node.Async, (result: any) => void], any>;
 }
+export type AsyncHandler = (node: Node.Async, callback?: (result: any) => void) => Promise<any>;
 /**
  * Async node plugin used to resolve async nodes in the content
  * If an async node is present, allow users to provide a replacement node to be rendered when ready
  */
 export declare class AsyncNodePlugin implements PlayerPlugin {
     private plugins;
-    constructor(options: AsyncNodePluginOptions);
+    constructor(options: AsyncNodePluginOptions, asyncHandler?: AsyncHandler);
     readonly hooks: {
         onAsyncNode: AsyncParallelBailHook<[Node.Async, (result: any) => void], any, Record<string, any>>;
     };