Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@filesrocket/local

Filesrocket17MIT1.2.2TypeScript support: included

Filesrocket service that manages your files locally

filesrocket, filemanager, filemanagement, upload, storage, files

readme

Filesrocket

Manage your files with any Cloud Storage Services

Filesrocket is an package of Node.js that allows you to manage your files with any cloud storage service (Local, Cloudinary, Amazon S3) through the use of strategies called Services

📙 Documentation

The Filesrocket Docs are packed with awesome stuff and tell you everything you need to know about using and configuring Filesrocket.

🚀 Getting started

You can start using Filesrocket in easy steps.

$ mkdir filesrocket-example
$ cd filesrocket-example
$ npm init -y && tsc --init
$ npm install express @filesrocket/core @filesrocket/local
$ npm install @types/express typescript ts-node -D

Create src/index.ts and copy following content.

  1. Initialize app
import express from "express";

const app = express();

app.listen(3030, ()  => {
  console.log("App execute in port:3030");
});
  1. Register the services you are going to use
import { Filesrocket } from "@filesrocket/core";
import { LocalService } from "@filesrocket/local";

// Initialize
const filesrocket = new Filesrocket();

// Config your service
const service = new LocalService({
  pagination: { default: 15, max: 50 },
  host: "http://localhost:3030",
  directory: "uploads"
});

// We register the service
filesrocket.register("local", service);
  1. Register your endpoints.
const controller = filesrocket.controller("local");

// Create/Upload files.
app.post("/files", async (req,  res) => {
  const files = await controller.create(req, {});

  res.status(200).json(files);
})

// List files.
app.get("/files", async (req, res) => {
  const query = req.query;

  const files = await controller.list(query);

  res.status(200).json(files);
})

// Remove files.
app.delete("/files", async (req, res) => {
  const query = req.query;
  const { id } = query;

  const files = await controller.remove(id, query)

  res.status(200).json(files)
})

Expose static files.

app.use("/uploads", express.static(path.resolve("uploads")));

We run the server

npx ts-node src/index.ts

With this simple example you can interact with the files, click on the following link: http://localhost:3030/files

❤️ Stay in touch

⚖️ Licence

Filesrocket is MIT Licenced

changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

1.2.0 (2022-08-20)

Bug Fixes

  • package.json: Removed npm-check-updates from dependencies (63e0530)
  • package.json: Removed package standard-version (cebeb85)
  • service: Add an exception when registering a service that already exists (e0a825e)

Features

  • dependencies: Dependencies updated (55dd81c)
  • LICENCE: Updated information (40752e5)
  • package.json: Updated repository and issue links (9f7c15a)

1.1.0 (2022-08-20)

Bug Fixes

  • package.json: Removed npm-check-updates from dependencies (63e0530)
  • package.json: Removed package standard-version (cebeb85)
  • service: Add an exception when registering a service that already exists (e0a825e)

Features

  • dependencies: Dependencies updated (55dd81c)
  • LICENCE: Updated information (40752e5)
  • package.json: Updated repository and issue links (9f7c15a)

1.0.1 (2022-08-07)

Note: Version bump only for package filesrocket

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

0.0.8 (2022-04-10)

Bug Fixes

0.0.7 (2022-04-10)

Bug Fixes

  • Added additional standard-version and script in package.json (d7d04a0)