@venturialstd/file-system 0.0.1

package/dist/entities/file-system-folder.entity.d.ts

@@ -0,0 +1,17 @@
+import { FileSystemFile } from './file-system-file.entity';
+export declare class FileSystemFolder {
+    id: string;
+    name: string;
+    description: string | null;
+    path: string | null;
+    parent: FileSystemFolder | null;
+    parentId: string | null;
+    children: FileSystemFolder[];
+    files: FileSystemFile[];
+    isRoot: boolean;
+    ownerId: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=file-system-folder.entity.d.ts.map

package/dist/entities/file-system-folder.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-folder.entity.d.ts","sourceRoot":"","sources":["../../src/entities/file-system-folder.entity.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,qBAMa,gBAAgB;IAE3B,EAAE,EAAE,MAAM,CAAC;IAGX,IAAI,EAAE,MAAM,CAAC;IAGb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAG3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAGpB,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAGhC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAGxB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAG7B,KAAK,EAAE,cAAc,EAAE,CAAC;IAGxB,MAAM,EAAE,OAAO,CAAC;IAGhB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGlC,SAAS,EAAE,IAAI,CAAC;IAGhB,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/entities/file-system-folder.entity.js

@@ -0,0 +1,92 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemFolder = void 0;
+const typeorm_1 = require("typeorm");
+const constants_1 = require("../constants");
+const file_system_file_entity_1 = require("./file-system-file.entity");
+let FileSystemFolder = class FileSystemFolder {
+    id;
+    name;
+    description;
+    path;
+    parent;
+    parentId;
+    children;
+    files;
+    isRoot;
+    ownerId;
+    metadata;
+    createdAt;
+    updatedAt;
+};
+exports.FileSystemFolder = FileSystemFolder;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], FileSystemFolder.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
+    __metadata("design:type", String)
+], FileSystemFolder.prototype, "name", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], FileSystemFolder.prototype, "description", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 512, nullable: true }),
+    __metadata("design:type", Object)
+], FileSystemFolder.prototype, "path", void 0);
+__decorate([
+    (0, typeorm_1.TreeParent)(),
+    __metadata("design:type", Object)
+], FileSystemFolder.prototype, "parent", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'uuid', nullable: true }),
+    __metadata("design:type", Object)
+], FileSystemFolder.prototype, "parentId", void 0);
+__decorate([
+    (0, typeorm_1.TreeChildren)(),
+    __metadata("design:type", Array)
+], FileSystemFolder.prototype, "children", void 0);
+__decorate([
+    (0, typeorm_1.OneToMany)(() => file_system_file_entity_1.FileSystemFile, (file) => file.folder),
+    __metadata("design:type", Array)
+], FileSystemFolder.prototype, "files", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'boolean', default: false }),
+    __metadata("design:type", Boolean)
+], FileSystemFolder.prototype, "isRoot", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'uuid', nullable: true }),
+    __metadata("design:type", Object)
+], FileSystemFolder.prototype, "ownerId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'jsonb', nullable: true, default: {} }),
+    __metadata("design:type", Object)
+], FileSystemFolder.prototype, "metadata", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)({ name: 'createdAt', type: 'timestamptz' }),
+    __metadata("design:type", Date)
+], FileSystemFolder.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)({ name: 'updatedAt', type: 'timestamptz' }),
+    __metadata("design:type", Date)
+], FileSystemFolder.prototype, "updatedAt", void 0);
+exports.FileSystemFolder = FileSystemFolder = __decorate([
+    (0, typeorm_1.Entity)(constants_1.FILE_SYSTEM_ENTITY_TABLES.FOLDER),
+    (0, typeorm_1.Tree)('closure-table', {
+        closureTableName: constants_1.FILE_SYSTEM_ENTITY_TABLES.FOLDER_CLOSURE,
+        ancestorColumnName: (c) => 'ancestor_' + c.propertyName,
+        descendantColumnName: (c) => 'descendant_' + c.propertyName,
+    })
+], FileSystemFolder);
+//# sourceMappingURL=file-system-folder.entity.js.map

