@volontariapp/domain-storage 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.0
+
+### Minor Changes
+
+- feat(domain-storage): implement FileStatus & EntityType enums, FileId & MimeType value objects, and domain exceptions
+
 All notable changes to this project will be documented in this file.
 
 ## 0.1.0
@@ -7,4 +13,3 @@ All notable changes to this project will be documented in this file.
 ### Minor Changes
 
 - Initial package scaffold.
-

package/dist/enums/entity-type.enum.d.ts

@@ -0,0 +1,7 @@
+export declare enum EntityType {
+    POST = "POST",
+    USER_AVATAR = "USER_AVATAR",
+    BADGE_ICON = "BADGE_ICON",
+    EVENT_COVER = "EVENT_COVER"
+}
+//# sourceMappingURL=entity-type.enum.d.ts.map

package/dist/enums/entity-type.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-type.enum.d.ts","sourceRoot":"","sources":["../../src/enums/entity-type.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,WAAW,gBAAgB;CAC5B"}

package/dist/enums/entity-type.enum.js

@@ -0,0 +1,8 @@
+export var EntityType;
+(function (EntityType) {
+    EntityType["POST"] = "POST";
+    EntityType["USER_AVATAR"] = "USER_AVATAR";
+    EntityType["BADGE_ICON"] = "BADGE_ICON";
+    EntityType["EVENT_COVER"] = "EVENT_COVER";
+})(EntityType || (EntityType = {}));
+//# sourceMappingURL=entity-type.enum.js.map

package/dist/enums/entity-type.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-type.enum.js","sourceRoot":"","sources":["../../src/enums/entity-type.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,yCAA2B,CAAA;IAC3B,uCAAyB,CAAA;IACzB,yCAA2B,CAAA;AAC7B,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB"}

package/dist/enums/file-status.enum.d.ts

@@ -0,0 +1,7 @@
+export declare enum FileStatus {
+    PENDING = "PENDING",
+    ATTACHED = "ATTACHED",
+    ORPHANED = "ORPHANED",
+    DELETED = "DELETED"
+}
+//# sourceMappingURL=file-status.enum.d.ts.map

package/dist/enums/file-status.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-status.enum.d.ts","sourceRoot":"","sources":["../../src/enums/file-status.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB"}

package/dist/enums/file-status.enum.js

@@ -0,0 +1,8 @@
+export var FileStatus;
+(function (FileStatus) {
+    FileStatus["PENDING"] = "PENDING";
+    FileStatus["ATTACHED"] = "ATTACHED";
+    FileStatus["ORPHANED"] = "ORPHANED";
+    FileStatus["DELETED"] = "DELETED";
+})(FileStatus || (FileStatus = {}));
+//# sourceMappingURL=file-status.enum.js.map

package/dist/enums/file-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-status.enum.js","sourceRoot":"","sources":["../../src/enums/file-status.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,mCAAqB,CAAA;IACrB,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;AACrB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB"}

package/dist/enums/index.d.ts

@@ -0,0 +1,3 @@
+export * from './file-status.enum.js';
+export * from './entity-type.enum.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/enums/index.js

@@ -0,0 +1,3 @@
+export * from './file-status.enum.js';
+export * from './entity-type.enum.js';
+//# sourceMappingURL=index.js.map

package/dist/enums/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/exceptions/file-not-found.exception.d.ts

@@ -0,0 +1,5 @@
+import { NotFoundError } from '@volontariapp/errors';
+export declare class FileNotFoundException extends NotFoundError {
+    constructor(fileId: string);
+}
+//# sourceMappingURL=file-not-found.exception.d.ts.map

package/dist/exceptions/file-not-found.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-not-found.exception.d.ts","sourceRoot":"","sources":["../../src/exceptions/file-not-found.exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,MAAM,EAAE,MAAM;CAG3B"}

package/dist/exceptions/file-not-found.exception.js

@@ -0,0 +1,7 @@
+import { NotFoundError } from '@volontariapp/errors';
+export class FileNotFoundException extends NotFoundError {
+    constructor(fileId) {
+        super(`File with ID '${fileId}' was not found.`, 'FILE_NOT_FOUND', { fileId });
+    }
+}
+//# sourceMappingURL=file-not-found.exception.js.map

