@typetron/framework 0.5.30 → 0.5.32

package/build/Storage/StorageDisk.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageDisk = void 0;
+const File_1 = require("./File");
+const errors_1 = require("./errors");
+class StorageDisk {
+    name;
+    storageDriver;
+    constructor(name, storageDriver) {
+        this.name = name;
+        this.storageDriver = storageDriver;
+    }
+    driver() {
+        return this.storageDriver;
+    }
+    async put(key, content, options = {}) {
+        await this.storageDriver.write(key, content, options);
+        return new File_1.File(key, this.name, { mimeType: options.mimeType, metadata: options.metadata, visibility: options.visibility });
+    }
+    putFile(key, file, options = {}) {
+        return this.put(key, file.stream(), { mimeType: file.mimeType, ...options });
+    }
+    read(key) { return this.storageDriver.read(key); }
+    get(key) { return this.read(key); }
+    readStream(key) { return this.storageDriver.readStream(key); }
+    async json(key) {
+        return JSON.parse((await this.read(key)).toString());
+    }
+    exists(key) { return this.storageDriver.exists(key); }
+    async missing(key) { return !(await this.exists(key)); }
+    async stat(key) {
+        return new File_1.File(key, this.name, await this.storageDriver.metadata(key));
+    }
+    list(prefix = '', options = {}) {
+        return this.storageDriver.list(prefix, options);
+    }
+    async files(prefix = '', options = {}) {
+        const files = [];
+        for await (const entry of this.list(prefix, options)) {
+            if (entry.type === 'file') {
+                files.push(new File_1.File(entry.key, this.name, {
+                    size: entry.size,
+                    lastModified: entry.lastModified,
+                    mimeType: entry.mimeType,
+                    etag: entry.etag,
+                    metadata: entry.metadata,
+                    visibility: entry.visibility,
+                }));
+            }
+        }
+        return files;
+    }
+    async directories(prefix = '') {
+        const directories = [];
+        for await (const entry of this.list(prefix)) {
+            if (entry.type === 'directory') {
+                directories.push(entry.key);
+            }
+        }
+        return directories;
+    }
+    delete(key) { return this.storageDriver.delete(key); }
+    deleteDirectory(prefix) { return this.storageDriver.deleteDirectory(prefix); }
+    async copy(source, destination) {
+        await this.storageDriver.copy(source, destination);
+        return new File_1.File(destination, this.name);
+    }
+    async move(source, destination) {
+        await this.storageDriver.move(source, destination);
+        return new File_1.File(destination, this.name);
+    }
+    visibility(key) { return this.storageDriver.visibility(key); }
+    setVisibility(key, visibility) { return this.storageDriver.setVisibility(key, visibility); }
+    url(key) {
+        if (!this.storageDriver.url) {
+            throw new errors_1.UnsupportedStorageOperation('url');
+        }
+        return this.storageDriver.url(key);
+    }
+    temporaryUrl(key, expiresInSeconds, options) {
+        if (!this.storageDriver.temporaryUrl) {
+            throw new errors_1.UnsupportedStorageOperation('temporaryUrl');
+        }
+        return this.storageDriver.temporaryUrl(key, expiresInSeconds, options);
+    }
+    async assertExists(key) {
+        if (!(await this.exists(key))) {
+            throw new Error(`Expected storage file '${key}' to exist.`);
+        }
+    }
+    async assertMissing(key) {
+        if (await this.exists(key)) {
+            throw new Error(`Expected storage file '${key}' to be missing.`);
+        }
+    }
+    async assertCount(prefix, count, recursively = false) {
+        const files = await this.files(prefix, { recursive: recursively });
+        if (files.length !== count) {
+            throw new Error(`Expected ${count} storage files below '${prefix}', found ${files.length}.`);
+        }
+    }
+}
+exports.StorageDisk = StorageDisk;
+//# sourceMappingURL=StorageDisk.js.map

package/build/Storage/StorageDisk.js.map

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

package/build/Storage/StorageDriver.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"StorageDriver.d.ts","sourceRoot":"","sources":["../../Storage/StorageDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEhI,8BAAsB,aAAa;IAC/B,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3F,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACrD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,YAAY,CAAC;IAClF,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACvD,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjE,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjE,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IACrD,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1E,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IACzB,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;CACvG"}

package/build/Storage/StorageDriver.js

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

package/build/Storage/StorageDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageDriver.js","sourceRoot":"","sources":["../../Storage/StorageDriver.ts"],"names":[],"mappings":";;;AAGA,MAAsB,aAAa;CAgBlC;AAhBD,sCAgBC"}

package/build/Storage/UploadedFile.d.ts

