@punks/backend-entity-manager 0.0.121 → 0.0.123

package/dist/esm/types/abstractions/files.d.ts

@@ -0,0 +1,64 @@
+/// <reference types="node" />
+export type FileData = {
+    content: Buffer;
+    contentType: string;
+    fileName: string;
+    folderPath: string;
+    metadata?: Record<string, any>;
+};
+export type FileDownloadUrl = {
+    downloadUrl: string;
+    contentType: string;
+    fileName: string;
+};
+export type FileReference = {
+    fileId: string;
+    reference: string;
+    providerId: string;
+};
+export interface IFileManager {
+    uploadFile(file: FileData): Promise<FileReference>;
+    getFileContent(fileId: string): Promise<FileData>;
+    getFileDownloadUrl(fileId: string): Promise<FileDownloadUrl>;
+}
+export type FilesReferenceData = {
+    reference: string;
+    providerId: string;
+    metadata?: Record<string, any>;
+    fileName: string;
+    filePath: string;
+    fileSize: number;
+    contentType: string;
+};
+export type FileReferenceRecord = FilesReferenceData & {
+    fileId: string;
+    createdOn: Date;
+    updatedOn: Date;
+};
+export interface IFilesReferenceRepository {
+    getReference(fileId: string): Promise<FileReferenceRecord>;
+    createReference(file: FilesReferenceData): Promise<FileReferenceRecord>;
+    updateReference(fileId: string, file: FilesReferenceData): Promise<FileReferenceRecord>;
+    deleteReference(fileId: string): Promise<void>;
+}
+export type FileProviderReference = {
+    reference: string;
+};
+export type FileProviderUploadData = {
+    fileName: string;
+    content: Buffer;
+    contentType: string;
+};
+export type FileProviderDownloadData = {
+    content: Buffer;
+};
+export type FileProviderDownloadUrl = {
+    downloadUrl: string;
+};
+export interface IFileProvider {
+    getProviderId(): string;
+    uploadFile(file: FileProviderUploadData): Promise<FileProviderReference>;
+    deleteFile(reference: FileProviderReference): Promise<void>;
+    downloadFile(reference: FileProviderReference): Promise<FileProviderDownloadData>;
+    getFileProviderDownloadUrl(reference: FileProviderReference): Promise<FileProviderDownloadUrl>;
+}

package/dist/esm/types/abstractions/index.d.ts

@@ -11,6 +11,7 @@ export * from "./email";
 export * from "./errors";
 export { IEntityEventsManager } from "./events";
 export { EntitiesExportFile, EntitiesExportInput, EntitiesExportOptions, EntitiesExportResult, EntitiesImportExportSettings, EntitiesSampleDownloadOptions, EntitiesSampleDownloadResult, EntityExportBucketSettings, } from "./export";
+export * from "./files";
 export * from "./filters";
 export { EntitiesImportInput, EntitiesImportResult, EntitiesImportStatistics, } from "./import";
 export * from "./localization";

package/dist/esm/types/abstractions/settings.d.ts