package/dist/exceptions/file-not-found.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-not-found.exception.js","sourceRoot":"","sources":["../../src/exceptions/file-not-found.exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,MAAc;QACxB,KAAK,CAAC,iBAAiB,MAAM,kBAAkB,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;CACF"}

package/dist/exceptions/index.d.ts

@@ -0,0 +1,3 @@
+export * from './file-not-found.exception.js';
+export * from './invalid-file-extension.exception.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}

package/dist/exceptions/index.js

@@ -0,0 +1,3 @@
+export * from './file-not-found.exception.js';
+export * from './invalid-file-extension.exception.js';
+//# sourceMappingURL=index.js.map

package/dist/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}

package/dist/exceptions/invalid-file-extension.exception.d.ts

@@ -0,0 +1,6 @@
+import { BadRequestError } from '@volontariapp/errors';
+import { EntityType } from '../enums/entity-type.enum.js';
+export declare class InvalidFileExtensionException extends BadRequestError {
+    constructor(mimeType: string, entityType?: EntityType | string);
+}
+//# sourceMappingURL=invalid-file-extension.exception.d.ts.map

package/dist/exceptions/invalid-file-extension.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-file-extension.exception.d.ts","sourceRoot":"","sources":["../../src/exceptions/invalid-file-extension.exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,qBAAa,6BAA8B,SAAQ,eAAe;gBACpD,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM;CAO/D"}

package/dist/exceptions/invalid-file-extension.exception.js

@@ -0,0 +1,10 @@
+import { BadRequestError } from '@volontariapp/errors';
+export class InvalidFileExtensionException extends BadRequestError {
+    constructor(mimeType, entityType) {
+        const message = entityType
+            ? `MIME type '${mimeType}' is not allowed for entity type '${entityType}'.`
+            : `MIME type '${mimeType}' is not allowed.`;
+        super(message, 'INVALID_FILE_EXTENSION', { mimeType, entityType });
+    }
+}
+//# sourceMappingURL=invalid-file-extension.exception.js.map

package/dist/exceptions/invalid-file-extension.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-file-extension.exception.js","sourceRoot":"","sources":["../../src/exceptions/invalid-file-extension.exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,OAAO,6BAA8B,SAAQ,eAAe;IAChE,YAAY,QAAgB,EAAE,UAAgC;QAC5D,MAAM,OAAO,GAAG,UAAU;YACxB,CAAC,CAAC,cAAc,QAAQ,qCAAqC,UAAU,IAAI;YAC3E,CAAC,CAAC,cAAc,QAAQ,mBAAmB,CAAC;QAE9C,KAAK,CAAC,OAAO,EAAE,wBAAwB,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,2 +1,4 @@
-export {};
+export * from './enums/index.js';
+export * from './exceptions/index.js';
+export * from './value-objects/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,2 +1,4 @@
-export {};
+export * from './enums/index.js';
+export * from './exceptions/index.js';
+export * from './value-objects/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/test/domain-storage.unit.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain-storage.unit.spec.d.ts.map

package/dist/test/domain-storage.unit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-storage.unit.spec.d.ts","sourceRoot":"","sources":["../../src/test/domain-storage.unit.spec.ts"],"names":[],"mappings":""}

package/dist/test/domain-storage.unit.spec.js