@@ -0,0 +1,9 @@
+import { Readable } from 'node:stream';
+import { File } from './File';
+export declare class UploadedFile extends File {
+    temporaryPath: string;
+    uploadMimeType?: string | undefined;
+    constructor(temporaryPath: string, originalName: string, uploadMimeType?: string | undefined);
+    stream(): Readable;
+}
+//# sourceMappingURL=UploadedFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UploadedFile.d.ts","sourceRoot":"","sources":["../../Storage/UploadedFile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B,qBAAa,YAAa,SAAQ,IAAI;IAEvB,aAAa,EAAE,MAAM;IAErB,cAAc,CAAC,EAAE,MAAM;gBAFvB,aAAa,EAAE,MAAM,EAC5B,YAAY,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,YAAA;IAQlC,MAAM,IAAI,QAAQ;CAGrB"}

package/build/Storage/UploadedFile.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadedFile = void 0;
+const node_fs_1 = require("node:fs");
+const File_1 = require("./File");
+class UploadedFile extends File_1.File {
+    temporaryPath;
+    uploadMimeType;
+    constructor(temporaryPath, originalName, uploadMimeType) {
+        super(temporaryPath);
+        this.temporaryPath = temporaryPath;
+        this.uploadMimeType = uploadMimeType;
+        this.originalName = originalName;
+        this.mimeType = uploadMimeType;
+        this.saved = true;
+    }
+    stream() {
+        return (0, node_fs_1.createReadStream)(this.temporaryPath);
+    }
+}
+exports.UploadedFile = UploadedFile;
+//# sourceMappingURL=UploadedFile.js.map

package/build/Storage/UploadedFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadedFile.js","sourceRoot":"","sources":["../../Storage/UploadedFile.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAE1C,iCAA6B;AAE7B,MAAa,YAAa,SAAQ,WAAI;IAEvB;IAEA;IAHX,YACW,aAAqB,EAC5B,YAAoB,EACb,cAAuB;QAE9B,KAAK,CAAC,aAAa,CAAC,CAAA;QAJb,kBAAa,GAAb,aAAa,CAAQ;QAErB,mBAAc,GAAd,cAAc,CAAS;QAG9B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAA;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACrB,CAAC;IAED,MAAM;QACF,OAAO,IAAA,0BAAgB,EAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC/C,CAAC;CACJ;AAfD,oCAeC"}

package/build/Storage/errors.d.ts

@@ -0,0 +1,21 @@
+export declare class StorageError extends Error {
+}
+export declare class StorageDiskNotFound extends StorageError {
+    constructor(name: string);
+}
+export declare class StorageDriverNotSupported extends StorageError {
+    constructor(name: string);
+}
+export declare class StorageFileNotFound extends StorageError {
+    constructor(key: string);
+}
+export declare class InvalidStorageKey extends StorageError {
+    constructor(key: string);
+}
+export declare class UnsupportedStorageOperation extends StorageError {
+    constructor(operation: string);
+}
+export declare class ReadOnlyStorage extends StorageError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../Storage/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;CAAG;AAE1C,qBAAa,mBAAoB,SAAQ,YAAY;gBACrC,IAAI,EAAE,MAAM;CAG3B;AAED,qBAAa,yBAA0B,SAAQ,YAAY;gBAC3C,IAAI,EAAE,MAAM;CAG3B;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACrC,GAAG,EAAE,MAAM;CAG1B;AAED,qBAAa,iBAAkB,SAAQ,YAAY;gBACnC,GAAG,EAAE,MAAM;CAG1B;AAED,qBAAa,2BAA4B,SAAQ,YAAY;gBAC7C,SAAS,EAAE,MAAM;CAGhC;AAED,qBAAa,eAAgB,SAAQ,YAAY;;CAIhD"}

package/build/Storage/errors.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadOnlyStorage = exports.UnsupportedStorageOperation = exports.InvalidStorageKey = exports.StorageFileNotFound = exports.StorageDriverNotSupported = exports.StorageDiskNotFound = exports.StorageError = void 0;
+class StorageError extends Error {
+}
+exports.StorageError = StorageError;
+class StorageDiskNotFound extends StorageError {
+    constructor(name) {
+        super(`Storage disk '${name}' is not configured.`);
+    }
+}
+exports.StorageDiskNotFound = StorageDiskNotFound;
+class StorageDriverNotSupported extends StorageError {
+    constructor(name) {
+        super(`Storage driver '${name}' is not supported.`);
+    }
+}
+exports.StorageDriverNotSupported = StorageDriverNotSupported;
+class StorageFileNotFound extends StorageError {
+    constructor(key) {
+        super(`Storage file '${key}' was not found.`);
+    }
+}
+exports.StorageFileNotFound = StorageFileNotFound;
+class InvalidStorageKey extends StorageError {
+    constructor(key) {
+        super(`Storage key '${key}' is invalid.`);
+    }
+}
+exports.InvalidStorageKey = InvalidStorageKey;
+class UnsupportedStorageOperation extends StorageError {
+    constructor(operation) {
+        super(`The storage driver does not support '${operation}'.`);
+    }
+}
+exports.UnsupportedStorageOperation = UnsupportedStorageOperation;
+class ReadOnlyStorage extends StorageError {
+    constructor() {
+        super('The storage disk is read-only.');
+    }
+}
+exports.ReadOnlyStorage = ReadOnlyStorage;
+//# sourceMappingURL=errors.js.map

