{"id":45066,"library":"gulp-file-transform-cache","title":"gulp-file-transform-cache","description":"A gulp plugin that caches intermediate file transformations to speed up build pipelines by skipping repeated expensive steps (e.g., Babel compilation). Version 2.0.0 wraps the file-transform-cache module and integrates as a gulp plugin. It allows specifying a cache file path and an array of transform streams. This plugin is useful for large projects where re-running transforms on unchanged files is wasteful, offering a simple drop-in enhancement to existing gulp pipelines. No recent activity; releases are sporadic.","status":"maintenance","version":"2.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/jdarren/gulp-file-transform-cache","tags":["javascript","gulpplugin","cache"],"install":[{"cmd":"npm install gulp-file-transform-cache","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-file-transform-cache","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-file-transform-cache","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"core caching logic","package":"file-transform-cache","optional":false},{"reason":"stream transformation in gulp plugin","package":"through2","optional":false},{"reason":"gulp plugin utilities (may be deprecated in favor of PluginError)","package":"gulp-util","optional":true}],"imports":[{"note":"ESM default import works; CommonJS require also works but typing may differ.","wrong":"const gftc = require('gulp-file-transform-cache')","symbol":"default","correct":"import gftc from 'gulp-file-transform-cache'"},{"note":"Named export 'gftc' is available; prefer default import for clarity.","symbol":"gftc (as named)","correct":"import { gftc } from 'gulp-file-transform-cache'"},{"note":"CommonJS require returns an object with default property; many forget the .default.","wrong":"const gftc = require('gulp-file-transform-cache')","symbol":"default (require)","correct":"const gftc = require('gulp-file-transform-cache').default"}],"quickstart":{"code":"import gulp from 'gulp';\nimport babel from 'gulp-babel';\nimport gftc from 'gulp-file-transform-cache';\n\nexport function build() {\n  return gulp.src('js/**/*.jsx')\n    .pipe(gftc({\n      path: '.babelCache',\n      transformStreams: [babel()]\n    }))\n    .pipe(gulp.dest('dest'));\n}","lang":"javascript","description":"Shows how to add transform caching to a gulp pipeline with Babel as an example."},"warnings":[{"fix":"Monitor for updates or switch to alternative cache plugins.","message":"gulp-util is deprecated; plugin uses it internally.","severity":"deprecated","affected_versions":">=1.0.0 <=2.0.0"},{"fix":"Provide absolute path using path.resolve() for consistency.","message":"Cache file path is relative to process.cwd() unless absolute; may cause issues in different working directories.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Always wrap single transform in array for clarity: transformStreams: [babel()]","message":"The plugin expects transformStreams to be an array, but if only one transform, array can be omitted; this can cause confusion.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use gulp 3 compatible pipelines or fork the package.","message":"Package has not been updated for modern gulp versions (gulp 4+).","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Delete cache file manually when updating transform libraries.","message":"Cache invalidation is based on file content hash; if transform dependencies change (e.g., Babel version), cache is not invalidated automatically.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'2.0.0':28 'activ':85 'allow':43 'array':51 'babel':25 'build':17 'cach':5,10,34,46,91 'compil':26 'drop':76 'drop-in':75 'e.g':24 'enhanc':78 'exist':80 'expens':22 'file':3,12,32,47,69 'file-transform-cach':31 'gulp':2,7,40,81 'gulp-file-transform-cach':1 'gulpplugin':90 'integr':37 'intermedi':11 'javascript':89 'larg':60 'modul':35 'offer':72 'path':48 'pipelin':18,82 'plugin':8,41,56 'project':61 're':64 're-run':63 'recent':84 'releas':86 'repeat':21 'run':65 'simpl':74 'skip':20 'specifi':44 'speed':15 'sporad':88 'step':23 'stream':54 'transform':4,13,33,53,66 'unchang':68 'use':58 'version':27 'wast':71 'wrap':29","created_at":"2026-06-07T12:53:12.446869+00:00","updated_at":"2026-06-07T12:53:12.446869+00:00","problems":[{"fix":"Run `npm install gulp-util --save-dev` or switch to a plugin that doesn't depend on it.","cause":"gulp-util is a peer dependency not installed automatically in npm v3+.","error":"Error: Cannot find module 'gulp-util'"},{"fix":"Wrap the stream in an array: transformStreams: [babel()]","cause":"Passing a single stream object instead of an array when only one transform.","error":"TypeError: transformStreams is not iterable"},{"fix":"Use absolute path: gftc({ path: path.resolve('.babelCache'), ... })","cause":"Cache file path is relative but the working directory differs; or cache file path does not exist.","error":"Error: ENOENT: no such file or directory, open '.babelCache'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/jdarren/gulp-file-transform-cache#readme","github":"https://github.com/jdarren/gulp-file-transform-cache","docs":null,"changelog":null,"pypi":null,"npm":"gulp-file-transform-cache","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}