Registry / devops / fis3-deploy-http-push

fis3-deploy-http-push

JSON →
library2.0.8jsnpmunverified

The `fis3-deploy-http-push` package serves as the default deployment plugin for the FIS3 build system, offering functionalities for both local and remote file synchronization via HTTP POST requests. Currently at version 2.0.8, it enables developers to configure custom deployment targets and attach specific data parameters for different file types directly within their FIS3 build configurations. A key characteristic is its deep integration with the FIS3 framework, allowing for sophisticated, programmatic control over the deployment process, including the ability to incorporate interactive elements like token prompts for authentication during a build. However, it is critical to note the explicit and severe security warnings associated with the provided `receiver.php` example script, which is inherently insecure and **must not be deployed in production environments**. This limitation means the plugin is primarily suitable for internal development, staging, or highly trusted network setups. The package's release cadence is not independent but rather follows the lifecycle and maintenance schedule of the broader FIS3 project.

devopshttp-networking
github ↗package ↗
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

This package is a CommonJS module. Direct 'require' is typically for advanced, programmatic usage as demonstrated in the '另类使用方法' section of the README, where its 'apply' method is used.

const deployPlugin = require('fis3-deploy-http-push');

This is the standard way to reference and configure the plugin within a FIS3 build configuration, telling FIS3 to use this plugin by its registered name.

fis.plugin('http-push', { /* config */ });

Demonstrates how to configure the `http-push` plugin within a FIS3 project to deploy JavaScript files to a remote HTTP receiver endpoint with custom parameters.

const fis = require('fis3'); fis.match('*.js', { deploy: fis.plugin('http-push', { // If configured, fis will POST files one by one to the receiver endpoint. receiver: 'http://www.example.com:8080/receiver.php', // This parameter will be sent along with the POST request. to: '/home/fis/www', // Additional parameters, backend accesses via $_POST['xx']. // If 'data' contains a 'to' key, the above 'to' parameter will override it. data: { token : 'abcdefghijk', user : 'maxming', uid : 1 } }) }); // Example of running the build (assuming fis3 CLI is installed) // fis.project.vcs.query = () => '1.0.0'; // Mock version for a complete example // fis.match('**', { release: '/$0' }); // Release all files // fis.log.level = fis.log.L_INFO; // fis.cli.run(process.argv); // This would trigger a build if run in a FIS3 project context
Debug
Known footguns
breakingThe `receiver.php` script provided as an example in the README has severe security vulnerabilities and is explicitly marked as unsafe for production. Deploying it in a live environment will expose your server to significant risks.
gotchaThis plugin is tightly coupled with the FIS3 build system. It is not a standalone deployment tool and requires a functioning FIS3 project setup to operate.
gotchaThe remote HTTP receiver endpoint (`receiver` option) must be a live server capable of accepting POST requests and handling file uploads. The plugin does not provide this server component itself (beyond the insecure example `receiver.php`).
Upgrade
Version history

Breaking-change detection hasn't run for this library yet.

Audit
Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity
20 hits · last 30 days
gptbot
4
ahrefsbot
4
bytedance
4
amazonbot
3
script
1
Resources
githubhttps://github.com/fex-team/fis3-deploy-http-push ↗
packagehttps://www.npmjs.com/package/fis3-deploy-http-push ↗