package/build/Storage/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../Storage/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAa,SAAQ,KAAK;CAAG;AAA1C,oCAA0C;AAE1C,MAAa,mBAAoB,SAAQ,YAAY;IACjD,YAAY,IAAY;QACpB,KAAK,CAAC,iBAAiB,IAAI,sBAAsB,CAAC,CAAA;IACtD,CAAC;CACJ;AAJD,kDAIC;AAED,MAAa,yBAA0B,SAAQ,YAAY;IACvD,YAAY,IAAY;QACpB,KAAK,CAAC,mBAAmB,IAAI,qBAAqB,CAAC,CAAA;IACvD,CAAC;CACJ;AAJD,8DAIC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACjD,YAAY,GAAW;QACnB,KAAK,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,CAAA;IACjD,CAAC;CACJ;AAJD,kDAIC;AAED,MAAa,iBAAkB,SAAQ,YAAY;IAC/C,YAAY,GAAW;QACnB,KAAK,CAAC,gBAAgB,GAAG,eAAe,CAAC,CAAA;IAC7C,CAAC;CACJ;AAJD,8CAIC;AAED,MAAa,2BAA4B,SAAQ,YAAY;IACzD,YAAY,SAAiB;QACzB,KAAK,CAAC,wCAAwC,SAAS,IAAI,CAAC,CAAA;IAChE,CAAC;CACJ;AAJD,kEAIC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC7C;QACI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IAC3C,CAAC;CACJ;AAJD,0CAIC"}

package/build/Storage/index.d.ts

@@ -1,5 +1,17 @@
 export * from './File';
+export * from './UploadedFile';
 export * from './Storage';
+export * from './StorageDisk';
+export * from './StorageDriver';
+export * from './Filesystem';
+export * from './PathPrefixer';
+export * from './types';
+export * from './errors';
+export * from './Drivers/LocalDriver';
+export * from './Drivers/MemoryDriver';
+export * from './Drivers/S3Driver';
+export * from './Drivers/ScopedDriver';
+export * from './Drivers/ReadOnlyDriver';
 export * from './Image';
 export * from './utils';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}

package/build/Storage/index.js

@@ -15,7 +15,19 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./File"), exports);
+__exportStar(require("./UploadedFile"), exports);
 __exportStar(require("./Storage"), exports);
