StorageCore

StorageCore is a vendor-neutral object storage foundation for backend systems.

It provides a small contract for storing objects, reading metadata, listing by prefix, generating presigned uploads, and resolving public URLs. The contract is stable across adapters, while provider-specific details stay inside adapters.

Packages

• @fengsoft/storage-core: core types, errors, helpers, and the storage driver contract
• @fengsoft/storage-core-adapter-r2: Cloudflare R2 adapter over the S3-compatible API
• @fengsoft/storage-core-adapter-filesystem: local filesystem adapter for development and self-hosted use
• @fengsoft/storage-core-adapter-memory: in-memory adapter for tests and local demos

Quick start

pnpm install
pnpm run ci

Repository map

packages/
  storage-core/         Public contract and shared helpers
  adapter-r2/           Cloudflare R2 adapter
  adapter-filesystem/   Local filesystem adapter
  adapter-memory/       In-memory adapter
tests/
  unit/                 Contract tests shared across adapters
docs/                   Concepts, architecture and operations notes

Project docs

• Contributing guide
• Security policy
• Architecture and concepts

Compatibility

• Node 24.x
• pnpm 10.33.x

License

Apache-2.0