package/dist/entities/file-system-folder.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-folder.entity.js","sourceRoot":"","sources":["../../src/entities/file-system-folder.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAUiB;AAEjB,4CAAuF;AACvF,uEAA2D;AAQpD,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAE3B,EAAE,CAAS;IAGX,IAAI,CAAS;IAGb,WAAW,CAAgB;IAG3B,IAAI,CAAgB;IAGpB,MAAM,CAA0B;IAGhC,QAAQ,CAAgB;IAGxB,QAAQ,CAAqB;IAG7B,KAAK,CAAmB;IAGxB,MAAM,CAAU;IAGhB,OAAO,CAAgB;IAGvB,QAAQ,CAA0B;IAGlC,SAAS,CAAO;IAGhB,SAAS,CAAO;CACjB,CAAA;AAvCY,4CAAgB;AAE3B;IADC,IAAA,gCAAsB,EAAC,MAAM,CAAC;;4CACpB;AAGX;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;8CAC5B;AAGb;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDACd;AAG3B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACrC;AAGpB;IADC,IAAA,oBAAU,GAAE;;gDACmB;AAGhC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACjB;AAGxB;IADC,IAAA,sBAAY,GAAE;;kDACc;AAG7B;IADC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,wCAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;;+CAC/B;AAGxB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;;gDAC5B;AAGhB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDAClB;AAGvB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;;kDACrB;AAGlC;IADC,IAAA,0BAAgB,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;8BAClD,IAAI;mDAAC;AAGhB;IADC,IAAA,0BAAgB,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;8BAClD,IAAI;mDAAC;2BAtCL,gBAAgB;IAN5B,IAAA,gBAAM,EAAC,qCAAyB,CAAC,MAAM,CAAC;IACxC,IAAA,cAAI,EAAC,eAAe,EAAE;QACrB,gBAAgB,EAAE,qCAAyB,CAAC,cAAc;QAC1D,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,GAAG,CAAC,CAAC,YAAY;QACvD,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,CAAC,CAAC,YAAY;KAC5D,CAAC;GACW,gBAAgB,CAuC5B"}

package/dist/errors/file-system-not-found.error.d.ts

@@ -0,0 +1,6 @@
+import { FileSystemError } from './file-system.error';
+/** Object or path not found (e.g. 404). */
+export declare class FileSystemNotFoundError extends FileSystemError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=file-system-not-found.error.d.ts.map

package/dist/errors/file-system-not-found.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-not-found.error.d.ts","sourceRoot":"","sources":["../../src/errors/file-system-not-found.error.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,2CAA2C;AAC3C,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,OAAO,CAAC,EAAE,MAAM;CAM7B"}

package/dist/errors/file-system-not-found.error.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemNotFoundError = void 0;
+const file_system_error_constant_1 = require("../constants/file-system-error.constant");
+const file_system_error_constant_2 = require("../constants/file-system-error.constant");
+const file_system_error_1 = require("./file-system.error");
+/** Object or path not found (e.g. 404). */
+class FileSystemNotFoundError extends file_system_error_1.FileSystemError {
+    constructor(message) {
+        const msg = message ?? file_system_error_constant_1.FILE_SYSTEM_ERROR_MESSAGES.RESOURCE_NOT_FOUND;
+        super(msg, file_system_error_constant_1.FileSystemErrorCode.NOT_FOUND);
+        this.name = file_system_error_constant_2.FILE_SYSTEM_ERROR_NAMES.NOT_FOUND;
+        Object.setPrototypeOf(this, FileSystemNotFoundError.prototype);
+    }
+}
+exports.FileSystemNotFoundError = FileSystemNotFoundError;
+//# sourceMappingURL=file-system-not-found.error.js.map

package/dist/errors/file-system-not-found.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-not-found.error.js","sourceRoot":"","sources":["../../src/errors/file-system-not-found.error.ts"],"names":[],"mappings":";;;AAAA,wFAGiD;AACjD,wFAAkF;AAClF,2DAAsD;AAEtD,2CAA2C;AAC3C,MAAa,uBAAwB,SAAQ,mCAAe;IAC1D,YAAY,OAAgB;QAC1B,MAAM,GAAG,GAAG,OAAO,IAAI,uDAA0B,CAAC,kBAAkB,CAAC;QACrE,KAAK,CAAC,GAAG,EAAE,gDAAmB,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,oDAAuB,CAAC,SAAS,CAAC;QAC9C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF;AAPD,0DAOC"}

package/dist/errors/file-system-not-supported.error.d.ts

