A Node integration for Transloadit's file uploading and encoding service.
Transloadit is a service that helps you handle file uploads, resize, crop and watermark your images, make GIFs, transcode your videos, extract thumbnails, generate audio waveforms, and so much more. In short, Transloadit is the Swiss Army Knife for your files.
This is a Node SDK to make it easy to talk to the Transloadit REST API.
Inside your project, type
npm install transloadit --saveIf there are no errors, you can start using the module.
const TransloaditClient = require('transloadit')
const transloadit = new TransloaditClient({
authKey : 'YOUR_TRANSLOADIT_KEY',
authSecret: 'YOUR_TRANSLOADIT_SECRET'
})
transloadit.addFile('file1', '/PATH/TO/FILE.jpg');
const assemblyOptions = {
params: {
template_id: 'YOUR_TEMPLATE_ID'
}
}
transloadit.createAssembly(assemblyOptions, (err, result) => {
if (err) {
throw err
}
console.log('✅ success')
let assemblyId = result.assembly_id
console.log({
assemblyId: assemblyId
})
transloadit.deleteAssembly(assemblyId, (err) => {
console.log('✅ deleted')
})
})For fully working examples take a look at
examples/.
These are the public methods on the TransloaditClient object and their descriptions.
Returns a new instance of the client. The options object must at least include authKey and authSecret keys (and their values).
You can also provide service, which defaults to 'api2.transloadit.com', and region, which defaults to 'us-east-1'.
By default TransloaditClient will use SSL so it will access service with a https:// prefix. You can switch this off by providing options.useSsl with a value of false.
Calculates a signature for the given params JSON object. If the params object does not include an authKey or expires keys (and their values) in the auth sub-key, then they are set automatically.
This function returns an object with the key signature (containing the calculated signature string) and a key params, which contains the stringified version of the passed params object (including the set expires and authKey keys).
Registers the local file with the client. The next call to createAssembly will upload that file.
Registers the provided stream with the client. The next call to createAssembly will upload that stream.
Creates a new assembly on Transloadit, uploading all streams and files that were registered via .addStream() and .addFile() prior to the call to .createAssembly().
You can provide some options:
params- an object containing yourtemplate_id,notify_url, some steps that overwrite your Transloadit template and other params to control Transloadit behavior.fields- an object of form fields to add to the request, to make use of in the assembly via assembly variables.waitForCompletion- A boolean (default isfalse) to indicate whether you want to wait for the assembly to finish with all encoding results present before the callback is called.
This function (like all functions of this client) automatically obeys all rate limiting imposed by Transloadit. There is no need to write your own wrapper scripts to handle rate limits.
Returns the internal url that was used for the last call to Transloadit.createAssembly(). This is meant to be used for debugging purposes.
Retrieves an array of assemblies according to the given params.
Valid params can be page, pagesize, type, fromdate and todate. Please consult the Transloadit API docs for details.
Creates an objectMode readable stream that automates handling of listAssembly pagination. It accepts the same params as listAssembly.
This can be used to iterate through assemblies:
var assemblyStream = client.streamAssemblies({ fromdate: '2016-08-19 01:15:00 UTC' });
assemblyStream.on('readable', function() {
var assembly = assemblyStream.read();
if (assembly == null) console.log('end of stream');
console.log(assembly.id);
});Results can also be piped. Here's an example using through2:
var assemblyStream = client.streamAssemblies({ fromdate: '2016-08-19 01:15:00 UTC' });
assemblyStream
.pipe(through.obj(function(chunk, enc, callback) {
this.push(chunk.id + '\n');
callback();
}))
.pipe(fs.createWriteStream('assemblies.txt'));Retrieves the JSON status of the assembly identified by the given assemblyId.
Removes the assembly identified by the given assemblyId from the memory of the Transloadit machines, ultimately cancelling it. This does not delete the assembly from the database - you can still access it on https://transloadit.com/assemblies/{assembly_id} in your Transloadit account. This also does not delete any files associated with the assembly from the Transloadit servers.
Replays the assembly identified by the given assembly_id. The options parameter must contain an assembly_id key containing the assembly id. Optionally you can also provide a notify_url key if you want to change the notification target.
Replays the notification for the assembly identified by the given assembly_id. The options parameter must contain an assembly_id key containing the assembly id. Optionally you can also provide a notify_url key if you want to change the notification target.
Retrieves an array of assembly notifications according to the given params.
Valid params can be page, pagesize, type and assembly_id. Please consult the Transloadit API docs for details.
Creates an objectMode readable stream like streamAssemblies that automates handling of listAssemblynotifications pagination.
Creates a template the provided params. The required params keys are: name (the template name) and template (the template JSON string).
Updates the template represented by the given templateId with the new value. The params works just like the one from the createTemplate call.
Retrieves the name and the template JSON for the template represented by the given templateId.
Deletes the template represented by the given templateId on Transloadit.
Retrieves a list of all your templates from Transloadit. The params parameter can contain properties such as order, sort, and page. For a list of all available params please check this entry in the Transloadit API docs.
Creates an objectMode readable stream like streamAssemblies that automates handling of listTemplates pagination.
We'd be happy to accept pull requests. If you plan on working on something big, please first drop us a line!
The SDK is written in ES6, but the ES5 JavaScript it generates is committed back into the repository so people can use this module without a ES6 dependency. If you want to work on the source, please do so in ./src and type: npm run build or npm run test (also builds first). Please don't edit generated JavaScript in ./lib!
Check your sources for linting errors via npm run lint, and unit tests, and run them via npm run test, or npm run mocha for faster iterations.
Releasing a new version to npmjs.org can be done via npm run release:major (or minor / patch, depending on the semantic versioning impact of your changes). This will automatically:
- Bump the version inside the
package.json - Save a release commit with the updated version in Git
- Push a tag to Github
- Publish to npmjs.org
If you come from a unix background and fancy faster auto-complete, you'll be delighted to know that all npm scripts are also accessible under make, via fakefile.
Contributions from:
Thanks to:
- Ian Hansen for donating the
transloaditnpm name. You can still access his code underv0.0.0.