@@ -0,0 +1,89 @@
+import { describe, expect, it } from '@jest/globals';
+import { EntityType, FileId, FileNotFoundException, FileStatus, InvalidFileExtensionException, MimeType, COMMON_ALLOWED_MIME_TYPES, GLOBAL_ALLOWED_MIME_TYPES, ALLOWED_MIME_TYPES_BY_ENTITY, } from '../index.js';
+describe('Domain Storage Unit Tests', () => {
+    describe('Enums', () => {
+        it('should contain expected FileStatus values', () => {
+            expect(FileStatus.PENDING).toBe('PENDING');
+            expect(FileStatus.ATTACHED).toBe('ATTACHED');
+            expect(FileStatus.ORPHANED).toBe('ORPHANED');
+            expect(FileStatus.DELETED).toBe('DELETED');
+        });
+        it('should contain expected EntityType values', () => {
+            expect(EntityType.POST).toBe('POST');
+            expect(EntityType.USER_AVATAR).toBe('USER_AVATAR');
+            expect(EntityType.BADGE_ICON).toBe('BADGE_ICON');
+            expect(EntityType.EVENT_COVER).toBe('EVENT_COVER');
+        });
+    });
+    describe('FileId Value Object', () => {
+        it('should create a valid FileId from UUID v4 string', () => {
+            const validUuid = '123e4567-e89b-42d3-a456-426614174000';
+            const fileId = FileId.create(validUuid);
+            expect(fileId.getValue()).toBe(validUuid);
+        });
+        it('should generate a valid FileId', () => {
+            const fileId = FileId.generate();
+            expect(fileId.getValue()).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i);
+        });
+        it('should throw error for invalid UUID v4 format', () => {
+            expect(() => FileId.create('invalid-uuid')).toThrow();
+            expect(() => FileId.create('')).toThrow();
+        });
+        it('should verify equality of FileId instances', () => {
+            const uuid = '123e4567-e89b-42d3-a456-426614174000';
+            const fileId1 = FileId.create(uuid);
+            const fileId2 = FileId.create(uuid);
+            const fileId3 = FileId.generate();
+            expect(fileId1.equals(fileId2)).toBe(true);
+            expect(fileId1.equals(fileId3)).toBe(false);
+        });
+    });
+    describe('MimeType Value Object & Constants', () => {
+        it('should define correct common and entity allowed MIME types', () => {
+            expect(COMMON_ALLOWED_MIME_TYPES).toContain('image/jpeg');
+            expect(COMMON_ALLOWED_MIME_TYPES).toContain('image/png');
+            expect(COMMON_ALLOWED_MIME_TYPES).toContain('image/webp');
+            expect(ALLOWED_MIME_TYPES_BY_ENTITY.BADGE_ICON).toContain('image/svg+xml');
+            expect(ALLOWED_MIME_TYPES_BY_ENTITY.USER_AVATAR).not.toContain('image/svg+xml');
+            expect(GLOBAL_ALLOWED_MIME_TYPES).toContain('image/svg+xml');
+        });
+        it('should create valid MimeType without entityType', () => {
+            const mime = MimeType.create('IMAGE/JPEG ');
+            expect(mime.getValue()).toBe('image/jpeg');
+        });
+        it('should create valid MimeType for entityType', () => {
+            const mime = MimeType.create('image/svg+xml', EntityType.BADGE_ICON);
+            expect(mime.getValue()).toBe('image/svg+xml');
+        });
+        it('should throw InvalidFileExtensionException when MIME type is not allowed for entity', () => {
+            expect(() => MimeType.create('image/svg+xml', EntityType.USER_AVATAR)).toThrow(InvalidFileExtensionException);
+        });
+        it('should throw InvalidFileExtensionException for unsupported global MIME type', () => {
+            expect(() => MimeType.create('application/exe')).toThrow(InvalidFileExtensionException);
+        });
+        it('should verify equality of MimeType instances', () => {
+            const mime1 = MimeType.create('image/png');
+            const mime2 = MimeType.create('IMAGE/PNG');
+            const mime3 = MimeType.create('image/webp');
+            expect(mime1.equals(mime2)).toBe(true);
+            expect(mime1.equals(mime3)).toBe(false);
+        });
+    });
+    describe('Exceptions', () => {
+        it('should create FileNotFoundException with correct properties', () => {
+            const fileId = '123e4567-e89b-42d3-a456-426614174000';
+            const exc = new FileNotFoundException(fileId);
+            expect(exc.statusCode).toBe(404);
+            expect(exc.code).toBe('FILE_NOT_FOUND');
+            expect(exc.message).toContain(fileId);
+        });
+        it('should create InvalidFileExtensionException with correct properties', () => {
+            const exc = new InvalidFileExtensionException('application/x-sh', EntityType.POST);
+            expect(exc.statusCode).toBe(400);
+            expect(exc.code).toBe('INVALID_FILE_EXTENSION');
+            expect(exc.message).toContain('application/x-sh');
+            expect(exc.message).toContain('POST');
+        });
+    });
+});
+//# sourceMappingURL=domain-storage.unit.spec.js.map

package/dist/test/domain-storage.unit.spec.js.map

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

package/dist/value-objects/file-id.vo.d.ts