@@ -0,0 +1,6 @@
+import { FileSystemError } from './file-system.error';
+/** Operation not supported by the current provider. */
+export declare class FileSystemNotSupportedError extends FileSystemError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=file-system-not-supported.error.d.ts.map

package/dist/errors/file-system-not-supported.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-not-supported.error.d.ts","sourceRoot":"","sources":["../../src/errors/file-system-not-supported.error.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,uDAAuD;AACvD,qBAAa,2BAA4B,SAAQ,eAAe;gBAClD,OAAO,CAAC,EAAE,MAAM;CAM7B"}

package/dist/errors/file-system-not-supported.error.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemNotSupportedError = void 0;
+const file_system_error_constant_1 = require("../constants/file-system-error.constant");
+const file_system_error_constant_2 = require("../constants/file-system-error.constant");
+const file_system_error_1 = require("./file-system.error");
+/** Operation not supported by the current provider. */
+class FileSystemNotSupportedError extends file_system_error_1.FileSystemError {
+    constructor(message) {
+        const msg = message ?? file_system_error_constant_1.FILE_SYSTEM_ERROR_MESSAGES.NOT_SUPPORTED;
+        super(msg, file_system_error_constant_1.FileSystemErrorCode.NOT_SUPPORTED);
+        this.name = file_system_error_constant_2.FILE_SYSTEM_ERROR_NAMES.NOT_SUPPORTED;
+        Object.setPrototypeOf(this, FileSystemNotSupportedError.prototype);
+    }
+}
+exports.FileSystemNotSupportedError = FileSystemNotSupportedError;
+//# sourceMappingURL=file-system-not-supported.error.js.map

package/dist/errors/file-system-not-supported.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-not-supported.error.js","sourceRoot":"","sources":["../../src/errors/file-system-not-supported.error.ts"],"names":[],"mappings":";;;AAAA,wFAGiD;AACjD,wFAAkF;AAClF,2DAAsD;AAEtD,uDAAuD;AACvD,MAAa,2BAA4B,SAAQ,mCAAe;IAC9D,YAAY,OAAgB;QAC1B,MAAM,GAAG,GAAG,OAAO,IAAI,uDAA0B,CAAC,aAAa,CAAC;QAChE,KAAK,CAAC,GAAG,EAAE,gDAAmB,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,oDAAuB,CAAC,aAAa,CAAC;QAClD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC;CACF;AAPD,kEAOC"}

package/dist/errors/file-system-permission-denied.error.d.ts

@@ -0,0 +1,6 @@
+import { FileSystemError } from './file-system.error';
+/** Permission denied or access forbidden. */
+export declare class FileSystemPermissionDeniedError extends FileSystemError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=file-system-permission-denied.error.d.ts.map

package/dist/errors/file-system-permission-denied.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-permission-denied.error.d.ts","sourceRoot":"","sources":["../../src/errors/file-system-permission-denied.error.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,6CAA6C;AAC7C,qBAAa,+BAAgC,SAAQ,eAAe;gBACtD,OAAO,CAAC,EAAE,MAAM;CAM7B"}

package/dist/errors/file-system-permission-denied.error.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemPermissionDeniedError = void 0;
+const file_system_error_constant_1 = require("../constants/file-system-error.constant");
+const file_system_error_constant_2 = require("../constants/file-system-error.constant");
+const file_system_error_1 = require("./file-system.error");
+/** Permission denied or access forbidden. */
+class FileSystemPermissionDeniedError extends file_system_error_1.FileSystemError {
+    constructor(message) {
+        const msg = message ?? file_system_error_constant_1.FILE_SYSTEM_ERROR_MESSAGES.PERMISSION_DENIED;
+        super(msg, file_system_error_constant_1.FileSystemErrorCode.PERMISSION_DENIED);
+        this.name = file_system_error_constant_2.FILE_SYSTEM_ERROR_NAMES.PERMISSION_DENIED;
+        Object.setPrototypeOf(this, FileSystemPermissionDeniedError.prototype);
+    }
+}
+exports.FileSystemPermissionDeniedError = FileSystemPermissionDeniedError;
+//# sourceMappingURL=file-system-permission-denied.error.js.map

