import { inject, injectable, } from 'inversify'; import { ServiceIdentifiers } from '../../container/ServiceIdentifiers'; import * as estraverse from 'estraverse'; import * as ESTree from 'estree'; import { TControlFlowCustomNodeFactory } from '../../types/container/custom-nodes/TControlFlowCustomNodeFactory'; import { TControlFlowReplacerFactory } from '../../types/container/node-transformers/TControlFlowReplacerFactory'; import { TControlFlowStorage } from '../../types/storages/TControlFlowStorage'; import { TControlFlowStorageFactory } from '../../types/container/node-transformers/TControlFlowStorageFactory'; import { TNodeWithBlockScope } from '../../types/node/TNodeWithBlockScope'; import { ICustomNode } from '../../interfaces/custom-nodes/ICustomNode'; import { IOptions } from '../../interfaces/options/IOptions'; import { IRandomGenerator } from '../../interfaces/utils/IRandomGenerator'; import { IVisitor } from '../../interfaces/node-transformers/IVisitor'; import { ControlFlowCustomNode } from '../../enums/custom-nodes/ControlFlowCustomNode'; import { ControlFlowReplacer } from '../../enums/node-transformers/obfuscating-transformers/obfuscating-replacers/ControlFlowReplacer'; import { NodeType } from '../../enums/node/NodeType'; import { TransformationStage } from '../../enums/node-transformers/TransformationStage'; import { AbstractNodeTransformer } from '../AbstractNodeTransformer'; import { NodeAppender } from '../../node/NodeAppender'; import { NodeGuards } from '../../node/NodeGuards'; import { NodeMetadata } from '../../node/NodeMetadata'; import { NodeUtils } from '../../node/NodeUtils'; @injectable() export class FunctionControlFlowTransformer extends AbstractNodeTransformer { /** * @type {Map } */ private static readonly controlFlowReplacersMap: Map = new Map([ [NodeType.BinaryExpression, ControlFlowReplacer.BinaryExpressionControlFlowReplacer], [NodeType.CallExpression, ControlFlowReplacer.CallExpressionControlFlowReplacer], [NodeType.LogicalExpression, ControlFlowReplacer.LogicalExpressionControlFlowReplacer], [NodeType.Literal, ControlFlowReplacer.StringLiteralControlFlowReplacer] ]); /** * @type {number} */ private static readonly hostNodeSearchMinDepth: number = 0; /** * @type {number} */ private static readonly hostNodeSearchMaxDepth: number = 2; /** * @type {Map} */ private readonly controlFlowData: Map = new Map(); /** * @type {Set} */ private readonly visitedFunctionNodes: Set = new Set(); /** * @type {Set} */ private readonly hostNodesWithControlFlowNode: Set = new Set(); /** * @type {TControlFlowReplacerFactory} */ private readonly controlFlowReplacerFactory: TControlFlowReplacerFactory; /** * @type {TControlFlowStorageFactory} */ private readonly controlFlowStorageFactory: TControlFlowStorageFactory; /** * @type {TControlFlowCustomNodeFactory} */ private readonly controlFlowCustomNodeFactory: TControlFlowCustomNodeFactory; /** * @param {TControlFlowStorageFactory} controlFlowStorageFactory * @param {TControlFlowReplacerFactory} controlFlowReplacerFactory * @param {TControlFlowCustomNodeFactory} controlFlowCustomNodeFactory * @param {IRandomGenerator} randomGenerator * @param {IOptions} options */ constructor ( @inject(ServiceIdentifiers.Factory__TControlFlowStorage) controlFlowStorageFactory: TControlFlowStorageFactory, @inject(ServiceIdentifiers.Factory__IControlFlowReplacer) controlFlowReplacerFactory: TControlFlowReplacerFactory, @inject(ServiceIdentifiers.Factory__IControlFlowCustomNode) controlFlowCustomNodeFactory: TControlFlowCustomNodeFactory, @inject(ServiceIdentifiers.IRandomGenerator) randomGenerator: IRandomGenerator, @inject(ServiceIdentifiers.IOptions) options: IOptions ) { super(randomGenerator, options); this.controlFlowStorageFactory = controlFlowStorageFactory; this.controlFlowReplacerFactory = controlFlowReplacerFactory; this.controlFlowCustomNodeFactory = controlFlowCustomNodeFactory; } /** * @param {TransformationStage} transformationStage * @returns {IVisitor | null} */ public getVisitor (transformationStage: TransformationStage): IVisitor | null { switch (transformationStage) { case TransformationStage.ControlFlowFlattening: return { leave: (node: ESTree.Node, parentNode: ESTree.Node | null) => { if ( parentNode && ( NodeGuards.isFunctionDeclarationNode(node) || NodeGuards.isFunctionExpressionNode(node) || NodeGuards.isArrowFunctionExpressionNode(node) ) ) { return this.transformNode(node, parentNode); } } }; default: return null; } } /** * @param {Function} functionNode * @param {NodeGuards} parentNode * @returns {Function} */ public transformNode (functionNode: ESTree.Function, parentNode: ESTree.Node): ESTree.Function { this.visitedFunctionNodes.add(functionNode); if (!NodeGuards.isBlockStatementNode(functionNode.body)) { return functionNode; } const hostNode: TNodeWithBlockScope = this.getHostNode(functionNode.body); const controlFlowStorage: TControlFlowStorage = this.getControlFlowStorage(hostNode); this.controlFlowData.set(hostNode, controlFlowStorage); this.transformFunctionBody(functionNode.body, controlFlowStorage); if (!controlFlowStorage.getLength()) { return functionNode; } const controlFlowStorageCustomNode: ICustomNode = this.controlFlowCustomNodeFactory( ControlFlowCustomNode.ControlFlowStorageNode ); controlFlowStorageCustomNode.initialize(controlFlowStorage); NodeAppender.prependNode(hostNode, controlFlowStorageCustomNode.getNode()); this.hostNodesWithControlFlowNode.add(hostNode); return functionNode; } /** * @param {TNodeWithBlockScope} hostNode * @returns {TControlFlowStorage} */ private getControlFlowStorage (hostNode: TNodeWithBlockScope): TControlFlowStorage { const controlFlowStorage: TControlFlowStorage = this.controlFlowStorageFactory(); if (this.controlFlowData.has(hostNode)) { if (this.hostNodesWithControlFlowNode.has(hostNode)) { hostNode.body.shift(); } const hostControlFlowStorage: TControlFlowStorage = this.controlFlowData.get(hostNode); controlFlowStorage.mergeWith(hostControlFlowStorage, true); } return controlFlowStorage; } /** * @param {BlockStatement} functionNodeBody * @returns {TNodeWithBlockScope} */ private getHostNode (functionNodeBody: ESTree.BlockStatement): TNodeWithBlockScope { const blockScopesOfNode: TNodeWithBlockScope[] = NodeUtils.getBlockScopesOfNode(functionNodeBody); if (blockScopesOfNode.length === 1) { return functionNodeBody; } else { blockScopesOfNode.pop(); } if (blockScopesOfNode.length > FunctionControlFlowTransformer.hostNodeSearchMinDepth) { blockScopesOfNode.splice(0, FunctionControlFlowTransformer.hostNodeSearchMinDepth); } if (blockScopesOfNode.length > FunctionControlFlowTransformer.hostNodeSearchMaxDepth) { blockScopesOfNode.length = FunctionControlFlowTransformer.hostNodeSearchMaxDepth; } return this.randomGenerator.getRandomGenerator().pickone(blockScopesOfNode); } /** * @param {NodeGuards} node * @returns {boolean} */ private isVisitedFunctionNode (node: ESTree.Node): boolean { return ( NodeGuards.isFunctionDeclarationNode(node) || NodeGuards.isFunctionExpressionNode(node) || NodeGuards.isArrowFunctionExpressionNode(node) ) && this.visitedFunctionNodes.has(node); } /** * @param {BlockStatement} functionNodeBody * @param {TControlFlowStorage} controlFlowStorage */ private transformFunctionBody (functionNodeBody: ESTree.BlockStatement, controlFlowStorage: TControlFlowStorage): void { estraverse.replace(functionNodeBody, { enter: (node: ESTree.Node, parentNode: ESTree.Node | null): estraverse.VisitorOption | ESTree.Node => { if (NodeMetadata.isIgnoredNode(node)) { return estraverse.VisitorOption.Skip; } if (this.isVisitedFunctionNode(node) || !parentNode) { return estraverse.VisitorOption.Skip; } if (!FunctionControlFlowTransformer.controlFlowReplacersMap.has(node.type)) { return node; } if (this.randomGenerator.getMathRandom() > this.options.controlFlowFlatteningThreshold) { return node; } const controlFlowReplacerName: ControlFlowReplacer = FunctionControlFlowTransformer .controlFlowReplacersMap.get(node.type); if (controlFlowReplacerName === undefined) { return node; } return { ...this.controlFlowReplacerFactory(controlFlowReplacerName).replace(node, parentNode, controlFlowStorage), parentNode }; } }); } }