@@ -0,0 +1,9 @@
+export declare class FileId {
+    private readonly value;
+    private constructor();
+    static create(id: string): FileId;
+    static generate(): FileId;
+    getValue(): string;
+    equals(other: FileId): boolean;
+}
+//# sourceMappingURL=file-id.vo.d.ts.map

package/dist/value-objects/file-id.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-id.vo.d.ts","sourceRoot":"","sources":["../../src/value-objects/file-id.vo.ts"],"names":[],"mappings":"AAKA,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO;WAIO,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;WAO1B,QAAQ,IAAI,MAAM;IAIzB,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAMtC"}

package/dist/value-objects/file-id.vo.js

@@ -0,0 +1,27 @@
+import { BadRequestError } from '@volontariapp/errors';
+const UUID_V4_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+export class FileId {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    static create(id) {
+        if (!id || typeof id !== 'string' || !UUID_V4_REGEX.test(id)) {
+            throw new BadRequestError(`Invalid FileId UUID v4 format: '${id}'`, 'INVALID_FILE_ID', { id });
+        }
+        return new FileId(id);
+    }
+    static generate() {
+        return new FileId(crypto.randomUUID());
+    }
+    getValue() {
+        return this.value;
+    }
+    equals(other) {
+        if (!other || !(other instanceof FileId)) {
+            return false;
+        }
+        return this.value === other.getValue();
+    }
+}
+//# sourceMappingURL=file-id.vo.js.map

package/dist/value-objects/file-id.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-id.vo.js","sourceRoot":"","sources":["../../src/value-objects/file-id.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,aAAa,GACjB,wEAAwE,CAAC;AAE3E,MAAM,OAAO,MAAM;IACA,KAAK,CAAS;IAE/B,YAAoB,KAAa;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,EAAU;QAC7B,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,eAAe,CAAC,mCAAmC,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACjG,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAEM,MAAM,CAAC,QAAQ;QACpB,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACzC,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEM,MAAM,CAAC,KAAa;QACzB,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,YAAY,MAAM,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/value-objects/index.d.ts

@@ -0,0 +1,4 @@
+export * from './mime-type.constants.js';
+export * from './mime-type.vo.js';
+export * from './file-id.vo.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/value-objects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/value-objects/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/value-objects/index.js

@@ -0,0 +1,4 @@
+export * from './mime-type.constants.js';
+export * from './mime-type.vo.js';
+export * from './file-id.vo.js';
+//# sourceMappingURL=index.js.map

package/dist/value-objects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/value-objects/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/value-objects/mime-type.constants.d.ts

@@ -0,0 +1,6 @@
+import { EntityType } from '../enums/entity-type.enum.js';
+export declare const COMMON_ALLOWED_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/webp"];
+export declare const ALLOWED_MIME_TYPES_BY_ENTITY: Record<EntityType, readonly string[]>;
+export declare const GLOBAL_ALLOWED_MIME_TYPES: readonly string[];
+export type AllowedMimeType = (typeof GLOBAL_ALLOWED_MIME_TYPES)[number];
+//# sourceMappingURL=mime-type.constants.d.ts.map

package/dist/value-objects/mime-type.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-type.constants.d.ts","sourceRoot":"","sources":["../../src/value-objects/mime-type.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,eAAO,MAAM,yBAAyB,oDAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAKrE,CAAC;AAEX,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAEtD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/value-objects/mime-type.constants.js

@@ -0,0 +1,14 @@
+import { EntityType } from '../enums/entity-type.enum.js';
+export const COMMON_ALLOWED_MIME_TYPES = [
+    'image/jpeg',
+    'image/png',
+    'image/webp',
+];
+export const ALLOWED_MIME_TYPES_BY_ENTITY = {
+    [EntityType.USER_AVATAR]: [...COMMON_ALLOWED_MIME_TYPES],
+    [EntityType.POST]: [...COMMON_ALLOWED_MIME_TYPES],
+    [EntityType.EVENT_COVER]: [...COMMON_ALLOWED_MIME_TYPES],
+    [EntityType.BADGE_ICON]: [...COMMON_ALLOWED_MIME_TYPES, 'image/svg+xml'],
+};
+export const GLOBAL_ALLOWED_MIME_TYPES = Array.from(new Set(Object.values(ALLOWED_MIME_TYPES_BY_ENTITY).flat()));
+//# sourceMappingURL=mime-type.constants.js.map

