@shohaghinfo/aerojs 0.1.0

package/dist/static/static.js

@@ -0,0 +1,134 @@
+/**
+ * @file static.ts
+ * @description Zero-dependency high-performance static asset server with caching and SPA fallback.
+ */
+import { statSync, createReadStream, existsSync } from 'node:fs';
+import { resolve, join, extname, normalize } from 'node:path';
+const MIME_MAP = {
+    '.html': 'text/html; charset=utf-8',
+    '.htm': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.webp': 'image/webp',
+    '.avif': 'image/avif',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.txt': 'text/plain; charset=utf-8',
+    '.pdf': 'application/pdf',
+    '.wasm': 'application/wasm',
+    '.map': 'application/json; charset=utf-8',
+    '.xml': 'application/xml; charset=utf-8',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.mp3': 'audio/mpeg',
+};
+export function getMimeType(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return MIME_MAP[ext] || 'application/octet-stream';
+}
+/**
+ * Creates a static asset serving middleware supporting ETags, Cache-Control, and SPA routing fallback.
+ */
+export function serveStatic(options) {
+    const rootDir = resolve(options.root);
+    const cleanPrefix = options.prefix ? `/${options.prefix.replace(/^\/+|\/+$/g, '')}` : '';
+    const indexFile = options.index ?? 'index.html';
+    const fallbackFile = options.fallback ?? indexFile;
+    const isSpa = Boolean(options.spa);
+    const maxAge = options.maxAge ?? 0;
+    const enableEtag = options.etag !== false;
+    const dotfiles = options.dotfiles ?? 'ignore';
+    return async (ctx, next) => {
+        if (ctx.method !== 'GET' && ctx.method !== 'HEAD') {
+            return next();
+        }
+        const pathname = ctx.path;
+        // Check if request matches prefix
+        if (cleanPrefix && !pathname.startsWith(cleanPrefix)) {
+            return next();
+        }
+        // Strip prefix
+        let relativePath = cleanPrefix ? pathname.slice(cleanPrefix.length) : pathname;
+        if (relativePath.startsWith('/')) {
+            relativePath = relativePath.slice(1);
+        }
+        // Prevent directory traversal attacks
+        const safePath = normalize(relativePath).replace(/^(\.\.[\/\\])+/, '');
+        if (safePath.includes('..')) {
+            return ctx.status(403).text('Forbidden: Directory traversal attempt');
+        }
+        // Dotfiles check
+        const isDotfile = safePath.split(/[\/\\]/).some((segment) => segment.startsWith('.'));
+        if (isDotfile) {
+            if (dotfiles === 'deny') {
+                return ctx.status(403).text('Forbidden: Access to dotfiles is denied');
+            }
+            if (dotfiles === 'ignore') {
+                return next();
+            }
+        }
+        let filePath = join(rootDir, safePath);
+        // If path is directory or empty, append index file
+        if (!safePath || safePath === '.') {
+            filePath = join(rootDir, indexFile);
+        }
+        // Defense-in-depth: Ensure resolved target never escapes rootDir
+        const resolvedPath = resolve(filePath);
+        if (!resolvedPath.startsWith(rootDir)) {
+            return ctx.status(403).text('Forbidden: Directory traversal attempt');
+        }
+        let stat = existsSync(filePath) ? statSync(filePath) : null;
+        if (stat && stat.isDirectory()) {
+            filePath = join(filePath, indexFile);
+            stat = existsSync(filePath) ? statSync(filePath) : null;
+        }
+        // SPA fallback handling
+        if (!stat && isSpa && ctx.method === 'GET') {
+            const acceptsHtml = ctx.req.get('accept')?.includes('text/html') || !extname(pathname);
+            if (acceptsHtml) {
+                filePath = join(rootDir, fallbackFile);
+                stat = existsSync(filePath) ? statSync(filePath) : null;
+            }
+        }
+        if (!stat || !stat.isFile()) {
+            return next();
+        }
+        // Set caching headers
+        const etagValue = `W/"${stat.size.toString(16)}-${Math.floor(stat.mtimeMs).toString(16)}"`;
+        if (enableEtag) {
+            ctx.set('ETag', etagValue);
+        }
+        if (maxAge > 0) {
+            ctx.set('Cache-Control', `public, max-age=${maxAge}`);
+        }
+        else {
+            ctx.set('Cache-Control', 'no-cache');
+        }
+        // Conditional GET (304 Not Modified)
+        if (enableEtag) {
+            const clientEtag = ctx.req.get('if-none-match');
+            if (clientEtag && clientEtag === etagValue) {
+                return ctx.status(304).send(null);
+            }
+        }
+        ctx.set('Content-Type', getMimeType(filePath));
+        ctx.set('Content-Length', String(stat.size));
+        if (ctx.method === 'HEAD') {
+            return ctx.status(200).send(null);
+        }
+        ctx.status(200);
+        const stream = createReadStream(filePath);
+        ctx.send(stream);
+    };
+}
+//# sourceMappingURL=static.js.map