package/dist/errors/file-system-permission-denied.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-permission-denied.error.js","sourceRoot":"","sources":["../../src/errors/file-system-permission-denied.error.ts"],"names":[],"mappings":";;;AAAA,wFAGiD;AACjD,wFAAkF;AAClF,2DAAsD;AAEtD,6CAA6C;AAC7C,MAAa,+BAAgC,SAAQ,mCAAe;IAClE,YAAY,OAAgB;QAC1B,MAAM,GAAG,GAAG,OAAO,IAAI,uDAA0B,CAAC,iBAAiB,CAAC;QACpE,KAAK,CAAC,GAAG,EAAE,gDAAmB,CAAC,iBAAiB,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,oDAAuB,CAAC,iBAAiB,CAAC;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,+BAA+B,CAAC,SAAS,CAAC,CAAC;IACzE,CAAC;CACF;AAPD,0EAOC"}

package/dist/errors/file-system-rate-limit.error.d.ts

@@ -0,0 +1,6 @@
+import { FileSystemError } from './file-system.error';
+/** Rate limit exceeded. */
+export declare class FileSystemRateLimitError extends FileSystemError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=file-system-rate-limit.error.d.ts.map

package/dist/errors/file-system-rate-limit.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-rate-limit.error.d.ts","sourceRoot":"","sources":["../../src/errors/file-system-rate-limit.error.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,2BAA2B;AAC3B,qBAAa,wBAAyB,SAAQ,eAAe;gBAC/C,OAAO,CAAC,EAAE,MAAM;CAM7B"}

package/dist/errors/file-system-rate-limit.error.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemRateLimitError = void 0;
+const file_system_error_constant_1 = require("../constants/file-system-error.constant");
+const file_system_error_constant_2 = require("../constants/file-system-error.constant");
+const file_system_error_1 = require("./file-system.error");
+/** Rate limit exceeded. */
+class FileSystemRateLimitError extends file_system_error_1.FileSystemError {
+    constructor(message) {
+        const msg = message ?? file_system_error_constant_1.FILE_SYSTEM_ERROR_MESSAGES.RATE_LIMIT_EXCEEDED;
+        super(msg, file_system_error_constant_1.FileSystemErrorCode.RATE_LIMIT);
+        this.name = file_system_error_constant_2.FILE_SYSTEM_ERROR_NAMES.RATE_LIMIT;
+        Object.setPrototypeOf(this, FileSystemRateLimitError.prototype);
+    }
+}
+exports.FileSystemRateLimitError = FileSystemRateLimitError;
+//# sourceMappingURL=file-system-rate-limit.error.js.map

package/dist/errors/file-system-rate-limit.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-rate-limit.error.js","sourceRoot":"","sources":["../../src/errors/file-system-rate-limit.error.ts"],"names":[],"mappings":";;;AAAA,wFAGiD;AACjD,wFAAkF;AAClF,2DAAsD;AAEtD,2BAA2B;AAC3B,MAAa,wBAAyB,SAAQ,mCAAe;IAC3D,YAAY,OAAgB;QAC1B,MAAM,GAAG,GAAG,OAAO,IAAI,uDAA0B,CAAC,mBAAmB,CAAC;QACtE,KAAK,CAAC,GAAG,EAAE,gDAAmB,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,oDAAuB,CAAC,UAAU,CAAC;QAC/C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;CACF;AAPD,4DAOC"}

package/dist/errors/file-system.error.d.ts

@@ -0,0 +1,10 @@
+import { FileSystemErrorCode } from '../constants/file-system-error.constant';
+/**
+ * Base domain error for the file-system module.
+ * Provider-specific errors should be mapped to subclasses so consumers can handle them uniformly.
+ */
+export declare class FileSystemError extends Error {
+    readonly code: FileSystemErrorCode | string;
+    constructor(message: string, code: FileSystemErrorCode | string);
+}
+//# sourceMappingURL=file-system.error.d.ts.map

package/dist/errors/file-system.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.error.d.ts","sourceRoot":"","sources":["../../src/errors/file-system.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAG9E;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,IAAI,EAAE,mBAAmB,GAAG,MAAM;gBADlD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,mBAAmB,GAAG,MAAM;CAMrD"}

