# sourcebit-transform-assets

> A Sourcebit plugin for downloading assets

Latest version **0.3.0** (published 2020-07-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install sourcebit-transform-assets
pnpm add sourcebit-transform-assets
yarn add sourcebit-transform-assets
bun add sourcebit-transform-assets
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.3.0 |
| Published | 2020-07-06 |
| First published | 2020-02-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 18.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Stackbit |
| Maintainers | ausrob, berdav, denar90, eduardoboucas, ohadpr, rodikh, romanlyga, smnh, stackbit-admin, vitaliyr, youvalv |
| Keywords | sourcebit, headless, assets, images |

## Links

- npm: https://www.npmjs.com/package/sourcebit-transform-assets
- Repository: https://github.com/stackbithq/sourcebit-transform-assets
- Homepage: https://github.com/stackbithq/sourcebit-transform-assets#readme
- Issues: https://github.com/stackbithq/sourcebit-transform-assets/issues
- npm.io page: https://npm.io/package/sourcebit-transform-assets

## Dependencies (1)

- [mkdirp](https://npm.io/package/mkdirp.md) ^1.0.3

## Alternatives

- [exif-parser](https://npm.io/package/exif-parser.md) — 3.8M weekly downloads
- [vite-plugin-compression](https://npm.io/package/vite-plugin-compression.md) — 569.5K weekly downloads
- [pica](https://npm.io/package/pica.md) — 442.4K weekly downloads
- [@reportportal/client-javascript](https://npm.io/package/@reportportal/client-javascript.md) — 408.8K weekly downloads
- [@tldraw/state](https://npm.io/package/@tldraw/state.md) — 316.0K weekly downloads

## Recent versions

- 0.3.0 (latest) — 2020-07-06
- 0.2.2 — 2020-03-19
- 0.2.1 — 2020-02-21
- 0.2.0 — 2020-02-13
- 0.1.0 — 2020-02-10

## README

# sourcebit-transform-assets

[![npm version](https://badge.fury.io/js/sourcebit-transform-assets.svg)](https://badge.fury.io/js/sourcebit-transform-assets)

> A Sourcebit plugin for downloading remote assets

## 👩‍🏫 Introduction

This plugin looks for any assets that have been used in an entry, downloads the asset file to the local filesystem and replaces its URL in the referencing objects so that a local URL is used instead.

**🚨 Caveat**: The current version of this plugin is only capable of replacing assets when they are referenced from a field that is explicitly marked as containing assets. If an object contains an asset URL as part of a free-form field, like a string or a Markdown field, the remote URL will not be replaced.

## 🏗 Installation

To install the plugin and add it to your project, run:

```
npm install sourcebit-transform-assets --save
```

> 💡 You don't need to run this command if you start Sourcebit using the [interactive setup process](#%EF%B8%8F-interactive-setup-process), as the CLI will install the plugin for you and add it as a dependency to your project.

## ⚙️ Configuration

The plugin accepts the following configuration parameters. They can be supplied in any of the following ways:

-   In the `options` object of the plugin configuration block inside `sourcebit.js`, with the value of the _Property_ column as a key;
-   As an environment variable named after the _Env variable_ column, when running the `sourcebit fetch` command;
-   As part of a `.env` file, with the value of the _Env variable_ column separated by the value with an equals sign (e.g. `MY_VARIABLE=my-value`);
-   As a CLI parameter, when running the `sourcebit fetch` command, using the value of the _Parameter_ column as the name of the parameter (e.g. `sourcebit fetch --my-parameter`).

| Property             | Type            | Visibility | Default value | Env variable | Parameter | Description                                                                                       |
| -------------------- | --------------- | ---------- | ------------- | ------------ | --------- | ------------------------------------------------------------------------------------------------- |
| `assetPath`          | String/Function | Public     | `assets`      |              |           | A function that determines the full path for each asset detected (see [`assetPath`](#assetpath)). |
| `maximumSearchDepth` | Number          | Public     | `5`           |              |           | When recursively finding asset URLs in nested object, the plugin will stop at this depth.         |
| `publicUrl`          | String/Function | Public     | `/assets`     |              |           | A function that determines the public URL for each asset (see [`publicUrl`](#publicUrl)).         |

### `assetPath`

If `assetPath` is defined as a string, its value will be used as the path for the asset.

If `assetPath` is a function, it will be invoked for each asset detected with two parameters:

-   `entry` (Object): The entry in which the asset was detected
-   `asset` (Object): The normalized asset object

Its return value will be used as the path for the asset.

### `publicUrl`

If `publicUrl` is defined as a string, its value will replace the original URL of the asset in any objects.

If `publicUrl` is a function, it will be invoked for each asset detected with two parameters:

-   `entry` (Object): The entry in which the asset was detected
-   `asset` (Object): The normalized asset object
-   `assetPath` (String): The local path where the asset has been saved

Its return value will replace the original URL of the asset in any objects.

### 👀 Example configuration

_`assetPath` and `publicUrl` as strings_

```js
module.exports = {
    plugins: [
        {
            module: require('sourcebit-transform-assets'),
            options: {
                assetPath: 'assets',
                publicUrl: '/assets'
            }
        }
    ]
};
```

_`assetPath` and `publicUrl` as functions_

```js
module.exports = {
    plugins: [
        {
            module: require('sourcebit-transform-assets'),
            options: {
                assetPath: function(entry, asset) {
                    return `my-assets/${entry.someField}-${asset.fileName}`;
                },
                publicUrl: function(entry, asset, assetPath) {
                    return `https://something.example.com/public/${assetPath}`;
                }
            }
        }
    ]
};
```

### 🧞‍♂️ Interactive setup process

This plugin offers an interactive setup process via the `npx create-sourcebit` command. It asks users to choose the `assetPath` and `publicUrl` options.

## 📥 Input

This plugin expects the following data buckets to exist:

-   `models`: An array of content models

## 📤 Output

This plugin creates files on disk, in locations defined by the `assetPath` option.

---
_Source: https://npm.io/package/sourcebit-transform-assets · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._