package/dist/value-objects/mime-type.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-type.constants.js","sourceRoot":"","sources":["../../src/value-objects/mime-type.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,YAAY;IACZ,WAAW;IACX,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GAA0C;IACjF,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,yBAAyB,CAAC;IACxD,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,yBAAyB,CAAC;IACjD,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,yBAAyB,CAAC;IACxD,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,yBAAyB,EAAE,eAAe,CAAC;CAChE,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAsB,KAAK,CAAC,IAAI,CACpE,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,IAAI,EAAE,CAAC,CAC5D,CAAC"}

package/dist/value-objects/mime-type.vo.d.ts

@@ -0,0 +1,9 @@
+import { EntityType } from '../enums/entity-type.enum.js';
+export declare class MimeType {
+    private readonly value;
+    private constructor();
+    static create(value: string, entityType?: EntityType | string): MimeType;
+    getValue(): string;
+    equals(other: MimeType): boolean;
+}
+//# sourceMappingURL=mime-type.vo.d.ts.map

package/dist/value-objects/mime-type.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-type.vo.d.ts","sourceRoot":"","sources":["../../src/value-objects/mime-type.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAO1D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO;WAIO,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ;IAqBxE,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;CAMxC"}

package/dist/value-objects/mime-type.vo.js

@@ -0,0 +1,36 @@
+import { InvalidFileExtensionException } from '../exceptions/invalid-file-extension.exception.js';
+import { ALLOWED_MIME_TYPES_BY_ENTITY, GLOBAL_ALLOWED_MIME_TYPES, } from './mime-type.constants.js';
+export class MimeType {
+    value;
+    constructor(value) {
+        this.value = value.toLowerCase().trim();
+    }
+    static create(value, entityType) {
+        if (!value || typeof value !== 'string') {
+            throw new InvalidFileExtensionException(String(value), entityType);
+        }
+        const normalized = value.toLowerCase().trim();
+        if (entityType && entityType in ALLOWED_MIME_TYPES_BY_ENTITY) {
+            const allowedForEntity = ALLOWED_MIME_TYPES_BY_ENTITY[entityType];
+            if (!allowedForEntity.includes(normalized)) {
+                throw new InvalidFileExtensionException(normalized, entityType);
+            }
+        }
+        else {
+            if (!GLOBAL_ALLOWED_MIME_TYPES.includes(normalized)) {
+                throw new InvalidFileExtensionException(normalized, entityType);
+            }
+        }
+        return new MimeType(normalized);
+    }
+    getValue() {
+        return this.value;
+    }
+    equals(other) {
+        if (!other || !(other instanceof MimeType)) {
+            return false;
+        }
+        return this.value === other.getValue();
+    }
+}
+//# sourceMappingURL=mime-type.vo.js.map

package/dist/value-objects/mime-type.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-type.vo.js","sourceRoot":"","sources":["../../src/value-objects/mime-type.vo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAClG,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,MAAM,OAAO,QAAQ;IACF,KAAK,CAAS;IAE/B,YAAoB,KAAa;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,KAAa,EAAE,UAAgC;QAClE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,6BAA6B,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAE9C,IAAI,UAAU,IAAI,UAAU,IAAI,4BAA4B,EAAE,CAAC;YAC7D,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,UAAwB,CAAC,CAAC;YAChF,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,6BAA6B,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,6BAA6B,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEM,MAAM,CAAC,KAAe;QAC3B,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volontariapp/domain-storage",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -9,7 +9,7 @@
     "type": "git",
     "url": "git+https://github.com/Volontariapp/npm-packages.git"
   },
-  "description": "",
+  "description": "Domain storage definitions, value objects, enums and exceptions for Volontariapp",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,9 +30,17 @@
     "prepublishOnly": "yarn build",
     "build": "tsc -p tsconfig.json",
     "lint": "eslint src/",
-    "test": "echo \"No tests yet\""
+    "test": "node --experimental-vm-modules ../../node_modules/.bin/jest"
+  },
+  "dependencies": {
+    "@volontariapp/errors": "0.6.2"
   },
   "devDependencies": {
+    "@jest/globals": "^30.3.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.10.7",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
     "typescript": "5.7.3"
   }
 }