@arikajs/storage 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ArikaJs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,247 @@
+## Arika Storage
+
+`@arikajs/storage` is the filesystem abstraction layer for the ArikaJS framework.
+
+It provides a clean, unified API to work with local and cloud-based storage systems using interchangeable drivers, inspired by Laravel's Storage but designed for Node.js and TypeScript.
+
+This package allows ArikaJS applications to interact with files without caring where or how they are stored.
+
+---
+
+## ✨ Features
+
+- **Multiple storage disks**: Configure different storage locations
+- **Driver-based filesystem architecture**: Pluggable storage backends
+- **Local filesystem driver**: Built-in support for local file storage (v1)
+- **Unified file API**: `put`, `get`, `delete`, `exists`, `url`
+- **Buffer, string, and stream support**: Flexible content handling
+- **Configuration-based disk resolution**: Easy setup via config files
+- **TypeScript-first**: Full type safety with JavaScript compatibility
+- **Designed for cloud drivers**: Ready for S3, GCS, Azure (planned)
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @arikajs/storage
+# or
+yarn add @arikajs/storage
+# or
+pnpm add @arikajs/storage
+```
+
+---
+
+## 🚀 Quick Start
+
+### Basic File Operations
+
+```ts
+import { Storage } from '@arikajs/storage';
+
+// Write a file
+await Storage.put('files/example.txt', 'Hello Arika');
+
+// Read a file
+const content = await Storage.get('files/example.txt');
+
+// Delete a file
+await Storage.delete('files/example.txt');
+```
+
+---
+
+## 💽 Working with Disks
+
+Arika Storage supports multiple disks, each backed by a driver.
+
+```ts
+// Use a specific disk
+await Storage.disk('local').put('notes.txt', 'Hello');
+
+// Check if file exists on a disk
+const exists = await Storage.disk('public').exists('image.png');
+```
+
+---
+
+## ⚙️ Configuration
+
+Storage disks are defined in your application configuration:
+
+```ts
+export default {
+  default: 'local',
+
+  disks: {
+    local: {
+      driver: 'local',
+      root: './storage/app'
+    },
+
+    public: {
+      driver: 'local',
+      root: './storage/public',
+      url: '/storage'
+    }
+  }
+};
+```
+
+---
+
+## 📁 Supported Drivers (v1)
+
+| Driver | Status |
+| :--- | :--- |
+| Local filesystem | ✅ Supported |
+| Amazon S3 | ✅ Supported |
+| Google Cloud Storage | ⏳ Planned |
+| Azure Blob Storage | ⏳ Planned |
+
+---
+
+## 📚 API Reference
+
+### `Storage.put(path, contents)`
+
+Write contents to a file.
+
+```ts
+await Storage.put('file.txt', 'content');
+```
+
+### `Storage.get(path)`
+
+Read file contents.
+
+```ts
+const content = await Storage.get('file.txt');
+```
+
+**Throws** `FileNotFoundException` if the file does not exist.
+
+### `Storage.exists(path)`
+
+Check if a file exists.
+
+```ts
+const exists = await Storage.exists('file.txt');
+```
+
+### `Storage.delete(path)`
+
+Delete a file.
+
+```ts
+await Storage.delete('file.txt');
+```
+
+### `Storage.url(path)`
+
+Get the public URL for a file.
+
+```ts
+const url = Storage.url('image.png');
+```
+
+Returns a public URL if supported by the disk.
+
+---
+
+## 🧠 Architecture
+
+```
+storage/
+├── src/
+│   ├── StorageManager.ts     ← Resolves disks and drivers
+│   ├── Disk.ts               ← Disk wrapper
+│   ├── Drivers/
+│   │   └── LocalDriver.ts    ← Local filesystem implementation
+│   ├── Contracts/
+│   │   └── Filesystem.ts     ← Driver interface
+│   ├── Exceptions/
+│   │   └── FileNotFoundException.ts
+│   └── index.ts
+├── tests/
+│   └── Storage.test.ts
+├── package.json
+├── tsconfig.json
+├── README.md
+└── LICENSE
+```
+
+---
+
+## 🔌 Extending Storage (Custom Drivers)
+
+You can create your own storage driver:
+
+```ts
+import { Filesystem } from '@arikajs/storage';
+
+class CustomDriver implements Filesystem {
+  async put(path: string, contents: string | Buffer): Promise<void> {
+    // Implementation
+  }
+
+  async get(path: string): Promise<Buffer> {
+    // Implementation
+  }
+
+  async delete(path: string): Promise<void> {
+    // Implementation
+  }
+
+  async exists(path: string): Promise<boolean> {
+    // Implementation
+  }
+
+  url(path: string): string {
+    // Implementation
+  }
+}
+```
+
+Register it inside `StorageManager`.
+
+---
+
+## 🔗 Integration with ArikaJS
+
+`@arikajs/storage` integrates seamlessly with:
+
+- **`@arikajs/auth`** → User uploads
+- **`@arikajs/mail`** → Attachments
+- **`@arikajs/logging`** → File logs
+- **`@arikajs/queue`** → Temporary files
+- **`@arikajs/view`** → Asset handling
+
+---
+
+## 🧪 Testing
+
+The storage layer is fully testable by mocking drivers or using temporary disks.
+
+---
+
+## 🛣 Roadmap
+
+- [x] S3 driver
+- [x] Streaming API
+- [x] Temporary signed URLs
+- [x] Disk-level middleware
+- [x] File metadata support
+
+---
+
+## 📄 License
+
+`@arikajs/storage` is open-source software licensed under the **MIT License**.
+
+---
+
+## 🧭 Philosophy
+
+> "Your application should care about files, not filesystems."

package/dist/Contracts/Filesystem.d.ts

@@ -0,0 +1,48 @@
+import { Readable } from 'stream';
+export interface Filesystem {
+    /**
+     * Write contents to a file.
+     */
+    put(path: string, contents: string | Buffer): Promise<void>;
+    /**
+     * Write a stream to a file.
+     */
+    putStream(path: string, stream: Readable): Promise<void>;
+    /**
+     * Read file contents.
+     */
+    get(path: string): Promise<Buffer>;
+    /**
+     * Read file as a stream.
+     */
+    readStream(path: string): Readable;
+    /**
+     * Check if a file exists.
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Delete a file.
+     */
+    delete(path: string): Promise<void>;
+    /**
+     * Get the URL for a file.
+     */
+    url(path: string): string;
+    /**
+     * Get a temporary URL for a file.
+     */
+    temporaryUrl(path: string, expiresAt: Date): Promise<string>;
+    /**
+     * Get the file size in bytes.
+     */
+    size(path: string): Promise<number>;
+    /**
+     * Get the last modified time of the file.
+     */
+    lastModified(path: string): Promise<number>;
+    /**
+     * Get the mime type of the file.
+     */
+    mimeType(path: string): Promise<string>;
+}
+//# sourceMappingURL=Filesystem.d.ts.map

package/dist/Contracts/Filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Filesystem.d.ts","sourceRoot":"","sources":["../../src/Contracts/Filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAY,MAAM,QAAQ,CAAC;AAE5C,MAAM,WAAW,UAAU;IACvB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IAEnC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7D;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C"}

package/dist/Contracts/Filesystem.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Filesystem.js.map

package/dist/Contracts/Filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Filesystem.js","sourceRoot":"","sources":["../../src/Contracts/Filesystem.ts"],"names":[],"mappings":""}

package/dist/Disk.d.ts

@@ -0,0 +1,60 @@
+import { Readable } from 'stream';
+import { Filesystem } from './Contracts/Filesystem';
+export declare class Disk {
+    private driver;
+    private middlewares;
+    constructor(driver: Filesystem);
+    /**
+     * Register middleware for this disk.
+     */
+    middleware(middleware: any): this;
+    /**
+     * Create a pipeline for an operation.
+     */
+    protected runPipeline(operation: string, params: any, callback: (params: any) => Promise<any>): Promise<any>;
+    /**
+     * Write contents to a file.
+     */
+    put(path: string, contents: string | Buffer): Promise<void>;
+    /**
+     * Write a stream to a file.
+     */
+    putStream(path: string, stream: Readable): Promise<void>;
+    /**
+     * Read file contents.
+     */
+    get(path: string): Promise<Buffer>;
+    /**
+     * Read file as a stream.
+     */
+    readStream(path: string): Readable;
+    /**
+     * Check if a file exists.
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Delete a file.
+     */
+    delete(path: string): Promise<void>;
+    /**
+     * Get the URL for a file.
+     */
+    url(path: string): string;
+    /**
+     * Get a temporary URL for a file.
+     */
+    temporaryUrl(path: string, expiresAt: Date): Promise<string>;
+    /**
+     * Get the file size in bytes.
+     */
+    size(path: string): Promise<number>;
+    /**
+     * Get the last modified time of the file.
+     */
+    lastModified(path: string): Promise<number>;
+    /**
+     * Get the mime type of the file.
+     */
+    mimeType(path: string): Promise<string>;
+}
+//# sourceMappingURL=Disk.d.ts.map

package/dist/Disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Disk.d.ts","sourceRoot":"","sources":["../src/Disk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,qBAAa,IAAI;IACb,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAa;gBAEpB,MAAM,EAAE,UAAU;IAI9B;;OAEG;IACI,UAAU,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI;IAKxC;;OAEG;cACa,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAYlH;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE;;OAEG;IACU,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/C;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAOzC;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMnD;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC;;OAEG;IACU,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAMzE;;OAEG;IACU,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMhD;;OAEG;IACU,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxD;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKvD"}

package/dist/Disk.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Disk = void 0;
+const middleware_1 = require("@arikajs/middleware");
+class Disk {
+    constructor(driver) {
+        this.middlewares = [];
+        this.driver = driver;
+    }
+    /**
+     * Register middleware for this disk.
+     */
+    middleware(middleware) {
+        this.middlewares.push(middleware);
+        return this;
+    }
+    /**
+     * Create a pipeline for an operation.
+     */
+    async runPipeline(operation, params, callback) {
+        if (this.middlewares.length === 0) {
+            return await callback(params);
+        }
+        return await new middleware_1.Pipeline()
+            .pipe(this.middlewares)
+            .handle({ operation, ...params }, async (data) => {
+            return await callback(data);
+        });
+    }
+    /**
+     * Write contents to a file.
+     */
+    async put(path, contents) {
+        return await this.runPipeline('put', { path, contents }, async (data) => {
+            return await this.driver.put(data.path, data.contents);
+        });
+    }
+    /**
+     * Write a stream to a file.
+     */
+    async putStream(path, stream) {
+        return await this.runPipeline('putStream', { path, stream }, async (data) => {
+            return await this.driver.putStream(data.path, data.stream);
+        });
+    }
+    /**
+     * Read file contents.
+     */
+    async get(path) {
+        return await this.runPipeline('get', { path }, async (data) => {
+            return await this.driver.get(data.path);
+        });
+    }
+    /**
+     * Read file as a stream.
+     */
+    readStream(path) {
+        // Note: readStream is tricky with async middleware.
+        // For now, we return the driver stream directly or 
+        // we'd need a more complex implementation for streaming middleware.
+        return this.driver.readStream(path);
+    }
+    /**
+     * Check if a file exists.
+     */
+    async exists(path) {
+        return await this.runPipeline('exists', { path }, async (data) => {
+            return await this.driver.exists(data.path);
+        });
+    }
+    /**
+     * Delete a file.
+     */
+    async delete(path) {
+        return await this.runPipeline('delete', { path }, async (data) => {
+            return await this.driver.delete(data.path);
+        });
+    }
+    /**
+     * Get the URL for a file.
+     */
+    url(path) {
+        return this.driver.url(path);
+    }
+    /**
+     * Get a temporary URL for a file.
+     */
+    async temporaryUrl(path, expiresAt) {
+        return await this.runPipeline('temporaryUrl', { path, expiresAt }, async (data) => {
+            return await this.driver.temporaryUrl(data.path, data.expiresAt);
+        });
+    }
+    /**
+     * Get the file size in bytes.
+     */
+    async size(path) {
+        return await this.runPipeline('size', { path }, async (data) => {
+            return await this.driver.size(data.path);
+        });
+    }
+    /**
+     * Get the last modified time of the file.
+     */
+    async lastModified(path) {
+        return await this.runPipeline('lastModified', { path }, async (data) => {
+            return await this.driver.lastModified(data.path);
+        });
+    }
+    /**
+     * Get the mime type of the file.
+     */
+    async mimeType(path) {
+        return await this.runPipeline('mimeType', { path }, async (data) => {
+            return await this.driver.mimeType(data.path);
+        });
+    }
+}
+exports.Disk = Disk;
+//# sourceMappingURL=Disk.js.map

package/dist/Disk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Disk.js","sourceRoot":"","sources":["../src/Disk.ts"],"names":[],"mappings":"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"}

package/dist/Drivers/LocalDriver.d.ts

@@ -0,0 +1,65 @@
+import { Readable } from 'stream';
+import { Filesystem } from '../Contracts/Filesystem';
+export declare class LocalDriver implements Filesystem {
+    private root;
+    private urlPrefix;
+    constructor(config: {
+        root: string;
+        url?: string;
+    });
+    /**
+     * Get the full path for a file.
+     */
+    private getFullPath;
+    /**
+     * Ensure directory exists.
+     */
+    private ensureDirectory;
+    /**
+     * Write contents to a file.
+     */
+    put(filePath: string, contents: string | Buffer): Promise<void>;
+    /**
+     * Write a stream to a file.
+     */
+    putStream(filePath: string, stream: Readable): Promise<void>;
+    /**
+     * Read file contents.
+     */
+    get(filePath: string): Promise<Buffer>;
+    /**
+     * Read file as a stream.
+     */
+    readStream(filePath: string): Readable;
+    /**
+     * Check if a file exists.
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Delete a file.
+     */
+    delete(filePath: string): Promise<void>;
+    /**
+     * Get the URL for a file.
+     */
+    url(filePath: string): string;
+    /**
+     * Get a temporary URL for a file.
+     * Note: For local driver, this just returns the normal URL as local files don't support signing by default
+     * without a custom server implementation.
+     */
+    temporaryUrl(filePath: string, expiresAt: Date): Promise<string>;
+    /**
+     * Get the file size in bytes.
+     */
+    size(filePath: string): Promise<number>;
+    /**
+     * Get the last modified time of the file.
+     */
+    lastModified(filePath: string): Promise<number>;
+    /**
+     * Get the mime type of the file.
+     */
+    mimeType(filePath: string): Promise<string>;
+}
+//# sourceMappingURL=LocalDriver.d.ts.map

package/dist/Drivers/LocalDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDriver.d.ts","sourceRoot":"","sources":["../../src/Drivers/LocalDriver.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,qBAAa,WAAY,YAAW,UAAU;IAC1C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;IAKlD;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;YACW,eAAe;IAK7B;;OAEG;IACU,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E;;OAEG;IACU,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzE;;OAEG;IACU,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUnD;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAK7C;;OAEG;IACU,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvD;;OAEG;IACU,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQpC;;;;OAIG;IACU,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7E;;OAEG;IACU,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpD;;OAEG;IACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;OAEG;IACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG3D"}