backfill-cache

library5.12.5jsnpmunverified

Internal cache provider package for Microsoft's backfill monorepo caching system (part of lage). Version 5.12.5 is current stable. Provides filesystem and remote cache backends for build caching. Not meant for direct use; consumers should use the main `backfill` package. Ships TypeScript declarations. Requires Node >=14. Release cadence is tied to lage releases.

devops

npm install backfill-cache

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BACKFILL-CACHE

backfill-cache

devopsjavascriptv5.12.5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

default

✓ import backfillCache from 'backfill-cache'

✗ import { backfillCache } from 'backfill-cache'

This package exports a default export only.

CacheProvider

✓ import { CacheProvider } from 'backfill-cache'

✗ const { CacheProvider } = require('backfill-cache')

Named exports for types are available; but runtime use via CJS require may work but is not recommended.

FileSystemCache

✓ import { FileSystemCache } from 'backfill-cache'

✗ import FileSystemCache from 'backfill-cache'

FileSystemCache is a named export, not default.

Shows basic usage of the cache provider to store and retrieve data.

import backfillCache from 'backfill-cache'; const cache = backfillCache.createCache({ cwd: process.cwd(), provider: 'filesystem' }); await cache.put('hash', Buffer.from('data')); const result = await cache.get('hash'); console.log(result.toString());

Debug

Known issues

gotchaThis package is internal to backfill; do NOT add as a direct dependency. Use the main `backfill` package instead.

fix

Install `backfill` instead and use its public API.

affects: >=5.0.0

deprecatedVersion 5.x may have breaking changes compared to 4.x. The cache provider API changed.

fix

Review migration guide in the lage/backfill repository.

affects: >=5.0.0

gotchaAPI surface may change without notice as it is an internal package. Do not rely on stable exports.

fix

Pin to exact version and monitor updates.

affects: >=5.0.0

Errors

Common errors & fixes

Cannot find module 'backfill-cache' or its corresponding type declarations.

Package is not installed; it's an internal dependency not published or not in node_modules.

fix

Install the main 'backfill' package instead: `npm install backfill`

TypeError: backfillCache.createCache is not a function

Using an incompatible version or incorrect import style.

fix

Ensure you are using the default import: `import backfillCache from 'backfill-cache'`

Upgrade

Version history

5.12.5latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/microsoft/lage ↗

packagebackfill-cache ↗

homepagehttps://github.com/microsoft/lage#readme ↗