545563e776
- Complete NestJS TypeScript implementation with WebSocket support - Direct messaging (DM) and group chat functionality - End-to-end encryption with AES encryption and key pairs - Media file support (images, videos, audio, documents) up to 100MB - Push notifications with Firebase Cloud Messaging integration - Mention alerts and real-time typing indicators - User authentication with JWT and Passport - SQLite database with TypeORM entities and relationships - Comprehensive API documentation with Swagger/OpenAPI - File upload handling with secure access control - Online/offline status tracking and presence management - Message editing, deletion, and reply functionality - Notification management with automatic cleanup - Health check endpoint for monitoring - CORS configuration for cross-origin requests - Environment-based configuration management - Structured for Flutter SDK integration Features implemented: ✅ Real-time messaging with Socket.IO ✅ User registration and authentication ✅ Direct messages and group chats ✅ Media file uploads and management ✅ End-to-end encryption ✅ Push notifications ✅ Mention alerts ✅ Typing indicators ✅ Message read receipts ✅ Online status tracking ✅ File access control ✅ Comprehensive API documentation Ready for Flutter SDK development and production deployment.
476 lines
24 KiB
JavaScript
476 lines
24 KiB
JavaScript
import { defaultMetadataStorage } from './storage';
|
|
import { TransformationType } from './enums';
|
|
import { getGlobal, isPromise } from './utils';
|
|
function instantiateArrayType(arrayType) {
|
|
const array = new arrayType();
|
|
if (!(array instanceof Set) && !('push' in array)) {
|
|
return [];
|
|
}
|
|
return array;
|
|
}
|
|
export class TransformOperationExecutor {
|
|
// -------------------------------------------------------------------------
|
|
// Constructor
|
|
// -------------------------------------------------------------------------
|
|
constructor(transformationType, options) {
|
|
this.transformationType = transformationType;
|
|
this.options = options;
|
|
// -------------------------------------------------------------------------
|
|
// Private Properties
|
|
// -------------------------------------------------------------------------
|
|
this.recursionStack = new Set();
|
|
}
|
|
// -------------------------------------------------------------------------
|
|
// Public Methods
|
|
// -------------------------------------------------------------------------
|
|
transform(source, value, targetType, arrayType, isMap, level = 0) {
|
|
if (Array.isArray(value) || value instanceof Set) {
|
|
const newValue = arrayType && this.transformationType === TransformationType.PLAIN_TO_CLASS
|
|
? instantiateArrayType(arrayType)
|
|
: [];
|
|
value.forEach((subValue, index) => {
|
|
const subSource = source ? source[index] : undefined;
|
|
if (!this.options.enableCircularCheck || !this.isCircular(subValue)) {
|
|
let realTargetType;
|
|
if (typeof targetType !== 'function' &&
|
|
targetType &&
|
|
targetType.options &&
|
|
targetType.options.discriminator &&
|
|
targetType.options.discriminator.property &&
|
|
targetType.options.discriminator.subTypes) {
|
|
if (this.transformationType === TransformationType.PLAIN_TO_CLASS) {
|
|
realTargetType = targetType.options.discriminator.subTypes.find(subType => subType.name === subValue[targetType.options.discriminator.property]);
|
|
const options = { newObject: newValue, object: subValue, property: undefined };
|
|
const newType = targetType.typeFunction(options);
|
|
realTargetType === undefined ? (realTargetType = newType) : (realTargetType = realTargetType.value);
|
|
if (!targetType.options.keepDiscriminatorProperty)
|
|
delete subValue[targetType.options.discriminator.property];
|
|
}
|
|
if (this.transformationType === TransformationType.CLASS_TO_CLASS) {
|
|
realTargetType = subValue.constructor;
|
|
}
|
|
if (this.transformationType === TransformationType.CLASS_TO_PLAIN) {
|
|
subValue[targetType.options.discriminator.property] = targetType.options.discriminator.subTypes.find(subType => subType.value === subValue.constructor).name;
|
|
}
|
|
}
|
|
else {
|
|
realTargetType = targetType;
|
|
}
|
|
const value = this.transform(subSource, subValue, realTargetType, undefined, subValue instanceof Map, level + 1);
|
|
if (newValue instanceof Set) {
|
|
newValue.add(value);
|
|
}
|
|
else {
|
|
newValue.push(value);
|
|
}
|
|
}
|
|
else if (this.transformationType === TransformationType.CLASS_TO_CLASS) {
|
|
if (newValue instanceof Set) {
|
|
newValue.add(subValue);
|
|
}
|
|
else {
|
|
newValue.push(subValue);
|
|
}
|
|
}
|
|
});
|
|
return newValue;
|
|
}
|
|
else if (targetType === String && !isMap) {
|
|
if (value === null || value === undefined)
|
|
return value;
|
|
return String(value);
|
|
}
|
|
else if (targetType === Number && !isMap) {
|
|
if (value === null || value === undefined)
|
|
return value;
|
|
return Number(value);
|
|
}
|
|
else if (targetType === Boolean && !isMap) {
|
|
if (value === null || value === undefined)
|
|
return value;
|
|
return Boolean(value);
|
|
}
|
|
else if ((targetType === Date || value instanceof Date) && !isMap) {
|
|
if (value instanceof Date) {
|
|
return new Date(value.valueOf());
|
|
}
|
|
if (value === null || value === undefined)
|
|
return value;
|
|
return new Date(value);
|
|
}
|
|
else if (!!getGlobal().Buffer && (targetType === Buffer || value instanceof Buffer) && !isMap) {
|
|
if (value === null || value === undefined)
|
|
return value;
|
|
return Buffer.from(value);
|
|
}
|
|
else if (isPromise(value) && !isMap) {
|
|
return new Promise((resolve, reject) => {
|
|
value.then((data) => resolve(this.transform(undefined, data, targetType, undefined, undefined, level + 1)), reject);
|
|
});
|
|
}
|
|
else if (!isMap && value !== null && typeof value === 'object' && typeof value.then === 'function') {
|
|
// Note: We should not enter this, as promise has been handled above
|
|
// This option simply returns the Promise preventing a JS error from happening and should be an inaccessible path.
|
|
return value; // skip promise transformation
|
|
}
|
|
else if (typeof value === 'object' && value !== null) {
|
|
// try to guess the type
|
|
if (!targetType && value.constructor !== Object /* && TransformationType === TransformationType.CLASS_TO_PLAIN*/)
|
|
if (!Array.isArray(value) && value.constructor === Array) {
|
|
// Somebody attempts to convert special Array like object to Array, eg:
|
|
// const evilObject = { '100000000': '100000000', __proto__: [] };
|
|
// This could be used to cause Denial-of-service attack so we don't allow it.
|
|
// See prevent-array-bomb.spec.ts for more details.
|
|
}
|
|
else {
|
|
// We are good we can use the built-in constructor
|
|
targetType = value.constructor;
|
|
}
|
|
if (!targetType && source)
|
|
targetType = source.constructor;
|
|
if (this.options.enableCircularCheck) {
|
|
// add transformed type to prevent circular references
|
|
this.recursionStack.add(value);
|
|
}
|
|
const keys = this.getKeys(targetType, value, isMap);
|
|
let newValue = source ? source : {};
|
|
if (!source &&
|
|
(this.transformationType === TransformationType.PLAIN_TO_CLASS ||
|
|
this.transformationType === TransformationType.CLASS_TO_CLASS)) {
|
|
if (isMap) {
|
|
newValue = new Map();
|
|
}
|
|
else if (targetType) {
|
|
newValue = new targetType();
|
|
}
|
|
else {
|
|
newValue = {};
|
|
}
|
|
}
|
|
// traverse over keys
|
|
for (const key of keys) {
|
|
if (key === '__proto__' || key === 'constructor') {
|
|
continue;
|
|
}
|
|
const valueKey = key;
|
|
let newValueKey = key, propertyName = key;
|
|
if (!this.options.ignoreDecorators && targetType) {
|
|
if (this.transformationType === TransformationType.PLAIN_TO_CLASS) {
|
|
const exposeMetadata = defaultMetadataStorage.findExposeMetadataByCustomName(targetType, key);
|
|
if (exposeMetadata) {
|
|
propertyName = exposeMetadata.propertyName;
|
|
newValueKey = exposeMetadata.propertyName;
|
|
}
|
|
}
|
|
else if (this.transformationType === TransformationType.CLASS_TO_PLAIN ||
|
|
this.transformationType === TransformationType.CLASS_TO_CLASS) {
|
|
const exposeMetadata = defaultMetadataStorage.findExposeMetadata(targetType, key);
|
|
if (exposeMetadata && exposeMetadata.options && exposeMetadata.options.name) {
|
|
newValueKey = exposeMetadata.options.name;
|
|
}
|
|
}
|
|
}
|
|
// get a subvalue
|
|
let subValue = undefined;
|
|
if (this.transformationType === TransformationType.PLAIN_TO_CLASS) {
|
|
/**
|
|
* This section is added for the following report:
|
|
* https://github.com/typestack/class-transformer/issues/596
|
|
*
|
|
* We should not call functions or constructors when transforming to class.
|
|
*/
|
|
subValue = value[valueKey];
|
|
}
|
|
else {
|
|
if (value instanceof Map) {
|
|
subValue = value.get(valueKey);
|
|
}
|
|
else if (value[valueKey] instanceof Function) {
|
|
subValue = value[valueKey]();
|
|
}
|
|
else {
|
|
subValue = value[valueKey];
|
|
}
|
|
}
|
|
// determine a type
|
|
let type = undefined, isSubValueMap = subValue instanceof Map;
|
|
if (targetType && isMap) {
|
|
type = targetType;
|
|
}
|
|
else if (targetType) {
|
|
const metadata = defaultMetadataStorage.findTypeMetadata(targetType, propertyName);
|
|
if (metadata) {
|
|
const options = { newObject: newValue, object: value, property: propertyName };
|
|
const newType = metadata.typeFunction ? metadata.typeFunction(options) : metadata.reflectedType;
|
|
if (metadata.options &&
|
|
metadata.options.discriminator &&
|
|
metadata.options.discriminator.property &&
|
|
metadata.options.discriminator.subTypes) {
|
|
if (!(value[valueKey] instanceof Array)) {
|
|
if (this.transformationType === TransformationType.PLAIN_TO_CLASS) {
|
|
type = metadata.options.discriminator.subTypes.find(subType => {
|
|
if (subValue && subValue instanceof Object && metadata.options.discriminator.property in subValue) {
|
|
return subType.name === subValue[metadata.options.discriminator.property];
|
|
}
|
|
});
|
|
type === undefined ? (type = newType) : (type = type.value);
|
|
if (!metadata.options.keepDiscriminatorProperty) {
|
|
if (subValue && subValue instanceof Object && metadata.options.discriminator.property in subValue) {
|
|
delete subValue[metadata.options.discriminator.property];
|
|
}
|
|
}
|
|
}
|
|
if (this.transformationType === TransformationType.CLASS_TO_CLASS) {
|
|
type = subValue.constructor;
|
|
}
|
|
if (this.transformationType === TransformationType.CLASS_TO_PLAIN) {
|
|
if (subValue) {
|
|
subValue[metadata.options.discriminator.property] = metadata.options.discriminator.subTypes.find(subType => subType.value === subValue.constructor).name;
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
type = metadata;
|
|
}
|
|
}
|
|
else {
|
|
type = newType;
|
|
}
|
|
isSubValueMap = isSubValueMap || metadata.reflectedType === Map;
|
|
}
|
|
else if (this.options.targetMaps) {
|
|
// try to find a type in target maps
|
|
this.options.targetMaps
|
|
.filter(map => map.target === targetType && !!map.properties[propertyName])
|
|
.forEach(map => (type = map.properties[propertyName]));
|
|
}
|
|
else if (this.options.enableImplicitConversion &&
|
|
this.transformationType === TransformationType.PLAIN_TO_CLASS) {
|
|
// if we have no registererd type via the @Type() decorator then we check if we have any
|
|
// type declarations in reflect-metadata (type declaration is emited only if some decorator is added to the property.)
|
|
const reflectedType = Reflect.getMetadata('design:type', targetType.prototype, propertyName);
|
|
if (reflectedType) {
|
|
type = reflectedType;
|
|
}
|
|
}
|
|
}
|
|
// if value is an array try to get its custom array type
|
|
const arrayType = Array.isArray(value[valueKey])
|
|
? this.getReflectedType(targetType, propertyName)
|
|
: undefined;
|
|
// const subValueKey = TransformationType === TransformationType.PLAIN_TO_CLASS && newKeyName ? newKeyName : key;
|
|
const subSource = source ? source[valueKey] : undefined;
|
|
// if its deserialization then type if required
|
|
// if we uncomment this types like string[] will not work
|
|
// if (this.transformationType === TransformationType.PLAIN_TO_CLASS && !type && subValue instanceof Object && !(subValue instanceof Date))
|
|
// throw new Error(`Cannot determine type for ${(targetType as any).name }.${propertyName}, did you forget to specify a @Type?`);
|
|
// if newValue is a source object that has method that match newKeyName then skip it
|
|
if (newValue.constructor.prototype) {
|
|
const descriptor = Object.getOwnPropertyDescriptor(newValue.constructor.prototype, newValueKey);
|
|
if ((this.transformationType === TransformationType.PLAIN_TO_CLASS ||
|
|
this.transformationType === TransformationType.CLASS_TO_CLASS) &&
|
|
// eslint-disable-next-line @typescript-eslint/unbound-method
|
|
((descriptor && !descriptor.set) || newValue[newValueKey] instanceof Function))
|
|
// || TransformationType === TransformationType.CLASS_TO_CLASS
|
|
continue;
|
|
}
|
|
if (!this.options.enableCircularCheck || !this.isCircular(subValue)) {
|
|
const transformKey = this.transformationType === TransformationType.PLAIN_TO_CLASS ? newValueKey : key;
|
|
let finalValue;
|
|
if (this.transformationType === TransformationType.CLASS_TO_PLAIN) {
|
|
// Get original value
|
|
finalValue = value[transformKey];
|
|
// Apply custom transformation
|
|
finalValue = this.applyCustomTransformations(finalValue, targetType, transformKey, value, this.transformationType);
|
|
// If nothing change, it means no custom transformation was applied, so use the subValue.
|
|
finalValue = value[transformKey] === finalValue ? subValue : finalValue;
|
|
// Apply the default transformation
|
|
finalValue = this.transform(subSource, finalValue, type, arrayType, isSubValueMap, level + 1);
|
|
}
|
|
else {
|
|
if (subValue === undefined && this.options.exposeDefaultValues) {
|
|
// Set default value if nothing provided
|
|
finalValue = newValue[newValueKey];
|
|
}
|
|
else {
|
|
finalValue = this.transform(subSource, subValue, type, arrayType, isSubValueMap, level + 1);
|
|
finalValue = this.applyCustomTransformations(finalValue, targetType, transformKey, value, this.transformationType);
|
|
}
|
|
}
|
|
if (finalValue !== undefined || this.options.exposeUnsetFields) {
|
|
if (newValue instanceof Map) {
|
|
newValue.set(newValueKey, finalValue);
|
|
}
|
|
else {
|
|
newValue[newValueKey] = finalValue;
|
|
}
|
|
}
|
|
}
|
|
else if (this.transformationType === TransformationType.CLASS_TO_CLASS) {
|
|
let finalValue = subValue;
|
|
finalValue = this.applyCustomTransformations(finalValue, targetType, key, value, this.transformationType);
|
|
if (finalValue !== undefined || this.options.exposeUnsetFields) {
|
|
if (newValue instanceof Map) {
|
|
newValue.set(newValueKey, finalValue);
|
|
}
|
|
else {
|
|
newValue[newValueKey] = finalValue;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
if (this.options.enableCircularCheck) {
|
|
this.recursionStack.delete(value);
|
|
}
|
|
return newValue;
|
|
}
|
|
else {
|
|
return value;
|
|
}
|
|
}
|
|
applyCustomTransformations(value, target, key, obj, transformationType) {
|
|
let metadatas = defaultMetadataStorage.findTransformMetadatas(target, key, this.transformationType);
|
|
// apply versioning options
|
|
if (this.options.version !== undefined) {
|
|
metadatas = metadatas.filter(metadata => {
|
|
if (!metadata.options)
|
|
return true;
|
|
return this.checkVersion(metadata.options.since, metadata.options.until);
|
|
});
|
|
}
|
|
// apply grouping options
|
|
if (this.options.groups && this.options.groups.length) {
|
|
metadatas = metadatas.filter(metadata => {
|
|
if (!metadata.options)
|
|
return true;
|
|
return this.checkGroups(metadata.options.groups);
|
|
});
|
|
}
|
|
else {
|
|
metadatas = metadatas.filter(metadata => {
|
|
return !metadata.options || !metadata.options.groups || !metadata.options.groups.length;
|
|
});
|
|
}
|
|
metadatas.forEach(metadata => {
|
|
value = metadata.transformFn({ value, key, obj, type: transformationType, options: this.options });
|
|
});
|
|
return value;
|
|
}
|
|
// preventing circular references
|
|
isCircular(object) {
|
|
return this.recursionStack.has(object);
|
|
}
|
|
getReflectedType(target, propertyName) {
|
|
if (!target)
|
|
return undefined;
|
|
const meta = defaultMetadataStorage.findTypeMetadata(target, propertyName);
|
|
return meta ? meta.reflectedType : undefined;
|
|
}
|
|
getKeys(target, object, isMap) {
|
|
// determine exclusion strategy
|
|
let strategy = defaultMetadataStorage.getStrategy(target);
|
|
if (strategy === 'none')
|
|
strategy = this.options.strategy || 'exposeAll'; // exposeAll is default strategy
|
|
// get all keys that need to expose
|
|
let keys = [];
|
|
if (strategy === 'exposeAll' || isMap) {
|
|
if (object instanceof Map) {
|
|
keys = Array.from(object.keys());
|
|
}
|
|
else {
|
|
keys = Object.keys(object);
|
|
}
|
|
}
|
|
if (isMap) {
|
|
// expose & exclude do not apply for map keys only to fields
|
|
return keys;
|
|
}
|
|
/**
|
|
* If decorators are ignored but we don't want the extraneous values, then we use the
|
|
* metadata to decide which property is needed, but doesn't apply the decorator effect.
|
|
*/
|
|
if (this.options.ignoreDecorators && this.options.excludeExtraneousValues && target) {
|
|
const exposedProperties = defaultMetadataStorage.getExposedProperties(target, this.transformationType);
|
|
const excludedProperties = defaultMetadataStorage.getExcludedProperties(target, this.transformationType);
|
|
keys = [...exposedProperties, ...excludedProperties];
|
|
}
|
|
if (!this.options.ignoreDecorators && target) {
|
|
// add all exposed to list of keys
|
|
let exposedProperties = defaultMetadataStorage.getExposedProperties(target, this.transformationType);
|
|
if (this.transformationType === TransformationType.PLAIN_TO_CLASS) {
|
|
exposedProperties = exposedProperties.map(key => {
|
|
const exposeMetadata = defaultMetadataStorage.findExposeMetadata(target, key);
|
|
if (exposeMetadata && exposeMetadata.options && exposeMetadata.options.name) {
|
|
return exposeMetadata.options.name;
|
|
}
|
|
return key;
|
|
});
|
|
}
|
|
if (this.options.excludeExtraneousValues) {
|
|
keys = exposedProperties;
|
|
}
|
|
else {
|
|
keys = keys.concat(exposedProperties);
|
|
}
|
|
// exclude excluded properties
|
|
const excludedProperties = defaultMetadataStorage.getExcludedProperties(target, this.transformationType);
|
|
if (excludedProperties.length > 0) {
|
|
keys = keys.filter(key => {
|
|
return !excludedProperties.includes(key);
|
|
});
|
|
}
|
|
// apply versioning options
|
|
if (this.options.version !== undefined) {
|
|
keys = keys.filter(key => {
|
|
const exposeMetadata = defaultMetadataStorage.findExposeMetadata(target, key);
|
|
if (!exposeMetadata || !exposeMetadata.options)
|
|
return true;
|
|
return this.checkVersion(exposeMetadata.options.since, exposeMetadata.options.until);
|
|
});
|
|
}
|
|
// apply grouping options
|
|
if (this.options.groups && this.options.groups.length) {
|
|
keys = keys.filter(key => {
|
|
const exposeMetadata = defaultMetadataStorage.findExposeMetadata(target, key);
|
|
if (!exposeMetadata || !exposeMetadata.options)
|
|
return true;
|
|
return this.checkGroups(exposeMetadata.options.groups);
|
|
});
|
|
}
|
|
else {
|
|
keys = keys.filter(key => {
|
|
const exposeMetadata = defaultMetadataStorage.findExposeMetadata(target, key);
|
|
return (!exposeMetadata ||
|
|
!exposeMetadata.options ||
|
|
!exposeMetadata.options.groups ||
|
|
!exposeMetadata.options.groups.length);
|
|
});
|
|
}
|
|
}
|
|
// exclude prefixed properties
|
|
if (this.options.excludePrefixes && this.options.excludePrefixes.length) {
|
|
keys = keys.filter(key => this.options.excludePrefixes.every(prefix => {
|
|
return key.substr(0, prefix.length) !== prefix;
|
|
}));
|
|
}
|
|
// make sure we have unique keys
|
|
keys = keys.filter((key, index, self) => {
|
|
return self.indexOf(key) === index;
|
|
});
|
|
return keys;
|
|
}
|
|
checkVersion(since, until) {
|
|
let decision = true;
|
|
if (decision && since)
|
|
decision = this.options.version >= since;
|
|
if (decision && until)
|
|
decision = this.options.version < until;
|
|
return decision;
|
|
}
|
|
checkGroups(groups) {
|
|
if (!groups)
|
|
return true;
|
|
return this.options.groups.some(optionGroup => groups.includes(optionGroup));
|
|
}
|
|
}
|
|
//# sourceMappingURL=TransformOperationExecutor.js.map
|