Socket
Socket
Sign inDemoInstall

sourcebit-transform-assets

Package Overview
Dependencies
Maintainers
11
Versions
5
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

sourcebit-transform-assets

A Sourcebit plugin for downloading assets


Version published
Weekly downloads
1
decreased by-92.86%
Maintainers
11
Weekly downloads
 
Created
Source

sourcebit-transform-assets

npm version

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, 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).
PropertyTypeVisibilityDefault valueEnv variableParameterDescription
assetPathString/FunctionPublicassetsA function that determines the full path for each asset detected (see assetPath).
maximumSearchDepthNumberPublic5When recursively finding asset URLs in nested object, the plugin will stop at this depth.
publicUrlString/FunctionPublic/assetsA function that determines the public URL for each asset (see 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

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

assetPath and publicUrl as functions

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.

Keywords

FAQs

Package last updated on 06 Jul 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc