@typetron/framework 0.5.30 → 0.5.32

package/build/Storage/Drivers/ReadOnlyDriver.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadOnlyDriver = void 0;
+const StorageDriver_1 = require("../StorageDriver");
+const errors_1 = require("../errors");
+class ReadOnlyDriver extends StorageDriver_1.StorageDriver {
+    driver;
+    constructor(driver) {
+        super();
+        this.driver = driver;
+    }
+    write(_key, _content, _options) { throw new errors_1.ReadOnlyStorage(); }
+    read(key) { return this.driver.read(key); }
+    readStream(key) { return this.driver.readStream(key); }
+    exists(key) { return this.driver.exists(key); }
+    metadata(key) { return this.driver.metadata(key); }
+    list(prefix, options) { return this.driver.list(prefix, options); }
+    delete(_key) { throw new errors_1.ReadOnlyStorage(); }
+    deleteDirectory(_prefix) { throw new errors_1.ReadOnlyStorage(); }
+    copy(_source, _destination) { throw new errors_1.ReadOnlyStorage(); }
+    move(_source, _destination) { throw new errors_1.ReadOnlyStorage(); }
+    visibility(key) { return this.driver.visibility(key); }
+    setVisibility(_key, _visibility) { throw new errors_1.ReadOnlyStorage(); }
+    url(key) {
+        if (!this.driver.url) {
+            throw new errors_1.UnsupportedStorageOperation('url');
+        }
+        return this.driver.url(key);
+    }
+    temporaryUrl(key, expiresInSeconds, options) {
+        if (!this.driver.temporaryUrl) {
+            throw new errors_1.UnsupportedStorageOperation('temporaryUrl');
+        }
+        return this.driver.temporaryUrl(key, expiresInSeconds, options);
+    }
+}
+exports.ReadOnlyDriver = ReadOnlyDriver;
+//# sourceMappingURL=ReadOnlyDriver.js.map

package/build/Storage/Drivers/ReadOnlyDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadOnlyDriver.js","sourceRoot":"","sources":["../../../Storage/Drivers/ReadOnlyDriver.ts"],"names":[],"mappings":";;;AAEA,oDAAgD;AAChD,sCAAwE;AAGxE,MAAa,cAAe,SAAQ,6BAAa;IAChB;IAA7B,YAA6B,MAAqB;QAAI,KAAK,EAAE,CAAA;QAAhC,WAAM,GAAN,MAAM,CAAe;IAAY,CAAC;IAE/D,KAAK,CAAC,IAAY,EAAE,QAAwB,EAAE,QAAuB,IAAmB,MAAM,IAAI,wBAAe,EAAE,CAAA,CAAC,CAAC;IACrH,IAAI,CAAC,GAAW,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA,CAAC,CAAC;IACnE,UAAU,CAAC,GAAW,IAAuB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA,CAAC,CAAC;IACjF,MAAM,CAAC,GAAW,IAAsB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA,CAAC,CAAC;IACxE,QAAQ,CAAC,GAAW,IAA2B,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA,CAAC,CAAC;IACjF,IAAI,CAAC,MAAe,EAAE,OAAqB,IAAiC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA,CAAC,CAAC;IACtH,MAAM,CAAC,IAAY,IAAmB,MAAM,IAAI,wBAAe,EAAE,CAAA,CAAC,CAAC;IACnE,eAAe,CAAC,OAAe,IAAmB,MAAM,IAAI,wBAAe,EAAE,CAAA,CAAC,CAAC;IAC/E,IAAI,CAAC,OAAe,EAAE,YAAoB,IAAmB,MAAM,IAAI,wBAAe,EAAE,CAAA,CAAC,CAAC;IAC1F,IAAI,CAAC,OAAe,EAAE,YAAoB,IAAmB,MAAM,IAAI,wBAAe,EAAE,CAAA,CAAC,CAAC;IAC1F,UAAU,CAAC,GAAW,IAAyB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA,CAAC,CAAC;IACnF,aAAa,CAAC,IAAY,EAAE,WAAuB,IAAmB,MAAM,IAAI,wBAAe,EAAE,CAAA,CAAC,CAAC;IACnG,GAAG,CAAC,GAAW;QACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,oCAA2B,CAAC,KAAK,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IACD,YAAY,CAAC,GAAW,EAAE,gBAAwB,EAAE,OAA6B;QAC7E,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC5B,MAAM,IAAI,oCAA2B,CAAC,cAAc,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAA;IACnE,CAAC;CACJ;AA3BD,wCA2BC"}

package/build/Storage/Drivers/S3Driver.d.ts

@@ -0,0 +1,32 @@
+import { Readable } from 'node:stream';
+import { StorageDriver } from '../StorageDriver';
+import { FileMetadata, ListOptions, S3DiskConfig, StorageContent, StorageEntry, TemporaryUrlOptions, Visibility, WriteOptions } from '../types';
+export declare class S3Driver extends StorageDriver {
+    private readonly config;
+    private readonly prefixer;
+    private client?;
+    constructor(config: S3DiskConfig, client?: unknown);
+    write(key: string, content: StorageContent, options?: WriteOptions): Promise<void>;
+    read(key: string): Promise<Buffer>;
+    readStream(key: string): Promise<Readable>;
+    exists(key: string): Promise<boolean>;
+    metadata(key: string): Promise<FileMetadata>;
+    list(prefix?: string, options?: ListOptions): AsyncIterable<StorageEntry>;
+    delete(key: string): Promise<void>;
+    deleteDirectory(prefix: string): Promise<void>;
+    copy(source: string, destination: string): Promise<void>;
+    move(source: string, destination: string): Promise<void>;
+    visibility(key: string): Promise<Visibility>;
+    setVisibility(key: string, visibility: Visibility): Promise<void>;
+    url(key: string): string;
+    temporaryUrl(key: string, expiresInSeconds: number, options?: TemporaryUrlOptions): Promise<string>;
+    private getObject;
+    private deleteBatch;
+    private getClient;
+    private sdk;
+    private key;
+    private acl;
+    private encodeKey;
+    private isMissing;
+}
+//# sourceMappingURL=S3Driver.d.ts.map

package/build/Storage/Drivers/S3Driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3Driver.d.ts","sourceRoot":"","sources":["../../../Storage/Drivers/S3Driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhD,OAAO,EACH,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,YAAY,EACf,MAAM,UAAU,CAAA;AAMjB,qBAAa,QAAS,SAAQ,aAAa;IAI3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,MAAM,CAAC,CAAc;gBAEA,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO;IAM7D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IActF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYlC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAc1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmB3C,IAAI,CAAC,MAAM,SAAK,EAAE,OAAO,GAAE,WAAgB,GAAG,aAAa,CAAC,YAAY,CAAC;IA+B1E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiB5C,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAgBlB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC;YAW/F,SAAS;YAYT,WAAW;IAOzB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,SAAS;CAIpB"}