package/dist/errors/file-system.error.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemError = void 0;
+const file_system_error_constant_1 = require("../constants/file-system-error.constant");
+/**
+ * Base domain error for the file-system module.
+ * Provider-specific errors should be mapped to subclasses so consumers can handle them uniformly.
+ */
+class FileSystemError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = file_system_error_constant_1.FILE_SYSTEM_ERROR_NAMES.BASE;
+        Object.setPrototypeOf(this, FileSystemError.prototype);
+    }
+}
+exports.FileSystemError = FileSystemError;
+//# sourceMappingURL=file-system.error.js.map

package/dist/errors/file-system.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.error.js","sourceRoot":"","sources":["../../src/errors/file-system.error.ts"],"names":[],"mappings":";;;AACA,wFAAkF;AAElF;;;GAGG;AACH,MAAa,eAAgB,SAAQ,KAAK;IAGtB;IAFlB,YACE,OAAe,EACC,IAAkC;QAElD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAA8B;QAGlD,IAAI,CAAC,IAAI,GAAG,oDAAuB,CAAC,IAAI,CAAC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AATD,0CASC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,6 @@
+export { FileSystemError } from './file-system.error';
+export { FileSystemNotFoundError } from './file-system-not-found.error';
+export { FileSystemPermissionDeniedError } from './file-system-permission-denied.error';
+export { FileSystemRateLimitError } from './file-system-rate-limit.error';
+export { FileSystemNotSupportedError } from './file-system-not-supported.error';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemNotSupportedError = exports.FileSystemRateLimitError = exports.FileSystemPermissionDeniedError = exports.FileSystemNotFoundError = exports.FileSystemError = void 0;
+var file_system_error_1 = require("./file-system.error");
+Object.defineProperty(exports, "FileSystemError", { enumerable: true, get: function () { return file_system_error_1.FileSystemError; } });
+var file_system_not_found_error_1 = require("./file-system-not-found.error");
+Object.defineProperty(exports, "FileSystemNotFoundError", { enumerable: true, get: function () { return file_system_not_found_error_1.FileSystemNotFoundError; } });
+var file_system_permission_denied_error_1 = require("./file-system-permission-denied.error");
+Object.defineProperty(exports, "FileSystemPermissionDeniedError", { enumerable: true, get: function () { return file_system_permission_denied_error_1.FileSystemPermissionDeniedError; } });
+var file_system_rate_limit_error_1 = require("./file-system-rate-limit.error");
+Object.defineProperty(exports, "FileSystemRateLimitError", { enumerable: true, get: function () { return file_system_rate_limit_error_1.FileSystemRateLimitError; } });
+var file_system_not_supported_error_1 = require("./file-system-not-supported.error");
+Object.defineProperty(exports, "FileSystemNotSupportedError", { enumerable: true, get: function () { return file_system_not_supported_error_1.FileSystemNotSupportedError; } });
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AACxB,6EAAwE;AAA/D,sIAAA,uBAAuB,OAAA;AAChC,6FAAwF;AAA/E,sJAAA,+BAA+B,OAAA;AACxC,+EAA0E;AAAjE,wIAAA,wBAAwB,OAAA;AACjC,qFAAgF;AAAvE,8IAAA,2BAA2B,OAAA"}

package/dist/file-system.module.d.ts

@@ -0,0 +1,10 @@
+import { DynamicModule } from '@nestjs/common';
+export declare class FileSystemModule {
+    /**
+     * Register the file system module. Provider and bucket name are read from
+     * Settings (FILE-SYSTEM / GENERAL / PROVIDER and FILE-SYSTEM / BACKBLAZE / BUCKET_NAME).
+     * Credentials continue to come from the Backblaze package configuration.
+     */
+    static forRoot(): DynamicModule;
+}
+//# sourceMappingURL=file-system.module.d.ts.map

package/dist/file-system.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.module.d.ts","sourceRoot":"","sources":["../src/file-system.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAgBvD,qBACa,gBAAgB;IAC3B;;;;OAIG;IACH,MAAM,CAAC,OAAO,IAAI,aAAa;CA+ChC"}

package/dist/file-system.module.js

