@shohaghinfo/aerojs 0.1.0

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

@@ -0,0 +1,186 @@
+import crypto from 'node:crypto';
+export class S3StorageDriver {
+    bucket;
+    region;
+    endpoint;
+    accessKeyId;
+    secretAccessKey;
+    publicUrl;
+    mockStore = new Map();
+    constructor(options) {
+        this.bucket = options.bucket;
+        this.region = options.region || 'us-east-1';
+        this.endpoint = options.endpoint;
+        this.accessKeyId = options.accessKeyId;
+        this.secretAccessKey = options.secretAccessKey;
+        this.publicUrl = options.publicUrl;
+    }
+    hasRealCredentials() {
+        return Boolean(this.accessKeyId && this.secretAccessKey);
+    }
+    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);
+        if (!this.hasRealCredentials()) {
+            // In-memory mock store for testing without AWS credentials
+            this.mockStore.set(norm, buf);
+            return norm;
+        }
+        const host = this.getHost();
+        const url = this.getEndpointUrl(norm);
+        const headers = this.signRequest('PUT', `/${norm}`, buf, host);
+        const res = await fetch(url, {
+            method: 'PUT',
+            headers,
+            body: buf,
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`S3 PUT failed with status ${res.status}: ${errText}`);
+        }
+        return norm;
+    }
+    async get(path) {
+        const norm = this.normalize(path);
+        if (!this.hasRealCredentials()) {
+            const item = this.mockStore.get(norm);
+            if (!item) {
+                throw new Error(`S3 Object not found: ${this.bucket}/${path}`);
+            }
+            return item;
+        }
+        const host = this.getHost();
+        const url = this.getEndpointUrl(norm);
+        const headers = this.signRequest('GET', `/${norm}`, Buffer.alloc(0), host);
+        const res = await fetch(url, {
+            method: 'GET',
+            headers,
+        });
+        if (res.status === 404) {
+            throw new Error(`S3 Object not found: ${this.bucket}/${path}`);
+        }
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`S3 GET failed with status ${res.status}: ${errText}`);
+        }
+        const arrayBuffer = await res.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
+    async getText(path, encoding = 'utf-8') {
+        const buf = await this.get(path);
+        return buf.toString(encoding);
+    }
+    async exists(path) {
+        const norm = this.normalize(path);
+        if (!this.hasRealCredentials()) {
+            return this.mockStore.has(norm);
+        }
+        try {
+            const host = this.getHost();
+            const url = this.getEndpointUrl(norm);
+            const headers = this.signRequest('HEAD', `/${norm}`, Buffer.alloc(0), host);
+            const res = await fetch(url, { method: 'HEAD', headers });
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    async delete(path) {
+        const norm = this.normalize(path);
+        if (!this.hasRealCredentials()) {
+            return this.mockStore.delete(norm);
+        }
+        try {
+            const host = this.getHost();
+            const url = this.getEndpointUrl(norm);
+            const headers = this.signRequest('DELETE', `/${norm}`, Buffer.alloc(0), host);
+            const res = await fetch(url, { method: 'DELETE', headers });
+            return res.ok || res.status === 204;
+        }
+        catch {
+            return false;
+        }
+    }
+    async size(path) {
+        const buf = await this.get(path);
+        return buf.length;
+    }
+    url(path) {
+        const norm = this.normalize(path);
+        if (this.publicUrl) {
+            return `${this.publicUrl}/${norm}`.replace(/([^:]\/)\/+/g, '$1');
+        }
+        if (this.endpoint) {
+            return `${this.endpoint}/${this.bucket}/${norm}`;
+        }
+        return `https://${this.bucket}.s3.${this.region}.amazonaws.com/${norm}`;
+    }
+    async temporaryUrl(path, expiresInSeconds = 3600) {
+        const norm = this.normalize(path);
+        const base = this.url(path);
+        if (!this.hasRealCredentials()) {
+            const expires = Math.floor(Date.now() / 1000) + expiresInSeconds;
+            return `${base}?X-Amz-Expires=${expires}&X-Amz-Signed=mock-signature`;
+        }
+        const now = new Date();
+        const amzDate = now.toISOString().replace(/[:-]|\.\d{3}/g, '');
+        const dateStamp = amzDate.slice(0, 8);
+        const credential = `${this.accessKeyId}/${dateStamp}/${this.region}/s3/aws4_request`;
+        const qs = [
+            `X-Amz-Algorithm=AWS4-HMAC-SHA256`,
+            `X-Amz-Credential=${encodeURIComponent(credential)}`,
+            `X-Amz-Date=${amzDate}`,
+            `X-Amz-Expires=${expiresInSeconds}`,
+            `X-Amz-SignedHeaders=host`,
+        ].join('&');
+        const canonicalReq = `GET\n/${norm}\n${qs}\nhost:${this.getHost()}\n\nhost\nUNSIGNED-PAYLOAD`;
+        const stringToSign = `AWS4-HMAC-SHA256\n${amzDate}\n${dateStamp}/${this.region}/s3/aws4_request\n${crypto.createHash('sha256').update(canonicalReq).digest('hex')}`;
+        const signingKey = this.getSignatureKey(this.secretAccessKey, dateStamp, this.region, 's3');
+        const signature = crypto.createHmac('sha256', signingKey).update(stringToSign).digest('hex');
+        return `${base}?${qs}&X-Amz-Signature=${signature}`;
+    }
+    normalize(path) {
+        return path.replace(/^[\\/]+/, '').replace(/\\/g, '/');
+    }
+    getHost() {
+        if (this.endpoint) {
+            return new URL(this.endpoint).host;
+        }
+        return `${this.bucket}.s3.${this.region}.amazonaws.com`;
+    }
+    getEndpointUrl(path) {
+        return `https://${this.getHost()}/${path}`;
+    }
+    signRequest(method, canonicalUri, payload, host) {
+        const now = new Date();
+        const amzDate = now.toISOString().replace(/[:-]|\.\d{3}/g, '');
+        const dateStamp = amzDate.slice(0, 8);
+        const payloadHash = crypto.createHash('sha256').update(payload).digest('hex');
+        const canonicalHeaders = `host:${host}\nx-amz-content-sha256:${payloadHash}\nx-amz-date:${amzDate}\n`;
+        const signedHeaders = 'host;x-amz-content-sha256;x-amz-date';
+        const canonicalRequest = `${method}\n${canonicalUri}\n\n${canonicalHeaders}\n${signedHeaders}\n${payloadHash}`;
+        const credentialScope = `${dateStamp}/${this.region}/s3/aws4_request`;
+        const stringToSign = `AWS4-HMAC-SHA256\n${amzDate}\n${credentialScope}\n${crypto.createHash('sha256').update(canonicalRequest).digest('hex')}`;
+        const signingKey = this.getSignatureKey(this.secretAccessKey, dateStamp, this.region, 's3');
+        const signature = crypto.createHmac('sha256', signingKey).update(stringToSign).digest('hex');
+        const authHeader = `AWS4-HMAC-SHA256 Credential=${this.accessKeyId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
+        return {
+            Host: host,
+            'x-amz-date': amzDate,
+            'x-amz-content-sha256': payloadHash,
+            Authorization: authHeader,
+        };
+    }
+    getSignatureKey(key, dateStamp, regionName, serviceName) {
+        const kDate = crypto.createHmac('sha256', `AWS4${key}`).update(dateStamp).digest();
+        const kRegion = crypto.createHmac('sha256', kDate).update(regionName).digest();
+        const kService = crypto.createHmac('sha256', kRegion).update(serviceName).digest();
+        return crypto.createHmac('sha256', kService).update('aws4_request').digest();
+    }
+}
+//# sourceMappingURL=s3-driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"s3-driver.js","sourceRoot":"","sources":["../../../src/storage/drivers/s3-driver.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAYjC,MAAM,OAAO,eAAe;IAClB,MAAM,CAAS;IACf,MAAM,CAAS;IACf,QAAQ,CAAU;IAClB,WAAW,CAAU;IACrB,eAAe,CAAU;IACzB,SAAS,CAAU;IACnB,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,YAAY,OAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAEO,kBAAkB;QACxB,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC;IAC3D,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,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC/B,2DAA2D;YAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAE/D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,KAAK;YACb,OAAO;YACP,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,IAAY;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAE3E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,KAAK;YACb,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClC,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,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC5E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1D,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAAY;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC9E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5D,OAAO,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,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,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,WAAW,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,kBAAkB,IAAI,EAAE,CAAC;IAC1E,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,gBAAgB,GAAG,IAAI;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,gBAAgB,CAAC;YACjE,OAAO,GAAG,IAAI,kBAAkB,OAAO,8BAA8B,CAAC;QACxE,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,IAAI,IAAI,CAAC,MAAM,kBAAkB,CAAC;QAErF,MAAM,EAAE,GAAG;YACT,kCAAkC;YAClC,oBAAoB,kBAAkB,CAAC,UAAU,CAAC,EAAE;YACpD,cAAc,OAAO,EAAE;YACvB,iBAAiB,gBAAgB,EAAE;YACnC,0BAA0B;SAC3B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,YAAY,GAAG,SAAS,IAAI,KAAK,EAAE,UAAU,IAAI,CAAC,OAAO,EAAE,4BAA4B,CAAC;QAC9F,MAAM,YAAY,GAAG,qBAAqB,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,qBAAqB,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACpK,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,eAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7F,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE7F,OAAO,GAAG,IAAI,IAAI,EAAE,oBAAoB,SAAS,EAAE,CAAC;IACtD,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;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;QACrC,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,gBAAgB,CAAC;IAC1D,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,OAAO,WAAW,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IAC7C,CAAC;IAEO,WAAW,CACjB,MAAc,EACd,YAAoB,EACpB,OAAe,EACf,IAAY;QAEZ,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE9E,MAAM,gBAAgB,GAAG,QAAQ,IAAI,0BAA0B,WAAW,gBAAgB,OAAO,IAAI,CAAC;QACtG,MAAM,aAAa,GAAG,sCAAsC,CAAC;QAE7D,MAAM,gBAAgB,GAAG,GAAG,MAAM,KAAK,YAAY,OAAO,gBAAgB,KAAK,aAAa,KAAK,WAAW,EAAE,CAAC;QAC/G,MAAM,eAAe,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,kBAAkB,CAAC;QACtE,MAAM,YAAY,GAAG,qBAAqB,OAAO,KAAK,eAAe,KAAK,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAE/I,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,eAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7F,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE7F,MAAM,UAAU,GAAG,+BAA+B,IAAI,CAAC,WAAW,IAAI,eAAe,mBAAmB,aAAa,eAAe,SAAS,EAAE,CAAC;QAEhJ,OAAO;YACL,IAAI,EAAE,IAAI;YACV,YAAY,EAAE,OAAO;YACrB,sBAAsB,EAAE,WAAW;YACnC,aAAa,EAAE,UAAU;SAC1B,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,GAAW,EAAE,SAAiB,EAAE,UAAkB,EAAE,WAAmB;QAC7F,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC;QACnF,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/E,CAAC;CACF"}

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

@@ -0,0 +1,40 @@
+/**
+ * @file storage-driver.ts
+ * @description StorageDriver interface for local, cloud, and memory storage adapters in AeroJS.
+ */
+export interface StorageDriver {
+    /**
+     * Puts file content at the target path.
+     * Returns the stored relative or absolute path.
+     */
+    put(path: string, content: Buffer | Uint8Array | string): Promise<string>;
+    /**
+     * Reads raw bytes from the target path.
+     */
+    get(path: string): Promise<Buffer>;
+    /**
+     * Reads file as UTF-8 string.
+     */
+    getText(path: string, encoding?: BufferEncoding): Promise<string>;
+    /**
+     * Checks if file exists.
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Deletes a file.
+     */
+    delete(path: string): Promise<boolean>;
+    /**
+     * Returns file size in bytes.
+     */
+    size(path: string): Promise<number>;
+    /**
+     * Returns public URL for accessing the file.
+     */
+    url(path: string): string;
+    /**
+     * Generates a temporary signed URL.
+     */
+    temporaryUrl?(path: string, expiresInSeconds: number): Promise<string>;
+}
+//# sourceMappingURL=storage-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-driver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/storage-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1E;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElE;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B;;OAEG;IACH,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxE"}

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

@@ -0,0 +1,6 @@
+/**
+ * @file storage-driver.ts
+ * @description StorageDriver interface for local, cloud, and memory storage adapters in AeroJS.
+ */
+export {};
+//# sourceMappingURL=storage-driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-driver.js","sourceRoot":"","sources":["../../../src/storage/drivers/storage-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/storage/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file index.ts
+ * @description AeroJS Storage and File Upload Module.
+ */
+export * from './drivers/storage-driver.js';
+export * from './drivers/local-driver.js';
+export * from './drivers/memory-driver.js';
+export * from './drivers/s3-driver.js';
+export * from './uploaded-file.js';
+export * from './multipart.js';
+export * from './storage-manager.js';
+export * from './chunked-uploader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,13 @@
+/**
+ * @file index.ts
+ * @description AeroJS Storage and File Upload Module.
+ */
+export * from './drivers/storage-driver.js';
+export * from './drivers/local-driver.js';
+export * from './drivers/memory-driver.js';
+export * from './drivers/s3-driver.js';
+export * from './uploaded-file.js';
+export * from './multipart.js';
+export * from './storage-manager.js';
+export * from './chunked-uploader.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/storage/multipart.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file multipart.ts
+ * @description Zero-dependency, stream/buffer RFC 7578 multipart/form-data parser for AeroJS.
+ * Extracts form fields and UploadedFile instances without external native dependencies.
+ */
+import { UploadedFile } from './uploaded-file.js';
+export interface MultipartParseResult {
+    fields: Record<string, string | string[]>;
+    files: Record<string, UploadedFile[]>;
+}
+export declare function parseMultipartBuffer(buffer: Buffer, boundary: string): MultipartParseResult;
+//# sourceMappingURL=multipart.d.ts.map

package/dist/storage/multipart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../src/storage/multipart.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;CACvC;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAgFtB"}

package/dist/storage/multipart.js

@@ -0,0 +1,79 @@
+/**
+ * @file multipart.ts
+ * @description Zero-dependency, stream/buffer RFC 7578 multipart/form-data parser for AeroJS.
+ * Extracts form fields and UploadedFile instances without external native dependencies.
+ */
+import { UploadedFile } from './uploaded-file.js';
+export function parseMultipartBuffer(buffer, boundary) {
+    const fields = {};
+    const files = {};
+    const delimiter = Buffer.from(`--${boundary}`);
+    const crlf = Buffer.from('\r\n');
+    const headerSeparator = Buffer.from('\r\n\r\n');
+    let startIndex = buffer.indexOf(delimiter);
+    if (startIndex === -1) {
+        return { fields, files };
+    }
+    while (startIndex !== -1) {
+        const nextIndex = buffer.indexOf(delimiter, startIndex + delimiter.length);
+        if (nextIndex === -1)
+            break;
+        // Slice content between boundaries
+        let partBuffer = buffer.subarray(startIndex + delimiter.length, nextIndex);
+        // Strip leading CRLF if present
+        if (partBuffer.subarray(0, 2).equals(crlf)) {
+            partBuffer = partBuffer.subarray(2);
+        }
+        // Strip trailing CRLF if present
+        if (partBuffer.length >= 2 && partBuffer.subarray(partBuffer.length - 2).equals(crlf)) {
+            partBuffer = partBuffer.subarray(0, partBuffer.length - 2);
+        }
+        if (partBuffer.length > 0) {
+            const headerEndIndex = partBuffer.indexOf(headerSeparator);
+            if (headerEndIndex !== -1) {
+                const headerText = partBuffer.subarray(0, headerEndIndex).toString('utf-8');
+                const bodyBuffer = partBuffer.subarray(headerEndIndex + headerSeparator.length);
+                const dispositionMatch = headerText.match(/Content-Disposition:\s*form-data;\s*([^;\r\n]+(?:;\s*[^;\r\n]+)*)/i);
+                if (dispositionMatch) {
+                    const dispositionParams = dispositionMatch[1];
+                    const nameMatch = dispositionParams.match(/name="([^"]+)"/i);
+                    const filenameMatch = dispositionParams.match(/filename="([^"]+)"/i);
+                    const fieldName = nameMatch ? nameMatch[1] : 'unnamed';
+                    if (filenameMatch) {
+                        // It's a file
+                        const filename = filenameMatch[1];
+                        const contentTypeMatch = headerText.match(/Content-Type:\s*([^\r\n]+)/i);
+                        const mimeType = contentTypeMatch ? contentTypeMatch[1].trim() : 'application/octet-stream';
+                        const uploadedFile = new UploadedFile({
+                            fieldName,
+                            originalName: filename,
+                            mimeType,
+                            buffer: bodyBuffer,
+                        });
+                        if (!files[fieldName]) {
+                            files[fieldName] = [];
+                        }
+                        files[fieldName].push(uploadedFile);
+                    }
+                    else {
+                        // It's a regular text field
+                        const fieldValue = bodyBuffer.toString('utf-8');
+                        const existing = fields[fieldName];
+                        if (existing === undefined) {
+                            fields[fieldName] = fieldValue;
+                        }
+                        else if (Array.isArray(existing)) {
+                            existing.push(fieldValue);
+                        }
+                        else {
+                            fields[fieldName] = [existing, fieldValue];
+                        }
+                    }
+                }
+            }
+        }
+        startIndex = nextIndex;
+    }
+    return { fields, files };
+}
+//# sourceMappingURL=multipart.js.map

package/dist/storage/multipart.js.map

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

package/dist/storage/storage-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file storage-manager.ts
+ * @description Central Storage manager and facade for AeroJS.
+ * Manages multiple named disks (local, cloud, memory) with driver resolution and configuration.
+ */
+import type { StorageDriver } from './drivers/storage-driver.js';
+export interface StorageDiskConfig {
+    driver: 'local' | 'memory' | 's3' | string;
+    root?: string;
+    baseUrl?: string;
+    bucket?: string;
+    region?: string;
+    endpoint?: string;
+    publicUrl?: string;
+    [key: string]: any;
+}
+export interface StorageConfig {
+    default?: string;
+    disks?: Record<string, StorageDiskConfig>;
+}
+export declare class StorageManager {
+    private defaultDiskName;
+    private diskConfigs;
+    private instantiatedDisks;
+    private customDrivers;
+    constructor(config?: StorageConfig);
+    configure(config: StorageConfig): this;
+    /**
+     * Registers a custom driver factory function.
+     */
+    extend(driverName: string, factory: (config: StorageDiskConfig) => StorageDriver): this;
+    /**
+     * Gets or instantiates a storage disk by name.
+     */
+    disk(name?: string): StorageDriver;
+    private createDriver;
+    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>;
+    reset(): void;
+}
+export declare const Storage: StorageManager;
+//# sourceMappingURL=storage-manager.d.ts.map

package/dist/storage/storage-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-manager.d.ts","sourceRoot":"","sources":["../../src/storage/storage-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAKjE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC3C;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,iBAAiB,CAAoC;IAC7D,OAAO,CAAC,aAAa,CAAmE;gBAE5E,MAAM,GAAE,aAAkB;IAI/B,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAY7C;;OAEG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,aAAa,GAAG,IAAI;IAK9F;;OAEG;IACI,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IAazC,OAAO,CAAC,YAAY;IA6Bb,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjE,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;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIzB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAOpE,KAAK,IAAI,IAAI;CAKrB;AAED,eAAO,MAAM,OAAO,gBAAuB,CAAC"}

package/dist/storage/storage-manager.js

@@ -0,0 +1,106 @@
+/**
+ * @file storage-manager.ts
+ * @description Central Storage manager and facade for AeroJS.
+ * Manages multiple named disks (local, cloud, memory) with driver resolution and configuration.
+ */
+import { MemoryStorageDriver } from './drivers/memory-driver.js';
+import { LocalStorageDriver } from './drivers/local-driver.js';
+import { S3StorageDriver } from './drivers/s3-driver.js';
+export class StorageManager {
+    defaultDiskName = 'memory';
+    diskConfigs = new Map();
+    instantiatedDisks = new Map();
+    customDrivers = new Map();
+    constructor(config = {}) {
+        this.configure(config);
+    }
+    configure(config) {
+        if (config.default) {
+            this.defaultDiskName = config.default;
+        }
+        if (config.disks) {
+            for (const [name, diskCfg] of Object.entries(config.disks)) {
+                this.diskConfigs.set(name, diskCfg);
+            }
+        }
+        return this;
+    }
+    /**
+     * Registers a custom driver factory function.
+     */
+    extend(driverName, factory) {
+        this.customDrivers.set(driverName, factory);
+        return this;
+    }
+    /**
+     * Gets or instantiates a storage disk by name.
+     */
+    disk(name) {
+        const diskName = name || this.defaultDiskName;
+        if (this.instantiatedDisks.has(diskName)) {
+            return this.instantiatedDisks.get(diskName);
+        }
+        const config = this.diskConfigs.get(diskName) || { driver: diskName === 'memory' ? 'memory' : 'local' };
+        const driver = this.createDriver(config);
+        this.instantiatedDisks.set(diskName, driver);
+        return driver;
+    }
+    createDriver(config) {
+        if (this.customDrivers.has(config.driver)) {
+            return this.customDrivers.get(config.driver)(config);
+        }
+        switch (config.driver) {
+            case 'memory':
+                return new MemoryStorageDriver({ baseUrl: config.baseUrl });
+            case 'local':
+                return new LocalStorageDriver({
+                    root: config.root || './storage/app',
+                    baseUrl: config.baseUrl || '/storage',
+                });
+            case 's3':
+                return new S3StorageDriver({
+                    bucket: config.bucket || 'default-bucket',
+                    region: config.region,
+                    endpoint: config.endpoint,
+                    publicUrl: config.publicUrl,
+                });
+            default:
+                throw new Error(`Unsupported storage driver: "${config.driver}"`);
+        }
+    }
+    // Facade proxies to the default disk
+    put(path, content) {
+        return this.disk().put(path, content);
+    }
+    get(path) {
+        return this.disk().get(path);
+    }
+    getText(path, encoding) {
+        return this.disk().getText(path, encoding);
+    }
+    exists(path) {
+        return this.disk().exists(path);
+    }
+    delete(path) {
+        return this.disk().delete(path);
+    }
+    size(path) {
+        return this.disk().size(path);
+    }
+    url(path) {
+        return this.disk().url(path);
+    }
+    temporaryUrl(path, expiresInSeconds = 3600) {
+        if (this.disk().temporaryUrl) {
+            return this.disk().temporaryUrl(path, expiresInSeconds);
+        }
+        return Promise.resolve(this.disk().url(path));
+    }
+    reset() {
+        this.instantiatedDisks.clear();
+        this.diskConfigs.clear();
+        this.defaultDiskName = 'memory';
+    }
+}
+export const Storage = new StorageManager();
+//# sourceMappingURL=storage-manager.js.map

package/dist/storage/storage-manager.js.map

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

package/dist/storage/uploaded-file.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @file uploaded-file.ts
+ * @description UploadedFile class representing an HTTP multipart uploaded file.
+ * Provides validation (size, MIME, extension), saving to disk, and direct Storage integration.
+ */
+export interface FileValidationRules {
+    maxSize?: number;
+    mimes?: string[];
+    extensions?: string[];
+}
+export declare class UploadedFile {
+    readonly fieldName: string;
+    readonly originalName: string;
+    readonly mimeType: string;
+    readonly size: number;
+    readonly buffer: Buffer;
+    constructor(options: {
+        fieldName: string;
+        originalName: string;
+        mimeType: string;
+        buffer: Buffer;
+    });
+    get extension(): string;
+    /**
+     * Validates file size, MIME type, and file extension.
+     */
+    validate(rules: FileValidationRules): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Saves the file to a local destination filepath.
+     */
+    saveAs(destinationPath: string): Promise<string>;
+    /**
+     * Stores the file using Aero's Storage manager onto a designated disk.
+     */
+    store(directory?: string, diskName?: string): Promise<string>;
+}
+//# sourceMappingURL=uploaded-file.d.ts.map

package/dist/storage/uploaded-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploaded-file.d.ts","sourceRoot":"","sources":["../../src/storage/uploaded-file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB;IAQD,IAAW,SAAS,IAAI,MAAM,CAG7B;IAED;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA6BjF;;OAEG;IACU,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO7D;;OAEG;IACU,KAAK,CAAC,SAAS,SAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAU9E"}