package/build/Storage/Drivers/S3Driver.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3Driver = void 0;
+const node_stream_1 = require("node:stream");
+const StorageDriver_1 = require("../StorageDriver");
+const PathPrefixer_1 = require("../PathPrefixer");
+const errors_1 = require("../errors");
+class S3Driver extends StorageDriver_1.StorageDriver {
+    config;
+    prefixer;
+    client;
+    constructor(config, client) {
+        super();
+        this.config = config;
+        this.prefixer = new PathPrefixer_1.PathPrefixer(config.prefix);
+        this.client = client;
+    }
+    async write(key, content, options = {}) {
+        const { PutObjectCommand } = this.sdk();
+        await this.getClient().send(new PutObjectCommand({
+            Bucket: this.config.bucket,
+            Key: this.key(key),
+            Body: content,
+            ACL: this.acl(options.visibility ?? this.config.visibility),
+            ContentType: options.mimeType,
+            Metadata: options.metadata,
+            CacheControl: options.cacheControl,
+            ContentDisposition: options.contentDisposition,
+        }));
+    }
+    async read(key) {
+        const response = await this.getObject(key);
+        if (!response.Body) {
+            return Buffer.alloc(0);
+        }
+        if (typeof response.Body.transformToByteArray === 'function') {
+            return Buffer.from(await response.Body.transformToByteArray());
+        }
+        const body = response.Body;
+        return Buffer.concat(await Array.fromAsync(body, chunk => Buffer.from(chunk)));
+    }
+    async readStream(key) {
+        const response = await this.getObject(key);
+        if (!response.Body) {
+            return node_stream_1.Readable.from([]);
+        }
+        if (response.Body instanceof node_stream_1.Readable) {
+            return response.Body;
+        }
+        if (typeof response.Body.transformToWebStream === 'function') {
+            return node_stream_1.Readable.fromWeb(response.Body.transformToWebStream());
+        }
+        return node_stream_1.Readable.from(response.Body);
+    }
+    async exists(key) {
+        const { HeadObjectCommand } = this.sdk();
+        try {
+            await this.getClient().send(new HeadObjectCommand({ Bucket: this.config.bucket, Key: this.key(key) }));
+            return true;
+        }
+        catch (error) {
+            if (this.isMissing(error)) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async metadata(key) {
+        const { HeadObjectCommand } = this.sdk();
+        try {
+            const response = await this.getClient().send(new HeadObjectCommand({ Bucket: this.config.bucket, Key: this.key(key) }));
+            return {
+                size: response.ContentLength,
+                lastModified: response.LastModified,
+                mimeType: response.ContentType,
+                etag: response.ETag,
+                metadata: response.Metadata,
+            };
+        }
+        catch (error) {
+            if (this.isMissing(error)) {
+                throw new errors_1.StorageFileNotFound(key);
+            }
+            throw error;
+        }
+    }
+    async *list(prefix = '', options = {}) {
+        const { ListObjectsV2Command } = this.sdk();
+        const keyPrefix = this.prefixer.prefix(prefix, true);
+        let continuationToken;
+        do {
+            const response = await this.getClient().send(new ListObjectsV2Command({
+                Bucket: this.config.bucket,
+                Prefix: keyPrefix ? `${keyPrefix.replace(/\/$/, '')}/` : undefined,
+                Delimiter: options.recursive ? undefined : '/',
+                ContinuationToken: continuationToken,
+            }));
+            for (const directory of response.CommonPrefixes ?? []) {
+                if (directory.Prefix) {
+                    yield { key: this.prefixer.stripPrefix(directory.Prefix.replace(/\/$/, '')), type: 'directory' };
+                }
+            }
+            for (const object of response.Contents ?? []) {
+                if (object.Key && object.Key !== keyPrefix) {
+                    yield {
+                        key: this.prefixer.stripPrefix(object.Key),
+                        type: 'file',
+                        size: object.Size,
+                        lastModified: object.LastModified,
+                        etag: object.ETag,
+                    };
+                }
+            }
+            continuationToken = response.IsTruncated ? response.NextContinuationToken : undefined;
+        } while (continuationToken);
+    }
+    async delete(key) {
+        const { DeleteObjectCommand } = this.sdk();
+        await this.getClient().send(new DeleteObjectCommand({ Bucket: this.config.bucket, Key: this.key(key) }));
+    }
+    async deleteDirectory(prefix) {
+        const { DeleteObjectsCommand } = this.sdk();
+        this.prefixer.normalize(prefix);
+        let batch = [];
+        for await (const entry of this.list(prefix, { recursive: true })) {
+            if (entry.type !== 'file') {
+                continue;
+            }
+            batch.push(this.key(entry.key));
+            if (batch.length === 1000) {
+                await this.deleteBatch(batch, DeleteObjectsCommand);
+                batch = [];
+            }
+        }
+        if (batch.length) {
+            await this.deleteBatch(batch, DeleteObjectsCommand);
+        }
+    }
+    async copy(source, destination) {
+        const { CopyObjectCommand } = this.sdk();
+        await this.getClient().send(new CopyObjectCommand({
+            Bucket: this.config.bucket,
+            CopySource: `${this.config.bucket}/${this.encodeKey(this.key(source))}`,
+            Key: this.key(destination),
+        }));
+    }
+    async move(source, destination) {
+        await this.copy(source, destination);
+        await this.delete(source);
+    }
+    async visibility(key) {
+        const { GetObjectAclCommand } = this.sdk();
+        try {
+            const response = await this.getClient().send(new GetObjectAclCommand({ Bucket: this.config.bucket, Key: this.key(key) }));
+            return response.Grants?.some((grant) => grant.Permission === 'READ' && grant.Grantee?.URI?.endsWith('/AllUsers'))
+                ? 'public'
+                : 'private';
+        }
+        catch (error) {
+            if (this.isMissing(error)) {
+                throw new errors_1.StorageFileNotFound(key);
+            }
+            throw error;
+        }
+    }
+    async setVisibility(key, visibility) {
+        const { PutObjectAclCommand } = this.sdk();
+        await this.getClient().send(new PutObjectAclCommand({
+            Bucket: this.config.bucket,
+            Key: this.key(key),
+            ACL: this.acl(visibility),
+        }));
+    }
+    url(key) {
+        const encodedKey = this.encodeKey(this.key(key));
+        if (this.config.url) {
+            return `${this.config.url.replace(/\/$/, '')}/${encodedKey}`;
+        }
+        if (this.config.endpoint) {
+            const endpoint = new URL(this.config.endpoint);
+            if (this.config.forcePathStyle) {
+                return `${endpoint.toString().replace(/\/$/, '')}/${this.config.bucket}/${encodedKey}`;
+            }
+            endpoint.hostname = `${this.config.bucket}.${endpoint.hostname}`;
+            return `${endpoint.toString().replace(/\/$/, '')}/${encodedKey}`;
+        }
+        return `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com/${encodedKey}`;
+    }
+    async temporaryUrl(key, expiresInSeconds, options = {}) {
+        const { GetObjectCommand } = this.sdk();
+        const { getSignedUrl } = require('@aws-sdk/s3-request-presigner');
+        return getSignedUrl(this.getClient(), new GetObjectCommand({
+            Bucket: this.config.bucket,
+            Key: this.key(key),
+            ResponseContentType: options.responseContentType,
+            ResponseContentDisposition: options.responseContentDisposition,
+        }), { expiresIn: expiresInSeconds });
+    }
+    async getObject(key) {
+        const { GetObjectCommand } = this.sdk();
+        try {
+            return await this.getClient().send(new GetObjectCommand({ Bucket: this.config.bucket, Key: this.key(key) }));
+        }
+        catch (error) {
+            if (this.isMissing(error)) {
+                throw new errors_1.StorageFileNotFound(key);
+            }
+            throw error;
+        }
+    }
+    async deleteBatch(keys, DeleteObjectsCommand) {
+        await this.getClient().send(new DeleteObjectsCommand({
+            Bucket: this.config.bucket,
+            Delete: { Objects: keys.map(Key => ({ Key })), Quiet: true },
+        }));
+    }
+    getClient() {
+        if (!this.client) {
+            const { S3Client } = this.sdk();
+            const clientConfig = {
+                region: this.config.region,
+                endpoint: this.config.endpoint,
+                forcePathStyle: this.config.forcePathStyle,
+                credentials: this.config.credentials,
+            };
+            this.client = new S3Client(clientConfig);
+        }
+        return this.client;
+    }
+    sdk() {
+        return require('@aws-sdk/client-s3');
+    }
+    key(key) {
+        return this.prefixer.prefix(key);
+    }
+    acl(visibility) {
+        return visibility ? visibility === 'public' ? 'public-read' : 'private' : undefined;
+    }
+    encodeKey(key) {
+        return key.split('/').map(encodeURIComponent).join('/');
+    }
+    isMissing(error) {
+        const value = error;
+        return value?.name === 'NoSuchKey' || value?.name === 'NotFound' || value?.$metadata?.httpStatusCode === 404;
+    }
+}
+exports.S3Driver = S3Driver;
+//# sourceMappingURL=S3Driver.js.map

package/build/Storage/Drivers/S3Driver.js.map

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

package/build/Storage/Drivers/ScopedDriver.d.ts

@@ -0,0 +1,24 @@
+import { Readable } from 'node:stream';
+import { StorageDriver } from '../StorageDriver';
+import { FileMetadata, ListOptions, StorageContent, StorageEntry, TemporaryUrlOptions, Visibility, WriteOptions } from '../types';
+export declare class ScopedDriver extends StorageDriver {
+    private readonly driver;
+    private readonly prefixer;
+    constructor(driver: StorageDriver, prefix: string);
+    write(key: string, content: StorageContent, options?: WriteOptions): Promise<void>;
+    read(key: string): Promise<Buffer>;
+    readStream(key: string): Promise<Readable>;
+    exists(key: string): Promise<boolean>;
+    metadata(key: string): Promise<FileMetadata>;
+    list(prefix?: string, options?: ListOptions): AsyncIterable<StorageEntry>;
+    delete(key: string): Promise<void>;
+    deleteDirectory(prefix: string): Promise<void>;
+    copy(source: string, destination: string): Promise<void>;
+    move(source: string, destination: string): Promise<void>;
+    visibility(key: string): Promise<Visibility>;
+    setVisibility(key: string, visibility: Visibility): Promise<void>;
+    url(key: string): string;
+    temporaryUrl(key: string, expiresInSeconds: number, options?: TemporaryUrlOptions): Promise<string>;
+    private key;
+}
+//# sourceMappingURL=ScopedDriver.d.ts.map

package/build/Storage/Drivers/ScopedDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopedDriver.d.ts","sourceRoot":"","sources":["../../../Storage/Drivers/ScopedDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEjI,qBAAa,YAAa,SAAQ,aAAa;IAG/B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;gBAEV,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;IAKlE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAGlF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAClC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAErC,IAAI,CAAC,MAAM,SAAK,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,YAAY,CAAC;IAM5E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAClC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAC5C,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IACjE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAMxB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAOnG,OAAO,CAAC,GAAG;CAGd"}

package/build/Storage/Drivers/ScopedDriver.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedDriver = void 0;
+const StorageDriver_1 = require("../StorageDriver");
+const PathPrefixer_1 = require("../PathPrefixer");
+const errors_1 = require("../errors");
+class ScopedDriver extends StorageDriver_1.StorageDriver {
+    driver;
+    prefixer;
+    constructor(driver, prefix) {
+        super();
+        this.driver = driver;
+        this.prefixer = new PathPrefixer_1.PathPrefixer(prefix);
+    }
+    write(key, content, options) {
+        return this.driver.write(this.key(key), content, options);
+    }
+    read(key) { return this.driver.read(this.key(key)); }
+    readStream(key) { return this.driver.readStream(this.key(key)); }
+    exists(key) { return this.driver.exists(this.key(key)); }
+    metadata(key) { return this.driver.metadata(this.key(key)); }
+    async *list(prefix = '', options) {
+        for await (const entry of this.driver.list(this.prefixer.prefix(prefix, true), options)) {
+            yield { ...entry, key: this.prefixer.stripPrefix(entry.key) };
+        }
+    }
+    delete(key) { return this.driver.delete(this.key(key)); }
+    deleteDirectory(prefix) { return this.driver.deleteDirectory(this.key(prefix)); }
+    copy(source, destination) { return this.driver.copy(this.key(source), this.key(destination)); }
+    move(source, destination) { return this.driver.move(this.key(source), this.key(destination)); }
+    visibility(key) { return this.driver.visibility(this.key(key)); }
+    setVisibility(key, visibility) { return this.driver.setVisibility(this.key(key), visibility); }
+    url(key) {
+        if (!this.driver.url) {
+            throw new errors_1.UnsupportedStorageOperation('url');
+        }
+        return this.driver.url(this.key(key));
+    }
+    temporaryUrl(key, expiresInSeconds, options) {
+        if (!this.driver.temporaryUrl) {
+            throw new errors_1.UnsupportedStorageOperation('temporaryUrl');
+        }
+        return this.driver.temporaryUrl(this.key(key), expiresInSeconds, options);
+    }
+    key(key) {
+        return this.prefixer.prefix(key);
+    }
+}
+exports.ScopedDriver = ScopedDriver;
+//# sourceMappingURL=ScopedDriver.js.map

package/build/Storage/Drivers/ScopedDriver.js.map

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

package/build/Storage/File.d.ts

@@ -1,11 +1,21 @@
+import { FileMetadata, Visibility } from './types';
 export declare class File {
-    name: string;
-    directory?: string | undefined;
+    key: string;
+    disk?: string | undefined;
     originalName?: string;
     saved: boolean;
-    constructor(name: string, directory?: string | undefined);
-    get extension(): string | undefined;
+    size?: number;
+    lastModified?: Date;
+    mimeType?: string;
+    etag?: string;
+    metadata?: Record<string, string>;
+    visibility?: Visibility;
+    constructor(key: string, disk?: string | undefined, metadata?: Partial<FileMetadata>);
+    get name(): string;
+    get directory(): string;
+    /** The logical storage key. Kept as an alias for existing file consumers. */
     get path(): string;
+    get extension(): string | undefined;
     guessExtension(): string | undefined;
     toString(): string;
 }

package/build/Storage/File.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../../Storage/File.ts"],"names":[],"mappings":"AAEA,qBAAa,IAAI;IAMM,IAAI,EAAE,MAAM;IAAS,SAAS,CAAC,EAAE,MAAM;IAJ1D,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,KAAK,UAAQ;gBAEM,IAAI,EAAE,MAAM,EAAS,SAAS,CAAC,EAAE,MAAM,YAAA;IAG1D,IAAI,SAAS,uBAEZ;IAED,IAAI,IAAI,WAEP;IAED,cAAc;IAOd,QAAQ;CAGX"}
+{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../../Storage/File.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAElD,qBAAa,IAAI;IAWF,GAAG,EAAE,MAAM;IACX,IAAI,CAAC,EAAE,MAAM;IAXxB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,UAAQ;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,UAAU,CAAA;gBAGZ,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,YAAA,EACpB,QAAQ,GAAE,OAAO,CAAC,YAAY,CAAM;IAKxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,MAAM,CAGtB;IAED,6EAA6E;IAC7E,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAGlC;IAED,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,QAAQ,IAAI,MAAM;CAGrB"}

package/build/Storage/File.js

@@ -1,61 +1,43 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.File = void 0;
-const path = __importStar(require("path"));
+const node_path_1 = __importDefault(require("node:path"));
 class File {
-    name;
-    directory;
-    // content?: string | Buffer
+    key;
+    disk;
     originalName;
     saved = false;
-    constructor(name, directory) {
-        this.name = name;
-        this.directory = directory;
+    size;
+    lastModified;
+    mimeType;
+    etag;
+    metadata;
+    visibility;
+    constructor(key, disk, metadata = {}) {
+        this.key = key;
+        this.disk = disk;
+        Object.assign(this, metadata);
     }
-    get extension() {
-        return this.guessExtension();
+    get name() {
+        return node_path_1.default.posix.basename(this.key.replaceAll('\\', '/'));
+    }
+    get directory() {
+        const directory = node_path_1.default.posix.dirname(this.key.replaceAll('\\', '/'));
+        return directory === '.' ? '' : directory;
     }
+    /** The logical storage key. Kept as an alias for existing file consumers. */
     get path() {
-        return path.join(this.directory || '', this.name);
+        return this.key;
+    }
+    get extension() {
+        const extension = node_path_1.default.posix.extname(this.name);
+        return extension ? extension.slice(1) : undefined;
     }
     guessExtension() {
-        const fileParts = this.name.split('.');
-        if (fileParts.length >= 1) {
-            return fileParts.pop();
-        }
+        return this.extension;
     }
     toString() {
         return this.name;

package/build/Storage/File.js.map

@@ -1 +1 @@
-{"version":3,"file":"File.js","sourceRoot":"","sources":["../../Storage/File.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA4B;AAE5B,MAAa,IAAI;IAMM;IAAqB;IALxC,4BAA4B;IAC5B,YAAY,CAAS;IAErB,KAAK,GAAG,KAAK,CAAA;IAEb,YAAmB,IAAY,EAAS,SAAkB;QAAvC,SAAI,GAAJ,IAAI,CAAQ;QAAS,cAAS,GAAT,SAAS,CAAS;IAC1D,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,cAAc,EAAE,CAAA;IAChC,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IACrD,CAAC;IAED,cAAc;QACV,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC,GAAG,EAAE,CAAA;QAC1B,CAAC;IACL,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,IAAI,CAAA;IACpB,CAAC;CACJ;AA3BD,oBA2BC"}
+{"version":3,"file":"File.js","sourceRoot":"","sources":["../../Storage/File.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA4B;AAG5B,MAAa,IAAI;IAWF;IACA;IAXX,YAAY,CAAS;IACrB,KAAK,GAAG,KAAK,CAAA;IACb,IAAI,CAAS;IACb,YAAY,CAAO;IACnB,QAAQ,CAAS;IACjB,IAAI,CAAS;IACb,QAAQ,CAAyB;IACjC,UAAU,CAAa;IAEvB,YACW,GAAW,EACX,IAAa,EACpB,WAAkC,EAAE;QAF7B,QAAG,GAAH,GAAG,CAAQ;QACX,SAAI,GAAJ,IAAI,CAAS;QAGpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACjC,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,mBAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,IAAI,SAAS;QACT,MAAM,SAAS,GAAG,mBAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;QACpE,OAAO,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC7C,CAAC;IAED,6EAA6E;IAC7E,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,GAAG,CAAA;IACnB,CAAC;IAED,IAAI,SAAS;QACT,MAAM,SAAS,GAAG,mBAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/C,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACrD,CAAC;IAED,cAAc;QACV,OAAO,IAAI,CAAC,SAAS,CAAA;IACzB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,IAAI,CAAA;IACpB,CAAC;CACJ;AA5CD,oBA4CC"}

package/build/Storage/Filesystem.d.ts

@@ -0,0 +1,31 @@
+import * as fileSystem from 'node:fs/promises';
+import { File } from './File';
+/**
+ * Typetron's internal access to the host operating-system filesystem.
+ *
+ * Framework bootstrap uses this service before application storage configuration
+ * is available. It accepts real OS paths so Typetron can discover configuration,
+ * controllers, entities, migrations, seeders, static assets, and file-cache data.
+ * Application code should use `Storage` and its configured disks instead.
+ *
+ * This is deliberately separate from `LocalDriver`: a local storage disk is
+ * constrained to its configured root and works with portable logical keys,
+ * while this service works with framework-owned host paths.
+ *
+ * @internal
+ */
+export declare class Filesystem {
+    /**
+     * Lists files synchronously because framework modules are currently loaded
+     * synchronously during bootstrap. Application storage listings are async.
+     */
+    files(directory: string, recursively?: boolean): File[];
+    read(filePath: string): Promise<Buffer>;
+    exists(filePath: string): Promise<boolean>;
+    save(file: File, destination: string, name?: string | number): Promise<File>;
+    put(filePath: string, content: string | Buffer, options?: Parameters<typeof fileSystem.writeFile>[2]): Promise<File>;
+    makeDirectory(directory: string): Promise<void>;
+    deleteDirectory(directory: string): Promise<void>;
+    delete(filePath: string): Promise<void>;
+}
+//# sourceMappingURL=Filesystem.d.ts.map

package/build/Storage/Filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Filesystem.d.ts","sourceRoot":"","sources":["../../Storage/Filesystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU;IACnB;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,IAAI,EAAE;IAc/C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5E,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAShD"}