@@ -0,0 +1,68 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var FileSystemModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemModule = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const core_1 = require("@venturialstd/core");
+const backblaze_1 = require("@venturialstd/backblaze");
+const constants_1 = require("./constants");
+const file_system_settings_constants_1 = require("./constants/file-system.settings.constants");
+const file_system_file_entity_1 = require("./entities/file-system-file.entity");
+const file_system_folder_entity_1 = require("./entities/file-system-folder.entity");
+const backblaze_file_system_provider_1 = require("./providers/backblaze-file-system.provider");
+const file_system_service_1 = require("./services/file-system.service");
+let FileSystemModule = FileSystemModule_1 = class FileSystemModule {
+    /**
+     * Register the file system module. Provider and bucket name are read from
+     * Settings (FILE-SYSTEM / GENERAL / PROVIDER and FILE-SYSTEM / BACKBLAZE / BUCKET_NAME).
+     * Credentials continue to come from the Backblaze package configuration.
+     */
+    static forRoot() {
+        return {
+            module: FileSystemModule_1,
+            imports: [
+                core_1.SettingsModule,
+                backblaze_1.BackblazeModule,
+                typeorm_1.TypeOrmModule.forFeature([file_system_file_entity_1.FileSystemFile, file_system_folder_entity_1.FileSystemFolder]),
+            ],
+            providers: [
+                {
+                    provide: backblaze_file_system_provider_1.BackblazeFileSystemProvider,
+                    useFactory: async (settingsService, objectService) => {
+                        const provider = await settingsService.get(file_system_settings_constants_1.FILE_SYSTEM_SETTING_KEYS.GENERAL_PROVIDER);
+                        const bucketName = await settingsService.get(file_system_settings_constants_1.FILE_SYSTEM_SETTING_KEYS.BACKBLAZE_BUCKET_NAME);
+                        if (provider !== constants_1.FileSystemProviderName.BACKBLAZE) {
+                            throw new Error(constants_1.FILE_SYSTEM_MESSAGES.UNSUPPORTED_PROVIDER(provider ?? ''));
+                        }
+                        if (!bucketName?.trim()) {
+                            throw new Error(constants_1.FILE_SYSTEM_MESSAGES.BUCKET_NAME_NOT_CONFIGURED);
+                        }
+                        const options = {
+                            bucketName: bucketName.trim(),
+                        };
+                        return new backblaze_file_system_provider_1.BackblazeFileSystemProvider(objectService, options);
+                    },
+                    inject: [core_1.SettingsService, backblaze_1.BackblazeObjectService],
+                },
+                {
+                    provide: constants_1.FILE_SYSTEM_DI_TOKENS.PROVIDER,
+                    useExisting: backblaze_file_system_provider_1.BackblazeFileSystemProvider,
+                },
+                file_system_service_1.FileSystemService,
+            ],
+            exports: [file_system_service_1.FileSystemService, constants_1.FILE_SYSTEM_DI_TOKENS.PROVIDER],
+        };
+    }
+};
+exports.FileSystemModule = FileSystemModule;
+exports.FileSystemModule = FileSystemModule = FileSystemModule_1 = __decorate([
+    (0, common_1.Module)({})
+], FileSystemModule);
+//# sourceMappingURL=file-system.module.js.map