package/dist/static/static.js.map

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

package/dist/storage/chunked-uploader.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @file chunked-uploader.ts
+ * @description Resumable Chunked File Upload Manager.
+ * Supports initiating, uploading chunks, validating SHA-256 checksums, and assembling final files.
+ */
+export interface ChunkUploadInitOptions {
+    fileName: string;
+    totalSize: number;
+    totalChunks: number;
+    tempDir?: string;
+    checksum?: string;
+}
+export interface ChunkUploadStatus {
+    uploadId: string;
+    fileName: string;
+    totalSize: number;
+    totalChunks: number;
+    uploadedChunks: number[];
+    expiresAt: number;
+}
+export declare class ChunkedUploadManager {
+    private tempDir;
+    private uploads;
+    private readonly DEFAULT_TTL;
+    constructor(tempDir?: string);
+    /**
+     * Initiates a new chunked upload session.
+     */
+    initiateUpload(options: ChunkUploadInitOptions): string;
+    /**
+     * Uploads a specific chunk.
+     * Optionally validates the MD5 or SHA-256 checksum of the chunk.
+     */
+    uploadChunk(uploadId: string, chunkIndex: number, buffer: Buffer, expectedChecksum?: string, algorithm?: string): Promise<boolean>;
+    /**
+     * Retrieves the current status of an upload session.
+     */
+    getStatus(uploadId: string): ChunkUploadStatus | null;
+    /**
+     * Finalizes the upload, combining all chunks into the final destination file.
+     */
+    finalizeUpload(uploadId: string, destinationPath: string, expectedFinalChecksum?: string, algorithm?: string): Promise<string>;
+    /**
+     * Aborts an upload and cleans up temporary chunk files.
+     */
+    abortUpload(uploadId: string): Promise<void>;
+    /**
+     * Cleans up expired upload sessions.
+     * Can be run periodically via a cron job or scheduler.
+     */
+    cleanupExpiredUploads(): Promise<void>;
+}
+//# sourceMappingURL=chunked-uploader.d.ts.map

package/dist/storage/chunked-uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunked-uploader.d.ts","sourceRoot":"","sources":["../../src/storage/chunked-uploader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAEvC,OAAO,SAAmB;IAKtC;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM;IAoB9D;;;OAGG;IACU,WAAW,CACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,MAAM,EACzB,SAAS,SAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IA4BnB;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAI5D;;OAEG;IACU,cAAc,CACzB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,qBAAqB,CAAC,EAAE,MAAM,EAC9B,SAAS,SAAW,GACnB,OAAO,CAAC,MAAM,CAAC;IAgDlB;;OAEG;IACU,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzD;;;OAGG;IACU,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAQpD"}

package/dist/storage/chunked-uploader.js

