Assets

import Assets from '@bbc/front-end-kit/js/showpad/managers/Assets';

A static class for loading Showpad assets via the Showpad SDK. Wraps each SDK call in an in-flight promise cache to prevent the blocking "Call didn't go through" error that occurs when identical requests fire simultaneously before the first one resolves.

Getting started

The class is static — no instantiation needed.

import Assets from '@bbc/front-end-kit/js/showpad/managers/Assets';

Assets.getAssetsByTags('tag-1,tag-2').then(data => {
    console.log(data);
});

Cache

The cache is in-flight only — it deduplicates concurrent calls with identical arguments by returning the same running Promise. Once the promise settles (resolves or rejects), the cache entry is cleared. Results are not memoized; a second call after the first has resolved will hit the SDK again.

The cache key is JSON.stringify(args), so argument order and value matter.

API

`Assets.getAssetsByTags(tags)`

Loads assets from Showpad by one or more tags.

Parameters

tags (string | string[]): A single tag, a comma-separated string of tags, or an array of tag strings. String inputs are split on , before being forwarded to the SDK. Tag matching behaviour (AND/OR) depends on the Showpad SDK — consult the Showpad SDK docs for details.

Returns

Promise — resolves with the raw asset data returned by the Showpad SDK.

`Assets.getAssetsInFolder(path)`

Loads assets located in the Showpad folder at the given link.

Parameters

path (string): The Showpad folder link.

Returns

Promise — resolves with the raw asset data returned by the Showpad SDK.

`Assets.getAssetsByQuery(query)`

Loads assets matching (part of) a filename using Showpad's query system.

Warning

Despite the name, this does not accept arbitrary queries. The value is wrapped in % signs and used in the WHERE clause of Showpad's internal SQL query — it matches against filenames only. See the Showpad SDK docs for details.

Parameters

query (string): A filename or partial filename to search for.

Returns

Promise — resolves with the raw asset data returned by the Showpad SDK.

External dependencies

Experience APP SDK (@showpad/experience-app-sdk): Provides the underlying Showpad.getAssetsByTags, Showpad.getAssetsInFolder, and Showpad.getAssetsByQuery methods.