@@ -1,7 +1,8 @@
 import { EntitiesImportExportSettings } from "./export";
 export type EntityManagerSettings = {
     importExport: EntitiesImportExportSettings;
-    defaultBuckerProvider: string;
+    defaultBucketProvider: string;
+    defaultFilesProvider: string;
 };
 export type EntityVersioningOptions = {
     enabled: boolean;

package/dist/esm/types/platforms/nest/__test__/server/database/core/entities/appFileReference.entity.d.ts

@@ -0,0 +1,13 @@
+export type AppFileReferenceEntityId = string;
+export declare class AppFileReferenceEntity {
+    id: string;
+    reference: string;
+    provider: string;
+    folder: string;
+    fileName: string;
+    contentType: string;
+    fileSize: number;
+    metadata?: any;
+    createdOn: Date;
+    updatedOn: Date;
+}

package/dist/esm/types/platforms/nest/__test__/server/database/core/index.d.ts

@@ -14,6 +14,7 @@ import { DynamicModule } from "@nestjs/common";
 import { AppEntityVersionEntity } from "./entities/appEntityVersion.entity";
 import { AppDirectoryEntity } from "./entities/appDirectory.entity";
 import { CrmContactEntity } from "./entities/crmContact.entity";
+import { AppFileReferenceEntity } from "./entities/appFileReference.entity";
 export declare const mockDatabaseProviders: (dataSource: DataSource) => ({
     provide: string | Function;
     useValue: import("typeorm").Repository<AppCompanyEntity>;
@@ -26,6 +27,9 @@ export declare const mockDatabaseProviders: (dataSource: DataSource) => ({
 } | {
     provide: string | Function;
     useValue: import("typeorm").Repository<AppEntityVersionEntity>;
+} | {
+    provide: string | Function;
+    useValue: import("typeorm").Repository<AppFileReferenceEntity>;
 } | {
     provide: string | Function;
     useValue: import("typeorm").Repository<FooEntity>;

package/dist/esm/types/platforms/nest/__test__/server/database/core/repositories/appFileReference.repository.d.ts

@@ -0,0 +1,11 @@
+import { Repository } from "typeorm";
+import { NestTypeOrmRepository } from "../../../../..";
+import { AppFileReferenceEntity, AppFileReferenceEntityId } from "../entities/appFileReference.entity";
+import { FileReferenceRecord, FilesReferenceData, IFilesReferenceRepository } from "../../../../../../../abstractions";
+export declare class AppFileReferenceRepository extends NestTypeOrmRepository<AppFileReferenceEntity, AppFileReferenceEntityId> implements IFilesReferenceRepository {
+    constructor(repository: Repository<AppFileReferenceEntity>);
+    getReference(fileId: string): Promise<FileReferenceRecord>;
+    createReference(file: FilesReferenceData): Promise<FileReferenceRecord>;
+    updateReference(fileId: string, file: FilesReferenceData): Promise<FileReferenceRecord>;
+    deleteReference(fileId: string): Promise<void>;
+}

package/dist/esm/types/platforms/nest/__test__/server/database/core/repositories.d.ts

@@ -2,6 +2,7 @@ import { AppCompanyRepository } from "./repositories/appCompany.repository";
 import { AppDirectoryRepository } from "./repositories/appDirectory.repository";
 import { AppDivisionRepository } from "./repositories/appDivision.repository";
 import { AppEntityVersionRepository } from "./repositories/appEntityVersion.repository";
+import { AppFileReferenceRepository } from "./repositories/appFileReference.repository";
 import { AppOrganizationRepository } from "./repositories/appOrganization.repository";
 import { AppRoleRepository } from "./repositories/appRole.repository";
 import { AppTenantRepository } from "./repositories/appTenant.repository";
@@ -12,4 +13,4 @@ import { AppUserProfileRepository } from "./repositories/appUserProfile.reposito
 import { AppUserRoleRepository } from "./repositories/appUserRole.repository";
 import { CrmContactRepository } from "./repositories/crmContact.repository";
 import { FooRepository } from "./repositories/foo.repository";
-export declare const CoreDatabaseRepositories: (typeof AppCompanyRepository | typeof AppDirectoryRepository | typeof AppDivisionRepository | typeof AppEntityVersionRepository | typeof AppOrganizationRepository | typeof AppRoleRepository | typeof AppTenantRepository | typeof AppUserRepository | typeof AppUserGroupRepository | typeof AppUserGroupMemberRepository | typeof AppUserProfileRepository | typeof AppUserRoleRepository | typeof CrmContactRepository | typeof FooRepository)[];
+export declare const CoreDatabaseRepositories: (typeof AppCompanyRepository | typeof AppDirectoryRepository | typeof AppDivisionRepository | typeof AppEntityVersionRepository | typeof AppFileReferenceRepository | typeof AppOrganizationRepository | typeof AppRoleRepository | typeof AppTenantRepository | typeof AppUserRepository | typeof AppUserGroupRepository | typeof AppUserGroupMemberRepository | typeof AppUserProfileRepository | typeof AppUserRoleRepository | typeof CrmContactRepository | typeof FooRepository)[];

package/dist/esm/types/platforms/nest/decorators/files.d.ts

@@ -0,0 +1,7 @@
+export interface FileProviderProps {
+    providerId: string;
+}
+export declare const WpFileProvider: (providerId: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol | undefined, descriptor?: TypedPropertyDescriptor<Y> | undefined) => void;
+export interface FileReferenceRepositoryProps {
+}
+export declare const WpFileReferenceRepository: () => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol | undefined, descriptor?: TypedPropertyDescriptor<Y> | undefined) => void;

package/dist/esm/types/platforms/nest/decorators/index.d.ts

@@ -6,6 +6,7 @@ export { WpEntityConnector, EntityConnectorProps } from "./connector";
 export { WpEntityConverter, EntityConverterProps } from "./converter";
 export { WpEmailTemplate, EmailTemplateProps } from "./email";
 export { WpEntity, EntityProps } from "./entity";
+export { WpFileProvider, FileProviderProps, WpFileReferenceRepository, FileReferenceRepositoryProps, } from "./files";
 export { WpAppInitializer } from "./initializer";
 export { WpEntityRepository, EntityRepositoryProps } from "./repository";
 export { WpEntityManager, EntityManagerProps } from "./manager";

package/dist/esm/types/platforms/nest/decorators/symbols.d.ts

@@ -16,5 +16,7 @@ export declare const EntityManagerSymbols: {
     EmailProvider: symbol;
     EmailTemplate: symbol;
     BucketProvider: symbol;
+    FileProvider: symbol;
+    FileReferenceRepository: symbol;
     PipelineTemplate: symbol;
 };

package/dist/esm/types/platforms/nest/plugins/buckets/aws-s3/index.d.ts

@@ -1,4 +1,4 @@
 export { AwsS3BucketError as AwsS2BucketError } from "./errors";
 export { AwsBucketModule } from "./module";
-export { AwsS3BucketProvider } from "./provider";
+export { AwsS3BucketProvider } from "./provider/bucket";
 export { AwsBucketSettings } from "./settings";

package/dist/esm/types/platforms/nest/plugins/buckets/aws-s3/provider/bucket.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="node" />
+import { BucketFileDeleteInput, BucketFileDownloadInput, BucketFilePublicUrlCreateInput, BucketFileUploadInput, BucketFolderEnsureInput, BucketFolderExistsInput, BucketFolderListInput, BucketFolderListResult, IBucketProvider } from "../../../../../../abstractions/buckets";
+export declare class AwsS3BucketProvider implements IBucketProvider {
+    private readonly client;
+    constructor();
+    folderList(input: BucketFolderListInput): Promise<BucketFolderListResult>;
+    folderEnsure(input: BucketFolderEnsureInput): Promise<void>;
+    folderCreate(input: BucketFolderEnsureInput): Promise<void>;
+    folderExists(input: BucketFolderExistsInput): Promise<boolean>;
+    fileDownload(input: BucketFileDownloadInput): Promise<Buffer>;
+    filePublicUrlCreate(input: BucketFilePublicUrlCreateInput): Promise<string>;
+    fileUpload(input: BucketFileUploadInput): Promise<void>;
+    fileDelete(input: BucketFileDeleteInput): Promise<void>;
+}

package/dist/esm/types/platforms/nest/plugins/buckets/aws-s3/provider/files.d.ts

@@ -0,0 +1,12 @@
+import { FileProviderDownloadData, FileProviderDownloadUrl, FileProviderReference, FileProviderUploadData, IFileProvider } from "../../../../../../abstractions";
+import { AwsS3BucketProvider } from "./bucket";
+export declare class AwsS3FileProvider implements IFileProvider {
+    private readonly bucket;
+    constructor(bucket: AwsS3BucketProvider);
+    getProviderId(): string;
+    uploadFile(file: FileProviderUploadData): Promise<FileProviderReference>;
+    deleteFile(reference: FileProviderReference): Promise<void>;
+    downloadFile(reference: FileProviderReference): Promise<FileProviderDownloadData>;
+    getFileProviderDownloadUrl(reference: FileProviderReference): Promise<FileProviderDownloadUrl>;
+    private getBucketFileUploadPath;
+}

package/dist/esm/types/platforms/nest/plugins/buckets/aws-s3/provider/index.d.ts

@@ -1,14 +1,2 @@
-/// <reference types="node" />
-import { BucketFileDeleteInput, BucketFileDownloadInput, BucketFilePublicUrlCreateInput, BucketFileUploadInput, BucketFolderEnsureInput, BucketFolderExistsInput, BucketFolderListInput, BucketFolderListResult, IBucketProvider } from "../../../../../../abstractions/buckets";
-export declare class AwsS3BucketProvider implements IBucketProvider {
-    private readonly client;
-    constructor();
-    folderList(input: BucketFolderListInput): Promise<BucketFolderListResult>;
-    folderEnsure(input: BucketFolderEnsureInput): Promise<void>;
-    folderCreate(input: BucketFolderEnsureInput): Promise<void>;
-    folderExists(input: BucketFolderExistsInput): Promise<boolean>;
-    fileDownload(input: BucketFileDownloadInput): Promise<Buffer>;
-    filePublicUrlCreate(input: BucketFilePublicUrlCreateInput): Promise<string>;
-    fileUpload(input: BucketFileUploadInput): Promise<void>;
-    fileDelete(input: BucketFileDeleteInput): Promise<void>;
-}
+export { AwsS3BucketProvider } from "./bucket";
+export { AwsS3FileProvider } from "./files";

package/dist/esm/types/platforms/nest/plugins/buckets/aws-s3/settings/index.d.ts

@@ -1,8 +1,13 @@
 import { AppInMemorySettings } from "../../../../../../settings";
+export type AwsBucketPaths = {
+    filesUpload: string;
+};
 export type AwsBucketSettings = {
     awsAccessKeyId?: string;
     awsSecretAccessKey?: string;
     region?: string;
     defaultBucket: string;
+    publicLinksExpirationMinutes: number;
+    paths: AwsBucketPaths;
 };
 export declare const awsBucketSettings: AppInMemorySettings<AwsBucketSettings>;

package/dist/esm/types/platforms/nest/plugins/buckets/testing/mock.d.ts

@@ -1,5 +1,15 @@
 /// <reference types="node" />
+import { FileProviderDownloadData, FileProviderDownloadUrl, FileProviderReference, FileProviderUploadData, IFileProvider } from "../../../../../abstractions";
 import { BucketFileDeleteInput, BucketFileDownloadInput, BucketFilePublicUrlCreateInput, BucketFileUploadInput, BucketFolderEnsureInput, BucketFolderExistsInput, BucketFolderListInput, BucketFolderListResult, IBucketProvider } from "../../../../../abstractions/buckets";
+export declare class InMemoryFileProvider implements IFileProvider {
+    private readonly provider;
+    constructor();
+    getProviderId(): string;
+    uploadFile(file: FileProviderUploadData): Promise<FileProviderReference>;
+    deleteFile(reference: FileProviderReference): Promise<void>;
+    downloadFile(reference: FileProviderReference): Promise<FileProviderDownloadData>;
+    getFileProviderDownloadUrl(reference: FileProviderReference): Promise<FileProviderDownloadUrl>;
+}
 export declare class InMemoryBucketProvider implements IBucketProvider {
     private inMemoryStorage;
     private inMemoryFolders;

package/dist/esm/types/platforms/nest/processors/initializer/index.d.ts

@@ -20,7 +20,9 @@ export declare class EntityManagerInitializer {
     private registerEntities;
     private executeInitializers;
     private executeSeeders;
+    private registerFileProviders;
     private registerBucketProviders;
+    private registerFilesReferenceRepositoryProviders;
     private registerEventTrackingProviders;
     private registerVersioningProviders;
     private registerEmailProviders;
@@ -41,4 +43,6 @@ export declare class EntityManagerInitializer {
     private discoverEmailProviders;
     private discoverEventTrackingProviders;
     private discoverBucketProviders;
+    private discoverFileProviders;
+    private discoverFilesReferenceRepositoryProviders;
 }

package/dist/esm/types/platforms/nest/services/files/index.d.ts

@@ -0,0 +1,12 @@
+import { FileData, FileDownloadUrl, FileReference, IFileManager } from "../../../../abstractions";
+import { EntityManagerRegistry } from "../../ioc";
+export declare class FilesService implements IFileManager {
+    private readonly registry;
+    constructor(registry: EntityManagerRegistry);
+    uploadFile(file: FileData): Promise<FileReference>;
+    getFileContent(fileId: string): Promise<FileData>;
+    getFileDownloadUrl(fileId: string): Promise<FileDownloadUrl>;
+    private getFileProvider;
+    private get defaultFileProvider();
+    private get referencesRepo();
+}

package/dist/esm/types/platforms/nest/services/index.d.ts

@@ -2,5 +2,6 @@ export { AppSessionService } from "./session";
 export { AppHashingService } from "./hashing";
 export { EntityManagerService } from "./manager";
 export { EmailService } from "./email";
+export { FilesService } from "./files";
 export { EventsService } from "./events";
 export { TrackingService } from "./tracking";

package/dist/esm/types/platforms/nest/services/providers.d.ts

@@ -1,7 +1,8 @@
 import { EmailService } from "./email";
 import { EventsService } from "./events";
+import { FilesService } from "./files";
 import { AppHashingService } from "./hashing";
 import { EntityManagerService } from "./manager";
 import { AppSessionService } from "./session";
 import { TrackingService } from "./tracking";
-export declare const Services: (typeof AppSessionService | typeof AppHashingService | typeof EntityManagerService | typeof EmailService | typeof EventsService | typeof TrackingService)[];
+export declare const Services: (typeof AppSessionService | typeof AppHashingService | typeof EntityManagerService | typeof EmailService | typeof FilesService | typeof EventsService | typeof TrackingService)[];

package/dist/esm/types/providers/services.d.ts

@@ -1,4 +1,4 @@
-import { IAuthenticationContext, IAuthenticationContextProvider, IBucketProvider, IEmailProvider, IEmailTemplatesCollection, IEntityFacets, IEntitySerializer, IEntityVersioningProvider, IEventLog, IEventsTracker } from "../abstractions";
+import { IAuthenticationContext, IAuthenticationContextProvider, IBucketProvider, IEmailProvider, IEmailTemplatesCollection, IEntityFacets, IEntitySerializer, IEntityVersioningProvider, IEventLog, IEventsTracker, IFileProvider, IFilesReferenceRepository } from "../abstractions";
 import { IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntitiesSampleDownloadAction, IEntitiesSearchAction, IEntityActions, IEntityCreateAction, IEntityDeleteAction, IEntityExistsAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction, IEntityVersionsSearchAction } from "../abstractions/actions";
 import { IEntityAdapter } from "../abstractions/adapters";
 import { IEntityAuthorizationMiddleware } from "../abstractions/authorization";
@@ -79,8 +79,13 @@ export declare class EntitiesServiceLocator {
     resolveEntityVersioningProvider<TEntityVersioningProvider extends IEntityVersioningProvider>(): TEntityVersioningProvider;
     registerEntityVersioningProvider<TEntityVersioningProvider extends IEntityVersioningProvider>(instance: TEntityVersioningProvider): void;
     resolveDefaultBucketProvider<TBucketProvider extends IBucketProvider>(): TBucketProvider;
-    resolveBucketProviders<TBucketProvider extends IBucketProvider>(): TBucketProvider[];
-    registerBucketProvider<TBucketProvider extends IBucketProvider>(name: string, instance: TBucketProvider): void;
+    resolveDefaultFilesProvider<TFileProvider extends IFileProvider>(): TFileProvider;
+    resolveBucketProviders<TBucketProvider extends IFileProvider>(): TBucketProvider[];
+    registerBucketProvider<TBucketProvider extends IBucketProvider>(name: string, instance: TBucketProvider): this;
+    resolveFileProvider<TFileProvider extends IFileProvider>(providerId: string): TFileProvider;
+    registerFileProvider<TFileProvider extends IFileProvider>(name: string, instance: TFileProvider): this;
+    resolveFilesReferenceRepositoryProviders<TFilesReferenceRepo extends IFilesReferenceRepository>(): TFilesReferenceRepo;
+    registerFilesReferenceRepositoryProviders<TFilesReferenceRepo extends IFilesReferenceRepository>(instance: TFilesReferenceRepo): void;
     resolveEventsTracker<TEventsTracker extends IEventsTracker<TEventLog>, TEventLog extends IEventLog<unknown>>(): TEventsTracker;
     registerEventsTracker<TEventsTracker extends IEventsTracker<TEventLog>, TEventLog extends IEventLog<unknown>>(instance: TEventsTracker): void;
     resolveEmailTemplatesCollection(): IEmailTemplatesCollection;

package/dist/esm/types/symbols/ioc.d.ts

@@ -67,6 +67,9 @@ export declare const EntityServices: {
     };
 };
 export declare const GlobalServices: {
+    Files: {
+        IFilesReferenceRepo: string;
+    };
     Events: {
         IEventEmitter: string;
         IEventsTracker: string;
@@ -81,6 +84,7 @@ export declare const GlobalServices: {
         IEmailProvider: string;
         IEmailTemplatesCollection: string;
         IBucketProvider: string;
+        IFileProvider: string;
     };
     Settings: {
         EntityManagerSettings: string;

package/dist/index.d.ts

@@ -710,7 +710,8 @@ interface IEntityReplicaSyncManager<TEntity> {
 
 type EntityManagerSettings = {
     importExport: EntitiesImportExportSettings;
-    defaultBuckerProvider: string;
+    defaultBucketProvider: string;
+    defaultFilesProvider: string;
 };
 type EntityVersioningOptions$1 = {
     enabled: boolean;
@@ -784,8 +785,13 @@ declare class EntitiesServiceLocator {
     resolveEntityVersioningProvider<TEntityVersioningProvider extends IEntityVersioningProvider>(): TEntityVersioningProvider;
     registerEntityVersioningProvider<TEntityVersioningProvider extends IEntityVersioningProvider>(instance: TEntityVersioningProvider): void;
     resolveDefaultBucketProvider<TBucketProvider extends IBucketProvider>(): TBucketProvider;
-    resolveBucketProviders<TBucketProvider extends IBucketProvider>(): TBucketProvider[];
-    registerBucketProvider<TBucketProvider extends IBucketProvider>(name: string, instance: TBucketProvider): void;
+    resolveDefaultFilesProvider<TFileProvider extends IFileProvider>(): TFileProvider;
+    resolveBucketProviders<TBucketProvider extends IFileProvider>(): TBucketProvider[];
+    registerBucketProvider<TBucketProvider extends IBucketProvider>(name: string, instance: TBucketProvider): this;
+    resolveFileProvider<TFileProvider extends IFileProvider>(providerId: string): TFileProvider;
+    registerFileProvider<TFileProvider extends IFileProvider>(name: string, instance: TFileProvider): this;
+    resolveFilesReferenceRepositoryProviders<TFilesReferenceRepo extends IFilesReferenceRepository>(): TFilesReferenceRepo;
+    registerFilesReferenceRepositoryProviders<TFilesReferenceRepo extends IFilesReferenceRepository>(instance: TFilesReferenceRepo): void;
     resolveEventsTracker<TEventsTracker extends IEventsTracker<TEventLog>, TEventLog extends IEventLog<unknown>>(): TEventsTracker;
     registerEventsTracker<TEventsTracker extends IEventsTracker<TEventLog>, TEventLog extends IEventLog<unknown>>(instance: TEventsTracker): void;
     resolveEmailTemplatesCollection(): IEmailTemplatesCollection;
@@ -983,6 +989,70 @@ declare class MissingEntityIdError extends EntityManagerException {
     constructor();
 }
 
+type FileData = {
+    content: Buffer;
+    contentType: string;
+    fileName: string;
+    folderPath: string;
+    metadata?: Record<string, any>;
+};
+type FileDownloadUrl = {
+    downloadUrl: string;
+    contentType: string;
+    fileName: string;
+};
+type FileReference = {
+    fileId: string;
+    reference: string;
+    providerId: string;
+};
+interface IFileManager {
+    uploadFile(file: FileData): Promise<FileReference>;
+    getFileContent(fileId: string): Promise<FileData>;
+    getFileDownloadUrl(fileId: string): Promise<FileDownloadUrl>;
+}
+type FilesReferenceData = {
+    reference: string;
+    providerId: string;
+    metadata?: Record<string, any>;
+    fileName: string;
+    filePath: string;
+    fileSize: number;
+    contentType: string;
+};
+type FileReferenceRecord = FilesReferenceData & {
+    fileId: string;
+    createdOn: Date;
+    updatedOn: Date;
+};
+interface IFilesReferenceRepository {
+    getReference(fileId: string): Promise<FileReferenceRecord>;
+    createReference(file: FilesReferenceData): Promise<FileReferenceRecord>;
+    updateReference(fileId: string, file: FilesReferenceData): Promise<FileReferenceRecord>;
+    deleteReference(fileId: string): Promise<void>;
+}
+type FileProviderReference = {
+    reference: string;
+};
+type FileProviderUploadData = {
+    fileName: string;
+    content: Buffer;
+    contentType: string;
+};
+type FileProviderDownloadData = {
+    content: Buffer;
+};
+type FileProviderDownloadUrl = {
+    downloadUrl: string;
+};
+interface IFileProvider {
+    getProviderId(): string;
+    uploadFile(file: FileProviderUploadData): Promise<FileProviderReference>;
+    deleteFile(reference: FileProviderReference): Promise<void>;
+    downloadFile(reference: FileProviderReference): Promise<FileProviderDownloadData>;
+    getFileProviderDownloadUrl(reference: FileProviderReference): Promise<FileProviderDownloadUrl>;
+}
+
 type FilterExpression<TEntity> = (entity: TEntity) => boolean;
 
 type LocalizedMap<T> = {
@@ -1141,6 +1211,14 @@ interface EntityProps {
 }
 declare const WpEntity: (name: string, props?: Omit<EntityProps, "name">) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol | undefined, descriptor?: TypedPropertyDescriptor<Y> | undefined) => void;
 
+interface FileProviderProps {
+    providerId: string;
+}
+declare const WpFileProvider: (providerId: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol | undefined, descriptor?: TypedPropertyDescriptor<Y> | undefined) => void;
+interface FileReferenceRepositoryProps {
+}
+declare const WpFileReferenceRepository: () => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol | undefined, descriptor?: TypedPropertyDescriptor<Y> | undefined) => void;
+
 interface WpAppInitializerProps {
     priority?: number;
 }
@@ -1195,6 +1273,8 @@ declare const EntityManagerSymbols: {
     EmailProvider: symbol;
     EmailTemplate: symbol;
     BucketProvider: symbol;
+    FileProvider: symbol;
+    FileReferenceRepository: symbol;
     PipelineTemplate: symbol;
 };
 
@@ -1704,6 +1784,17 @@ declare class EmailService {
     private get provider();
 }
 
+declare class FilesService implements IFileManager {
+    private readonly registry;
+    constructor(registry: EntityManagerRegistry);
+    uploadFile(file: FileData): Promise<FileReference>;
+    getFileContent(fileId: string): Promise<FileData>;
+    getFileDownloadUrl(fileId: string): Promise<FileDownloadUrl>;
+    private getFileProvider;
+    private get defaultFileProvider();
+    private get referencesRepo();
+}
+
 type IEventData<TEventPayload> = {
     payload?: TEventPayload;
     userId?: string;
@@ -2200,11 +2291,16 @@ declare class AppInMemorySettings<T> {
     get value(): T;
 }
 
+type AwsBucketPaths = {
+    filesUpload: string;
+};
 type AwsBucketSettings = {
     awsAccessKeyId?: string;
     awsSecretAccessKey?: string;
     region?: string;
     defaultBucket: string;
+    publicLinksExpirationMinutes: number;
+    paths: AwsBucketPaths;
 };
 
 declare class AwsBucketModule {
@@ -2340,7 +2436,9 @@ declare class EntityManagerInitializer {
     private registerEntities;
     private executeInitializers;
     private executeSeeders;
+    private registerFileProviders;
     private registerBucketProviders;
+    private registerFilesReferenceRepositoryProviders;
     private registerEventTrackingProviders;
     private registerVersioningProviders;
     private registerEmailProviders;
@@ -2361,6 +2459,8 @@ declare class EntityManagerInitializer {
     private discoverEmailProviders;
     private discoverEventTrackingProviders;
     private discoverBucketProviders;
+    private discoverFileProviders;
+    private discoverFilesReferenceRepositoryProviders;
 }
 
 declare class AppSessionMiddleware implements NestMiddleware {
@@ -2382,4 +2482,4 @@ declare const renderHandlebarsTemplate: <TContext extends object>(input: {
 
 declare const newUuid: () => string;
 
-export { AUTHENTICATION_EVENTS_NAMESPACE, AppExceptionsFilterBase, AppHashingService, AppInMemorySettings, AppRole, AppSessionMiddleware, AppSessionService, AuthGuard, Authenticated, AuthenticationEmailTemplates, AuthenticationError, AuthenticationEvents, AuthenticationExtensionSymbols, AuthenticationModule, AuthenticationModuleSettings, AuthenticationService, AwsBucketModule, AwsBucketSettings, AwsEmailModule, AwsS3BucketError as AwsS2BucketError, AwsS3BucketProvider, AwsSesEmailTemplate, AwsSesEmailTemplateData, AwsSesSettings, BooleanFacet, BooleanFacetItem, BucketContentItem, BucketFileDeleteInput, BucketFileDownloadInput, BucketFilePublicUrlCreateInput, BucketFileUploadInput, BucketFolderContentResult, BucketFolderCreateInput, BucketFolderEnsureInput, BucketFolderExistsInput, BucketFolderListInput, BucketFolderListResult, BucketItemType, BucketProviderProps, ClassType, CurrentUser, CurrentUserData, DeepPartial, EmailService, EmailTemplateProps, EmailVerifyEmailPayload, EmailVerifyTokenPayload, EntitiesExportFile, EntitiesExportInput, EntitiesExportOptions, EntitiesExportResult, EntitiesImportExportSettings, EntitiesImportInput, EntitiesImportResult, EntitiesImportStatistics, EntitiesSampleDownloadOptions, EntitiesSampleDownloadResult, EntityActionsProps, EntityAdapterProps, EntityAuthMiddlewareProps, EntityConnectorProps, EntityConverterProps, EntityExportBucketSettings, EntityManagerConfigurationError, EntityManagerException, EntityManagerInitializer, EntityManagerModule, EntityManagerProps, EntityManagerRegistry, EntityManagerService, EntityManagerSettings, EntityManagerSymbols, EntityManagerUnauthorizedException, EntityNotFoundException, EntityOperationType, EntityOperationUnauthorizedException, EntityProps, EntityQueryBuilderProps, EntityRepositoryProps, EntitySeeder, EntitySeederProps, EntitySerializationFormat, EntitySerializer, EntitySerializerColumnDefinition, EntitySerializerProps, EntitySerializerSheetDefinition, EntityVersionInput, EntityVersionOperation, EntityVersioningProviderProps, EnumType, EventsService, EventsTrackerProps, FilterExpression, HtmlEmailInput, IAppCompany, IAppDirectory, IAppDivision, IAppOrganization, IAppRole, IAppTenant, IAppUser, IAppUserGroup, IAppUserProfile, IAuthRole, IAuthRoleService, IAuthService, IAuthUser, IAuthUserContext, IAuthUserOrganization, IAuthUserProfile, IAuthUserRolesService, IAuthUserService, IAuthUserTenant, IAuthUserTokenData, IAuthenticationContext, IAuthenticationContextProvider, IAuthenticationUserRole, IAuthorizationResult, IBucketProvider, IEmailProvider, IEmailTemplate, IEmailTemplatesCollection, IEntitiesCountAction, IEntitiesCountQuery, IEntitiesDeleteAction, IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesDeleteResult$1 as IEntitiesDeleteResult, IEntitiesExportAction, IEntitiesExportCommand, IEntitiesImportAction, IEntitiesImportCommand, IEntitiesQueryBuilder, IEntitiesSampleDownloadAction, IEntitiesSampleDownloadCommand, IEntitiesSearchAction, IEntitiesSearchQuery, IEntitiesSearchResults, IEntitiesSearchResultsPaging, IEntityActions, IEntityAdapter, IEntityAuthorizationMiddleware, IEntityConverter, IEntityCreateAction, IEntityCreateCommand, IEntityDeleteAction, IEntityDeleteCommand, IEntityEventsManager, IEntityExistsAction, IEntityExistsQuery, IEntityFacet, IEntityFacetItem, IEntityFacets, IEntityGetAction, IEntityGetQuery, IEntityManager, IEntityManagerServiceCollection, IEntityManagerServiceRoot, IEntityMapper, IEntityReplicaDeleteManager, IEntityReplicaSyncManager, IEntityRepository, IEntitySearchParameters, IEntitySearchResults, IEntitySerializer, IEntityUpdateAction, IEntityUpdateCommand, IEntityUpsertAction, IEntityUpsertCommand, IEntityVersioningProvider, IEntityVersioningResults, IEntityVersionsCursor, IEntityVersionsFilters, IEntityVersionsReference, IEntityVersionsResultsPaging, IEntityVersionsSearchAction, IEntityVersionsSearchInput, IEntityVersionsSearchParameters, IEntityVersionsSearchQuery, IEntityVersionsSearchResults, IEntityVersionsSorting, IEventLog, IEventsTracker, IFullTextQuery, IMultiCompanyEntity, IMultiOrganizationEntity, IMultiTenantEntity, IPipelineStepBuilder, IPipelineStepOperationBuilder, IPipelineStepOperationOptionsBuilder, IPipelineTemplateBuilder, IReplicasConfiguration, ISearchFilters, ISearchOptions, ISearchRequestPaging, ISearchResultsPaging, ISearchSorting, ISearchSortingField, InMemoryBucketProvider, InMemoryEmailProvider, InvalidCredentialsError, LocalizedMap, LocalizedTexts, MemberOf, MessagingEmailSentPayload, MissingEntityIdError, ModulesContainerProvider, MultiTenancyModule, MultipleEntitiesFoundException, NestEntityActions, NestEntityAuthorizationMiddleware, NestEntityManager, NestEntitySerializer, NestPipelineTemplate, NestTypeOrmEntitySeeder, NestTypeOrmQueryBuilder, NestTypeOrmRepository, NonNullable$1 as NonNullable, NumericFacet, NumericFacetItem, OperationDefinition, OperationTokenMismatchError, PLATFORM_EVENT_NAMESPACE, PasswordResetEmailPayload, PipelineCompletedStepState, PipelineController, PipelineCurrentStepState, PipelineDefinition, PipelineErrorType, PipelineOperationError, PipelineOperationResult, PipelineOperationResultType, PipelineOperationRollbackResult, PipelineOperationRollbackResultType, PipelineResult, PipelineResultType, PipelineStatus, PipelineStep, PipelineStepErrorType, PipelineStepOperation, PipelineStepResult, PipelineStepResultType, PipelineStepRollbackResult, PipelineStepRollbackResultType, PipelineStepState, PipelineTemplateProps, PipelinesBuilder, PipelinesRunner, PlatformEvents, Public, QueryBuilderBase, RegistrationEmailPayload, ReplicaConfiguration, ReplicaOptions, ReplicationMode, Roles, RolesGuardOptions, RollbackOperationDefinition, RuntimeErrorInformation, SendgridEmailModule, SendgridEmailTemplate, SendgridEmailTemplateData, SendgridSettings, SendgridTemplateBaseData, SendgridTemplateType, SortDirection, SortingType, StringFacet, StringFacetItem, TemplatedEmailInput, TrackingService, UserCreationError, UserCreationInput, UserCreationResult, UserDeleteInput, UserDisableInput, UserEnableInput, UserLoginEventPayload, UserLoginInput, UserLoginResult, UserPasswordChangeInput, UserPasswordResetCompleteInput, UserPasswordResetCompletedEventPayload, UserPasswordResetRequestCallbackTemplate, UserPasswordResetRequestInput, UserPasswordResetRequestResult, UserPasswordResetStartedEventPayload, UserPasswordResetTokenPayload, UserProfile, UserRegisterCallbackTemplate, UserRegistrationCompletedEventPayload, UserRegistrationError, UserRegistrationInput, UserRegistrationResult, UserRegistrationStartedEventPayload, UserTokenVerifyInput, UserTokenVerifyResult, UserVerifyCompleteInput, UserVerifyRequestCallbackTemplate, UserVerifyRequestInput, UserVerifyRequestResult as UserVerifyResetRequestResult, WpAppInitializer, WpAwsSesEmailTemplate, WpBucketProvider, WpEmailTemplate, WpEntity, WpEntityActions, WpEntityAdapter, WpEntityAuthMiddleware, WpEntityConnector, WpEntityConverter, WpEntityManager, WpEntityQueryBuilder, WpEntityRepository, WpEntitySeeder, WpEntitySerializer, WpEntityVersioningProvider, WpEventsTracker, WpPipeline, WpRolesService, WpSendgridEmailTemplate, WpUserRolesService, WpUserService, buildRolesGuard, createContainer, createExpressFileResponse, getLocalizedText, newUuid, renderHandlebarsTemplate, toEntitiesImportInput };
+export { AUTHENTICATION_EVENTS_NAMESPACE, AppExceptionsFilterBase, AppHashingService, AppInMemorySettings, AppRole, AppSessionMiddleware, AppSessionService, AuthGuard, Authenticated, AuthenticationEmailTemplates, AuthenticationError, AuthenticationEvents, AuthenticationExtensionSymbols, AuthenticationModule, AuthenticationModuleSettings, AuthenticationService, AwsBucketModule, AwsBucketSettings, AwsEmailModule, AwsS3BucketError as AwsS2BucketError, AwsS3BucketProvider, AwsSesEmailTemplate, AwsSesEmailTemplateData, AwsSesSettings, BooleanFacet, BooleanFacetItem, BucketContentItem, BucketFileDeleteInput, BucketFileDownloadInput, BucketFilePublicUrlCreateInput, BucketFileUploadInput, BucketFolderContentResult, BucketFolderCreateInput, BucketFolderEnsureInput, BucketFolderExistsInput, BucketFolderListInput, BucketFolderListResult, BucketItemType, BucketProviderProps, ClassType, CurrentUser, CurrentUserData, DeepPartial, EmailService, EmailTemplateProps, EmailVerifyEmailPayload, EmailVerifyTokenPayload, EntitiesExportFile, EntitiesExportInput, EntitiesExportOptions, EntitiesExportResult, EntitiesImportExportSettings, EntitiesImportInput, EntitiesImportResult, EntitiesImportStatistics, EntitiesSampleDownloadOptions, EntitiesSampleDownloadResult, EntityActionsProps, EntityAdapterProps, EntityAuthMiddlewareProps, EntityConnectorProps, EntityConverterProps, EntityExportBucketSettings, EntityManagerConfigurationError, EntityManagerException, EntityManagerInitializer, EntityManagerModule, EntityManagerProps, EntityManagerRegistry, EntityManagerService, EntityManagerSettings, EntityManagerSymbols, EntityManagerUnauthorizedException, EntityNotFoundException, EntityOperationType, EntityOperationUnauthorizedException, EntityProps, EntityQueryBuilderProps, EntityRepositoryProps, EntitySeeder, EntitySeederProps, EntitySerializationFormat, EntitySerializer, EntitySerializerColumnDefinition, EntitySerializerProps, EntitySerializerSheetDefinition, EntityVersionInput, EntityVersionOperation, EntityVersioningProviderProps, EnumType, EventsService, EventsTrackerProps, FileData, FileDownloadUrl, FileProviderDownloadData, FileProviderDownloadUrl, FileProviderProps, FileProviderReference, FileProviderUploadData, FileReference, FileReferenceRecord, FileReferenceRepositoryProps, FilesReferenceData, FilesService, FilterExpression, HtmlEmailInput, IAppCompany, IAppDirectory, IAppDivision, IAppOrganization, IAppRole, IAppTenant, IAppUser, IAppUserGroup, IAppUserProfile, IAuthRole, IAuthRoleService, IAuthService, IAuthUser, IAuthUserContext, IAuthUserOrganization, IAuthUserProfile, IAuthUserRolesService, IAuthUserService, IAuthUserTenant, IAuthUserTokenData, IAuthenticationContext, IAuthenticationContextProvider, IAuthenticationUserRole, IAuthorizationResult, IBucketProvider, IEmailProvider, IEmailTemplate, IEmailTemplatesCollection, IEntitiesCountAction, IEntitiesCountQuery, IEntitiesDeleteAction, IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesDeleteResult$1 as IEntitiesDeleteResult, IEntitiesExportAction, IEntitiesExportCommand, IEntitiesImportAction, IEntitiesImportCommand, IEntitiesQueryBuilder, IEntitiesSampleDownloadAction, IEntitiesSampleDownloadCommand, IEntitiesSearchAction, IEntitiesSearchQuery, IEntitiesSearchResults, IEntitiesSearchResultsPaging, IEntityActions, IEntityAdapter, IEntityAuthorizationMiddleware, IEntityConverter, IEntityCreateAction, IEntityCreateCommand, IEntityDeleteAction, IEntityDeleteCommand, IEntityEventsManager, IEntityExistsAction, IEntityExistsQuery, IEntityFacet, IEntityFacetItem, IEntityFacets, IEntityGetAction, IEntityGetQuery, IEntityManager, IEntityManagerServiceCollection, IEntityManagerServiceRoot, IEntityMapper, IEntityReplicaDeleteManager, IEntityReplicaSyncManager, IEntityRepository, IEntitySearchParameters, IEntitySearchResults, IEntitySerializer, IEntityUpdateAction, IEntityUpdateCommand, IEntityUpsertAction, IEntityUpsertCommand, IEntityVersioningProvider, IEntityVersioningResults, IEntityVersionsCursor, IEntityVersionsFilters, IEntityVersionsReference, IEntityVersionsResultsPaging, IEntityVersionsSearchAction, IEntityVersionsSearchInput, IEntityVersionsSearchParameters, IEntityVersionsSearchQuery, IEntityVersionsSearchResults, IEntityVersionsSorting, IEventLog, IEventsTracker, IFileManager, IFileProvider, IFilesReferenceRepository, IFullTextQuery, IMultiCompanyEntity, IMultiOrganizationEntity, IMultiTenantEntity, IPipelineStepBuilder, IPipelineStepOperationBuilder, IPipelineStepOperationOptionsBuilder, IPipelineTemplateBuilder, IReplicasConfiguration, ISearchFilters, ISearchOptions, ISearchRequestPaging, ISearchResultsPaging, ISearchSorting, ISearchSortingField, InMemoryBucketProvider, InMemoryEmailProvider, InvalidCredentialsError, LocalizedMap, LocalizedTexts, MemberOf, MessagingEmailSentPayload, MissingEntityIdError, ModulesContainerProvider, MultiTenancyModule, MultipleEntitiesFoundException, NestEntityActions, NestEntityAuthorizationMiddleware, NestEntityManager, NestEntitySerializer, NestPipelineTemplate, NestTypeOrmEntitySeeder, NestTypeOrmQueryBuilder, NestTypeOrmRepository, NonNullable$1 as NonNullable, NumericFacet, NumericFacetItem, OperationDefinition, OperationTokenMismatchError, PLATFORM_EVENT_NAMESPACE, PasswordResetEmailPayload, PipelineCompletedStepState, PipelineController, PipelineCurrentStepState, PipelineDefinition, PipelineErrorType, PipelineOperationError, PipelineOperationResult, PipelineOperationResultType, PipelineOperationRollbackResult, PipelineOperationRollbackResultType, PipelineResult, PipelineResultType, PipelineStatus, PipelineStep, PipelineStepErrorType, PipelineStepOperation, PipelineStepResult, PipelineStepResultType, PipelineStepRollbackResult, PipelineStepRollbackResultType, PipelineStepState, PipelineTemplateProps, PipelinesBuilder, PipelinesRunner, PlatformEvents, Public, QueryBuilderBase, RegistrationEmailPayload, ReplicaConfiguration, ReplicaOptions, ReplicationMode, Roles, RolesGuardOptions, RollbackOperationDefinition, RuntimeErrorInformation, SendgridEmailModule, SendgridEmailTemplate, SendgridEmailTemplateData, SendgridSettings, SendgridTemplateBaseData, SendgridTemplateType, SortDirection, SortingType, StringFacet, StringFacetItem, TemplatedEmailInput, TrackingService, UserCreationError, UserCreationInput, UserCreationResult, UserDeleteInput, UserDisableInput, UserEnableInput, UserLoginEventPayload, UserLoginInput, UserLoginResult, UserPasswordChangeInput, UserPasswordResetCompleteInput, UserPasswordResetCompletedEventPayload, UserPasswordResetRequestCallbackTemplate, UserPasswordResetRequestInput, UserPasswordResetRequestResult, UserPasswordResetStartedEventPayload, UserPasswordResetTokenPayload, UserProfile, UserRegisterCallbackTemplate, UserRegistrationCompletedEventPayload, UserRegistrationError, UserRegistrationInput, UserRegistrationResult, UserRegistrationStartedEventPayload, UserTokenVerifyInput, UserTokenVerifyResult, UserVerifyCompleteInput, UserVerifyRequestCallbackTemplate, UserVerifyRequestInput, UserVerifyRequestResult as UserVerifyResetRequestResult, WpAppInitializer, WpAwsSesEmailTemplate, WpBucketProvider, WpEmailTemplate, WpEntity, WpEntityActions, WpEntityAdapter, WpEntityAuthMiddleware, WpEntityConnector, WpEntityConverter, WpEntityManager, WpEntityQueryBuilder, WpEntityRepository, WpEntitySeeder, WpEntitySerializer, WpEntityVersioningProvider, WpEventsTracker, WpFileProvider, WpFileReferenceRepository, WpPipeline, WpRolesService, WpSendgridEmailTemplate, WpUserRolesService, WpUserService, buildRolesGuard, createContainer, createExpressFileResponse, getLocalizedText, newUuid, renderHandlebarsTemplate, toEntitiesImportInput };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punks/backend-entity-manager",
-  "version": "0.0.121",
+  "version": "0.0.123",
   "description": "",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",