@@ -0,0 +1,135 @@
+/**
+ * @file chunked-uploader.ts
+ * @description Resumable Chunked File Upload Manager.
+ * Supports initiating, uploading chunks, validating SHA-256 checksums, and assembling final files.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { pipeline } from 'node:stream/promises';
+export class ChunkedUploadManager {
+    tempDir;
+    uploads = new Map();
+    DEFAULT_TTL = 1000 * 60 * 60 * 24; // 24 hours
+    constructor(tempDir = './storage/temp') {
+        this.tempDir = tempDir;
+        fs.mkdirSync(this.tempDir, { recursive: true });
+    }
+    /**
+     * Initiates a new chunked upload session.
+     */
+    initiateUpload(options) {
+        const uploadId = crypto.randomUUID();
+        const status = {
+            uploadId,
+            fileName: options.fileName,
+            totalSize: options.totalSize,
+            totalChunks: options.totalChunks,
+            uploadedChunks: [],
+            expiresAt: Date.now() + this.DEFAULT_TTL
+        };
+        this.uploads.set(uploadId, status);
+        // Create dedicated temp directory for this upload
+        const uploadDir = path.join(this.tempDir, uploadId);
+        fs.mkdirSync(uploadDir, { recursive: true });
+        return uploadId;
+    }
+    /**
+     * Uploads a specific chunk.
+     * Optionally validates the MD5 or SHA-256 checksum of the chunk.
+     */
+    async uploadChunk(uploadId, chunkIndex, buffer, expectedChecksum, algorithm = 'sha256') {
+        const status = this.uploads.get(uploadId);
+        if (!status) {
+            throw new Error(`Upload session ${uploadId} not found or expired.`);
+        }
+        if (chunkIndex < 0 || chunkIndex >= status.totalChunks) {
+            throw new Error(`Invalid chunk index ${chunkIndex}. Total chunks: ${status.totalChunks}`);
+        }
+        if (expectedChecksum) {
+            const hash = crypto.createHash(algorithm).update(buffer).digest('hex');
+            if (hash !== expectedChecksum) {
+                throw new Error(`Checksum validation failed for chunk ${chunkIndex}. Expected ${expectedChecksum}, got ${hash}`);
+            }
+        }
+        const chunkPath = path.join(this.tempDir, uploadId, `${chunkIndex}.part`);
+        await fs.promises.writeFile(chunkPath, buffer);
+        if (!status.uploadedChunks.includes(chunkIndex)) {
+            status.uploadedChunks.push(chunkIndex);
+            status.uploadedChunks.sort((a, b) => a - b);
+        }
+        return true;
+    }
+    /**
+     * Retrieves the current status of an upload session.
+     */
+    getStatus(uploadId) {
+        return this.uploads.get(uploadId) || null;
+    }
+    /**
+     * Finalizes the upload, combining all chunks into the final destination file.
+     */
+    async finalizeUpload(uploadId, destinationPath, expectedFinalChecksum, algorithm = 'sha256') {
+        const status = this.uploads.get(uploadId);
+        if (!status) {
+            throw new Error(`Upload session ${uploadId} not found or expired.`);
+        }
+        if (status.uploadedChunks.length !== status.totalChunks) {
+            throw new Error(`Cannot finalize. Missing chunks. Received ${status.uploadedChunks.length} of ${status.totalChunks}`);
+        }
+        // Ensure destination directory exists
+        await fs.promises.mkdir(path.dirname(destinationPath), { recursive: true });
+        const writeStream = fs.createWriteStream(destinationPath);
+        const hash = expectedFinalChecksum ? crypto.createHash(algorithm) : null;
+        for (let i = 0; i < status.totalChunks; i++) {
+            const chunkPath = path.join(this.tempDir, uploadId, `${i}.part`);
+            const chunkBuffer = await fs.promises.readFile(chunkPath);
+            writeStream.write(chunkBuffer);
+            if (hash) {
+                hash.update(chunkBuffer);
+            }
+        }
+        writeStream.end();
+        await new Promise((resolve, reject) => {
+            writeStream.on('finish', () => resolve(undefined));
+            writeStream.on('error', reject);
+        });
+        if (hash) {
+            const finalHash = hash.digest('hex');
+            if (finalHash !== expectedFinalChecksum) {
+                // Cleanup failed assembled file
+                await fs.promises.unlink(destinationPath).catch(() => { });
+                throw new Error(`Final checksum validation failed. Expected ${expectedFinalChecksum}, got ${finalHash}`);
+            }
+        }
+        // Clean up temporary chunks
+        await this.abortUpload(uploadId);
+        return destinationPath;
+    }
+    /**
+     * Aborts an upload and cleans up temporary chunk files.
+     */
+    async abortUpload(uploadId) {
+        this.uploads.delete(uploadId);
+        const uploadDir = path.join(this.tempDir, uploadId);
+        try {
+            await fs.promises.rm(uploadDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore if dir already removed
+        }
+    }
+    /**
+     * Cleans up expired upload sessions.
+     * Can be run periodically via a cron job or scheduler.
+     */
+    async cleanupExpiredUploads() {
+        const now = Date.now();
+        for (const [uploadId, status] of this.uploads.entries()) {
+            if (now > status.expiresAt) {
+                await this.abortUpload(uploadId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=chunked-uploader.js.map

package/dist/storage/chunked-uploader.js.map

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

package/dist/storage/drivers/local-driver.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file local-driver.ts
+ * @description Local filesystem storage driver for AeroJS.
+ * Features safe path traversal prevention, recursive directory creation, and public URL mapping.
+ */
+import type { StorageDriver } from './storage-driver.js';
+export interface LocalStorageOptions {
+    root: string;
+    baseUrl?: string;
+}
+export declare class LocalStorageDriver implements StorageDriver {
+    private root;
+    private baseUrl;
+    constructor(options: LocalStorageOptions);
+    put(path: string, content: Buffer | Uint8Array | string): Promise<string>;
+    get(path: string): Promise<Buffer>;
+    getText(path: string, encoding?: BufferEncoding): Promise<string>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<boolean>;
+    size(path: string): Promise<number>;
+    url(path: string): string;
+    resolveSafePath(path: string): string;
+    private normalizeRelative;
+}
+//# sourceMappingURL=local-driver.d.ts.map

package/dist/storage/drivers/local-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-driver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/local-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,mBAAmB;IAK3B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAczE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS5C,OAAO,CAAC,iBAAiB;CAG1B"}

package/dist/storage/drivers/local-driver.js

@@ -0,0 +1,75 @@
+/**
+ * @file local-driver.ts
+ * @description Local filesystem storage driver for AeroJS.
+ * Features safe path traversal prevention, recursive directory creation, and public URL mapping.
+ */
+import { readFile, writeFile, unlink, stat, mkdir } from 'node:fs/promises';
+import { resolve, dirname, normalize } from 'node:path';
+export class LocalStorageDriver {
+    root;
+    baseUrl;
+    constructor(options) {
+        this.root = resolve(options.root);
+        this.baseUrl = options.baseUrl || '/storage';
+    }
+    async put(path, content) {
+        const fullPath = this.resolveSafePath(path);
+        await mkdir(dirname(fullPath), { recursive: true });
+        const buf = Buffer.isBuffer(content)
+            ? content
+            : typeof content === 'string'
+                ? Buffer.from(content, 'utf-8')
+                : Buffer.from(content);
+        await writeFile(fullPath, buf);
+        return this.normalizeRelative(path);
+    }
+    async get(path) {
+        const fullPath = this.resolveSafePath(path);
+        return await readFile(fullPath);
+    }
+    async getText(path, encoding = 'utf-8') {
+        const buf = await this.get(path);
+        return buf.toString(encoding);
+    }
+    async exists(path) {
+        try {
+            const fullPath = this.resolveSafePath(path);
+            await stat(fullPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async delete(path) {
+        try {
+            const fullPath = this.resolveSafePath(path);
+            await unlink(fullPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async size(path) {
+        const fullPath = this.resolveSafePath(path);
+        const s = await stat(fullPath);
+        return s.size;
+    }
+    url(path) {
+        const rel = this.normalizeRelative(path);
+        return `${this.baseUrl}/${rel}`.replace(/\/+/g, '/');
+    }
+    resolveSafePath(path) {
+        const cleanRel = path.replace(/^[\\/]+/, '');
+        const target = resolve(this.root, cleanRel);
+        if (!target.startsWith(this.root)) {
+            throw new Error(`Path traversal violation: "${path}" is outside storage root.`);
+        }
+        return target;
+    }
+    normalizeRelative(path) {
+        return normalize(path).replace(/^[\\/]+/, '').replace(/\\/g, '/');
+    }
+}
+//# sourceMappingURL=local-driver.js.map

package/dist/storage/drivers/local-driver.js.map

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

package/dist/storage/drivers/memory-driver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file memory-driver.ts
+ * @description In-memory storage driver for AeroJS.
+ * Perfect for ephemeral cache, fast testing, and non-persistent uploads.
+ */
+import type { StorageDriver } from './storage-driver.js';
+export declare class MemoryStorageDriver implements StorageDriver {
+    private files;
+    private baseUrl;
+    constructor(options?: {
+        baseUrl?: string;
+    });
+    put(path: string, content: Buffer | Uint8Array | string): Promise<string>;
+    get(path: string): Promise<Buffer>;
+    getText(path: string, encoding?: BufferEncoding): Promise<string>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<boolean>;
+    size(path: string): Promise<number>;
+    url(path: string): string;
+    clear(): void;
+    private normalize;
+}
+//# sourceMappingURL=memory-driver.d.ts.map

package/dist/storage/drivers/memory-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-driver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/memory-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYzE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASlC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzB,KAAK,IAAI,IAAI;IAIpB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/storage/drivers/memory-driver.js

@@ -0,0 +1,55 @@
+/**
+ * @file memory-driver.ts
+ * @description In-memory storage driver for AeroJS.
+ * Perfect for ephemeral cache, fast testing, and non-persistent uploads.
+ */
+export class MemoryStorageDriver {
+    files = new Map();
+    baseUrl;
+    constructor(options = {}) {
+        this.baseUrl = options.baseUrl || '/storage';
+    }
+    async put(path, content) {
+        const norm = this.normalize(path);
+        const buf = Buffer.isBuffer(content)
+            ? content
+            : typeof content === 'string'
+                ? Buffer.from(content, 'utf-8')
+                : Buffer.from(content);
+        this.files.set(norm, buf);
+        return norm;
+    }
+    async get(path) {
+        const norm = this.normalize(path);
+        const file = this.files.get(norm);
+        if (!file) {
+            throw new Error(`File not found: ${path}`);
+        }
+        return file;
+    }
+    async getText(path, encoding = 'utf-8') {
+        const buf = await this.get(path);
+        return buf.toString(encoding);
+    }
+    async exists(path) {
+        return this.files.has(this.normalize(path));
+    }
+    async delete(path) {
+        return this.files.delete(this.normalize(path));
+    }
+    async size(path) {
+        const buf = await this.get(path);
+        return buf.length;
+    }
+    url(path) {
+        const norm = this.normalize(path);
+        return `${this.baseUrl}/${norm}`.replace(/\/+/g, '/');
+    }
+    clear() {
+        this.files.clear();
+    }
+    normalize(path) {
+        return path.replace(/^[\\/]+/, '').replace(/\\/g, '/');
+    }
+}
+//# sourceMappingURL=memory-driver.js.map

package/dist/storage/drivers/memory-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-driver.js","sourceRoot":"","sources":["../../../src/storage/drivers/memory-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClC,OAAO,CAAS;IAExB,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,OAAqC;QAClE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YAClC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ;gBAC7B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;gBAC/B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,IAAY;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,WAA2B,OAAO;QACnE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,IAAY;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAEM,GAAG,CAAC,IAAY;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAEO,SAAS,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/storage/drivers/s3-driver.d.ts

@@ -0,0 +1,34 @@
+import type { StorageDriver } from './storage-driver.js';
+export interface S3StorageOptions {
+    bucket: string;
+    region?: string;
+    endpoint?: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    publicUrl?: string;
+}
+export declare class S3StorageDriver implements StorageDriver {
+    private bucket;
+    private region;
+    private endpoint?;
+    private accessKeyId?;
+    private secretAccessKey?;
+    private publicUrl?;
+    private mockStore;
+    constructor(options: S3StorageOptions);
+    private hasRealCredentials;
+    put(path: string, content: Buffer | Uint8Array | string): Promise<string>;
+    get(path: string): Promise<Buffer>;
+    getText(path: string, encoding?: BufferEncoding): Promise<string>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<boolean>;
+    size(path: string): Promise<number>;
+    url(path: string): string;
+    temporaryUrl(path: string, expiresInSeconds?: number): Promise<string>;
+    private normalize;
+    private getHost;
+    private getEndpointUrl;
+    private signRequest;
+    private getSignatureKey;
+}
+//# sourceMappingURL=s3-driver.d.ts.map

package/dist/storage/drivers/s3-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-driver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/s3-driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA6B;gBAElC,OAAO,EAAE,gBAAgB;IASrC,OAAO,CAAC,kBAAkB;IAIb,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCzE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgClC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAWnB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BjF,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,eAAe;CAMxB"}