package/dist/file-system.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.module.js","sourceRoot":"","sources":["../src/file-system.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,6CAAgD;AAChD,6CAAqE;AACrE,uDAGiC;AAEjC,2CAAkG;AAClG,+FAAsF;AACtF,gFAAoE;AACpE,oFAAwE;AAExE,+FAAyF;AACzF,wEAAmE;AAG5D,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IAC3B;;;;OAIG;IACH,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,kBAAgB;YACxB,OAAO,EAAE;gBACP,qBAAc;gBACd,2BAAe;gBACf,uBAAa,CAAC,UAAU,CAAC,CAAC,wCAAc,EAAE,4CAAgB,CAAC,CAAC;aAC7D;YACD,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,4DAA2B;oBACpC,UAAU,EAAE,KAAK,EACf,eAAgC,EAChC,aAAqC,EACC,EAAE;wBACxC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,CACxC,yDAAwB,CAAC,gBAAgB,CAC1C,CAAC;wBACF,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,GAAG,CAC1C,yDAAwB,CAAC,qBAAqB,CAC/C,CAAC;wBAEF,IAAI,QAAQ,KAAK,kCAAsB,CAAC,SAAS,EAAE,CAAC;4BAClD,MAAM,IAAI,KAAK,CACb,gCAAoB,CAAC,oBAAoB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAC1D,CAAC;wBACJ,CAAC;wBACD,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;4BACxB,MAAM,IAAI,KAAK,CAAC,gCAAoB,CAAC,0BAA0B,CAAC,CAAC;wBACnE,CAAC;wBAED,MAAM,OAAO,GAAuC;4BAClD,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE;yBAC9B,CAAC;wBACF,OAAO,IAAI,4DAA2B,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;oBACjE,CAAC;oBACD,MAAM,EAAE,CAAC,sBAAe,EAAE,kCAAsB,CAAC;iBAClD;gBACD;oBACE,OAAO,EAAE,iCAAqB,CAAC,QAAQ;oBACvC,WAAW,EAAE,4DAA2B;iBACzC;gBACD,uCAAiB;aAClB;YACD,OAAO,EAAE,CAAC,uCAAiB,EAAE,iCAAqB,CAAC,QAAQ,CAAC;SAC7D,CAAC;IACJ,CAAC;CACF,CAAA;AArDY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,gBAAgB,CAqD5B"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './constants';
+export * from './errors';
+export * from './types';
+export * from './interfaces';
+export * from './entities/file-system-file.entity';
+export * from './entities/file-system-folder.entity';
+export * from './file-system.module';
+export * from './providers/backblaze-file-system.provider';
+export * from './services/file-system.service';
+export { FILE_SYSTEM_SETTINGS, SETTINGS, } from './settings/file-system.settings';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EACL,oBAAoB,EACpB,QAAQ,GACT,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETTINGS = exports.FILE_SYSTEM_SETTINGS = void 0;
+__exportStar(require("./constants"), exports);
+__exportStar(require("./errors"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./entities/file-system-file.entity"), exports);
+__exportStar(require("./entities/file-system-folder.entity"), exports);
+__exportStar(require("./file-system.module"), exports);
+__exportStar(require("./providers/backblaze-file-system.provider"), exports);
+__exportStar(require("./services/file-system.service"), exports);
+var file_system_settings_1 = require("./settings/file-system.settings");
+Object.defineProperty(exports, "FILE_SYSTEM_SETTINGS", { enumerable: true, get: function () { return file_system_settings_1.FILE_SYSTEM_SETTINGS; } });
+Object.defineProperty(exports, "SETTINGS", { enumerable: true, get: function () { return file_system_settings_1.SETTINGS; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,2CAAyB;AACzB,0CAAwB;AACxB,+CAA6B;AAC7B,qEAAmD;AACnD,uEAAqD;AACrD,uDAAqC;AACrC,6EAA2D;AAC3D,iEAA+C;AAC/C,wEAGyC;AAFvC,4HAAA,oBAAoB,OAAA;AACpB,gHAAA,QAAQ,OAAA"}

package/dist/interfaces/backblaze-file-system-provider-options.interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Options for BackblazeFileSystemProvider (injected in module).
+ * Only bucketName is supplied; credentials and region are always taken from
+ * the Backblaze package configuration (Settings), never from here or .env.
+ */
+export interface BackblazeFileSystemProviderOptions {
+    bucketName: string;
+}
+//# sourceMappingURL=backblaze-file-system-provider-options.interface.d.ts.map

package/dist/interfaces/backblaze-file-system-provider-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-file-system-provider-options.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/backblaze-file-system-provider-options.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/interfaces/backblaze-file-system-provider-options.interface.js

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

package/dist/interfaces/backblaze-file-system-provider-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-file-system-provider-options.interface.js","sourceRoot":"","sources":["../../src/interfaces/backblaze-file-system-provider-options.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/file-system-backblaze-config.interface.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Backblaze-specific configuration for file-system module.
+ * Credentials and region are never taken here; they are inherited from the
+ * Backblaze package configuration (Settings / app config). Only the bucket name
+ * is required so the file-system knows which bucket to use.
+ */
+export interface FileSystemBackblazeConfig {
+    /** B2 bucket name. Credentials and region come from Backblaze package config. */
+    bucketName: string;
+}
+//# sourceMappingURL=file-system-backblaze-config.interface.d.ts.map

package/dist/interfaces/file-system-backblaze-config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-backblaze-config.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/file-system-backblaze-config.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/interfaces/file-system-backblaze-config.interface.js

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

package/dist/interfaces/file-system-backblaze-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-backblaze-config.interface.js","sourceRoot":"","sources":["../../src/interfaces/file-system-backblaze-config.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/file-system-module-options.interface.d.ts

@@ -0,0 +1,9 @@
+import type { FileSystemBackblazeConfig } from './file-system-backblaze-config.interface';
+import { FileSystemProviderName } from '../constants/file-system-provider.constant';
+/** Options passed to FileSystemModule.forRoot(). */
+export interface FileSystemModuleOptions {
+    /** Currently only FileSystemProviderName.BACKBLAZE ('backblaze') is supported. */
+    provider: FileSystemProviderName | `${FileSystemProviderName}`;
+    backblaze: FileSystemBackblazeConfig;
+}
+//# sourceMappingURL=file-system-module-options.interface.d.ts.map

package/dist/interfaces/file-system-module-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-module-options.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/file-system-module-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEpF,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,QAAQ,EAAE,sBAAsB,GAAG,GAAG,sBAAsB,EAAE,CAAC;IAC/D,SAAS,EAAE,yBAAyB,CAAC;CACtC"}

package/dist/interfaces/file-system-module-options.interface.js

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

package/dist/interfaces/file-system-module-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-module-options.interface.js","sourceRoot":"","sources":["../../src/interfaces/file-system-module-options.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/file-system-provider.interface.d.ts

@@ -0,0 +1,67 @@
+import type { FileMetadata, ListOptions, ListResult, SignedUrlResult, UploadOptions } from '../types';
+/**
+ * Provider-agnostic file storage contract.
+ * All storage providers (Backblaze, AWS S3, etc.) must implement this interface.
+ */
+export interface IFileSystemProvider {
+    /**
+     * Upload content to the given key (path).
+     * @param key - Remote path/key for the object
+     * @param body - Buffer, Uint8Array, or string
+     * @param options - Optional content-type and metadata
+     * @throws FileSystemNotFoundError, FileSystemPermissionDeniedError, FileSystemRateLimitError
+     */
+    upload(key: string, body: Buffer | Uint8Array | string, options?: UploadOptions): Promise<void>;
+    /**
+     * Download content from the given key.
+     * @param key - Remote path/key of the object
+     * @returns ArrayBuffer with the object body
+     * @throws FileSystemNotFoundError, FileSystemPermissionDeniedError
+     */
+    download(key: string): Promise<ArrayBuffer>;
+    /**
+     * Delete a single object by key. For versioned buckets (e.g. Backblaze B2), pass versionId
+     * for permanent deletion.
+     * @param key - Remote path/key of the object
+     * @param options - Optional versionId (use when provider returns it from exists/head)
+     * @throws FileSystemNotFoundError, FileSystemPermissionDeniedError
+     */
+    delete(key: string, options?: {
+        versionId?: string;
+    }): Promise<void>;
+    /**
+     * Delete multiple objects by key. Optional; default implementation may call delete in loop.
+     * @param keys - Array of remote path/keys
+     */
+    deleteMany?(keys: string[]): Promise<void>;
+    /**
+     * List objects under a prefix with optional pagination.
+     * @param prefix - Prefix (path) to list under
+     * @param options - maxKeys, continuationToken, startAfter
+     * @returns ListResult with entries and pagination info
+     */
+    list(prefix: string, options?: ListOptions): Promise<ListResult>;
+    /**
+     * Check if an object exists and optionally return its metadata (head).
+     * @param key - Remote path/key of the object
+     * @returns FileMetadata if exists
+     * @throws FileSystemNotFoundError if not found
+     */
+    exists(key: string): Promise<FileMetadata>;
+    /**
+     * Generate a signed URL for downloading (temporary read access).
+     * Optional: providers that don't support it may throw FileSystemNotSupportedError.
+     * @param key - Remote path/key
+     * @param expiresInSeconds - Optional TTL for the URL
+     */
+    getSignedDownloadUrl?(key: string, expiresInSeconds?: number): Promise<SignedUrlResult>;
+    /**
+     * Generate a signed URL (and optional auth token) for uploading.
+     * Optional: providers that don't support it may throw FileSystemNotSupportedError.
+     * @param key - Remote path/key where the file will be uploaded
+     * @param contentType - Optional content type
+     * @param expiresInSeconds - Optional TTL
+     */
+    getSignedUploadUrl?(key: string, contentType?: string, expiresInSeconds?: number): Promise<SignedUrlResult>;
+}
+//# sourceMappingURL=file-system-provider.interface.d.ts.map