streamby-core 0.8.0 โ†’ 0.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,114 +1,114 @@
1
- # @streamby/core
2
-
3
- Middleware framework for building storage-agnostic media APIs.
4
- Part of the [StreamBy](https://streamby.nhexa.cl) ecosystem by TerminalCore Labs.
5
-
6
- ---
7
-
8
- ## ๐Ÿš€ What is it?
9
-
10
- `@streamby/core` is a plug-and-play middleware for Express (or compatible frameworks) that enables file uploads, listings and **multi-project access** over services like:
11
-
12
- - โœ… AWS S3
13
- - โœ… Google Cloud Storage (soon)
14
- - โœ… Cloudflare R2 (soon)
15
- - โœ… Local/Personal servers (soon)
16
-
17
- It's designed to be installed inside your existing API as a library โ€” **no need to run a separate backend**.
18
-
19
- ---
20
-
21
- ## ๐Ÿ“ฆ Installation
22
-
23
- ```bash
24
- npm install @streamby/core
25
- ```
26
-
27
- ---
28
-
29
- ## ๐Ÿงฑ Basic usage
30
-
31
- ```ts
32
- import express from 'express';
33
- import { createStreamByRouter } from '@streamby/core';
34
-
35
- const app = express();
36
-
37
- app.use('/streamby', createStreamByRouter({
38
- storageProvider: {
39
- type: 's3',
40
- config: {
41
- bucket: 'your-bucket-name',
42
- region: 'your-region',
43
- accessKeyId: 'YOUR_AWS_KEY',
44
- secretAccessKey: 'YOUR_AWS_SECRET'
45
- }
46
- },
47
- authProvider: async (req) => {
48
- // extract token/cookie and validate
49
- return {
50
- userId: 'demo',
51
- projects: ['demo-project'],
52
- role: 'admin',
53
- };
54
- },
55
- projectProvider: async (projectId) => {
56
- // fetch project from your DB
57
- return {
58
- id: projectId,
59
- name: 'Demo Project',
60
- description: 'Demo for StreamBy integration',
61
- rootFolders: [],
62
- settings: { allowUpload: true }
63
- };
64
- }
65
- }));
66
-
67
- app.listen(3000);
68
- ```
69
-
70
- ---
71
-
72
- ## ๐Ÿงช Testing
73
-
74
- ```bash
75
- npm run test
76
- ```
77
-
78
- Unit tests use [Vitest](https://vitest.dev) and [Supertest](https://www.npmjs.com/package/supertest).
79
-
80
- ---
81
-
82
- ## ๐Ÿ“ Features
83
-
84
- - ๐Ÿ“‚ Multi-project access control
85
- - ๐Ÿ” Project-aware file uploads & listings
86
- - ๐Ÿงน Modular adapters per storage provider
87
- - ๐Ÿงฐ Built-in testability with mock auth & storage
88
- - โœจ Simple to extend for custom business logic
89
-
90
- ---
91
-
92
- ## ๐Ÿšฃ Roadmap
93
-
94
- - [ ] Support for Google Cloud Storage
95
- - [ ] CLI tool for uploading files
96
- - [ ] Role-based access control middleware
97
- - [ ] Plugin system for extended routes
98
- - [ ] Streaming support (HLS, audio, etc.)
99
-
100
- ---
101
-
102
- ## ๐Ÿง‘โ€๐Ÿ’ป Maintained by
103
-
104
- **TerminalCore Labs** โ€“ part of [Nhexa Entertainment](https://nhexa.cl)
105
- Developed as open-source infrastructure for creative and media-oriented apps.
106
-
107
- Visit us [here](https://terminalcore.cl)
108
-
109
- ---
110
-
111
- ## ๐Ÿ“Ÿ License
112
-
113
- [MIT](./LICENSE)
114
-
1
+ # @streamby/core
2
+
3
+ Middleware framework for building storage-agnostic media APIs.
4
+ Part of the [StreamBy](https://streamby.nhexa.cl) ecosystem by TerminalCore Labs.
5
+
6
+ ---
7
+
8
+ ## ๐Ÿš€ What is it?
9
+
10
+ `@streamby/core` is a plug-and-play middleware for Express (or compatible frameworks) that enables file uploads, listings and **multi-project access** over services like:
11
+
12
+ - โœ… AWS S3
13
+ - โœ… Google Cloud Storage (soon)
14
+ - โœ… Cloudflare R2 (soon)
15
+ - โœ… Local/Personal servers (soon)
16
+
17
+ It's designed to be installed inside your existing API as a library โ€” **no need to run a separate backend**.
18
+
19
+ ---
20
+
21
+ ## ๐Ÿ“ฆ Installation
22
+
23
+ ```bash
24
+ npm install @streamby/core
25
+ ```
26
+
27
+ ---
28
+
29
+ ## ๐Ÿงฑ Basic usage
30
+
31
+ ```ts
32
+ import express from 'express';
33
+ import { createStreamByRouter } from '@streamby/core';
34
+
35
+ const app = express();
36
+
37
+ app.use('/streamby', createStreamByRouter({
38
+ storageProvider: {
39
+ type: 's3',
40
+ config: {
41
+ bucket: 'your-bucket-name',
42
+ region: 'your-region',
43
+ accessKeyId: 'YOUR_AWS_KEY',
44
+ secretAccessKey: 'YOUR_AWS_SECRET'
45
+ }
46
+ },
47
+ authProvider: async (req) => {
48
+ // extract token/cookie and validate
49
+ return {
50
+ userId: 'demo',
51
+ projects: ['demo-project'],
52
+ role: 'admin',
53
+ };
54
+ },
55
+ projectProvider: async (projectId) => {
56
+ // fetch project from your DB
57
+ return {
58
+ id: projectId,
59
+ name: 'Demo Project',
60
+ description: 'Demo for StreamBy integration',
61
+ rootFolders: [],
62
+ settings: { allowUpload: true }
63
+ };
64
+ }
65
+ }));
66
+
67
+ app.listen(3000);
68
+ ```
69
+
70
+ ---
71
+
72
+ ## ๐Ÿงช Testing
73
+
74
+ ```bash
75
+ npm run test
76
+ ```
77
+
78
+ Unit tests use [Vitest](https://vitest.dev) and [Supertest](https://www.npmjs.com/package/supertest).
79
+
80
+ ---
81
+
82
+ ## ๐Ÿ“ Features
83
+
84
+ - ๐Ÿ“‚ Multi-project access control
85
+ - ๐Ÿ” Project-aware file uploads & listings
86
+ - ๐Ÿงน Modular adapters per storage provider
87
+ - ๐Ÿงฐ Built-in testability with mock auth & storage
88
+ - โœจ Simple to extend for custom business logic
89
+
90
+ ---
91
+
92
+ ## ๐Ÿšฃ Roadmap
93
+
94
+ - [ ] Support for Google Cloud Storage
95
+ - [ ] CLI tool for uploading files
96
+ - [ ] Role-based access control middleware
97
+ - [ ] Plugin system for extended routes
98
+ - [ ] Streaming support (HLS, audio, etc.)
99
+
100
+ ---
101
+
102
+ ## ๐Ÿง‘โ€๐Ÿ’ป Maintained by
103
+
104
+ **TerminalCore Labs** โ€“ part of [Nhexa Entertainment](https://nhexa.cl)
105
+ Developed as open-source infrastructure for creative and media-oriented apps.
106
+
107
+ Visit us [here](https://terminalcore.cl)
108
+
109
+ ---
110
+
111
+ ## ๐Ÿ“Ÿ License
112
+
113
+ [MIT](./LICENSE)
114
+
@@ -1,8 +1,12 @@
1
1
  "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
2
5
  Object.defineProperty(exports, "__esModule", { value: true });
3
6
  exports.createS3Adapter = createS3Adapter;
4
7
  const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
5
8
  const client_s3_1 = require("@aws-sdk/client-s3");
9
+ const bcrypt_1 = __importDefault(require("bcrypt"));
6
10
  function createS3Adapter(config) {
7
11
  const s3 = new client_s3_1.S3Client({
8
12
  region: config.region,
@@ -13,28 +17,17 @@ function createS3Adapter(config) {
13
17
  });
14
18
  return {
15
19
  async getPresignedUrl(filename, contentType, projectId) {
16
- const key = `projects/${projectId}/file-${Date.now()}-${filename}`;
20
+ const salt = await bcrypt_1.default.genSalt();
21
+ const hashedPassword = await bcrypt_1.default.hash(filename, salt);
22
+ const key = `${projectId}/file-${Date.now()}-${hashedPassword}`;
17
23
  const command = new client_s3_1.PutObjectCommand({
18
24
  Bucket: config.bucket,
19
25
  Key: key,
20
26
  ContentType: contentType,
21
27
  });
22
28
  const url = await (0, s3_request_presigner_1.getSignedUrl)(s3, command, { expiresIn: 60 });
23
- return { url, key };
24
- },
25
- async uploadFile(req, projectId) {
26
- const file = req.body?.file;
27
- if (!file || !file.name || !file.buffer) {
28
- throw new Error('Invalid file upload: missing name or buffer');
29
- }
30
- const key = `${projectId}/${file.name}`;
31
- const command = new client_s3_1.PutObjectCommand({
32
- Bucket: config.bucket,
33
- Key: key,
34
- Body: file.buffer,
35
- });
36
- await s3.send(command);
37
- return { success: true, key };
29
+ const publicUrl = `https://${config.bucket}.s3.${config.region}.amazonaws.com/${key}`;
30
+ return { url, publicUrl };
38
31
  },
39
32
  async listFiles(projectId) {
40
33
  const command = new client_s3_1.ListObjectsV2Command({
@@ -77,20 +77,6 @@ function createStreamByRouter(config) {
77
77
  res.status(500).json({ error: 'Failed to update project', details: err.message });
78
78
  }
79
79
  });
80
- router.post('/upload', async (req, res) => {
81
- try {
82
- const auth = await config.authProvider(req);
83
- const projectId = (req.query.projectId || req.headers['x-project-id']);
84
- if (!projectId || !auth.projects.includes(projectId)) {
85
- return res.status(403).json({ error: 'Unauthorized or missing projectId' });
86
- }
87
- const result = await (0, file_1.uploadFileService)(adapter, req, projectId);
88
- res.json(result);
89
- }
90
- catch (err) {
91
- res.status(500).json({ error: 'Failed to upload file', details: err });
92
- }
93
- });
94
80
  router.get('/projects/:id', async (req, res) => {
95
81
  try {
96
82
  const auth = await config.authProvider(req);
@@ -1,4 +1,3 @@
1
1
  import { StorageAdapter } from '../types';
2
2
  import { Request } from 'express';
3
3
  export declare function listFilesService(adapter: StorageAdapter, req: Request, projectId: string): Promise<any[]>;
4
- export declare function uploadFileService(adapter: StorageAdapter, req: Request, projectId: string): Promise<any>;
@@ -1,10 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.listFilesService = listFilesService;
4
- exports.uploadFileService = uploadFileService;
5
4
  async function listFilesService(adapter, req, projectId) {
6
5
  return adapter.listFiles(projectId);
7
6
  }
8
- async function uploadFileService(adapter, req, projectId) {
9
- return adapter.uploadFile(req, projectId);
10
- }
@@ -7,7 +7,6 @@ export interface S3Config {
7
7
  }
8
8
  export type StorageProviderType = 's3';
9
9
  export interface StorageAdapter {
10
- uploadFile(req: Request, projectId: string): Promise<any>;
11
10
  listFiles(projectId: string): Promise<any[]>;
12
11
  getPresignedUrl?: (filename: string, contentType: string, projectId: string) => Promise<any>;
13
12
  }
package/package.json CHANGED
@@ -1,46 +1,48 @@
1
- {
2
- "name": "streamby-core",
3
- "version": "0.8.0",
4
- "description": "StreamBy middleware framework for media storage management",
5
- "main": "dist/index.js",
6
- "types": "dist/index.d.ts",
7
- "files": [
8
- "dist"
9
- ],
10
- "scripts": {
11
- "build": "tsc",
12
- "test": "vitest",
13
- "dev": "tsc --watch",
14
- "prepublishOnly": "npm run build"
15
- },
16
- "repository": {
17
- "type": "git",
18
- "url": "https://github.com/GwerhDev/StreamBy-Package.git"
19
- },
20
- "keywords": [
21
- "streamby",
22
- "middleware",
23
- "upload",
24
- "storage",
25
- "s3",
26
- "express",
27
- "typescript"
28
- ],
29
- "author": "TerminalCore Labs",
30
- "license": "MIT",
31
- "dependencies": {
32
- "@aws-sdk/client-s3": "^3.528.0",
33
- "@aws-sdk/s3-request-presigner": "^3.787.0",
34
- "express": "^4.0.0"
35
- },
36
- "devDependencies": {
37
- "@types/express": "^4.17.17",
38
- "@types/supertest": "^6.0.3",
39
- "supertest": "^7.1.0",
40
- "typescript": "^5.8.3",
41
- "vitest": "^3.1.1"
42
- },
43
- "peerDependencies": {
44
- "express": "^4.0.0"
45
- }
46
- }
1
+ {
2
+ "name": "streamby-core",
3
+ "version": "0.8.2",
4
+ "description": "StreamBy middleware framework for media storage management",
5
+ "main": "dist/index.js",
6
+ "types": "dist/index.d.ts",
7
+ "files": [
8
+ "dist"
9
+ ],
10
+ "scripts": {
11
+ "build": "tsc",
12
+ "test": "vitest",
13
+ "dev": "tsc --watch",
14
+ "prepublishOnly": "npm run build"
15
+ },
16
+ "repository": {
17
+ "type": "git",
18
+ "url": "https://github.com/GwerhDev/StreamBy-Package.git"
19
+ },
20
+ "keywords": [
21
+ "streamby",
22
+ "middleware",
23
+ "upload",
24
+ "storage",
25
+ "s3",
26
+ "express",
27
+ "typescript"
28
+ ],
29
+ "author": "TerminalCore Labs",
30
+ "license": "MIT",
31
+ "dependencies": {
32
+ "@aws-sdk/client-s3": "^3.528.0",
33
+ "@aws-sdk/s3-request-presigner": "^3.787.0",
34
+ "bcrypt": "^5.1.1",
35
+ "express": "^4.0.0"
36
+ },
37
+ "devDependencies": {
38
+ "@types/bcrypt": "^5.0.2",
39
+ "@types/express": "^4.17.17",
40
+ "@types/supertest": "^6.0.3",
41
+ "supertest": "^7.1.0",
42
+ "typescript": "^5.8.3",
43
+ "vitest": "^3.1.1"
44
+ },
45
+ "peerDependencies": {
46
+ "express": "^4.0.0"
47
+ }
48
+ }