+__exportStar(require("./StorageDisk"), exports);
+__exportStar(require("./StorageDriver"), exports);
+__exportStar(require("./Filesystem"), exports);
+__exportStar(require("./PathPrefixer"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./errors"), exports);
+__exportStar(require("./Drivers/LocalDriver"), exports);
+__exportStar(require("./Drivers/MemoryDriver"), exports);
+__exportStar(require("./Drivers/S3Driver"), exports);
+__exportStar(require("./Drivers/ScopedDriver"), exports);
+__exportStar(require("./Drivers/ReadOnlyDriver"), exports);
 __exportStar(require("./Image"), exports);
 __exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/build/Storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,4CAAyB;AACzB,0CAAuB;AACvB,0CAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,iDAA8B;AAC9B,4CAAyB;AACzB,gDAA6B;AAC7B,kDAA+B;AAC/B,+CAA4B;AAC5B,iDAA8B;AAC9B,0CAAuB;AACvB,2CAAwB;AACxB,wDAAqC;AACrC,yDAAsC;AACtC,qDAAkC;AAClC,yDAAsC;AACtC,2DAAwC;AACxC,0CAAuB;AACvB,0CAAuB"}

package/build/Storage/types.d.ts

@@ -0,0 +1,73 @@
+import { Readable } from 'node:stream';
+export type StorageContent = string | Buffer | Readable;
+export type Visibility = 'private' | 'public';
+export interface FileMetadata {
+    size?: number;
+    lastModified?: Date;
+    mimeType?: string;
+    etag?: string;
+    metadata?: Record<string, string>;
+    visibility?: Visibility;
+}
+export interface StorageEntry extends FileMetadata {
+    key: string;
+    type: 'file' | 'directory';
+}
+export interface WriteOptions {
+    visibility?: Visibility;
+    mimeType?: string;
+    metadata?: Record<string, string>;
+    cacheControl?: string;
+    contentDisposition?: string;
+}
+export interface ListOptions {
+    recursive?: boolean;
+}
+export interface TemporaryUrlOptions {
+    responseContentType?: string;
+    responseContentDisposition?: string;
+}
+export interface LocalDiskConfig {
+    driver: 'local';
+    root: string;
+    url?: string;
+    visibility?: Visibility;
+}
+export interface S3DiskConfig {
+    driver: 's3';
+    bucket: string;
+    region: string;
+    endpoint?: string;
+    forcePathStyle?: boolean;
+    prefix?: string;
+    url?: string;
+    visibility?: Visibility;
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+        sessionToken?: string;
+    };
+}
+export interface MemoryDiskConfig {
+    driver: 'memory';
+    visibility?: Visibility;
+}
+export interface ScopedDiskConfig {
+    driver: 'scoped';
+    disk: string;
+    prefix: string;
+}
+export interface ReadOnlyDiskConfig {
+    driver: 'read-only';
+    disk: string;
+}
+export interface CustomDiskConfig {
+    driver: string;
+    [option: string]: unknown;
+}
+export type StorageDiskConfig = LocalDiskConfig | S3DiskConfig | MemoryDiskConfig | ScopedDiskConfig | ReadOnlyDiskConfig | CustomDiskConfig;
+export interface StorageConfiguration {
+    default: string;
+    disks: Record<string, StorageDiskConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../Storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;AACvD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE7C,MAAM,WAAW,YAAY;IACzB,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;CAC1B;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAC9C,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAC7B;AAED,MAAM,WAAW,YAAY;IACzB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,0BAA0B,CAAC,EAAE,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,UAAU,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,IAAI,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,WAAW,CAAC,EAAE;QACV,WAAW,EAAE,MAAM,CAAA;QACnB,eAAe,EAAE,MAAM,CAAA;QACvB,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,CAAA;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,QAAQ,CAAA;IAChB,UAAU,CAAC,EAAE,UAAU,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,QAAQ,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,WAAW,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;CAC5B;AAED,MAAM,MAAM,iBAAiB,GACvB,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,CAAA;AAEtB,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAC3C"}

package/build/Storage/types.js

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

package/build/Storage/types.js.map

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

package/package.json

@@ -2,7 +2,7 @@
     "name": "@typetron/framework",
     "description": "Modern Node.js framework for modern apps written in Typescript",
     "license": "MIT",
-    "version": "0.5.30",
+    "version": "0.5.32",
     "keywords": [
         "typetron",
         "framework",
@@ -32,7 +32,7 @@
         "lint": "eslint ."
     },
     "engines": {
-        "node": ">= 12.13.0"
+        "node": ">=20.0.0"
     },
     "dependencies": {
         "@sendgrid/mail": "^8.1.6",
@@ -46,6 +46,8 @@
         "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.68.0"
     },
     "devDependencies": {
+        "@aws-sdk/client-s3": "^3.1121.0",
+        "@aws-sdk/s3-request-presigner": "^3.1121.0",
         "@eslint/js": "^10.0.1",
         "@testdeck/mocha": "^0.3.3",
         "@types/bcryptjs": "^3.0.0",
@@ -68,11 +70,41 @@
         "tsconfig-paths": "^4.2.0",
         "typescript": "6.0.3"
     },
+    "peerDependencies": {
+        "@aws-sdk/client-s3": "^3.1121.0",
+        "@aws-sdk/s3-request-presigner": "^3.1121.0"
+    },
+    "peerDependenciesMeta": {
+        "@aws-sdk/client-s3": {
+            "optional": true
+        },
+        "@aws-sdk/s3-request-presigner": {
+            "optional": true
+        }
+    },
     "repository": {
         "type": "git",
         "url": "https://github.com/typetron/framework.git"
     },
     "files": [
-        "build"
+        "build",
+        "AGENTS.md",
+        "CLAUDE.md",
+        "Readme.md",
+        "Cache/Readme.md",
+        "Container/Readme.md",
+        "Database/Readme.md",
+        "Encryption/Readme.md",
+        "Forms/Readme.md",
+        "Framework/Readme.md",
+        "Mail/Readme.md",
+        "Models/Readme.md",
+        "Router/Readme.md",
+        "Storage/Readme.md",
+        "Support/Readme.md",
+        "Testing/Readme.md",
+        "Validation/Readme.md",
+        "Frontend/Angular/Readme.md",
+        "Frontend/Websockets/Readme.md"
     ]
 }